AWS cli documentation change
Summary
Updated CLI command parameters for list-subscription-requests, including reordered flags, added status/subscribed-listing-id filters, modified validation patterns, and restructured response documentation with IAM principal ARN support
Security assessment
Added IAM principal ARN validation pattern (arn:aws[^:]*:iam::\d{12}:(role|user)) improves security documentation by enforcing proper IAM resource formatting. However, no direct evidence of addressing a specific vulnerability or security incident is present in the changes.
Diff
diff --git a/cli/latest/reference/datazone/list-subscription-requests.md b/cli/latest/reference/datazone/list-subscription-requests.md index 34eed331b..2c97a6da5 100644 --- a//cli/latest/reference/datazone/list-subscription-requests.md +++ b//cli/latest/reference/datazone/list-subscription-requests.md @@ -15 +15 @@ - * [AWS CLI 2.32.33 Command Reference](../../index.html) » + * [AWS CLI 2.33.1 Command Reference](../../index.html) » @@ -69 +68,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo - [--approver-project-id <value>] @@ -71 +70,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo - [--owning-group-id <value>] + [--status <value>] + [--subscribed-listing-id <value>] @@ -72,0 +73,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo + [--owning-iam-principal-arn <value>] + [--approver-project-id <value>] @@ -73,0 +76 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo + [--owning-group-id <value>] @@ -76,2 +78,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo - [--status <value>] - [--subscribed-listing-id <value>] @@ -105 +106 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--approver-project-id` (string) +`--domain-identifier` (string) [required] @@ -107 +108 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> The identifier of the subscription request approver’s project. +> The identifier of the Amazon DataZone domain. @@ -111 +112 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * pattern: `^[a-zA-Z0-9_-]{1,36}$` +> * pattern: `dzd[-_][a-zA-Z0-9_-]{1,36}` @@ -115 +116 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--domain-identifier` (string) [required] +`--status` (string) @@ -117 +118 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> The identifier of the Amazon DataZone domain. +> Specifies the status of the subscription requests. @@ -119 +120,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> Constraints: +> ### Note +> +> This is not a required parameter, but if not specified, by default, Amazon DataZone returns only `PENDING` subscription requests. @@ -121 +124,5 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * pattern: `^dzd[-_][a-zA-Z0-9_-]{1,36}$` +> Possible values: +> +> * `PENDING` +> * `ACCEPTED` +> * `REJECTED` @@ -125 +132 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--owning-group-id` (string) +`--subscribed-listing-id` (string) @@ -127 +134 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> The ID of the owning group. +> The identifier of the subscribed listing. @@ -131 +138 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * pattern: `^([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$` +> * pattern: `[a-zA-Z0-9_-]{1,36}` @@ -141 +148 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * pattern: `^[a-zA-Z0-9_-]{1,36}$` +> * pattern: `[a-zA-Z0-9_-]{1,36}` @@ -145 +152 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--owning-user-id` (string) +`--owning-iam-principal-arn` (string) @@ -147 +154 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> The ID of the owning user. +> The ARN of the owning IAM principal. @@ -151 +158,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * pattern: `^([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$` +> * min: `1` +> * max: `255` +> * pattern: `arn:aws[^:]*:iam::\d{12}:(role|user)(/[\w+=,.@-]*)*/[\w+=,.@-]+` @@ -155 +164 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--sort-by` (string) +`--approver-project-id` (string) @@ -157 +166 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> Specifies the way to sort the results of this action. +> The identifier of the subscription request approver’s project. @@ -159 +168 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> Possible values: +> Constraints: @@ -161,2 +170 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * `CREATED_AT` -> * `UPDATED_AT` +> * pattern: `[a-zA-Z0-9_-]{1,36}` @@ -166 +174 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--sort-order` (string) +`--owning-user-id` (string) @@ -168 +176 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> Specifies the sort order for the results of this action. +> The ID of the owning user. @@ -170 +178 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> Possible values: +> Constraints: @@ -172,2 +180 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * `ASCENDING` -> * `DESCENDING` +> * pattern: `([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` @@ -177 +184 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--status` (string) +`--owning-group-id` (string) @@ -179 +186 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> Specifies the status of the subscription requests. +> The ID of the owning group. @@ -181 +188 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> ### Note +> Constraints: @@ -183 +190,7 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> This is not a required parameter, but if not specified, by default, Amazon DataZone returns only `PENDING` subscription requests. +> * pattern: `([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` +> + + +`--sort-by` (string) + +> Specifies the way to sort the results of this action. @@ -187,3 +200,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * `PENDING` -> * `ACCEPTED` -> * `REJECTED` +> * `CREATED_AT` +> * `UPDATED_AT` @@ -193 +205 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -`--subscribed-listing-id` (string) +`--sort-order` (string) @@ -195 +207 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> The identifier of the subscribed listing. +> Specifies the sort order for the results of this action. @@ -197 +209 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> Constraints: +> Possible values: @@ -199 +211,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/datazo -> * pattern: `^[a-zA-Z0-9_-]{1,36}$` +> * `ASCENDING` +> * `DESCENDING` @@ -328 +341 @@ items -> (list) ->> createdAt -> (timestamp) [required] +>> id -> (string) [required] @@ -330 +343,7 @@ items -> (list) ->>> The timestamp of when a subscription request was created. +>>> The identifier of the subscription request. +>>> +>>> Constraints: +>>> +>>> * pattern: `[a-zA-Z0-9_-]{1,36}` +>>> + @@ -336 +355 @@ items -> (list) ->> decisionComment -> (string) +>> updatedBy -> (string) @@ -338,8 +357 @@ items -> (list) ->>> The decision comment of the subscription request. ->>> ->>> Constraints: ->>> ->>> * min: `1` ->>> * max: `4096` ->>> - +>>> The identifier of the Amazon DataZone user who updated the subscription request. @@ -353 +365 @@ items -> (list) ->>> * pattern: `^dzd[-_][a-zA-Z0-9_-]{1,36}$` +>>> * pattern: `dzd[-_][a-zA-Z0-9_-]{1,36}` @@ -357 +369 @@ items -> (list) ->> existingSubscriptionId -> (string) +>> status -> (string) [required] @@ -359 +371 @@ items -> (list) ->>> The ID of the existing subscription. +>>> The status of the subscription request. @@ -361 +373 @@ items -> (list) ->>> Constraints: +>>> Possible values: @@ -363 +375,3 @@ items -> (list) ->>> * pattern: `^[a-zA-Z0-9_-]{1,36}$` +>>> * `PENDING` +>>> * `ACCEPTED` +>>> * `REJECTED` @@ -367 +381 @@ items -> (list) ->> id -> (string) [required] +>> createdAt -> (timestamp) [required] @@ -369,7 +383 @@ items -> (list) ->>> The identifier of the subscription request. ->>> ->>> Constraints: ->>> ->>> * pattern: `^[a-zA-Z0-9_-]{1,36}$` ->>> - +>>> The timestamp of when a subscription request was created. @@ -377 +385 @@ items -> (list) ->> metadataFormsSummary -> (list) +>> updatedAt -> (timestamp) [required] @@ -379,40 +387 @@ items -> (list) ->>> The summary of the metadata forms. ->>> ->>> (structure) ->>> ->>>> The summary of the metadata form. ->>>> ->>>> formName -> (string) ->>>>