awscli 1.37.4__py3-none-any.whl → 1.37.6__py3-none-any.whl

awscli/examples/ecs/list-service-deployments.rst

@@ -0,0 +1,25 @@
+**To list service deployments**
+
+The following ``list-service-deployments`` example retrieves the service deployments for the service named ``example-service``. ::
+
+    aws ecs list-service-deployments \
+        --service arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service
+
+Output::
+
+    {
+        "serviceDeployments": [
+            {
+                "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe",
+                "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service",
+                "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/example-cluster",
+                "startedAt": "2024-10-31T08:03:32.510000-04:00",
+                "createdAt": "2024-10-31T08:03:30.917000-04:00",
+                "finishedAt": "2024-10-31T08:05:04.527000-04:00",
+                "targetServiceRevisionArn": "arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678",
+                "status": "SUCCESSFUL"
+            }
+        ]
+    }
+
+For more information, see `View service history using Amazon ECS service deployments <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html>`_ in the *Amazon ECS Developer Guide*.

awscli/examples/ivs-realtime/create-storage-configuration.rst

@@ -1,21 +1,21 @@
-**To create a composition storage configuration**
-
-The following ``create-storage-configuration`` example creates a composition storage configuration with the specified properties. ::
-
-    aws ivs-realtime create-storage-configuration \
-        --name "test-sc" --s3 "bucketName=test-bucket-name"
-
-Output::
-
-    {
-        "storageConfiguration": {
-            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef",
-            "name": "test-sc",
-            "s3": {
-                "bucketName": "test-bucket-name"
-            },
-            "tags": {}
-        }
-    }
-
+**To create a composition storage configuration**
+
+The following ``create-storage-configuration`` example creates a composition storage configuration with the specified properties. ::
+
+    aws ivs-realtime create-storage-configuration \
+        --name "test-sc" --s3 "bucketName=amzn-s3-demo-bucket"
+
+Output::
+
+    {
+        "storageConfiguration": {
+            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABabCDcdEFef",
+            "name": "test-sc",
+            "s3": {
+                "bucketName": "amzn-s3-demo-bucket"
+            },
+            "tags": {}
+        }
+    }
+
 For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.

awscli/examples/ivs-realtime/get-storage-configuration.rst

@@ -1,21 +1,21 @@
-**To get a composition storage configuration**
-
-The following ``get-storage-configuration`` example gets the composition storage configuration specified by the given ARN (Amazon Resource Name). ::
-
-    aws ivs-realtime get-storage-configuration \
-        --name arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh"
-
-Output::
-
-    {
-        "storageConfiguration": {
-            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
-            "name": "test-sc",
-            "s3": {
-                "bucketName": "test-bucket-name"
-            },
-            "tags": {}
-        }
-    }
-
+**To get a composition storage configuration**
+
+The following ``get-storage-configuration`` example gets the composition storage configuration specified by the given ARN (Amazon Resource Name). ::
+
+    aws ivs-realtime get-storage-configuration \
+        --name arn "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh"
+
+Output::
+
+    {
+        "storageConfiguration": {
+            "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
+            "name": "test-sc",
+            "s3": {
+                "bucketName": "amzn-s3-demo-bucket"
+            },
+            "tags": {}
+        }
+    }
+
 For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.

awscli/examples/ivs-realtime/list-storage-configurations.rst

@@ -1,30 +1,30 @@
-**To list composition storage configurations**
-
-The following ``list-storage-configurations`` lists all composition storage configurations for your AWS account, in the AWS region where the API request is processed. ::
-
-    aws ivs-realtime list-storage-configurations
-
-Output::
-
-    {  
-        "storageConfigurations": [
-            {
-                "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
-                "name": "test-sc-1",
-                "s3": {
-                    "bucketName": "test-bucket-1-name"
-                },
-                "tags": {}
-            },
-            {
-                "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABCefgEFGabc",
-                "name": "test-sc-2",
-                "s3": {
-                    "bucketName": "test-bucket-2-name"
-                },
-                "tags": {}
-            }
-        ]
-    }
-
+**To list composition storage configurations**
+
+The following ``list-storage-configurations`` lists all composition storage configurations for your AWS account, in the AWS region where the API request is processed. ::
+
+    aws ivs-realtime list-storage-configurations
+
+Output::
+
+    {  
+        "storageConfigurations": [
+            {
+                "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/abcdABCDefgh",
+                "name": "test-sc-1",
+                "s3": {
+                    "bucketName": "amzn-s3-demo-bucket-1"
+                },
+                "tags": {}
+            },
+            {
+                "arn": "arn:aws:ivs:ap-northeast-1:123456789012:storage-configuration/ABCefgEFGabc",
+                "name": "test-sc-2",
+                "s3": {
+                    "bucketName": "amzn-s3-demo-bucket-2"
+                },
+                "tags": {}
+            }
+        ]
+    }
+
 For more information, see `Enabling Multiple Hosts on an Amazon IVS Stream <https://docs.aws.amazon.com/ivs/latest/LowLatencyUserGuide/multiple-hosts.html>`__ in the *Amazon Interactive Video Service User Guide*.

awscli/examples/kendra/create-data-source.rst

@@ -1,24 +1,24 @@
-**To create an Amazon Kendra data source connector**
-
-The following ``create-data-source`` creates and configures an Amazon Kendra data source connector. You can use ``describe-data-source`` to view the status of a data source connector, and read any error messages if the status shows a data source connector "FAILED" to completely create. ::
-
-    aws kendra create-data-source \
-        --name "example data source 1" \
-        --description "Example data source 1 for example index 1 contains the first set of example documents" \
-        --tags '{"Key": "test resources", "Value": "kendra"}, {"Key": "test resources", "Value": "aws"}' \
-        --role-arn "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource" \
-        --index-id exampleindex1 \
-        --language-code "es" \
-        --schedule "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *" \
-        --configuration '{"TemplateConfiguration": {"Template": file://s3schemaconfig.json}}' \
-        --type "TEMPLATE" \
-        --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://my-s3-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE"}' \
-        --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}'
-
-Output::
-
-    {
-        "Id": "exampledatasource1"
-    }
-
+**To create an Amazon Kendra data source connector**
+
+The following ``create-data-source`` creates and configures an Amazon Kendra data source connector. You can use ``describe-data-source`` to view the status of a data source connector, and read any error messages if the status shows a data source connector "FAILED" to completely create. ::
+
+    aws kendra create-data-source \
+        --name "example data source 1" \
+        --description "Example data source 1 for example index 1 contains the first set of example documents" \
+        --tags '{"Key": "test resources", "Value": "kendra"}, {"Key": "test resources", "Value": "aws"}' \
+        --role-arn "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource" \
+        --index-id exampleindex1 \
+        --language-code "es" \
+        --schedule "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *" \
+        --configuration '{"TemplateConfiguration": {"Template": file://s3schemaconfig.json}}' \
+        --type "TEMPLATE" \
+        --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE"}' \
+        --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}'
+
+Output::
+
+    {
+        "Id": "exampledatasource1"
+    }
+
 For more information, see `Getting started with an Amazon Kendra index and data source connector <https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html>`__ in the *Amazon Kendra Developer Guide*.

awscli/examples/kendra/describe-data-source.rst

@@ -1,84 +1,84 @@
-**To get information about an Amazon Kendra data source connector**
-
-The following ``describe-data-source`` gets information about an Amazon Kendra data soource connector. You can view the configuration of a data source connector, and read any error messages if the status shows a data source connector "FAILED" to completely create. ::
-
-    aws kendra describe-data-source \
-        --id exampledatasource1 \
-        --index-id exampleindex1
-
-Output::
-
-    {
-        "Configuration": {
-            "TemplateConfiguration": {
-                "Template": {
-                    "connectionConfiguration": {
-                        "repositoryEndpointMetadata": {
-                            "BucketName": "my-bucket"
-                        }
-                    },
-                    "repositoryConfigurations": {
-                        "document":{
-                            "fieldMappings": [
-                                {
-                                    "indexFieldName":"_document_title",
-                                    "indexFieldType":"STRING",
-                                    "dataSourceFieldName": "title"
-                                },
-                                {
-                                    "indexFieldName":"_last_updated_at",
-                                    "indexFieldType":"DATE",
-                                    "dataSourceFieldName": "modified_date"
-                                }
-                            ]
-                        }
-                    },
-                    "additionalProperties": {
-                        "inclusionPatterns": [
-                            "*.txt",
-                            "*.doc",
-                            "*.docx"
-                        ],
-                        "exclusionPatterns": [
-                            "*.json"
-                        ],
-                        "inclusionPrefixes": [
-                            "PublicExampleDocsFolder"
-                        ],
-                        "exclusionPrefixes": [
-                            "PrivateDocsFolder/private"
-                        ],
-                        "aclConfigurationFilePath": "ExampleDocsFolder/AclConfig.json",
-                        "metadataFilesPrefix": "metadata"
-                    },
-                    "syncMode": "FULL_CRAWL",
-                    "type" : "S3",
-                    "version": "1.0.0"
-                }
-            }
-        },
-        "CreatedAt": 2024-02-25T13:30:10+00:00,
-        "CustomDocumentEnrichmentConfiguration": {
-            "PostExtractionHookConfiguration": {
-                "LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs",
-                "S3Bucket": "s3://my-s3-bucket/scanned-image-text-example-docs/function"
-            },
-            "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE"
-        }
-        "Description": "Example data source 1 for example index 1 contains the first set of example documents",
-        "Id": exampledatasource1,
-        "IndexId": exampleindex1,
-        "LanguageCode": "en",
-        "Name": "example data source 1",
-        "RoleArn": "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource",
-        "Schedule": "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *",
-        "Status": "ACTIVE",
-        "Type": "TEMPLATE",
-        "UpdatedAt": 1709163615,
-        "VpcConfiguration": {
-            "SecurityGroupIds": ["sg-1234567890abcdef0"],
-            "SubnetIds": ["subnet-1c234","subnet-2b134"]
-        }
-    }
-
+**To get information about an Amazon Kendra data source connector**
+
+The following ``describe-data-source`` gets information about an Amazon Kendra data soource connector. You can view the configuration of a data source connector, and read any error messages if the status shows a data source connector "FAILED" to completely create. ::
+
+    aws kendra describe-data-source \
+        --id exampledatasource1 \
+        --index-id exampleindex1
+
+Output::
+
+    {
+        "Configuration": {
+            "TemplateConfiguration": {
+                "Template": {
+                    "connectionConfiguration": {
+                        "repositoryEndpointMetadata": {
+                            "BucketName": "my-bucket"
+                        }
+                    },
+                    "repositoryConfigurations": {
+                        "document":{
+                            "fieldMappings": [
+                                {
+                                    "indexFieldName":"_document_title",
+                                    "indexFieldType":"STRING",
+                                    "dataSourceFieldName": "title"
+                                },
+                                {
+                                    "indexFieldName":"_last_updated_at",
+                                    "indexFieldType":"DATE",
+                                    "dataSourceFieldName": "modified_date"
+                                }
+                            ]
+                        }
+                    },
+                    "additionalProperties": {
+                        "inclusionPatterns": [
+                            "*.txt",
+                            "*.doc",
+                            "*.docx"
+                        ],
+                        "exclusionPatterns": [
+                            "*.json"
+                        ],
+                        "inclusionPrefixes": [
+                            "PublicExampleDocsFolder"
+                        ],
+                        "exclusionPrefixes": [
+                            "PrivateDocsFolder/private"
+                        ],
+                        "aclConfigurationFilePath": "ExampleDocsFolder/AclConfig.json",
+                        "metadataFilesPrefix": "metadata"
+                    },
+                    "syncMode": "FULL_CRAWL",
+                    "type" : "S3",
+                    "version": "1.0.0"
+                }
+            }
+        },
+        "CreatedAt": 2024-02-25T13:30:10+00:00,
+        "CustomDocumentEnrichmentConfiguration": {
+            "PostExtractionHookConfiguration": {
+                "LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs",
+                "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs/function"
+            },
+            "RoleArn": "arn:aws:iam:my-account-id:role/KendraRoleForCDE"
+        }
+        "Description": "Example data source 1 for example index 1 contains the first set of example documents",
+        "Id": exampledatasource1,
+        "IndexId": exampleindex1,
+        "LanguageCode": "en",
+        "Name": "example data source 1",
+        "RoleArn": "arn:aws:iam::my-account-id:role/KendraRoleForS3TemplateConfigDataSource",
+        "Schedule": "0 0 18 ? * TUE,MON,WED,THU,FRI,SAT *",
+        "Status": "ACTIVE",
+        "Type": "TEMPLATE",
+        "UpdatedAt": 1709163615,
+        "VpcConfiguration": {
+            "SecurityGroupIds": ["sg-1234567890abcdef0"],
+            "SubnetIds": ["subnet-1c234","subnet-2b134"]
+        }
+    }
+
 For more information, see `Getting started with an Amazon Kendra index and data source connector <https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html>`__ in the *Amazon Kendra Developer Guide*.

awscli/examples/kendra/update-data-source.rst

@@ -1,19 +1,19 @@
-**To update an Amazon Kendra data source connector**
-
-The following ``update-data-source`` updates the configuration of an Amazon Kendra data source connector. If the action is successful, the service either sends back no output, the HTTP status code 200, or the AWS CLI return code 0. You can use ``describe-data-source`` to view the configuration and status of a data source connector. ::
-
-    aws kendra update-data-source \
-        --id exampledatasource1 \
-        --index-id exampleindex1 \
-        --name "new name for example data source 1" \
-        --description "new description for example data source 1" \
-        --role-arn arn:aws:iam::my-account-id:role/KendraNewRoleForExampleDataSource \
-        --configuration '{"TemplateConfiguration": {"Template": file://s3schemanewconfig.json}}' \
-        --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://my-s3-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraNewRoleForCDE"}' \
-        --language-code "es" \
-        --schedule "0 0 18 ? * MON,WED,FRI *" \
-        --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}'
-
-This command produces no output.
-
+**To update an Amazon Kendra data source connector**
+
+The following ``update-data-source`` updates the configuration of an Amazon Kendra data source connector. If the action is successful, the service either sends back no output, the HTTP status code 200, or the AWS CLI return code 0. You can use ``describe-data-source`` to view the configuration and status of a data source connector. ::
+
+    aws kendra update-data-source \
+        --id exampledatasource1 \
+        --index-id exampleindex1 \
+        --name "new name for example data source 1" \
+        --description "new description for example data source 1" \
+        --role-arn arn:aws:iam::my-account-id:role/KendraNewRoleForExampleDataSource \
+        --configuration '{"TemplateConfiguration": {"Template": file://s3schemanewconfig.json}}' \
+        --custom-document-enrichment-configuration '{"PostExtractionHookConfiguration": {"LambdaArn": "arn:aws:iam::my-account-id:function/my-function-ocr-docs", "S3Bucket": "s3://amzn-s3-demo-bucket/scanned-image-text-example-docs"}, "RoleArn": "arn:aws:iam:my-account-id:role/KendraNewRoleForCDE"}' \
+        --language-code "es" \
+        --schedule "0 0 18 ? * MON,WED,FRI *" \
+        --vpc-configuration '{"SecurityGroupIds": ["sg-1234567890abcdef0"], "SubnetIds": ["subnet-1c234","subnet-2b134"]}'
+
+This command produces no output.
+
 For more information, see `Getting started with an Amazon Kendra index and data source connector <https://docs.aws.amazon.com/kendra/latest/dg/getting-started.html>`__ in the *Amazon Kendra Developer Guide*.

awscli/examples/macie2/describe-buckets.rst

@@ -1,9 +1,9 @@
 **To query data about one or more S3 buckets that Amazon Macie monitors and analyzes for your account**
 
-The following ``describe-buckets`` example queries metadata for all S3 buckets whose names begin with MY-S3 and are in the current AWS Region. ::
+The following ``describe-buckets`` example queries metadata for all S3 buckets whose names begin with amzn-s3-demo-bucket and are in the current AWS Region. ::
 
     aws macie2 describe-buckets \
-        --criteria '{"bucketName":{"prefix":"my-S3"}}'
+        --criteria '{"bucketName":{"prefix":"amzn-s3-demo-bucket"}}'
 
 Output::
 
@@ -12,6 +12,7 @@ Output::
             {
                 "accountId": "123456789012",
                 "allowsUnencryptedObjectUploads": "FALSE",
+                "automatedDiscoveryMonitoringStatus": "MONITORED",
                 "bucketArn": "arn:aws:s3:::amzn-s3-demo-bucket1",
                 "bucketCreatedAt": "2020-05-18T19:54:00+00:00",
                 "bucketName": "amzn-s3-demo-bucket1",
@@ -20,11 +21,11 @@ Output::
                 "jobDetails": {
                     "isDefinedInJob": "TRUE",
                     "isMonitoredByJob": "TRUE",
-                    "lastJobId": "08c81dc4a2f3377fae45c9ddaexample",
-                    "lastJobRunTime": "2021-04-26T14:55:30.270000+00:00"
+                    "lastJobId": "08c81dc4a2f3377fae45c9ddaEXAMPLE",
+                    "lastJobRunTime": "2024-08-19T14:55:30.270000+00:00"
                 },
-                "lastAutomatedDiscoveryTime": "2022-12-10T19:11:25.364000+00:00",
-                "lastUpdated": "2022-12-13T07:33:06.337000+00:00",
+                "lastAutomatedDiscoveryTime": "2024-10-22T19:11:25.364000+00:00",
+                "lastUpdated": "2024-10-25T07:33:06.337000+00:00",
                 "objectCount": 13,
                 "objectCountByEncryptionType": {
                     "customerManaged": 0,
@@ -101,6 +102,7 @@ Output::
             {
                 "accountId": "123456789012",
                 "allowsUnencryptedObjectUploads": "TRUE",
+                "automatedDiscoveryMonitoringStatus": "MONITORED",
                 "bucketArn": "arn:aws:s3:::amzn-s3-demo-bucket2",
                 "bucketCreatedAt": "2020-11-25T18:24:38+00:00",
                 "bucketName": "amzn-s3-demo-bucket2",
@@ -109,11 +111,11 @@ Output::
                 "jobDetails": {
                     "isDefinedInJob": "TRUE",
                     "isMonitoredByJob": "FALSE",
-                    "lastJobId": "188d4f6044d621771ef7d65f2example",
-                    "lastJobRunTime": "2021-04-09T19:37:11.511000+00:00"
+                    "lastJobId": "188d4f6044d621771ef7d65f2EXAMPLE",
+                    "lastJobRunTime": "2024-07-09T19:37:11.511000+00:00"
                 },
-                "lastAutomatedDiscoveryTime": "2022-12-12T19:11:25.364000+00:00",
-                "lastUpdated": "2022-12-13T07:33:06.337000+00:00",
+                "lastAutomatedDiscoveryTime": "2024-10-24T19:11:25.364000+00:00",
+                "lastUpdated": "2024-10-25T07:33:06.337000+00:00",
                 "objectCount": 8,
                 "objectCountByEncryptionType": {
                     "customerManaged": 0,
@@ -190,4 +192,4 @@ Output::
         ]
     }
 
-For more information, see `Filtering your S3 bucket inventory <https://docs.aws.amazon.com/macie/latest/user/monitoring-s3-inventory-filter.html>`__ in the *Amazon Macie User Guide*.
+For more information, see `Filtering your S3 bucket inventory <https://docs.aws.amazon.com/macie/latest/user/monitoring-s3-inventory-filter.html>`__ in the *Amazon Macie User Guide*.

awscli/examples/oam/create-link.rst

@@ -0,0 +1,24 @@
+**To create a link**
+
+The following ``create-link`` example creates a link between a source account and a sink that you have created in a monitoring account. ::
+
+    aws oam create-link \
+        --label-template sourceAccount \
+        --resource-types AWS::CloudWatch::Metric \
+        --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
+
+Output::
+
+    {
+        "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
+        "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
+        "Label": "sourceAccount",
+        "LabelTemplate": "sourceAccount",
+        "ResourceTypes": [
+            "AWS::CloudWatch::Metric"
+        ],
+        "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
+        "Tags": {}
+    }
+
+For more information, see `CloudWatch cross-account observability <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/oam/create-sink.rst

@@ -0,0 +1,17 @@
+**To create a sink**
+
+The following ``create-sink`` example creates a sink in the current account, so that it can be used as a monitoring account in CloudWatch cross-account observability. ::
+
+    aws oam create-sink \
+        --name DemoSink
+
+Output::
+
+    {
+        "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
+        "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
+        "Name": "DemoSink",
+        "Tags": {}
+    }
+
+For more information, see `CloudWatch cross-account observability <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/oam/delete-link.rst

@@ -0,0 +1,10 @@
+**To delete a link**
+
+The following ``delete-link`` example deletes a link between a monitoring account sink and a source account. ::
+
+    aws oam delete-link \
+        --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111
+
+This command produces no output.
+
+For more information, see `CloudWatch cross-account observability <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/oam/delete-sink.rst

@@ -0,0 +1,10 @@
+**To delete a sink**
+
+The following ``delete-sink`` example deletes a sink. You must delete all links to a sink before you can delete that sink. ::
+
+    aws oam delete-sink \
+        --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
+
+This command produces no output.
+
+For more information, see `CloudWatch cross-account observability <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/oam/get-link.rst

@@ -0,0 +1,22 @@
+**To return complete information about one link**
+
+The following ``get-link`` example returns complete information about a link. ::
+
+    aws oam get-link \
+        --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111
+
+Output::
+
+    {
+        "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
+        "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
+        "Label": "sourceAccount",
+        "LabelTemplate": "sourceAccount",
+        "ResourceTypes": [
+            "AWS::CloudWatch::Metric"
+        ],
+        "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
+        "Tags": {}
+    }
+
+For more information, see `CloudWatch cross-account observability <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/oam/get-sink-policy.rst

@@ -0,0 +1,16 @@
+**To return the current sink policy attached to the sink**
+
+The following ``get-sink-policy`` example returns the current sink policy attached to the sink. ::
+
+    aws oam get-sink-policy \
+        --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
+
+Output::
+
+    {
+        "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
+        "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345",
+        "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}"
+    }
+
+For more information, see `CloudWatch cross-account observability <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html>`__ in the *Amazon CloudWatch User Guide*.

awscli/examples/oam/get-sink.rst

@@ -0,0 +1,17 @@
+**To return complete information about one monitoring account sink**
+
+The following ``get-sink`` example returns complete information about a monitoring account sink. ::
+
+    aws oam get-sink \
+        --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
+
+Output::
+
+    {
+        "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
+        "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
+        "Name": "DemoSink",
+        "Tags": {}
+    }
+
+For more information, see `CloudWatch cross-account observability <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html>`__ in the *Amazon CloudWatch User Guide*.