awscli 1.42.7__py3-none-any.whl → 1.44.26__py3-none-any.whl

awscli/examples/servicediscovery/create-service.rst

@@ -1,22 +1,23 @@
-**To create a service**
+**Example 1: To create a service using namespace ID**
 
 The following ``create-service`` example creates a service. ::
 
     aws servicediscovery create-service \
         --name myservice \
         --namespace-id  ns-ylexjili4cdxy3xm \
-        --dns-config "NamespaceId=ns-ylexjili4cdxy3xm,RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"
+        --dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"
 
 Output::
 
     {
-            "Service": {
-            "Id": "srv-p5zdwlg5uvvzjita",
-            "Arn": "arn:aws:servicediscovery:us-west-2:803642222207:service/srv-p5zdwlg5uvvzjita",
+        "Service": {
+            "Id": "srv-abcd1234xmpl5678",
+            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
             "Name": "myservice",
-            "NamespaceId": "ns-ylexjili4cdxy3xm",
+            "NamespaceId": "ns-abcd1234xmpl5678",
             "DnsConfig": {
-                "NamespaceId": "ns-ylexjili4cdxy3xm",
+                "NamespaceId": "ns-abcd1234xmpl5678",
                 "RoutingPolicy": "MULTIVALUE",
                 "DnsRecords": [
                     {
@@ -25,10 +26,49 @@ Output::
                     }
                 ]
             },
-            "CreateDate": 1587081768.334,
-            "CreatorRequestId": "567c1193-6b00-4308-bd57-ad38a8822d25"
+            "Type": "DNS_HTTP",
+            "CreateDate": "2025-08-18T13:45:31.023000-05:00",
+            "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
+            "CreatedByAccount": "123456789012"
         }
     }
 
-For more information, see `Creating services <https://docs.aws.amazon.com/cloud-map/latest/dg/creating-services.html>`__ in the *AWS Cloud Map Developer Guide*.
+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>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To create a service using namespace ARN**
+
+The following ``create-service`` example creates a service using a namespace ARN instead of namespace ID. Specifying a namespace ARN is necessary when creating a service in a shared namespace. ::
+
+    aws servicediscovery create-service \
+        --name myservice-arn \
+        --namespace-id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
+        --dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"
+
+Output::
+
+    {
+        "Service": {
+            "Id": "srv-abcd1234xmpl5678",
+            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
+            "ResourceOwner": "123456789012",
+            "Name": "myservice-arn",
+            "NamespaceId": "ns-abcd1234xmpl5678",
+            "DnsConfig": {
+                "NamespaceId": "ns-abcd1234xmpl5678",
+                "RoutingPolicy": "MULTIVALUE",
+                "DnsRecords": [
+                    {
+                        "Type": "A",
+                        "TTL": 60
+                    }
+                ]
+            },
+            "Type": "DNS_HTTP",
+            "CreateDate": "2025-08-18T13:45:31.023000-05: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>`__ in the *AWS Cloud Map Developer Guide*.
 

awscli/examples/servicediscovery/delete-namespace.rst

@@ -1,17 +1,31 @@
-**To delete a namespace**
+**Example 1: To delete a namespace**
 
 The following ``delete-namespace`` example deletes a namespace. ::
 
     aws servicediscovery delete-namespace \
-        --id ns-ylexjili4cdxy3xm
+        --id ns-abcd1234xmpl5678
 
 Output::
 
     {
-        "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
+        "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 `Deleting namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+For more information, see `Deleting an AWS Cloud Map namespace <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
 
+**Example 2: To delete a namespace using namespace ARN**
+
+The following ``delete-namespace`` example deletes a namespace using its ARN. ::
+
+    aws servicediscovery delete-namespace \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678
+
+Output::
+
+    {
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
+    }
+
+For more information, see `Deleting an AWS Cloud Map namespace <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

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

@@ -1,11 +1,23 @@
-**To delete a service attribute**
+**Example 1: To delete a service attribute**
 
 The following ``delete-service-attributes`` example deletes a service attribute with the key ``Port`` that is associated with the specified service. ::
 
     aws servicediscovery delete-service-attributes \
-        --service-id srv-e4anhexample0004 \
+        --service-id srv-abcd1234xmpl5678 \
         --attributes Port
 
 This command produces no output.
 
-For more information, see `Deleting namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+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 delete a service attribute using ARN**
+
+The following ``delete-service-attributes`` example deletes a service attribute using the service ARN. Specifying the ARN is necessary for deleting attributes associated with services created in namespaces shared with your account. ::
+
+    aws servicediscovery delete-service-attributes \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
+        --attributes Port
+
+This command produces no output.
+
+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/delete-service.rst

@@ -1,11 +1,21 @@
-**To delete a service**
+**Example 1: To delete a service**
 
 The following ``delete-service`` example deletes a service. ::
 
     aws servicediscovery delete-service \
-        --id srv-p5zdwlg5uvvzjita
+        --id srv-abcd1234xmpl5678
 
 This command produces no output.
 
-For more information, see `Deleting services <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html>`__ in the *AWS Cloud Map Developer Guide*.
+For more information, see `Deleting an AWS Cloud Map service <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html>`__ in the *AWS Cloud Map Developer Guide*.
 
+**Example 2: To delete a service using ARN**
+
+The following ``delete-service`` example deletes a service using its ARN. ::
+
+    aws servicediscovery delete-service \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678
+
+This command produces no output.
+
+For more information, see `Deleting an AWS Cloud Map service <https://docs.aws.amazon.com/cloud-map/latest/dg/deleting-services.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/deregister-instance.rst

@@ -1,4 +1,4 @@
-**To deregister a service instance**
+**Example 1: To deregister a service instance**
 
 The following ``deregister-instance`` example deregisters a service instance. ::
 
@@ -12,7 +12,23 @@ Output::
         "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
     }
 
-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>`__ .
+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 `Deregistering service instances <https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
 
+**Example 2: To deregister a service instance using service ARN for shared namespaces**
+
+The following ``deregister-instance`` example deregisters a service instance using a service ARN instead of service ID. Specifying an ARN is required when deregistering instances from services created in namespaces that are shared with your account. ::
+
+    aws servicediscovery deregister-instance \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
+        --instance-id web-server-01
+
+Output::
+
+    {
+        "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
+    }
+
+For more information, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ and `Deregistering an AWS Cloud Map service instance <https://docs.aws.amazon.com/cloud-map/latest/dg/deregistering-instances.html>`__ in the *AWS Cloud Map Developer Guide*.
+

awscli/examples/servicediscovery/discover-instances-revision.rst

@@ -1,4 +1,4 @@
-**To discover the revision of an instance**
+**Example 1: To discover the revision of an instance**
 
 The following ``discover-instances-revision`` example discovers the increasing revision of an instance. ::
 
@@ -13,3 +13,20 @@ 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 discover the revision of instances from a specific owner account**
+
+The following ``discover-instances-revision`` example discovers the revision of instances from a specific owner account. The owner-account parameter is necessary for instances in namespaces that are shared with your account. ::
+
+    aws servicediscovery discover-instances-revision \
+        --namespace-name shared-namespace \
+        --service-name shared-service \
+        --owner-account 123456789111
+
+Output::
+
+    {
+        "InstancesRevision": 1234567890
+    }
+
+For more information, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ and `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*.

awscli/examples/servicediscovery/discover-instances.rst

@@ -1,4 +1,4 @@
-**To discover registered instances**
+**Example 1: To discover registered instances**
 
 The following ``discover-instances`` example discovers registered instances. ::
 
@@ -22,7 +22,37 @@ Output::
                     "AWS_INSTANCE_PORT": "808"
                 }
             }
-        ]
+        ],
+        "InstancesRevision": 85648075627387284
     }
 
 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 discover instances from a specific owner account**
+
+The following ``discover-instances`` example discovers registered instances from a specific owner account. This parameter is necessary to discover instances in namespaces that are shared with your account. ::
+
+    aws servicediscovery discover-instances \
+        --namespace-name shared-namespace \
+        --service-name shared-service \
+        --owner-account 123456789111
+
+Output::
+
+    {
+        "Instances": [
+            {
+                "InstanceId": "shared-instance-1234",
+                "NamespaceName": "shared-namespace",
+                "ServiceName": "shared-service",
+                "HealthStatus": "HEALTHY",
+                "Attributes": {
+                    "AWS_INSTANCE_IPV4": "203.0.113.75",
+                    "AWS_INSTANCE_PORT": "80"
+                }
+            }
+        ],
+        "InstancesRevision": 1234567890
+    }
+
+For more information, see `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ and `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*.

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*.