AWS cli documentation change
Summary
Updated AWS CLI version reference from 2.34.25 to 2.34.28, reordered parameters in syntax sections, removed regex anchors (^ and $) from pattern constraints, restructured response fields including swapping jobID and arn positions, and reorganized participatingServers/participatingResources sections with updated field patterns.
Security assessment
The changes are primarily documentation formatting updates, parameter reordering, and pattern constraint modifications (removing regex anchors). There is no evidence of addressing a specific security vulnerability, incident, or weakness. The changes appear to be routine documentation maintenance and clarification of API response structure without security implications.
Diff
diff --git a/cli/latest/reference/drs/describe-jobs.md b/cli/latest/reference/drs/describe-jobs.md index 7d18707d2..df0e11597 100644 --- a//cli/latest/reference/drs/describe-jobs.md +++ b//cli/latest/reference/drs/describe-jobs.md @@ -15 +15 @@ - * [AWS CLI 2.34.25 Command Reference](../../index.html) » + * [AWS CLI 2.34.28 Command Reference](../../index.html) » @@ -101,12 +100,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 -> -> fromDate -> (string) -> ->> The start date in a date range query. ->> ->> Constraints: ->> ->> * min: `19` ->> * max: `32` ->> * pattern: `^[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z$` ->> - @@ -131 +119 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->>> * pattern: `^drsjob-[0-9a-zA-Z]{17}$` +>>> * pattern: `drsjob-[0-9a-zA-Z]{17}` @@ -133,0 +122,12 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 +> +> fromDate -> (string) +> +>> The start date in a date range query. +>> +>> Constraints: +>> +>> * min: `19` +>> * max: `32` +>> * pattern: `[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z` +>> + @@ -143 +143 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->> * pattern: `^[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z$` +>> * pattern: `[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z` @@ -150 +150 @@ Shorthand Syntax: - fromDate=string,jobIDs=string,string,toDate=string + jobIDs=string,string,fromDate=string,toDate=string @@ -157 +156,0 @@ JSON Syntax: - "fromDate": "string", @@ -158,0 +158 @@ JSON Syntax: + "fromDate": "string", @@ -302 +302 @@ items -> (list) ->> arn -> (string) +>> jobID -> (string) [required] @@ -304 +304 @@ items -> (list) ->>> The ARN of a Job. +>>> The ID of the Job. @@ -308,3 +308,3 @@ items -> (list) ->>> * min: `20` ->>> * max: `2048` ->>> * pattern: `^arn:.{16,2044}$` +>>> * min: `24` +>>> * max: `24` +>>> * pattern: `drsjob-[0-9a-zA-Z]{17}` @@ -314 +314 @@ items -> (list) ->> creationDateTime -> (string) +>> arn -> (string) @@ -316 +316 @@ items -> (list) ->>> The date and time of when the Job was created. +>>> The ARN of a Job. @@ -320,3 +320,3 @@ items -> (list) ->>> * min: `19` ->>> * max: `32` ->>> * pattern: `^[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z$` +>>> * min: `20` +>>> * max: `2048` +>>> * pattern: `arn:.{16,2044}` @@ -326 +326 @@ items -> (list) ->> endDateTime -> (string) +>> type -> (string) @@ -328 +328 @@ items -> (list) ->>> The date and time of when the Job ended. +>>> The type of the Job. @@ -330 +330 @@ items -> (list) ->>> Constraints: +>>> Possible values: @@ -332,3 +332,3 @@ items -> (list) ->>> * min: `19` ->>> * max: `32` ->>> * pattern: `^[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z$` +>>> * `LAUNCH` +>>> * `TERMINATE` +>>> * `CREATE_CONVERTED_SNAPSHOT` @@ -356 +356 @@ items -> (list) ->> jobID -> (string) [required] +>> creationDateTime -> (string) @@ -358 +358 @@ items -> (list) ->>> The ID of the Job. +>>> The date and time of when the Job was created. @@ -362,3 +362,3 @@ items -> (list) ->>> * min: `24` ->>> * max: `24` ->>> * pattern: `^drsjob-[0-9a-zA-Z]{17}$` +>>> * min: `19` +>>> * max: `32` +>>> * pattern: `[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z` @@ -368 +368 @@ items -> (list) ->> participatingResources -> (list) +>> endDateTime -> (string) @@ -370 +370,25 @@ items -> (list) ->>> A list of resources that the Job is acting upon. +>>> The date and time of when the Job ended. +>>> +>>> Constraints: +>>> +>>> * min: `19` +>>> * max: `32` +>>> * pattern: `[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z` +>>> + +>> +>> status -> (string) +>> +>>> The status of the Job. +>>> +>>> Possible values: +>>> +>>> * `PENDING` +>>> * `STARTED` +>>> * `COMPLETED` +>>> + +>> +>> participatingServers -> (list) +>> +>>> A list of servers that the Job is acting upon. @@ -374 +398,25 @@ items -> (list) ->>>> Represents a resource participating in an asynchronous Job. +>>>> Represents a server participating in an asynchronous Job. +>>>> +>>>> sourceServerID -> (string) +>>>> +>>>>> The Source Server ID of a participating server. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `19` +>>>>> * max: `19` +>>>>> * pattern: `s-[0-9a-zA-Z]{17}` +>>>>> + +>>>> +>>>> recoveryInstanceID -> (string) +>>>> +>>>>> The Recovery Instance ID of a participating server. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `10` +>>>>> * max: `19` +>>>>> * pattern: `i-[0-9a-fA-F]{8,}` +>>>>> + @@ -378 +426 @@ items -> (list) ->>>>> The launch status of a participating resource. +>>>>> The launch status of a participating server. @@ -390 +438 @@ items -> (list) ->>>> participatingResourceID -> (tagged union structure) +>>>> launchActionsStatus -> (structure) @@ -392,5 +440 @@ items -> (list) ->>>>> The ID of a participating resource. ->>>>> ->>>>> ### Note ->>>>> ->>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `sourceNetworkID`. +>>>>> The post-launch action runs of a participating server. @@ -398 +442 @@ items -> (list) ->>>>> sourceNetworkID -> (string) +>>>>> ssmAgentDiscoveryDatetime -> (string) @@ -400 +444 @@ items -> (list) ->>>>>> Source Network ID. +>>>>>> Time where the AWS Systems Manager was detected as running on the launched instance. @@ -404,3 +448,3 @@ items -> (list) ->>>>>> * min: `20` ->>>>>> * max: `20` ->>>>>> * pattern: `^sn-[0-9a-zA-Z]{17}$` +>>>>>> * min: `19` +>>>>>> * max: `32` +>>>>>> * pattern: `[1-9][0-9]*-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([0-1][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\.[0-9]+)?Z` @@ -409,12 +452,0 @@ items -> (list) ->> ->> participatingServers -> (list) ->> ->>> A list of servers that the Job is acting upon. ->>> ->>> (structure) ->>> ->>>> Represents a server participating in an asynchronous Job. ->>>> ->>>> launchActionsStatus -> (structure) ->>>> ->>>>> The post-launch action runs of a participating server. @@ -433,12 +464,0 @@ items -> (list) ->>>>>>>> ->>>>>>>> actionCode -> (string)