awscli 1.42.33__py3-none-any.whl → 1.44.6__py3-none-any.whl

awscli/examples/servicediscovery/get-instance.rst

@@ -1,4 +1,4 @@
-**To get the details of an instance**
+**Example 1: To get the details of an instance**
 
 The following ``get-instance`` example gets the attributes of a service. ::
 
@@ -8,8 +8,9 @@ The following ``get-instance`` example gets the attributes of a service. ::
 
 Output::
 
-    {
-        "Instances": {
+    {  
+        "ResourceOwner": "123456789012", 
+        "Instance": {
             "Id": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
             "Attributes": {
                 "AWS_INSTANCE_IPV4": "192.0.2.44",
@@ -17,8 +18,33 @@ Output::
                 "color": "green",
                 "region": "us-west-2",
                 "stage": "beta"
-            }
+            },
+            "CreatedByAccount": "123456789012"
         }
     }
 
 For more information, see `AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To get the details of an instance using service ARN for shared namespaces**
+
+The following ``get-instance`` example gets the attributes of an instance using a service ARN instead of service ID. Specifying an ARN is required when getting details of instances associated with namespaces that are shared with your account. The instance returned in this example was registered by account ``123456789111`` in a namespace owned by account ``123456789012``. ::
+
+    aws servicediscovery get-instance \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
+        --instance-id web-server-01
+
+Output::
+
+    {
+        "ResourceOwner": "123456789012",
+        "Instance": {
+            "Id": "web-server-01",
+            "Attributes": {
+                "AWS_INSTANCE_IPV4": "203.0.113.15",
+                "AWS_INSTANCE_PORT": "80"
+            },
+            "CreatedByAccount": "123456789111"
+        }
+    }
+
+For more information about cross-account namespace sharing, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/get-instances-health-status.rst

@@ -1,4 +1,4 @@
-**To get the health status of instances associated with a service**
+**Example 1: To get the health status of instances associated with a service**
 
 The following ``get-instances-health-status`` example gets the health status of instances associated with the specified service. ::
 
@@ -15,3 +15,21 @@ Output::
     }
 
 For more information, see `AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To get the health status of instances using service ARN for shared namespaces**
+
+The following ``get-instances-health-status`` example gets the health status of instances using a service ARN instead of service ID. Specifying an ARN is required when getting health status for instances associated with namespaces that are shared with the requester's account. ::
+
+    aws servicediscovery get-instances-health-status \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
+
+Output::
+
+    {
+        "Status": {
+            "web-server-01": "HEALTHY",
+            "web-server-02": "UNHEALTHY"
+        }
+    }
+
+For more information, see `AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-instances.html>`__ and `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/get-namespace.rst

@@ -1,28 +1,59 @@
-**To get the details of a namespace**
+**Example 1: To get the details of a namespace**
 
 The following ``get-namespace`` example retrieves information about the specified namespace. ::
 
     aws servicediscovery get-namespace \
-        --id ns-e4anhexample0004
+        --id ns-abcd1234xmpl5678
 
 Output::
 
     {
-        "Namespaces": {
-            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004",
-            "CreateDate": "20181118T211712Z",
-            "CreatorRequestId": "example-creator-request-id-0001",
-            "Description": "Example.com AWS Cloud Map HTTP Namespace",
-            "Id": "ns-e4anhexample0004",
+        "Namespace": {
+            "Id": "ns-abcd1234xmpl5678",
+            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
             "Name": "example-http.com",
+            "Type": "HTTP",
+            "Description": "Example.com AWS Cloud Map HTTP Namespace",
             "Properties": {
                 "DnsProperties": {},
                 "HttpProperties": {
                     "HttpName": "example-http.com"
                 }
             },
-            "Type": "HTTP"
+            "CreateDate": "2024-02-23T13:35:21.874000-06:00",
+            "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
         }
     }
 
 For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To get the details of a namespace using ARN**
+
+The following ``get-namespace`` example retrieves information about the specified namespace using its ARN. Specifying the ARN is necessary for retreiving details of a namespace shared with your account. ::
+
+    aws servicediscovery get-namespace \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
+
+Output::
+
+    {
+        "Namespace": {
+            "Id": "ns-abcd1234xmpl5678",
+            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
+            "Name": "example-http.com",
+            "Type": "HTTP",
+            "Description": "Example.com AWS Cloud Map HTTP Namespace",
+            "Properties": {
+                "DnsProperties": {},
+                "HttpProperties": {
+                    "HttpName": "example-http.com"
+                }
+            },
+            "CreateDate": "2024-02-23T13:35:21.874000-06:00",
+            "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
+        }
+    }
+
+For more information, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/get-operation.rst

@@ -1,23 +1,49 @@
-**To get the result of an operation**
+**Example 1: To get the result of an operation**
 
 The following ``get-operation`` example gets the result of a namespace creation operation. ::
 
     aws servicediscovery get-operation \
-        --operation-id gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd
+        --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234
 
 Output::
 
     {
         "Operation": {
-            "Id": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd",
+            "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
             "Type": "CREATE_NAMESPACE",
             "Status": "SUCCESS",
-            "CreateDate": 1587055860.121,
-            "UpdateDate": 1587055900.469,
+            "CreateDate": "2025-01-13T13:35:21.874000-06:00",
+            "UpdateDate": "2025-01-13T13:36:02.469000-06:00",
             "Targets": {
-                "NAMESPACE": "ns-ylexjili4cdxy3xm"
+                "NAMESPACE": "ns-abcd1234xmpl5678"
             }
         }
     }
 
 For more information, see `Creating an AWS Cloud Map namespace to group application services <https://docs.aws.amazon.com/cloud-map/latest/dg/creating-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To get an operation from a specific owner account**
+
+The following ``get-operation`` example gets the result of an operation associated with a specific namespace owner account. This parameter is necessary to get the result of operations associated with namespaces shared with your account. ::
+
+    aws servicediscovery get-operation \
+        --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \
+        --owner-account 123456789111
+
+Output::
+
+    {
+        "Operation": {
+            "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
+            "OwnerAccount": "123456789111",
+            "Type": "CREATE_NAMESPACE",
+            "Status": "SUCCESS",
+            "CreateDate": "2025-01-13T13:35:21.874000-06:00",
+            "UpdateDate": "2025-01-13T13:36:02.469000-06:00",
+            "Targets": {
+                "NAMESPACE": "ns-abcd1234xmpl5678"
+            }
+        }
+    }
+
+For more information, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/get-service-attributes.rst

@@ -1,15 +1,16 @@
-**To get the attributes of an service**
+**Example 1: To get the attributes of a service**
 
 The following ``get-service-attributes`` example gets the attributes of a service. ::
 
     aws servicediscovery get-service-attributes \
-        --service-id srv-e4anhexample0004
+        --service-id srv-abcd1234xmpl5678
 
 Output::
 
     {
         "ServiceAttributes": {
-            "ServiceArn": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
+            "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
             "Attributes": {
                 "Port": "80"
             }
@@ -17,3 +18,24 @@ Output::
     }
 
 For more information, see `AWS Cloud Map services <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To get the attributes of a service using ARN**
+
+The following ``get-service-attributes`` example gets the attributes of a service using its ARN. Specifying an ARN is necessary for getting attributes of a service created in a namespace shared with your account. ::
+
+    aws servicediscovery get-service-attributes \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
+
+Output::
+
+    {
+        "ServiceAttributes": {
+            "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
+            "Attributes": {
+                "Port": "80"
+            }
+        }
+    }
+
+For more information, see `AWS Cloud Map services <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html>`__ and `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/get-service.rst

@@ -1,23 +1,51 @@
-**To get the settings of a service**
+**Example 1: To get the settings of a service**
 
 The following ``get-service`` example gets the settings of a specified service. ::
 
     aws servicediscovery get-service \
-        --id srv-e4anhexample0004
+        --id srv-abcd1234xmpl5678
 
 Output::
 
     {
         "Service": {
-            "Id": "srv-e4anhexample0004",
-            "Arn": "arn:aws:servicediscovery:us-west-2:111122223333:service/srv-e4anhexample0004",
+            "Id": "srv-abcd1234xmpl5678",
+            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
             "Name": "test-service",
-            "NamespaceId": "ns-e4anhexample0004",
+            "NamespaceId": "ns-abcd1234xmpl5678",
             "DnsConfig": {},
             "Type": "HTTP",
-            "CreateDate": "2025-02-24T10:59:02.905000-06:00",
-            "CreatorRequestId": "3f50f9d9-b14c-482e-a556-d2a22fe6106d"
+            "CreateDate": "2025-08-18T13:53:02.775000-05:00",
+            "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
+            "CreatedByAccount": "123456789012"
         }
     }
 
 For more information, see `AWS Cloud Map services <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To get the settings of a service using ARN**
+
+The following ``get-service`` example gets the settings of a specified service using its ARN. Specifying the ARN is necessary when retrieving information about a service created in a namespace that is shared with your account. The caller account ``123456789111`` created the service in a namespace shared by account ``123456789012``. ::
+
+    aws servicediscovery get-service \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
+
+Output::
+
+    {
+        "Service": {
+            "Id": "srv-abcd1234xmpl5678",
+            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
+            "Name": "test-service",
+            "NamespaceId": "ns-abcd1234xmpl5678",
+            "DnsConfig": {},
+            "Type": "HTTP",
+            "CreateDate": "2025-08-18T13:53:02.775000-05:00",
+            "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
+            "CreatedByAccount": "123456789111"
+        }
+    }
+
+For more information, see `Creating an AWS Cloud Map service for an application component <https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html>`__ and `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/list-instances.rst

@@ -1,4 +1,4 @@
-**To list service instances**
+**Example 1: To list service instances**
 
 The following ``list-instances`` example lists service instances. ::
 
@@ -14,10 +14,45 @@ Output::
                 "Attributes": {
                     "AWS_INSTANCE_IPV4": "172.2.1.3",
                     "AWS_INSTANCE_PORT": "808"
-                }
+                },
+                "CreatedByAccount": "123456789012"
+            }
+        ],
+        "ResourceOwner": "123456789012"
+    }
+
+For more information, see `Listing AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To list service instances using service ARN**
+
+The following ``list-instances`` example lists service instances using a service ARN instead of service ID. Specifying an ARN is required when listing instances associated with namespaces that are shared with your account. ::
+
+    aws servicediscovery list-instances \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita
+
+Output::
+
+    {
+        "ResourceOwner": "123456789012",
+        "Instances": [
+            {
+                "Id": "web-server-01",
+                "Attributes": {
+                    "AWS_INSTANCE_IPV4": "203.0.113.15",
+                    "AWS_INSTANCE_PORT": "80"
+                },
+                "CreatedByAccount": "123456789012"
+            },
+            {
+                "Id": "web-server-02",
+                "Attributes": {
+                    "AWS_INSTANCE_IPV4": "203.0.113.16",
+                    "AWS_INSTANCE_PORT": "80"
+                },
+                "CreatedByAccount": "123456789012"
             }
         ]
     }
 
-For more information, see `Viewing a list of service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
+For more information about cross-account namespace sharing, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`_ and `Listing AWS Cloud Map service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
 

awscli/examples/servicediscovery/list-namespaces.rst

@@ -1,4 +1,4 @@
-**To list namespaces**
+**Example 1: To list namespaces**
 
 The following ``list-namespaces`` example lists namespaces. ::
 
@@ -9,50 +9,73 @@ Output::
     {
         "Namespaces": [
             {
-                "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-a3ccy2e7e3a7rile",
-                "CreateDate": 1585354387.357,
-                "Id": "ns-a3ccy2e7e3a7rile",
+                "Id": "ns-abcd1234xmpl5678",
+                "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
+                "ResourceOwner": "123456789012",
                 "Name": "local",
+                "Type": "DNS_PRIVATE",
                 "Properties": {
                     "DnsProperties": {
-                        "HostedZoneId": "Z06752353VBUDTC32S84S"
+                        "HostedZoneId": "Z06752353VBUDTC32S84S",
+                        "SOA": {}
                     },
                     "HttpProperties": {
                         "HttpName": "local"
                      }
                 },
-                "Type": "DNS_PRIVATE"
+                "CreateDate": "2023-07-17T13:37:27.872000-05:00"
             },
             {
-                "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-pocfyjtrsmwtvcxx",
-                "CreateDate": 1586468974.698,
-                "Description": "My second namespace",
-                "Id": "ns-pocfyjtrsmwtvcxx",
+                "Id": "ns-abcd1234xmpl9012",
+                "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl9012",
+                "ResourceOwner": "123456789012",
                 "Name": "My-second-namespace",
+                "Type": "HTTP",
+                "Description": "My second namespace",
                 "Properties": {
-                    "DnsProperties": {},
+                    "DnsProperties": {
+                        "SOA": {}
+                    },
                     "HttpProperties": {
                         "HttpName": "My-second-namespace"
                     }
                 },
-                "Type": "HTTP"
-            },
+                "CreateDate": "2023-11-14T10:35:47.840000-06:00"
+            }
+        ]
+    }
+
+For more information, see `Listing AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To list namespaces shared by other accounts**
+
+The following ``list-namespaces`` example lists namespaces that are shared with the caller account by other AWS accounts using the ``RESOURCE_OWNER`` filter. ::
+
+    aws servicediscovery list-namespaces \
+        --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
+
+Output::
+
+    {
+        "Namespaces": [
             {
-                "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-ylexjili4cdxy3xm",
-                "CreateDate": 1587055896.798,
-                "Id": "ns-ylexjili4cdxy3xm",
-                "Name": "example.com",
+                "Id": "ns-abcd1234xmpl5678",
+                "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:namespace/ns-abcd1234xmpl5678",
+                "ResourceOwner": "123456789111",
+                "Name": "shared-namespace",
+                "Type": "HTTP",
+                "Description": "Namespace shared from another account",
                 "Properties": {
                     "DnsProperties": {
-                        "HostedZoneId": "Z09983722P0QME1B3KC8I"
+                        "SOA": {}
                     },
-                     "HttpProperties": {
-                         "HttpName": "example.com"
+                    "HttpProperties": {
+                        "HttpName": "shared-namespace"
                     }
                 },
-                "Type": "DNS_PRIVATE"
+                "CreateDate": "2025-01-13T13:35:21.874000-06:00"
             }
         ]
     }
 
-For more information, see `Viewing a list of namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+For more information, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/list-services.rst

@@ -1,4 +1,4 @@
-**To list services**
+**Example 1: To list services**
 
 The following ``list-services`` example lists services. ::
 
@@ -26,5 +26,33 @@ Output::
         ]
     }
 
-For more information, see `Viewing a list of services <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html>`__ in the *AWS Cloud Map Developer Guide*.
+For more information, see `Listing AWS Cloud Map services in a namespace <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html>`__ in the *AWS Cloud Map Developer Guide*.
 
+**Example 2: To list services created in shared namespaces**
+
+The following ``list-services`` example lists services that are created in namespaces shared with the caller account ``123456789012`` by other AWS accounts using the ``RESOURCE_OWNER`` filter. ::
+
+    aws servicediscovery list-services \
+        --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ
+
+Output::
+
+    {
+        "Services": [
+            {
+                "Id": "srv-abcd1234xmpl5678",
+                "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:service/srv-abcd1234xmpl5678",
+                "ResourceOwner": "123456789111",
+                "Name": "shared-service",
+                "NamespaceId": "ns-abcd1234xmpl5678",
+                "Type": "HTTP",
+                "Description": "Service in shared namespace",
+                "DnsConfig": {},
+                "CreateDate": "2025-01-13T13:35:21.874000-06:00",
+                "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
+                "CreatedByAccount": "123456789012"
+            }
+        ]
+    }
+
+For more information, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ and `Listing AWS Cloud Map services in a namespace <https://docs.aws.amazon.com/cloud-map/latest/dg/listing-services.html>`__  in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/register-instance.rst

@@ -1,4 +1,4 @@
-**To register a service instance**
+**Example 1: To register a service instance using service ID**
 
 The following ``register-instance`` example registers a service instance. ::
 
@@ -15,5 +15,21 @@ Output::
 
 To confirm that the operation succeeded, you can run ``get-operation``. For more information, see `get-operation <https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html>`__ .
 
-For more information, see `Registering instances <https://docs.aws.amazon.com/cloud-map/latest/dg/registering-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
+For more information about registering an instance, see `Registering a resource as an AWS Cloud Map service instance <https://docs.aws.amazon.com/cloud-map/latest/dg/registering-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
 
+**Example 2: To register a service instance using service ARN**
+
+The following ``register-instance`` example registers a service instance using a service ARN. Specifying the ARN is required when registering instances in services that are shared with your account. ::
+
+    aws servicediscovery register-instance \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
+        --instance-id web-server-01 \
+        --attributes=AWS_INSTANCE_IPV4=203.0.113.15,AWS_INSTANCE_PORT=80
+
+Output::
+
+    {
+        "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
+    }
+
+For more information about cross-account namespace sharing, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/update-http-namespace.rst

@@ -1,18 +1,35 @@
-**To update an HTTP namespace**
+**Example 1: To update an HTTP namespace**
 
 The following ``update-http-namespace`` example updates the specified HTTP namespace's description. ::
 
     aws servicediscovery update-http-namespace \
-        --id ns-vh4nbmEXAMPLE \
-        --updater-request-id example-request-id \
+        --id ns-abcd1234xmpl5678 \
+        --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
         --namespace Description="The updated namespace description."
 
 Output::
 
     {
-        "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
     }
 
 To confirm that the operation succeeded, you can run ``get-operation``. For more information, see `get-operation <https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/get-operation.html>`__ .
 
-For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To update an HTTP namespace using ARN**
+
+The following ``update-http-namespace`` example updates the specified HTTP namespace using its ARN. ::
+
+    aws servicediscovery update-http-namespace \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
+        --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
+        --namespace Description="The updated namespace description."
+
+Output::
+
+    {
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
+    }
+
+For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/update-instance-custom-health-status.rst

@@ -1,4 +1,4 @@
-**To update a custom health check**
+**Example 1: To update a custom health check**
 
 The following ``update-instance-custom-health-status`` example updates the status of the custom health check for the specified service and example service instance to ``HEALTHY``. ::
 
@@ -10,3 +10,16 @@ The following ``update-instance-custom-health-status`` example updates the statu
 This command produces no output.
 
 For more information, see `AWS Cloud Map service health check configuration <https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To update a custom health check using service ARN**
+
+The following ``update-instance-custom-health-status`` example updates the status of the custom health check using a service ARN. The ARN is required when updating health status for instances associated with namespaces that are shared with the your account. ::
+
+    aws servicediscovery update-instance-custom-health-status \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
+        --instance-id web-server-01 \
+        --status HEALTHY
+
+This command produces no output.
+
+For more information, see `AWS Cloud Map service health check configuration <https://docs.aws.amazon.com/cloud-map/latest/dg/services-health-checks.html>`__ and `Cross-account AWS Cloud Map namespace sharing <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/update-private-dns-namespace.rst

@@ -1,18 +1,35 @@
-**To update a private DNS namespace**
+**Example 1: To update a private DNS namespace using ID**
 
-The following ``update-private-dns-namespace`` example updates the description of a private DNS namespace. ::
+The following ``update-private-dns-namespace`` example updates the description of a private DNS namespace using namespace ID. ::
 
     aws servicediscovery update-private-dns-namespace \
-        --id ns-bk3aEXAMPLE \
-        --updater-request-id example-private-request-id \
+        --id ns-abcd1234xmpl5678 \
+        --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
         --namespace Description="The updated namespace description."
 
 Output::
 
     {
-        "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
     }
 
 To confirm that the operation succeeded, you can run ``get-operation``.
 
 For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To update a private DNS namespace using ARN**
+
+The following ``update-private-dns-namespace`` example updates a private DNS namespace using its ARN. ::
+
+    aws servicediscovery update-private-dns-namespace \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
+        --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
+        --namespace Description="The updated namespace description."
+
+Output::
+
+    {
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
+    }
+
+For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.