AWS cli documentation change
Summary
Updated AWS CLI version from 2.34.25 to 2.34.28, restructured parameters and output for the start-recovery command, including reordering of fields, pattern updates (removing ^ and $ from regex patterns), and restructuring of the job object's participatingServers and participatingResources sections.
Security assessment
The changes are primarily structural and pattern updates for the AWS CLI documentation. There is no mention of security vulnerabilities, fixes, or new security features. The existing security-related content (e.g., the SECURITY category in launchActionsStatus) is unchanged in meaning and only moved in position.
Diff
diff --git a/cli/latest/reference/drs/start-recovery.md b/cli/latest/reference/drs/start-recovery.md index 449c2a9bc..292f9c447 100644 --- a//cli/latest/reference/drs/start-recovery.md +++ b//cli/latest/reference/drs/start-recovery.md @@ -15 +15 @@ - * [AWS CLI 2.34.25 Command Reference](../../index.html) » + * [AWS CLI 2.34.28 Command Reference](../../index.html) » @@ -67 +66,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 - [--is-drill | --no-is-drill] @@ -68,0 +68 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 + [--is-drill | --no-is-drill] @@ -95,4 +94,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 -`--is-drill` | `--no-is-drill` (boolean) - -> Whether this Source Server Recovery operation is a drill or not. - @@ -114 +110 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->> recoverySnapshotID -> (string) +>> sourceServerID -> (string) [required] @@ -116 +112 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->>> The ID of a Recovery Snapshot we want to recover from. Omit this field to launch from the latest data by taking an on-demand snapshot. +>>> The ID of the Source Server you want to recover. @@ -120,3 +116,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->>> * min: `21` ->>> * max: `21` ->>> * pattern: `^pit-[0-9a-zA-Z]{17}$` +>>> * min: `19` +>>> * max: `19` +>>> * pattern: `s-[0-9a-zA-Z]{17}` @@ -126 +122 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->> sourceServerID -> (string) [required] +>> recoverySnapshotID -> (string) @@ -128 +124 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->>> The ID of the Source Server you want to recover. +>>> The ID of a Recovery Snapshot we want to recover from. Omit this field to launch from the latest data by taking an on-demand snapshot. @@ -132,3 +128,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/drs-20 ->>> * min: `19` ->>> * max: `19` ->>> * pattern: `^s-[0-9a-zA-Z]{17}$` +>>> * min: `21` +>>> * max: `21` +>>> * pattern: `pit-[0-9a-zA-Z]{17}` @@ -141 +137 @@ Shorthand Syntax: - recoverySnapshotID=string,sourceServerID=string ... + sourceServerID=string,recoverySnapshotID=string ... @@ -149,2 +145,2 @@ JSON Syntax: - "recoverySnapshotID": "string", - "sourceServerID": "string" + "sourceServerID": "string", + "recoverySnapshotID": "string" @@ -155,0 +152,4 @@ JSON Syntax: +`--is-drill` | `--no-is-drill` (boolean) + +> Whether this Source Server Recovery operation is a drill or not. + @@ -308 +308 @@ job -> (structure) -> arn -> (string) +> jobID -> (string) [required] @@ -310 +310 @@ job -> (structure) ->> The ARN of a Job. +>> The ID of the Job. @@ -314,3 +314,3 @@ job -> (structure) ->> * min: `20` ->> * max: `2048` ->> * pattern: `^arn:.{16,2044}$` +>> * min: `24` +>> * max: `24` +>> * pattern: `drsjob-[0-9a-zA-Z]{17}` @@ -320 +320 @@ job -> (structure) -> creationDateTime -> (string) +> arn -> (string) @@ -322 +322 @@ job -> (structure) ->> The date and time of when the Job was created. +>> The ARN of a Job. @@ -326,3 +326,3 @@ job -> (structure) ->> * 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}` @@ -332 +332 @@ job -> (structure) -> endDateTime -> (string) +> type -> (string) @@ -334 +334 @@ job -> (structure) ->> The date and time of when the Job ended. +>> The type of the Job. @@ -336 +336 @@ job -> (structure) ->> Constraints: +>> Possible values: @@ -338,3 +338,3 @@ job -> (structure) ->> * 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` @@ -362 +362 @@ job -> (structure) -> jobID -> (string) [required] +> creationDateTime -> (string) @@ -364 +364 @@ job -> (structure) ->> The ID of the Job. +>> The date and time of when the Job was created. @@ -368,3 +368,3 @@ job -> (structure) ->> * 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` @@ -374 +374 @@ job -> (structure) -> participatingResources -> (list) +> endDateTime -> (string) @@ -376 +376,25 @@ job -> (structure) ->> 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. @@ -380 +404,25 @@ job -> (structure) ->>> 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,}` +>>>> + @@ -384 +432 @@ job -> (structure) ->>>> The launch status of a participating resource. +>>>> The launch status of a participating server. @@ -396 +444 @@ job -> (structure) ->>> participatingResourceID -> (tagged union structure) +>>> launchActionsStatus -> (structure) @@ -398,5 +446 @@ job -> (structure) ->>>> 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. @@ -404 +448 @@ job -> (structure) ->>>> sourceNetworkID -> (string) +>>>> ssmAgentDiscoveryDatetime -> (string) @@ -406 +450 @@ job -> (structure) ->>>>> Source Network ID. +>>>>> Time where the AWS Systems Manager was detected as running on the launched instance. @@ -410,3 +454,3 @@ job -> (structure) ->>>>> * 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` @@ -415,12 +458,0 @@ job -> (structure) -> -> participatingServers -> (list) -> ->> A list of servers that the Job is acting upon. ->> ->> (structure)