AWS cli documentation change
Summary
Updated AWS CLI version references from 2.35.19 to 2.35.21 and added new 'Examples' section demonstrating describe-extension-pack-associations command with privilege error case
Security assessment
The change adds an example showing a security-related error condition ('insufficient privileges'), documenting permission requirements for extension packs. No evidence of fixing a specific vulnerability.
Diff
diff --git a/cli/latest/reference/dms/describe-extension-pack-associations.md b/cli/latest/reference/dms/describe-extension-pack-associations.md index 34d40522e..5a4d34be0 100644 --- a//cli/latest/reference/dms/describe-extension-pack-associations.md +++ b//cli/latest/reference/dms/describe-extension-pack-associations.md @@ -15 +15 @@ - * [AWS CLI 2.35.19 Command Reference](../../index.html) » + * [AWS CLI 2.35.21 Command Reference](../../index.html) » @@ -35,0 +36 @@ + * Examples @@ -262,0 +264,53 @@ The formatting style for error output. By default, errors are displayed in enhan +## Examples¶ + +### Note + +To use the following examples, you must have the AWS CLI installed and configured. See the [Getting started guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) in the _AWS CLI User Guide_ for more information. + +Unless otherwise stated, all examples have unix-like quotation rules. These examples will need to be adapted to your terminal’s quoting rules. See [Using quotation marks with strings](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) in the _AWS CLI User Guide_ . + +**To describe extension pack associations** + +The following `describe-extension-pack-associations` example retrieves the status of operations that apply an extension pack to the target database, identified by their request IDs. + + + aws dms describe-extension-pack-associations \ + --migration-project-identifier arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS \ + --filters Name=request-id,Values=a1b2c3d4-5678-90ab-cdef-EXAMPLE11111,a1b2c3d4-5678-90ab-cdef-EXAMPLE22222,a1b2c3d4-5678-90ab-cdef-EXAMPLE33333 + + +Output: + + + { + "Requests": [ + { + "Status": "SUCCESS", + "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", + "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" + }, + { + "Status": "IN_PROGRESS", + "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", + "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", + "Progress": { + "ProgressPercent": 50.0, + "ProgressStep": "IN_PROGRESS" + } + }, + { + "Status": "FAILED", + "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", + "MigrationProjectArn": "arn:aws:dms:us-east-1:123456789012:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS", + "Error": { + "defaultErrorDetails": { + "Message": "The database user in your target secret does not have sufficient privileges. Grant the required privileges and try again." + } + } + } + ] + } + + +For more information, see [Using extension packs](https://docs.aws.amazon.com/dms/latest/userguide/extension-pack.html) in the _AWS Database Migration Service User Guide_. + @@ -371 +425 @@ Requests -> (list) - * [AWS CLI 2.35.19 Command Reference](../../index.html) » + * [AWS CLI 2.35.21 Command Reference](../../index.html) »