diff --git a/awscli/examples/apigateway/update-vpc-link.rst b/awscli/examples/apigateway/update-vpc-link.rst
new file mode 100644
index 000000000000..4732e410d7eb
--- /dev/null
+++ b/awscli/examples/apigateway/update-vpc-link.rst
@@ -0,0 +1,43 @@
+**Example 1: To update an existing vpc link name**
+
+The following ``update-vpc-link`` example updates name of an existing the vpc link. ::
+
+    aws apigateway update-vpc-link  \
+        --vpc-link-id ab3de6 \
+        --patch-operations op=replace,path=/name,value=my-vpc-link
+
+Output::
+
+    {
+      "id": "ab3de6",
+      "name": "my-vpc-link",
+      "targetArns": [
+          "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/my-lb/12a456s89aaa12345"
+      ],
+      "status": "AVAILABLE",
+      "statusMessage": "Your vpc link is ready for use",
+      "tags": {}
+    }
+
+
+**Example 2: To update an existing vpc link name and description**
+
+The following ``update-vpc-link`` example updates name of an existing the vpc link. ::
+
+    aws apigateway update-vpc-link  \
+        --vpc-link-id ab3de6 \
+        --patch-operations op=replace,path=/name,value=my-vpc-link op=replace,path=/description,value="My custom description"
+
+Output::
+
+    {
+      "id": "ab3de6",
+      "name": "my-vpc-link",
+      "description": "My custom description",
+      "targetArns": [
+          "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/my-lb/12a456s89aaa12345"
+      ],
+      "status": "AVAILABLE",
+      "statusMessage": "Your vpc link is ready for use",
+      "tags": {}
+    }