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

awscli/examples/omics/list-run-tasks.rst

@@ -32,4 +32,4 @@ Output::
         ]
     }
 
-For more information, see `Omics Workflows <https://docs.aws.amazon.com/omics/latest/dev/workflows.html>`__ in the *Amazon Omics Developer Guide*.
+For more information, see `Task lifecycle in a HealthOmics run <https://docs.aws.amazon.com/omics/latest/dev/workflow-run-tasks.html>`__ in the *AWS HealthOmics User Guide*.

awscli/examples/omics/list-runs.rst

@@ -43,4 +43,4 @@ Output::
         ]
     }
 
-For more information, see `Omics Workflows <https://docs.aws.amazon.com/omics/latest/dev/workflows.html>`__ in the *Amazon Omics Developer Guide*.
+For more information, see `Run lifecycle in a workflow <https://docs.aws.amazon.com/omics/latest/dev/monitoring-runs.html>`__ in the *AWS HealthOmics User Guide*.

awscli/examples/omics/list-workflows.rst

@@ -29,4 +29,4 @@ Output::
         ]
     }
 
-For more information, see `Omics Workflows <https://docs.aws.amazon.com/omics/latest/dev/workflows.html>`__ in the *Amazon Omics Developer Guide*.
+For more information, see `Creating private workflows <https://docs.aws.amazon.com/omics/latest/dev/workflows-setup.html>`__ in the *AWS HealthOmics User Guide*.

awscli/examples/omics/start-run.rst

@@ -32,7 +32,7 @@ Output::
         "tags": {}
     }
 
-For more information, see `Omics Workflows <https://docs.aws.amazon.com/omics/latest/dev/workflows.html>`__ in the *Amazon Omics Developer Guide*.
+For more information, see `Starting a run <https://docs.aws.amazon.com/omics/latest/dev/starting-a-run.html>`__ in the *AWS HealthOmics User Guide*.
 
 **To load source files from Amazon Omics**
 
@@ -46,4 +46,3 @@ You can also load source files from Amazon Omics storage, by using service-speci
         "ref_fasta_index": "omics://123456789012.storage.us-west-2.amazonaws.com/1234567890/reference/1234567890/index"
     }
 
-For more information, see `Omics Workflows <https://docs.aws.amazon.com/omics/latest/dev/workflows.html>`__ in the *Amazon Omics Developer Guide*.

awscli/examples/omics/update-workflow.rst

@@ -6,4 +6,4 @@ The following ``update-workflow`` example updates the description of a workflow
         --id 1234567 \
         --description "copy workflow"
 
-For more information, see `Omics Storage <https://docs.aws.amazon.com/omics/latest/dev/workflows.html>`__ in the *Amazon Omics Developer Guide*.
+For more information, see `Creating or updating a workflow <https://docs.aws.amazon.com/omics/latest/dev/creating-private-workflows.html>`__ in the *AWS HealthOmics User Guide*.

awscli/examples/pi/create-performance-analysis-report.rst

@@ -0,0 +1,17 @@
+**To create a performance analysis report**
+
+The following ``create-performance-analysis-report`` example creates a performance analysis report with the start time ``1682969503`` and end time ``1682979503`` for the database ``db-abcdefg123456789``. ::
+
+    aws pi create-performance-analysis-report \
+        --service-type RDS \
+        --identifier db-abcdefg123456789 \
+        --start-time 1682969503 \
+        --end-time 1682979503
+
+Output::
+
+    {
+        "AnalysisReportId": "report-0234d3ed98e28fb17"
+    }
+
+For more information about creating performance analysis reports, see `Creating a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html>`__ in the *Amazon RDS User Guide* and `Creating a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/delete-performance-analysis-report.rst

@@ -0,0 +1,12 @@
+**To delete a performance analysis report**
+
+The following ``delete-performance-analysis-report`` example deletes the performance analysis report with the report ID ``report-0d99cc91c4422ee61``. ::
+
+    aws pi delete-performance-analysis-report \
+        --service-type RDS \
+        --identifier db-abcdefg123456789 \
+        --analysis-report-id report-0d99cc91c4422ee61
+
+This command produces no output.
+
+For more information about deleting performance analysis reports, see `Deleting a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html>`__ in the *Amazon RDS User Guide* and `Deleting a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/describe-dimension-keys.rst

@@ -1,4 +1,4 @@
-**To describe dimension keys**
+**Example 1: To describe dimension keys**
 
 This example requests the names of all wait events. The data is summarized by event name, and the aggregate values of those events over the specified time period.
 
@@ -54,3 +54,35 @@ Output::
           }
       ]
   }
+
+**Example 2: To find the SQL ID for statements contributing the most to DB load**
+
+The following ``describe-dimension-keys`` requests the SQL statement and SQL ID for the 10 statements that contributed the most to DB load. ::
+
+    aws pi describe-dimension-keys \
+        --service-type RDS \
+        --identifier db-abcdefg123456789 \
+        --start-time 2023-05-01T00:00:00Z \
+        --end-time 2023-05-01T01:00:00Z \
+        --metric db.load.avg \
+        --group-by '{"Group": "db.sql", "Dimensions": ["db.sql.id", "db.sql.statement"],"Limit": 10}'
+
+Output::
+
+    {
+        "AlignedEndTime": 1.5270804E9,
+        "AlignedStartTime": 1.5270264E9,
+        "Identifier": "db-abcdefg123456789",
+        "MetricList": [
+            {
+                "Keys": [
+                    {
+                        "Dimensions": {"db.sql.id": "AKIAIOSFODNN7EXAMPLE", "db.sql.statement": "SELECT * FROM customers WHERE customer_id = 123"},
+                        "Total": 25.5,"Partitions": [12.3, 13.2]
+                    }
+                ]
+            }
+        ]
+    }
+
+For more information about dimensions in Performance Insights, see `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon RDS User Guide* and `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/get-dimension-key-details.rst

@@ -0,0 +1,25 @@
+**To get details for a specified dimension group for a DB instance**
+
+The following ``get-dimension-key-details`` example retrieves the full text of a SQL statement for DB instance ``db-10BCD2EFGHIJ3KL4M5NO6PQRS5``. The ``--group`` is ``db.sql``, and the ``--group-identifier`` is ``db.sql.id``. In this example, ``example-sql-id`` represents a SQL ID retrieved by using the ``get-resource-metrics`` or ``describe-dimension-keys`` operations. In this example, the dimensions details are available. Thus, Performance Insights retrieves the full text of the SQL statement, without truncating it. ::
+
+    aws pi get-dimension-key-details \
+        --service-type RDS \
+        --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \
+        --group db.sql \
+        --group-identifier example-sql-id \
+        --requested-dimensions statement
+
+Output::
+
+    {
+        "Dimensions":[
+            {
+                "Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id",
+                "Dimension": "db.sql.statement",
+                "Status": "AVAILABLE"
+            },
+        ...
+        ]
+    }
+
+For more information about dimensions in Performance Insights, see `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon RDS User Guide* and `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/get-performance-analysis-report.rst

@@ -0,0 +1,27 @@
+**To get a performance analysis report**
+
+The following ``get-performance-analysis-report`` example gets the performance analysis report for the database ``db-abcdefg123456789`` with the report ID ``report-0d99cc91c4422ee61``. The response provides the report status, ID, time details, and insights. ::
+
+    aws pi get-performance-analysis-report \
+        --service-type RDS \
+        --identifier db-abcdefg123456789 \
+        --analysis-report-id report-0d99cc91c4422ee61
+
+Output::
+
+    {
+        "AnalysisReport": {
+            "Status": "Succeeded",
+            "ServiceType": "RDS",
+            "Identifier": "db-abcdefg123456789",
+            "StartTime": 1680583486.584,
+            "AnalysisReportId": "report-0d99cc91c4422ee61",
+            "EndTime": 1680587086.584,
+            "CreateTime": 1680587087.139,
+            "Insights": [
+                ... (Condensed for space)
+           ]
+        }
+    }
+
+For more information about performance analysis reports, see `Analyzing database performance for a period of time <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html>`__ in the *Amazon RDS User Guide* and `Analyzing database performance for a period of time <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/get-resource-metadata.rst

@@ -0,0 +1,20 @@
+**To get resource metadata for a database**
+
+The following ``get-resource-metadata`` example gets the resource metadata for the database ``db-abcdefg123456789``. The response shows that SQL digest statistics are enabled. ::
+
+    aws pi get-resource-metadata \
+        --service-type RDS \
+        --identifier db-abcdefg123456789
+
+Output::
+
+    {    
+        "Identifier": "db-abcdefg123456789",
+        "Features":{
+            "SQL_DIGEST_STATISTICS":{
+                "Status": "ENABLED"
+            }
+        }
+    }
+
+For more information about SQL statistics for Performance Insights, see `SQL statistics for Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/sql-statistics.html>`__ in the *Amazon RDS User Guide* and `SQL statistics for Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/sql-statistics.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/list-available-resource-dimensions.rst

@@ -0,0 +1,48 @@
+**To list the dimensions that can be queried for a metric type on a DB instance**
+
+The following ``list-available-resource-dimensions`` example lists the ``db.load`` metrics you can query for the database ``db-abcdefg123456789``. ::
+
+    aws pi list-available-resource-dimensions \
+        --service-type RDS \
+        --identifier db-abcdefg123456789 \
+        --metrics db.load
+
+Output::
+
+    {
+        "MetricDimensions": [
+            {
+                "Metric": "db.load",
+                "Groups": [
+                    {
+                        "Group": "db.user",
+                        "Dimensions": [
+                            {
+                                "Identifier": "db.user.id"
+                            },
+                            {
+                                "Identifier": "db.user.name"
+                            }
+                        ]
+                    },
+                    {
+                        "Group": "db.sql_tokenized",
+                        "Dimensions": [
+                            {
+                                "Identifier": "db.sql_tokenized.id"
+                            },
+                            {
+                                "Identifier": "db.sql_tokenized.db_id"
+                            },
+                            {
+                                "Identifier": "db.sql_tokenized.statement"
+                            }
+                        ]
+                    },
+                    ...
+                ]
+            }
+        ]
+    }
+
+For more information about dimensions in Performance Insights, see `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon RDS User Guide* and `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/list-available-resource-metrics.rst

@@ -0,0 +1,29 @@
+**To list the metrics that can be queried for a metric type on a DB instance**
+
+The following ``list-available-resource-metrics`` example lists the ``db.load`` metrics you can query for the database ``db-abcdefg123456789``. ::
+
+    aws pi list-available-resource-metrics \
+        --service-type RDS \
+        --identifier db-abcdefg123456789 \
+        --metric-types "os" "db"
+
+Output::
+
+    {
+        "Metrics": [
+            {
+                "Description": "The number of virtual CPUs for the DB instance",
+                "Metric": "os.general.numVCPUs",
+                "Unit": "vCPUs"
+            },
+            ......,
+            {
+                "Description": "Time spent reading data file blocks by backends in this instance",
+                "Metric": "db.IO.read_latency",
+                "Unit": "Milliseconds per block"
+            },
+            ......
+        ]
+    }
+
+For more information about metrics in Performance Insights, see `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon RDS User Guide* and `Database load <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/list-performance-analysis-reports.rst

@@ -0,0 +1,44 @@
+**To list performance analysis reports for a database**
+
+The following ``list-performance-analysis-reports`` example lists performance analysis reports for the database ``db-abcdefg123456789``. The response lists all the reports with the report ID, status, and time period details. ::
+
+    aws pi list-performance-analysis-reports \
+        --service-type RDS \
+        --identifier db-abcdefg123456789
+
+Output::
+
+    {
+        "AnalysisReports": [
+            {
+                "Status": "Succeeded",
+                "EndTime": 1680587086.584,
+                "CreateTime": 1680587087.139,
+                "StartTime": 1680583486.584,
+                "AnalysisReportId": "report-0d99cc91c4422ee61"
+            },
+            {
+                "Status": "Succeeded",
+                "EndTime": 1681491137.914,
+                "CreateTime": 1681491145.973,
+                "StartTime": 1681487537.914,
+                "AnalysisReportId": "report-002633115cc002233"
+            },
+            {
+                "Status": "Succeeded",
+                "EndTime": 1681493499.849,
+                "CreateTime": 1681493507.762,
+                "StartTime": 1681489899.849,
+                "AnalysisReportId": "report-043b1e006b47246f9"
+            },
+            {
+                "Status": "InProgress",
+                "EndTime": 1682979503.0,
+                "CreateTime": 1682979618.994,
+                "StartTime": 1682969503.0,
+                "AnalysisReportId": "report-01ad15f9b88bcbd56"
+            }
+        ]
+    }
+
+For more information about performance analysis reports, see `Analyzing database performance for a period of time <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html>`__ in the *Amazon RDS User Guide* and `Analyzing database performance for a period of time <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/list-tags-for-resource.rst

@@ -0,0 +1,20 @@
+**To list tags for a performance analysis report**
+
+The following ``list-tags-for-resource`` example lists tags for a performance analysis report with the report ID ``report-0d99cc91c4422ee61``. ::
+
+    aws pi list-tags-for-resource \
+        --service-type RDS \
+        --resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61
+
+Output::
+
+    {
+        "Tags": [
+            {
+                "Value": "test-tag",
+                "Key": "name"
+            }
+        ]
+    }
+
+For more information about tagging performance analysis reports, see `Adding tags to a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html>`__ in the *Amazon RDS User Guide* and `Adding tags to a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/tag-resource.rst

@@ -0,0 +1,12 @@
+**To add a tag to a performance analysis report**
+
+The following ``tag-resource`` example adds the tag key ``name`` with the tag value ``test-tag`` to a performance analysis report with the report ID ``report-0d99cc91c4422ee61``. ::
+
+    aws pi tag-resource \
+        --service-type RDS \
+        --resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61 \
+        --tags Key=name,Value=test-tag
+
+This command produces no output.
+
+For more information about tagging performance analysis reports, see `Adding tags to a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html>`__ in the *Amazon RDS User Guide* and `Adding tags to a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/pi/untag-resource.rst

@@ -0,0 +1,12 @@
+**To delete a tag for a performance analysis report**
+
+The following ``untag-resource`` example deletes the tag ``name`` for a performance analysis report with the report ID ``report-0d99cc91c4422ee61``. ::
+
+    aws pi untag-resource \
+        --service-type RDS \
+        --resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61 \
+        --tag-keys name
+
+This command produces no output.
+
+For more information about tagging performance analysis reports, see `Adding tags to a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html>`__ in the *Amazon RDS User Guide* and `Adding tags to a performance analysis report in Performance Insights <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html>`__ in the *Amazon Aurora User Guide*.

awscli/examples/route53domains/get-domain-detail.rst

@@ -4,7 +4,7 @@ The following ``get-domain-detail`` command displays detailed information about
 
 This command runs only in the ``us-east-1`` Region. If your default region is set to ``us-east-1``, you can omit the ``region`` parameter. ::
 
-    aws route53domains get-domain-detail \ 
+    aws route53domains get-domain-detail \
         --region us-east-1 \
         --domain-name example.com
 
@@ -77,7 +77,7 @@ Output::
         "RegistrantPrivacy": true,
         "TechPrivacy": true,
         "RegistrarName": "Amazon Registrar, Inc.",
-        "WhoIsServer": "whois.registrar.amazon.com",
+        "WhoIsServer": "whois.registrar.amazon",
         "RegistrarUrl": "http://registrar.amazon.com",
         "AbuseContactEmail": "abuse@registrar.amazon.com",
         "AbuseContactPhone": "+1.2062661000",
@@ -86,4 +86,4 @@ Output::
         "StatusList": [
             "clientTransferProhibited"
         ]
-    }
+    }

awscli/examples/securityhub/describe-hub.rst

@@ -1,15 +1,17 @@
 **To get information about a hub resource**
 
-The following ``describe-hub`` example returns the subscription date for the specified hub resource. The hub resource is identified by its ARN. ::
+The following ``describe-hub`` example returns the subscription date and other configuration settings for the specified hub resource. The hub resource is identified by its ARN. ::
 
-    aws securityhub describe-hub \
+    aws securityhub describe-hub \
         --hub-arn "arn:aws:securityhub:us-west-1:123456789012:hub/default"
 
 Output::
 
     {
         "HubArn": "arn:aws:securityhub:us-west-1:123456789012:hub/default",
-        "SubscribedAt": "2019-11-19T23:15:10.046Z"
+        "SubscribedAt": "2019-11-19T23:15:10.046Z",
+        "AutoEnableControls": true,
+        "ControlFindingGenerator": "SECURITY_CONTROL"
     }
 
-For more information, see `AWS::SecurityHub::Hub <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-securityhub-hub.html>`__ in the *AWS CloudFormation User Guide*.
+For more information, see `AWS::SecurityHub::Hub <https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-securityhub-hub.html>`__ in the *AWS CloudFormation User Guide*.

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