{ "smithy": "2.0", "shapes": { "com.amazonaws.arcregionswitch#AbbreviatedExecution": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "
The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
", "smithy.api#required": {} } }, "version": { "target": "smithy.api#String", "traits": { "aws.cloudformation#cfnMutability": "read", "smithy.api#documentation": "The version for the plan.
" } }, "updatedAt": { "target": "smithy.api#Timestamp", "traits": { "aws.cloudformation#cfnExcludeProperty": {}, "smithy.api#documentation": "The timestamp when the plan execution was last updated.
" } }, "comment": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "An optional comment about the plan execution.
" } }, "startTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when the plan execution was started.
", "smithy.api#required": {} } }, "endTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when the plan execution was ended.
" } }, "mode": { "target": "com.amazonaws.arcregionswitch#ExecutionMode", "traits": { "smithy.api#documentation": "The plan execution mode. Valid values are graceful, for graceful executions, or ungraceful, for ungraceful executions.
The plan execution state. Provides the state of a plan execution, for example, In Progress or Paused by Operator.
", "smithy.api#required": {} } }, "executionAction": { "target": "com.amazonaws.arcregionswitch#ExecutionAction", "traits": { "smithy.api#documentation": "The plan execution action. Valid values are activate, to activate an Amazon Web Services Region, or deactivate, to deactivate a Region.
The Amazon Web Services Region for a plan execution.
", "smithy.api#required": {} } }, "recoveryExecutionId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The unique identifier of the most recent recovery execution. Required when starting a post-recovery execution.
" } }, "actualRecoveryTime": { "target": "com.amazonaws.arcregionswitch#Duration", "traits": { "smithy.api#documentation": "The actual recovery time that Region switch calculates for a plan execution. Actual recovery time includes the time for the plan to run added to the time elapsed until the application health alarms that you've specified are healthy again.
" } } }, "traits": { "smithy.api#documentation": "A summarized representation of a plan execution. This structure contains key information about an execution without all the detailed step data.
" } }, "com.amazonaws.arcregionswitch#AbbreviatedExecutionsList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#AbbreviatedExecution" } }, "com.amazonaws.arcregionswitch#AbbreviatedPlan": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Region switch plan.
", "smithy.api#required": {} } }, "owner": { "target": "com.amazonaws.arcregionswitch#AccountId", "traits": { "aws.cloudformation#cfnMutability": "read", "smithy.api#documentation": "The owner of a Region switch plan.
", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.arcregionswitch#PlanName", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The name of a Region switch plan.
", "smithy.api#required": {} } }, "regions": { "target": "com.amazonaws.arcregionswitch#RegionList", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The Amazon Web Services Region specified for a Region switch plan.
", "smithy.api#required": {} } }, "recoveryApproach": { "target": "com.amazonaws.arcregionswitch#RecoveryApproach", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The recovery approach for a Region switch plan, which can be active/active (activeActive) or active/passive (activePassive).
", "smithy.api#required": {} } }, "primaryRegion": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The primary Region for a plan.
" } }, "version": { "target": "smithy.api#String", "traits": { "aws.cloudformation#cfnMutability": "read", "smithy.api#documentation": "The version for the plan.
" } }, "updatedAt": { "target": "smithy.api#Timestamp", "traits": { "aws.cloudformation#cfnExcludeProperty": {}, "smithy.api#documentation": "The timestamp when the plan execution was last updated.
" } }, "description": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The description of a Region switch plan.
" } }, "executionRole": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The execution role is a way to categorize a Region switch plan.
" } }, "activePlanExecution": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "Specifies if this is the active plan execution at this time.
" } }, "recoveryTimeObjectiveMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The recovery time objective that you've specified.
", "smithy.api#range": { "min": 1, "max": 10080 } } } }, "traits": { "smithy.api#documentation": "A summarized representation of a Region switch plan. This structure contains key information about a plan without all the detailed workflow and step data.
" } }, "com.amazonaws.arcregionswitch#AccessDeniedException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "You do not have sufficient access to perform this action.
HTTP Status Code: 403
", "smithy.api#error": "client", "smithy.api#httpError": 403 } }, "com.amazonaws.arcregionswitch#AccountId": { "type": "string", "traits": { "smithy.api#pattern": "^\\d{12}$" } }, "com.amazonaws.arcregionswitch#AlarmCondition": { "type": "enum", "members": { "RED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "red" } }, "GREEN": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "green" } } } }, "com.amazonaws.arcregionswitch#AlarmType": { "type": "enum", "members": { "APPLICATION_HEALTH": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "applicationHealth" } }, "TRIGGER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "trigger" } } } }, "com.amazonaws.arcregionswitch#Approval": { "type": "enum", "members": { "APPROVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "approve" } }, "DECLINE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "decline" } } } }, "com.amazonaws.arcregionswitch#ApprovePlanExecutionStep": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#ApprovePlanExecutionStepRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#ApprovePlanExecutionStepResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to approve a plan execution step" }, "smithy.api#documentation": "Approves a step in a plan execution that requires manual approval. When you create a plan, you can include approval steps that require manual intervention before the execution can proceed. This operation allows you to provide that approval.
You must specify the plan ARN, execution ID, step name, and approval status. You can also provide an optional comment explaining the approval decision.
" } }, "com.amazonaws.arcregionswitch#ApprovePlanExecutionStepRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
", "smithy.api#required": {} } }, "stepName": { "target": "com.amazonaws.arcregionswitch#StepName", "traits": { "smithy.api#documentation": "The name of a step in a plan execution.
", "smithy.api#required": {} } }, "approval": { "target": "com.amazonaws.arcregionswitch#Approval", "traits": { "smithy.api#documentation": "The status of approval for a plan execution step.
", "smithy.api#required": {} } }, "comment": { "target": "com.amazonaws.arcregionswitch#ExecutionComment", "traits": { "smithy.api#documentation": "A comment that you can enter about a plan execution.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#ApprovePlanExecutionStepResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#ArcRegionSwitch": { "type": "service", "version": "2022-07-26", "operations": [ { "target": "com.amazonaws.arcregionswitch#ApprovePlanExecutionStep" }, { "target": "com.amazonaws.arcregionswitch#CancelPlanExecution" }, { "target": "com.amazonaws.arcregionswitch#GetPlanEvaluationStatus" }, { "target": "com.amazonaws.arcregionswitch#GetPlanExecution" }, { "target": "com.amazonaws.arcregionswitch#GetPlanInRegion" }, { "target": "com.amazonaws.arcregionswitch#ListPlanExecutionEvents" }, { "target": "com.amazonaws.arcregionswitch#ListPlanExecutions" }, { "target": "com.amazonaws.arcregionswitch#ListPlansInRegion" }, { "target": "com.amazonaws.arcregionswitch#ListRoute53HealthChecks" }, { "target": "com.amazonaws.arcregionswitch#ListRoute53HealthChecksInRegion" }, { "target": "com.amazonaws.arcregionswitch#ListServiceQuotaWarnings" }, { "target": "com.amazonaws.arcregionswitch#StartPlanExecution" }, { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecution" }, { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecutionStep" } ], "resources": [ { "target": "com.amazonaws.arcregionswitch#RegionSwitchPlan" } ], "traits": { "aws.api#service": { "sdkId": "ARC Region switch", "endpointPrefix": "arc-region-switch", "arnNamespace": "arc-region-switch", "cloudFormationName": "ARCRegionSwitch" }, "aws.auth#sigv4": { "name": "arc-region-switch" }, "aws.endpoints#dualStackOnlyEndpoints": {}, "aws.endpoints#rulesBasedEndpoints": {}, "aws.endpoints#standardRegionalEndpoints": {}, "aws.iam#defineConditionKeys": { "aws:ResourceTag/${TagKey}": { "type": "String", "documentation": "Filters access by a tag's key and value in a request", "externalDocumentation": "${DocHomeURL}IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag" }, "aws:RequestTag/${TagKey}": { "type": "String", "documentation": "Filters access by tag key-value pairs attached to the resource", "externalDocumentation": "${DocHomeURL}IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requesttag" }, "aws:TagKeys": { "type": "ArrayOfString", "documentation": "Filters access by the presence of tag keys in the request", "externalDocumentation": "${DocHomeURL}IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-tagkeys" } }, "aws.iam#supportedPrincipalTypes": [ "Root", "IAMUser", "IAMRole", "FederatedUser" ], "aws.protocols#awsJson1_0": {}, "smithy.api#documentation": "Amazon Application Recovery Controller (ARC) Region switch helps you to quickly and reliably shift traffic away from an impaired Amazon Web Services Region to a healthy Region. With Region switch, you can create plans that define the steps to shift traffic for your application from one Amazon Web Services Region to another.
Region switch provides a structured approach to multi-Region failover, helping you to meet your recovery time objectives (RTOs) and maintain business continuity during regional disruptions.
For more information, see Region switch in ARC in the Amazon Application Recovery Controller User Guide.
", "smithy.api#title": "ARC - Region switch", "smithy.protocols#rpcv2Cbor": {}, "smithy.rules#endpointBdd": { "version": "1.1", "parameters": { "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" }, "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseControlPlaneEndpoint": { "required": false, "documentation": "Whether the operation is a control plane operation. Control plane operations are routed to a centralized endpoint in the partition leader.", "type": "boolean" } }, "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] }, { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" }, { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] }, { "fn": "booleanEquals", "argv": [ { "fn": "coalesce", "argv": [ { "ref": "UseControlPlaneEndpoint" }, false ] }, true ] }, { "fn": "stringEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "name" ] }, "aws-cn" ] } ], "results": [ { "conditions": [], "endpoint": { "url": "https://arc-region-switch-control-plane.cn-north-1.{PartitionResult#dualStackDnsSuffix}", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "arc-region-switch", "signingRegion": "cn-north-1" } ] }, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "Invalid Configuration: FIPS is not supported in this partition", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://arc-region-switch-control-plane-fips.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dualStackDnsSuffix}", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "arc-region-switch", "signingRegion": "{PartitionResult#implicitGlobalRegion}" } ] }, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://arc-region-switch-control-plane.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dualStackDnsSuffix}", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "arc-region-switch", "signingRegion": "{PartitionResult#implicitGlobalRegion}" } ] }, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://arc-region-switch-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://arc-region-switch.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ], "root": 2, "nodeCount": 10, "nodes": "/////wAAAAH/////AAAAAAAAAAoAAAADAAAAAQAAAAQF9eEJAAAAAgAAAAUF9eEJAAAAAwAAAAgAAAAGAAAABAAAAAcF9eEIAAAABQX14QEF9eEEAAAABAAAAAkF9eEHAAAABQX14QIF9eEDAAAAAwX14QUF9eEG" }, "smithy.rules#endpointRuleSet": { "version": "1.0", "parameters": { "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" }, "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseControlPlaneEndpoint": { "required": false, "documentation": "Whether the operation is a control plane operation. Control plane operations are routed to a centralized endpoint in the partition leader.", "type": "boolean" } }, "rules": [ { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "UseControlPlaneEndpoint" } ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseControlPlaneEndpoint" }, true ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] }, { "fn": "not", "argv": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ] }, { "fn": "not", "argv": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ] }, { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" }, { "fn": "stringEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "name" ] }, "aws-cn" ] } ], "rules": [ { "conditions": [], "endpoint": { "url": "https://arc-region-switch-control-plane.cn-north-1.{PartitionResult#dualStackDnsSuffix}", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "arc-region-switch", "signingRegion": "cn-north-1" } ] }, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [ { "fn": "not", "argv": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ] }, { "fn": "isSet", "argv": [ { "ref": "UseControlPlaneEndpoint" } ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseControlPlaneEndpoint" }, true ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] }, { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" } ], "rules": [ { "conditions": [ { "fn": "stringEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "name" ] }, "aws-cn" ] } ], "error": "Invalid Configuration: FIPS is not supported in this partition", "type": "error" }, { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://arc-region-switch-control-plane-fips.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dualStackDnsSuffix}", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "arc-region-switch", "signingRegion": "{PartitionResult#implicitGlobalRegion}" } ] }, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "UseControlPlaneEndpoint" } ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseControlPlaneEndpoint" }, true ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] }, { "fn": "not", "argv": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ] }, { "fn": "not", "argv": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ] }, { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" } ], "rules": [ { "conditions": [], "endpoint": { "url": "https://arc-region-switch-control-plane.{PartitionResult#implicitGlobalRegion}.{PartitionResult#dualStackDnsSuffix}", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "arc-region-switch", "signingRegion": "{PartitionResult#implicitGlobalRegion}" } ] }, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [], "rules": [ { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Region" } ] } ], "rules": [ { "conditions": [ { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "endpoint": { "url": "https://arc-region-switch-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://arc-region-switch.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ], "type": "tree" } ] }, "smithy.rules#endpointTests": { "testCases": [ { "documentation": "For custom endpoint with region not set and fips disabled", "expect": { "endpoint": { "url": "https://example.com" } }, "params": { "Endpoint": "https://example.com", "UseFIPS": false } }, { "documentation": "For custom endpoint with fips enabled", "expect": { "error": "Invalid Configuration: FIPS and custom endpoint are not supported" }, "params": { "Endpoint": "https://example.com", "UseFIPS": true } }, { "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://arc-region-switch-fips.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": true } }, { "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://arc-region-switch.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": false } }, { "documentation": "For region cn-northwest-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://arc-region-switch-fips.cn-northwest-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-northwest-1", "UseFIPS": true } }, { "documentation": "For region cn-northwest-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://arc-region-switch.cn-northwest-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-northwest-1", "UseFIPS": false } }, { "documentation": "For region us-gov-west-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://arc-region-switch-fips.us-gov-west-1.api.aws" } }, "params": { "Region": "us-gov-west-1", "UseFIPS": true } }, { "documentation": "For region us-gov-west-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://arc-region-switch.us-gov-west-1.api.aws" } }, "params": { "Region": "us-gov-west-1", "UseFIPS": false } }, { "documentation": "Missing region", "expect": { "error": "Invalid Configuration: Missing Region" } }, { "documentation": "Control plane operation with DualStack in us-west-2 routes to us-east-1 DualStack endpoint", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "us-east-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane.us-east-1.api.aws" } }, "params": { "Region": "us-west-2", "UseControlPlaneEndpoint": true } }, { "documentation": "Control plane operation with endpoint set in us-east-1 routes to provided endpoint", "expect": { "endpoint": { "url": "https://amazonaws.com" } }, "params": { "Region": "us-east-1", "UseControlPlaneEndpoint": true, "Endpoint": "https://amazonaws.com" } }, { "documentation": "Control plane operation with endpoint set in us-west-2 routes to provided endpoint", "expect": { "endpoint": { "url": "https://amazonaws.com" } }, "params": { "Region": "us-west-2", "UseControlPlaneEndpoint": true, "Endpoint": "https://amazonaws.com" } }, { "documentation": "Control plane operation in us-west-2 (standard partition) routes to us-east-1", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "us-east-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane.us-east-1.api.aws" } }, "params": { "Region": "us-west-2", "UseControlPlaneEndpoint": true } }, { "documentation": "Control plane operation in cn-north-1 (China partition) routes to cn-north-1 with China DNS suffix", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "cn-north-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-north-1", "UseControlPlaneEndpoint": true } }, { "documentation": "Control plane operation in cn-northwest-1 (China partition) routes to cn-north-1 with China DNS suffix", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "cn-north-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-northwest-1", "UseControlPlaneEndpoint": true } }, { "documentation": "Control plane operation in us-gov-west-1 (GovCloud partition) routes to us-gov-west-1 with GovCloud DNS suffix", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "us-gov-west-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane.us-gov-west-1.api.aws" } }, "params": { "Region": "us-gov-west-1", "UseControlPlaneEndpoint": true } }, { "documentation": "Control plane operation in us-gov-east-1 (GovCloud partition) routes to us-gov-west-1 with GovCloud DNS suffix", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "us-gov-west-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane.us-gov-west-1.api.aws" } }, "params": { "Region": "us-gov-east-1", "UseControlPlaneEndpoint": true } }, { "documentation": "Control plane operation with FIPS in us-west-2 routes to us-east-1 FIPS endpoint", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "us-east-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane-fips.us-east-1.api.aws" } }, "params": { "Region": "us-west-2", "UseControlPlaneEndpoint": true, "UseFIPS": true } }, { "documentation": "Control plane operation with FIPS in us-east-1 routes to us-east-1 FIPS endpoint", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingRegion": "us-east-1", "signingName": "arc-region-switch" } ] }, "url": "https://arc-region-switch-control-plane-fips.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseControlPlaneEndpoint": true, "UseFIPS": true } }, { "documentation": "Control plane operation with FIPS in CN returns an error", "expect": { "error": "Invalid Configuration: FIPS is not supported in this partition" }, "params": { "Region": "cn-north-1", "UseControlPlaneEndpoint": true, "UseFIPS": true } }, { "documentation": "Control plane operation with endpoint set using FIPS in us-east-1 errors", "expect": { "error": "Invalid Configuration: FIPS and custom endpoint are not supported" }, "params": { "Region": "us-east-1", "UseControlPlaneEndpoint": true, "UseFIPS": true, "Endpoint": "https://amazonaws.com" } }, { "documentation": "Control plane operation with endpoint set using FIPS in us-west-2 routes to provided endpoint", "expect": { "error": "Invalid Configuration: FIPS and custom endpoint are not supported" }, "params": { "Region": "us-west-2", "UseControlPlaneEndpoint": true, "UseFIPS": true, "Endpoint": "https://amazonaws.com" } } ], "version": "1.0" } } }, "com.amazonaws.arcregionswitch#ArcRoutingControlConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "regionAndRoutingControls": { "target": "com.amazonaws.arcregionswitch#RegionAndRoutingControls", "traits": { "smithy.api#documentation": "The Region and ARC routing controls for the configuration.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for ARC routing controls used in a Region switch plan. Routing controls are simple on/off switches that you can use to shift traffic away from an impaired Region.
" } }, "com.amazonaws.arcregionswitch#ArcRoutingControlState": { "type": "structure", "members": { "routingControlArn": { "target": "com.amazonaws.arcregionswitch#RoutingControlArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of a routing control.
", "smithy.api#required": {} } }, "state": { "target": "com.amazonaws.arcregionswitch#RoutingControlStateChange", "traits": { "smithy.api#documentation": "The state of an ARC routing control, On or Off.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Represents the state of an ARC routing control.
" } }, "com.amazonaws.arcregionswitch#ArcRoutingControlStates": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#ArcRoutingControlState" } }, "com.amazonaws.arcregionswitch#Asg": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "arn": { "target": "com.amazonaws.arcregionswitch#AsgArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the EC2 Auto Scaling group.
" } } }, "traits": { "smithy.api#documentation": "Configuration for an Amazon EC2 Auto Scaling group used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#AsgArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:autoscaling:[a-z0-9-]+:\\d{12}:autoScalingGroup:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:autoScalingGroupName/[\\S\\s]{1,255}$" } }, "com.amazonaws.arcregionswitch#AsgList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Asg" }, "traits": { "smithy.api#length": { "min": 2, "max": 2 } } }, "com.amazonaws.arcregionswitch#AssociatedAlarm": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "resourceIdentifier": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The resource identifier for alarms that you associate with a plan.
", "smithy.api#required": {} } }, "alarmType": { "target": "com.amazonaws.arcregionswitch#AlarmType", "traits": { "smithy.api#documentation": "The alarm type for an associated alarm. An associated CloudWatch alarm can be an application health alarm or a trigger alarm.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "An Amazon CloudWatch alarm associated with a Region switch plan. These alarms can be used to trigger automatic execution of the plan.
" } }, "com.amazonaws.arcregionswitch#AssociatedAlarmMap": { "type": "map", "key": { "target": "smithy.api#String" }, "value": { "target": "com.amazonaws.arcregionswitch#AssociatedAlarm" } }, "com.amazonaws.arcregionswitch#AuroraClusterArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:rds:[a-z0-9-]+:\\d{12}:cluster:[A-Za-z][0-9A-Za-z-:._]*$" } }, "com.amazonaws.arcregionswitch#AuroraClusterArns": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#AuroraClusterArn" } }, "com.amazonaws.arcregionswitch#AuroraInstanceArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:rds:[a-z0-9-]+:\\d{12}:db:[A-Za-z][0-9A-Za-z-]{0,62}$" } }, "com.amazonaws.arcregionswitch#AuroraProvisionedScalingConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "globalClusterIdentifier": { "target": "com.amazonaws.arcregionswitch#GlobalClusterIdentifier", "traits": { "smithy.api#documentation": "The global cluster identifier for a global database.
", "smithy.api#required": {} } }, "regionDatabaseClusterArns": { "target": "com.amazonaws.arcregionswitch#RegionAuroraClusterMap", "traits": { "smithy.api#documentation": "Per-Region configuration that maps each Region to the Aurora database cluster ARN for scaling.
", "smithy.api#required": {} } }, "instanceArns": { "target": "com.amazonaws.arcregionswitch#RegionAuroraInstanceArnMap", "traits": { "smithy.api#documentation": "Per-Region configuration that maps each Region to the Aurora database instance ARN for scaling.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon Aurora provisioned cluster scaling used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#AuroraServerlessScalingConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "globalClusterIdentifier": { "target": "com.amazonaws.arcregionswitch#GlobalClusterIdentifier", "traits": { "smithy.api#documentation": "The global cluster identifier for a global database.
", "smithy.api#required": {} } }, "regionDatabaseClusterArns": { "target": "com.amazonaws.arcregionswitch#RegionAuroraClusterMap", "traits": { "smithy.api#documentation": "Per-Region configuration that maps each Region to the Aurora database cluster ARN for scaling.
", "smithy.api#required": {} } }, "targetPercent": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 100, "smithy.api#documentation": "The target capacity percentage for Aurora Serverless scaling.
" } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon Aurora Serverless scaling used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#CancelPlanExecution": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#CancelPlanExecutionRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#CancelPlanExecutionResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to cancel a plan execution" }, "smithy.api#documentation": "Cancels an in-progress plan execution. This operation stops the execution of the plan and prevents any further steps from being processed.
You must specify the plan ARN and execution ID. You can also provide an optional comment explaining why the execution was canceled.
" } }, "com.amazonaws.arcregionswitch#CancelPlanExecutionRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
", "smithy.api#required": {} } }, "comment": { "target": "com.amazonaws.arcregionswitch#ExecutionComment", "traits": { "smithy.api#documentation": "A comment that you can enter about canceling a plan execution step.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#CancelPlanExecutionResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#ConflictException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "resourceId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The identifier of the resource involved in the client token conflict.
" } }, "resourceType": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The type of the resource involved in the client token conflict.
" } } }, "traits": { "smithy.api#documentation": "The client token was already used with different request parameters. A client token must map to the same parameters for every request. To retry this operation, provide a new client token.
", "smithy.api#error": "client", "smithy.api#httpError": 409 } }, "com.amazonaws.arcregionswitch#CreatePlan": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#CreatePlanRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#CreatePlanResponse" }, "traits": { "aws.iam#conditionKeys": [ "aws:TagKeys", "aws:RequestTag/${TagKey}" ], "aws.iam#iamAction": { "documentation": "Grants permission to create a plan" }, "smithy.api#documentation": "Creates a new Region switch plan. A plan defines the steps required to shift traffic from one Amazon Web Services Region to another.
You must specify a name for the plan, the primary Region, and at least one additional Region. You can also provide a description, execution role, recovery time objective, associated alarms, triggers, and workflows that define the steps to execute during a Region switch.
", "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#CreatePlanRequest": { "type": "structure", "members": { "description": { "target": "smithy.api#String", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The description of a Region switch plan.
" } }, "workflows": { "target": "com.amazonaws.arcregionswitch#WorkflowList", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "An array of workflows included in a Region switch plan.
", "smithy.api#required": {} } }, "executionRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "An execution role is a way to categorize a Region switch plan.
", "smithy.api#required": {} } }, "recoveryTimeObjectiveMinutes": { "target": "smithy.api#Integer", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "Optionally, you can specify an recovery time objective for a Region switch plan, in minutes.
", "smithy.api#range": { "min": 1, "max": 10080 } } }, "associatedAlarms": { "target": "com.amazonaws.arcregionswitch#AssociatedAlarmMap", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The alarms associated with a Region switch plan.
" } }, "triggers": { "target": "com.amazonaws.arcregionswitch#TriggerList", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The triggers associated with a Region switch plan.
" } }, "reportConfiguration": { "target": "com.amazonaws.arcregionswitch#ReportConfiguration", "traits": { "aws.cloudformation#cfnMutability": "full" } }, "serviceQuotaChecksEnabled": { "target": "smithy.api#Boolean", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "Specifies whether to enable service quota checks for the Region switch plan.
" } }, "name": { "target": "com.amazonaws.arcregionswitch#PlanName", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The name of a Region switch plan.
", "smithy.api#required": {} } }, "regions": { "target": "com.amazonaws.arcregionswitch#RegionList", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "An array that specifies the Amazon Web Services Regions for a Region switch plan. Specify two Regions.
", "smithy.api#required": {} } }, "recoveryApproach": { "target": "com.amazonaws.arcregionswitch#RecoveryApproach", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The recovery approach for a Region switch plan, which can be active/active (activeActive) or active/passive (activePassive).
", "smithy.api#required": {} } }, "primaryRegion": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The primary Amazon Web Services Region for the application. This is the Region where the application normally runs before any Region switch occurs.
" } }, "tags": { "target": "com.amazonaws.arcregionswitch#Tags", "traits": { "smithy.api#documentation": "The tags to apply to the Region switch plan.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#CreatePlanResponse": { "type": "structure", "members": { "plan": { "target": "com.amazonaws.arcregionswitch#Plan", "traits": { "smithy.api#documentation": "The details of the created Region switch plan.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#CustomActionLambdaConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "lambdas": { "target": "com.amazonaws.arcregionswitch#LambdaList", "traits": { "smithy.api#documentation": "The Amazon Web Services Lambda functions for the execution block.
", "smithy.api#required": {} } }, "retryIntervalMinutes": { "target": "smithy.api#Float", "traits": { "smithy.api#documentation": "The retry interval specified.
", "smithy.api#required": {} } }, "regionToRun": { "target": "com.amazonaws.arcregionswitch#RegionToRunIn", "traits": { "smithy.api#documentation": "The Amazon Web Services Region for the function to run in. For recovery workflows use activatingRegion or deactivatingRegion. For post-recovery workflows, use activeRegion (the Region with customer traffic) or inactiveRegion (the Region with no customer traffic).
The settings for ungraceful execution.
" } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon Web Services Lambda functions that perform custom actions during a Region switch.
" } }, "com.amazonaws.arcregionswitch#DeletePlan": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#DeletePlanRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#DeletePlanResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#IllegalStateException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to delete a plan" }, "smithy.api#documentation": "Deletes a Region switch plan. You must specify the ARN of the plan to delete.
You cannot delete a plan that has an active execution in progress.
", "smithy.api#idempotent": {}, "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#DeletePlanRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#DeletePlanResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#DocumentDbClusterArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:rds:[a-z0-9-]+:\\d{12}:cluster:[a-zA-Z0-9][a-zA-Z0-9-_]{0,99}$" } }, "com.amazonaws.arcregionswitch#DocumentDbClusterArns": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#DocumentDbClusterArn" } }, "com.amazonaws.arcregionswitch#DocumentDbConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "behavior": { "target": "com.amazonaws.arcregionswitch#DocumentDbDefaultBehavior", "traits": { "smithy.api#default": "switchoverOnly", "smithy.api#documentation": "The behavior for a global cluster, that is, only allow switchover or also allow failover.
", "smithy.api#required": {} } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#DocumentDbUngraceful", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } }, "globalClusterIdentifier": { "target": "com.amazonaws.arcregionswitch#DocumentDbGlobalClusterIdentifier", "traits": { "smithy.api#documentation": "The global cluster identifier for a DocumentDB global cluster.
", "smithy.api#required": {} } }, "databaseClusterArns": { "target": "com.amazonaws.arcregionswitch#DocumentDbClusterArns", "traits": { "smithy.api#documentation": "The database cluster Amazon Resource Names (ARNs) for a DocumentDB global cluster.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon DocumentDB global clusters used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#DocumentDbDefaultBehavior": { "type": "enum", "members": { "SWITCHOVER_ONLY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "switchoverOnly" } }, "FAILOVER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failover" } } } }, "com.amazonaws.arcregionswitch#DocumentDbGlobalClusterIdentifier": { "type": "string", "traits": { "smithy.api#pattern": "^[A-Za-z][0-9A-Za-z-:._]*$" } }, "com.amazonaws.arcregionswitch#DocumentDbUngraceful": { "type": "structure", "members": { "ungraceful": { "target": "com.amazonaws.arcregionswitch#DocumentDbUngracefulBehavior", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } } }, "traits": { "smithy.api#documentation": "Configuration for handling failures when performing operations on DocumentDB global clusters.
" } }, "com.amazonaws.arcregionswitch#DocumentDbUngracefulBehavior": { "type": "enum", "members": { "FAILOVER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failover" } } } }, "com.amazonaws.arcregionswitch#Duration": { "type": "string", "traits": { "smithy.api#pattern": "^P(?!$)(\\d+Y)?(\\d+M)?(\\d+D)?(T(?=\\d)(\\d+H)?(\\d+M)?(\\d+S)?)?$" } }, "com.amazonaws.arcregionswitch#Ec2AsgCapacityIncreaseConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "asgs": { "target": "com.amazonaws.arcregionswitch#AsgList", "traits": { "smithy.api#documentation": "The EC2 Auto Scaling groups for the configuration.
", "smithy.api#required": {} } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#Ec2Ungraceful", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } }, "targetPercent": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 100, "smithy.api#documentation": "The target percentage that you specify for EC2 Auto Scaling groups. The default is 100.
" } }, "capacityMonitoringApproach": { "target": "com.amazonaws.arcregionswitch#Ec2AsgCapacityMonitoringApproach", "traits": { "smithy.api#default": "sampledMaxInLast24Hours", "smithy.api#documentation": "The monitoring approach that you specify EC2 Auto Scaling groups for the configuration.
" } }, "waitELBTargetGroupHealthy": { "target": "com.amazonaws.arcregionswitch#WaitELBTargetGroupHealthy", "traits": { "smithy.api#documentation": "If enabled, the step completes only after each attached ELB target group reports a healthy target count that matches the group's new desired capacity calculated in the step.
" } } }, "traits": { "smithy.api#documentation": "Configuration for increasing the capacity of Amazon EC2 Auto Scaling groups during a Region switch.
" } }, "com.amazonaws.arcregionswitch#Ec2AsgCapacityMonitoringApproach": { "type": "enum", "members": { "SAMPLED_MAX_IN_LAST_24_HOURS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "sampledMaxInLast24Hours" } }, "AUTOSCALING_MAX_IN_LAST_24_HOURS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "autoscalingMaxInLast24Hours" } } } }, "com.amazonaws.arcregionswitch#Ec2Ungraceful": { "type": "structure", "members": { "minimumSuccessPercentage": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The minimum success percentage that you specify for EC2 Auto Scaling groups.
", "smithy.api#range": { "min": 0, "max": 99 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for handling failures when performing operations on EC2 resources.
" } }, "com.amazonaws.arcregionswitch#EcsCapacityIncreaseConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "services": { "target": "com.amazonaws.arcregionswitch#ServiceList", "traits": { "smithy.api#documentation": "The services specified for the configuration.
", "smithy.api#required": {} } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#EcsUngraceful", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } }, "targetPercent": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 100, "smithy.api#documentation": "The target percentage specified for the configuration. The default is 100.
" } }, "capacityMonitoringApproach": { "target": "com.amazonaws.arcregionswitch#EcsCapacityMonitoringApproach", "traits": { "smithy.api#default": "sampledMaxInLast24Hours", "smithy.api#documentation": "The monitoring approach specified for the configuration, for example, Most_Recent.
If enabled, the step completes only after each attached ELB target group reports a healthy target count that matches the service's new desired task count calculated in the step.
" } } }, "traits": { "smithy.api#documentation": "The configuration for an Amazon Web Services ECS capacity increase.
" } }, "com.amazonaws.arcregionswitch#EcsCapacityMonitoringApproach": { "type": "enum", "members": { "SAMPLED_MAX_IN_LAST_24_HOURS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "sampledMaxInLast24Hours" } }, "CONTAINER_INSIGHTS_MAX_IN_LAST_24_HOURS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "containerInsightsMaxInLast24Hours" } } } }, "com.amazonaws.arcregionswitch#EcsClusterArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:ecs:[a-z0-9-]+:\\d{12}:cluster/[a-zA-Z0-9_-]{1,255}$" } }, "com.amazonaws.arcregionswitch#EcsServiceArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:ecs:[a-z0-9-]+:\\d{12}:service/[a-zA-Z0-9_-]+/[a-zA-Z0-9_-]{1,255}$" } }, "com.amazonaws.arcregionswitch#EcsUngraceful": { "type": "structure", "members": { "minimumSuccessPercentage": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The minimum success percentage specified for the configuration.
", "smithy.api#range": { "min": 0, "max": 99 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } }, "com.amazonaws.arcregionswitch#EksCapacityMonitoringApproach": { "type": "enum", "members": { "SAMPLED_MAX_IN_LAST_24_HOURS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "sampledMaxInLast24Hours" } } } }, "com.amazonaws.arcregionswitch#EksCluster": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "clusterArn": { "target": "com.amazonaws.arcregionswitch#EksClusterArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of an Amazon Web Services EKS cluster.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The Amazon Web Services EKS cluster execution block configuration.
" } }, "com.amazonaws.arcregionswitch#EksClusterArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:eks:[a-z0-9-]+:\\d{12}:cluster/[a-zA-Z0-9][a-zA-Z0-9-_]{0,99}$" } }, "com.amazonaws.arcregionswitch#EksClusters": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#EksCluster" }, "traits": { "smithy.api#length": { "min": 2 } } }, "com.amazonaws.arcregionswitch#EksResourceScalingConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "kubernetesResourceType": { "target": "com.amazonaws.arcregionswitch#KubernetesResourceType", "traits": { "smithy.api#documentation": "The Kubernetes resource type for the configuration.
", "smithy.api#required": {} } }, "scalingResources": { "target": "com.amazonaws.arcregionswitch#KubernetesScalingApps", "traits": { "smithy.api#documentation": "The scaling resources for the configuration.
" } }, "eksClusters": { "target": "com.amazonaws.arcregionswitch#EksClusters", "traits": { "smithy.api#documentation": "The clusters for the configuration.
" } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#EksResourceScalingUngraceful", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } }, "targetPercent": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 100, "smithy.api#documentation": "The target percentage for the configuration. The default is 100.
", "smithy.api#range": { "min": 1 } } }, "capacityMonitoringApproach": { "target": "com.amazonaws.arcregionswitch#EksCapacityMonitoringApproach", "traits": { "smithy.api#default": "sampledMaxInLast24Hours", "smithy.api#documentation": "The monitoring approach for the configuration, that is, whether it was sampled in the last 24 hours or autoscaled in the last 24 hours.
" } } }, "traits": { "smithy.api#documentation": "The Amazon Web Services EKS resource scaling configuration.
" } }, "com.amazonaws.arcregionswitch#EksResourceScalingUngraceful": { "type": "structure", "members": { "minimumSuccessPercentage": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The minimum success percentage for the configuration.
", "smithy.api#range": { "min": 0, "max": 99 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The ungraceful settings for Amazon Web Services EKS resource scaling.
" } }, "com.amazonaws.arcregionswitch#EvaluationStatus": { "type": "enum", "members": { "PASSED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "passed" } }, "ACTION_REQUIRED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "actionRequired" } }, "PENDING_EVALUATION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pendingEvaluation" } }, "UNKNOWN": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "unknown" } } } }, "com.amazonaws.arcregionswitch#EventSourceMapping": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "arn": { "target": "com.amazonaws.arcregionswitch#EventSourceMappingArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Lambda event source mapping.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The Amazon Web Services Lambda event source mapping configuration, containing the resource ARN and optional cross-account configuration.
" } }, "com.amazonaws.arcregionswitch#EventSourceMappingAction": { "type": "enum", "members": { "ENABLE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "enable" } }, "DISABLE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "disable" } } } }, "com.amazonaws.arcregionswitch#EventSourceMappingArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:lambda:[a-z0-9-]+:\\d{12}:event-source-mapping:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" } }, "com.amazonaws.arcregionswitch#ExecutionAction": { "type": "enum", "members": { "ACTIVATE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "activate" } }, "DEACTIVATE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "deactivate" } }, "POST_RECOVERY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "postRecovery" } } } }, "com.amazonaws.arcregionswitch#ExecutionApprovalConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "approvalRole": { "target": "com.amazonaws.arcregionswitch#RoleArn", "traits": { "smithy.api#documentation": "The IAM approval role for the configuration.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for approval steps in a Region switch plan execution. Approval steps require manual intervention before the execution can proceed.
" } }, "com.amazonaws.arcregionswitch#ExecutionBlockConfiguration": { "type": "union", "members": { "customActionLambdaConfig": { "target": "com.amazonaws.arcregionswitch#CustomActionLambdaConfiguration", "traits": { "smithy.api#documentation": "An Amazon Web Services Lambda execution block.
" } }, "ec2AsgCapacityIncreaseConfig": { "target": "com.amazonaws.arcregionswitch#Ec2AsgCapacityIncreaseConfiguration", "traits": { "smithy.api#documentation": "An EC2 Auto Scaling group execution block.
" } }, "executionApprovalConfig": { "target": "com.amazonaws.arcregionswitch#ExecutionApprovalConfiguration", "traits": { "smithy.api#documentation": "A manual approval execution block.
" } }, "arcRoutingControlConfig": { "target": "com.amazonaws.arcregionswitch#ArcRoutingControlConfiguration", "traits": { "smithy.api#documentation": "An ARC routing control execution block.
" } }, "globalAuroraConfig": { "target": "com.amazonaws.arcregionswitch#GlobalAuroraConfiguration", "traits": { "smithy.api#documentation": "An Aurora Global Database execution block.
" } }, "parallelConfig": { "target": "com.amazonaws.arcregionswitch#ParallelExecutionBlockConfiguration", "traits": { "smithy.api#documentation": "A parallel configuration execution block.
" } }, "regionSwitchPlanConfig": { "target": "com.amazonaws.arcregionswitch#RegionSwitchPlanConfiguration", "traits": { "smithy.api#documentation": "A Region switch plan execution block.
" } }, "ecsCapacityIncreaseConfig": { "target": "com.amazonaws.arcregionswitch#EcsCapacityIncreaseConfiguration", "traits": { "smithy.api#documentation": "The capacity increase specified for the configuration.
" } }, "eksResourceScalingConfig": { "target": "com.amazonaws.arcregionswitch#EksResourceScalingConfiguration", "traits": { "smithy.api#documentation": "An Amazon Web Services EKS resource scaling execution block.
" } }, "route53HealthCheckConfig": { "target": "com.amazonaws.arcregionswitch#Route53HealthCheckConfiguration", "traits": { "smithy.api#documentation": "The Amazon Route 53 health check configuration.
" } }, "documentDbConfig": { "target": "com.amazonaws.arcregionswitch#DocumentDbConfiguration" }, "rdsPromoteReadReplicaConfig": { "target": "com.amazonaws.arcregionswitch#RdsPromoteReadReplicaConfiguration", "traits": { "smithy.api#documentation": "An Amazon RDS promote read replica execution block.
" } }, "rdsCreateCrossRegionReadReplicaConfig": { "target": "com.amazonaws.arcregionswitch#RdsCreateCrossRegionReplicaConfiguration", "traits": { "smithy.api#documentation": "An Amazon RDS create cross-Region replica execution block.
" } }, "lambdaEventSourceMappingConfig": { "target": "com.amazonaws.arcregionswitch#LambdaEventSourceMappingConfiguration", "traits": { "smithy.api#documentation": "A Lambda event source mapping execution block.
" } }, "auroraServerlessScalingConfig": { "target": "com.amazonaws.arcregionswitch#AuroraServerlessScalingConfiguration", "traits": { "smithy.api#documentation": "An Aurora Serverless scaling execution block.
" } }, "auroraProvisionedScalingConfig": { "target": "com.amazonaws.arcregionswitch#AuroraProvisionedScalingConfiguration", "traits": { "smithy.api#documentation": "An Aurora provisioned cluster scaling execution block.
" } }, "neptuneGlobalDatabaseConfig": { "target": "com.amazonaws.arcregionswitch#NeptuneGlobalDatabaseConfiguration", "traits": { "smithy.api#documentation": "A Neptune global database execution block.
" } }, "rdsSwitchoverReadReplicaConfig": { "target": "com.amazonaws.arcregionswitch#RdsSwitchoverReadReplicaConfiguration", "traits": { "smithy.api#documentation": "An Amazon RDS switchover read replica execution block.
" } }, "ssmSendCommandConfig": { "target": "com.amazonaws.arcregionswitch#SsmSendCommandConfiguration", "traits": { "smithy.api#documentation": "Specifies an AWS Systems Manager SendCommand execution block.
Execution block configurations for a workflow in a Region switch plan. An execution block represents a specific type of action to perform during a Region switch.
" } }, "com.amazonaws.arcregionswitch#ExecutionBlockType": { "type": "enum", "members": { "CUSTOM_ACTION_LAMBDA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CustomActionLambda" } }, "EXECUTION_APPROVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ManualApproval" } }, "AURORA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AuroraGlobalDatabase" } }, "EC2_ASG": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EC2AutoScaling" } }, "ROUTING_CONTROL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ARCRoutingControl" } }, "REGION_SWITCH": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ARCRegionSwitchPlan" } }, "PARALLEL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Parallel" } }, "ECS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ECSServiceScaling" } }, "EKS_RESOURCE_SCALING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EKSResourceScaling" } }, "ROUTE53_HEALTH_CHECK": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Route53HealthCheck" } }, "DOCUMENTDB": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DocumentDb" } }, "RDS_PROMOTE_READ_REPLICA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "RdsPromoteReadReplica" } }, "RDS_CREATE_CROSS_REGION_REPLICA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "RdsCreateCrossRegionReplica" } }, "LAMBDA_EVENT_SOURCE_MAPPING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "LambdaEventSourceMapping" } }, "AURORA_SERVERLESS_SCALING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AuroraServerlessScaling" } }, "AURORA_PROVISIONED_SCALING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AuroraProvisionedScaling" } }, "NEPTUNE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "NeptuneGlobalDatabase" } }, "RDS_SWITCHOVER_READ_REPLICA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "RdsSwitchoverReadReplica" } }, "SSM_SEND_COMMAND": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SSMSendCommand" } } } }, "com.amazonaws.arcregionswitch#ExecutionComment": { "type": "string", "traits": { "smithy.api#length": { "max": 1024 } } }, "com.amazonaws.arcregionswitch#ExecutionEvent": { "type": "structure", "members": { "timestamp": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp for an execution event.
" } }, "type": { "target": "com.amazonaws.arcregionswitch#ExecutionEventType", "traits": { "smithy.api#documentation": "The type of an execution event.
" } }, "stepName": { "target": "com.amazonaws.arcregionswitch#StepName", "traits": { "smithy.api#documentation": "The step name for an execution event.
" } }, "executionBlockType": { "target": "com.amazonaws.arcregionswitch#ExecutionBlockType", "traits": { "smithy.api#documentation": "The execution block type for an execution event.
" } }, "resources": { "target": "com.amazonaws.arcregionswitch#Resources", "traits": { "smithy.api#documentation": "The resources for an execution event.
" } }, "error": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "Errors for an execution event.
" } }, "description": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The description for an execution event.
" } }, "eventId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The event ID for an execution event.
", "smithy.api#required": {} } }, "previousEventId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The event ID of the previous execution event.
" } } }, "traits": { "smithy.api#documentation": "Represents an event that occurred during a plan execution. These events provide a detailed timeline of the execution process.
" } }, "com.amazonaws.arcregionswitch#ExecutionEventList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#ExecutionEvent" } }, "com.amazonaws.arcregionswitch#ExecutionEventType": { "type": "enum", "members": { "UNKNOWN": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "unknown" } }, "EXECUTION_PENDING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionPending" } }, "EXECUTION_STARTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionStarted" } }, "EXECUTION_SUCCEEDED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionSucceeded" } }, "EXECUTION_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionFailed" } }, "EXECUTION_PAUSING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionPausing" } }, "EXECUTION_PAUSED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionPaused" } }, "EXECUTION_CANCELING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionCanceling" } }, "EXECUTION_CANCELED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionCanceled" } }, "EXECUTION_PENDING_APPROVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionPendingApproval" } }, "EXECUTION_BEHAVIOR_CHANGED_TO_UNGRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionBehaviorChangedToUngraceful" } }, "EXECUTION_BEHAVIOR_CHANGED_TO_GRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionBehaviorChangedToGraceful" } }, "EXECUTION_PENDING_CHILD_PLAN_MANUAL_APPROVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionPendingChildPlanManualApproval" } }, "EXECUTION_SUCCESS_MONITORING_APPLICATION_HEALTH": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "executionSuccessMonitoringApplicationHealth" } }, "STEP_STARTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepStarted" } }, "STEP_UPDATE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepUpdate" } }, "STEP_SUCCEEDED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepSucceeded" } }, "STEP_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepFailed" } }, "STEP_SKIPPED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepSkipped" } }, "STEP_PAUSED_BY_ERROR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepPausedByError" } }, "STEP_PAUSED_BY_OPERATOR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepPausedByOperator" } }, "STEP_CANCELED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepCanceled" } }, "STEP_PENDING_APPROVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepPendingApproval" } }, "STEP_EXECUTION_BEHAVIOR_CHANGED_TO_UNGRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepExecutionBehaviorChangedToUngraceful" } }, "STEP_PENDING_APPLICATION_HEALTH_MONITOR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "stepPendingApplicationHealthMonitor" } }, "PLAN_EVALUATION_WARNING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "planEvaluationWarning" } } } }, "com.amazonaws.arcregionswitch#ExecutionId": { "type": "string" }, "com.amazonaws.arcregionswitch#ExecutionMode": { "type": "enum", "members": { "GRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "graceful" } }, "UNGRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ungraceful" } } } }, "com.amazonaws.arcregionswitch#ExecutionState": { "type": "enum", "members": { "IN_PROGRESS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "inProgress" } }, "PAUSED_BY_FAILED_STEP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pausedByFailedStep" } }, "PAUSED_BY_OPERATOR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pausedByOperator" } }, "COMPLETED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "completed" } }, "COMPLETED_WITH_EXCEPTIONS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "completedWithExceptions" } }, "CANCELLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "canceled" } }, "PLAN_EXECUTION_TIMED_OUT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "planExecutionTimedOut" } }, "PENDING_MANUAL_APPROVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pendingManualApproval" } }, "FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failed" } }, "PENDING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pending" } }, "COMPLETED_MONITORING_APPLICATION_HEALTH": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "completedMonitoringApplicationHealth" } } } }, "com.amazonaws.arcregionswitch#FailedReportErrorCode": { "type": "enum", "members": { "INSUFFICIENT_PERMISSIONS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "insufficientPermissions" } }, "INVALID_RESOURCE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "invalidResource" } }, "CONFIGURATION_ERROR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "configurationError" } } } }, "com.amazonaws.arcregionswitch#FailedReportOutput": { "type": "structure", "members": { "errorCode": { "target": "com.amazonaws.arcregionswitch#FailedReportErrorCode", "traits": { "smithy.api#documentation": "The error code for the failed report generation.
" } }, "errorMessage": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The error message for the failed report generation.
" } } }, "traits": { "smithy.api#documentation": "Information about a report generation that failed.
" } }, "com.amazonaws.arcregionswitch#GeneratedReport": { "type": "structure", "members": { "reportGenerationTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when the report was generated.
" } }, "reportOutput": { "target": "com.amazonaws.arcregionswitch#ReportOutput", "traits": { "smithy.api#documentation": "The output location or cause of a failure in report generation.
" } } }, "traits": { "smithy.api#documentation": "Information about a generated execution report.
" } }, "com.amazonaws.arcregionswitch#GeneratedReportDetails": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#GeneratedReport" }, "traits": { "smithy.api#length": { "min": 0, "max": 1 } } }, "com.amazonaws.arcregionswitch#GetPlan": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#GetPlanRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#GetPlanResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to get information about a plan" }, "smithy.api#documentation": "Retrieves detailed information about a Region switch plan. You must specify the ARN of the plan.
", "smithy.api#readonly": {}, "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#GetPlanEvaluationStatus": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#GetPlanEvaluationStatusRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#GetPlanEvaluationStatusResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to get a plan's evaluation status" }, "smithy.api#documentation": "Retrieves the evaluation status of a Region switch plan. The evaluation status provides information about the last time the plan was evaluated and any warnings or issues detected.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "warnings" }, "smithy.api#readonly": {}, "smithy.waiters#waitable": { "PlanEvaluationStatusPassed": { "minDelay": 30, "acceptors": [ { "state": "success", "matcher": { "output": { "path": "evaluationState", "expected": "passed", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "evaluationState", "expected": "actionRequired", "comparator": "stringEquals" } } }, { "state": "retry", "matcher": { "output": { "path": "evaluationState", "expected": "pendingEvaluation", "comparator": "stringEquals" } } } ] } } } }, "com.amazonaws.arcregionswitch#GetPlanEvaluationStatusRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Region switch plan to retrieve evaluation status for.
", "smithy.api#required": {} } }, "maxResults": { "target": "com.amazonaws.arcregionswitch#MaxResults", "traits": { "smithy.api#documentation": "The number of objects that you want to return with this call.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "lastEvaluationTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The time of the last time that Region switch ran an evaluation of the plan.
" } }, "lastEvaluatedVersion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The version of the last evaluation of the plan.
" } }, "region": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "smithy.api#documentation": "The Amazon Web Services Region for the plan.
" } }, "evaluationState": { "target": "com.amazonaws.arcregionswitch#EvaluationStatus", "traits": { "smithy.api#documentation": "The evaluation state for the plan.
" } }, "warnings": { "target": "com.amazonaws.arcregionswitch#PlanWarnings", "traits": { "smithy.api#documentation": "The current evaluation warnings for the plan.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
Retrieves detailed information about a specific plan execution. You must specify the plan ARN and execution ID.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "stepStates" }, "smithy.api#readonly": {}, "smithy.waiters#waitable": { "PlanExecutionCompleted": { "minDelay": 30, "acceptors": [ { "state": "success", "matcher": { "output": { "path": "executionState", "expected": "completed", "comparator": "stringEquals" } } }, { "state": "success", "matcher": { "output": { "path": "executionState", "expected": "completedWithExceptions", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "executionState", "expected": "failed", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "executionState", "expected": "canceled", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "executionState", "expected": "planExecutionTimedOut", "comparator": "stringEquals" } } } ] } } } }, "com.amazonaws.arcregionswitch#GetPlanExecutionRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan with the execution to retrieve.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
", "smithy.api#required": {} } }, "maxResults": { "target": "com.amazonaws.arcregionswitch#GetPlanExecutionStepStatesMaxResults", "traits": { "smithy.api#default": 100, "smithy.api#documentation": "The number of objects that you want to return with this call.
" } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
", "smithy.api#required": {} } }, "version": { "target": "smithy.api#String", "traits": { "aws.cloudformation#cfnMutability": "read", "smithy.api#documentation": "The version for the plan.
" } }, "updatedAt": { "target": "smithy.api#Timestamp", "traits": { "aws.cloudformation#cfnExcludeProperty": {}, "smithy.api#documentation": "The timestamp when the plan execution was last updated.
" } }, "comment": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A comment included on the plan execution.
" } }, "startTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The time (UTC) when the plan execution started.
", "smithy.api#required": {} } }, "endTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The time (UTC) when the plan execution ended.
" } }, "mode": { "target": "com.amazonaws.arcregionswitch#ExecutionMode", "traits": { "smithy.api#documentation": "The plan execution mode. Valid values are graceful, for graceful executions, or ungraceful, for ungraceful executions.
The plan execution state. Provides the state of a plan execution, for example, In Progress or Paused by Operator.
", "smithy.api#required": {} } }, "executionAction": { "target": "com.amazonaws.arcregionswitch#ExecutionAction", "traits": { "smithy.api#documentation": "The plan execution action. Valid values are activate, to activate an Amazon Web Services Region, or deactivate, to deactivate a Region.
The Amazon Web Services Region for a plan execution.
", "smithy.api#required": {} } }, "recoveryExecutionId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The unique identifier of the most recent recovery execution. Required when starting a post-recovery execution.
" } }, "stepStates": { "target": "com.amazonaws.arcregionswitch#StepStates", "traits": { "smithy.api#documentation": "The states of the steps in the plan execution.
" } }, "plan": { "target": "com.amazonaws.arcregionswitch#Plan", "traits": { "smithy.api#documentation": "The details of the Region switch plan.
" } }, "actualRecoveryTime": { "target": "com.amazonaws.arcregionswitch#Duration", "traits": { "smithy.api#documentation": "The actual recovery time that Region switch calculates for a plan execution. Actual recovery time includes the time for the plan to run added to the time elapsed until the application health alarms that you've specified are healthy again.
" } }, "generatedReportDetails": { "target": "com.amazonaws.arcregionswitch#GeneratedReportDetails", "traits": { "smithy.api#documentation": "Information about the location of a generated report, or the cause of its failure.
" } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
Retrieves information about a Region switch plan in a specific Amazon Web Services Region. This operation is useful for getting Region-specific information about a plan.
", "smithy.api#readonly": {} } }, "com.amazonaws.arcregionswitch#GetPlanInRegionRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan in Region.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#GetPlanInRegionResponse": { "type": "structure", "members": { "plan": { "target": "com.amazonaws.arcregionswitch#Plan", "traits": { "smithy.api#documentation": "The details of the Region switch plan.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#GetPlanRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#GetPlanResponse": { "type": "structure", "members": { "plan": { "target": "com.amazonaws.arcregionswitch#Plan", "traits": { "aws.cloudformation#cfnExcludeProperty": {}, "smithy.api#documentation": "The detailed information about the requested Region switch plan.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#GlobalAuroraConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "behavior": { "target": "com.amazonaws.arcregionswitch#GlobalAuroraDefaultBehavior", "traits": { "smithy.api#default": "switchoverOnly", "smithy.api#documentation": "The default behavior for the Aurora global database execution block. Valid values:
switchoverOnly - Calls SwitchoverGlobalCluster for a zero-data-loss switchover during graceful execution.
failover - Calls FailoverGlobalCluster with AllowDataLoss set to true. This operation might cause data loss, including during graceful execution.
The behavior to use when the plan runs in ungraceful mode. If you omit this value, Region switch uses the value of behavior.
The global cluster identifier for a global database.
", "smithy.api#required": {} } }, "databaseClusterArns": { "target": "com.amazonaws.arcregionswitch#AuroraClusterArns", "traits": { "smithy.api#documentation": "The database cluster Amazon Resource Names (ARNs) for a global database.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon Aurora global databases used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#GlobalAuroraDefaultBehavior": { "type": "enum", "members": { "SWITCHOVER_ONLY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "switchoverOnly" } }, "FAILOVER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failover" } } } }, "com.amazonaws.arcregionswitch#GlobalAuroraUngraceful": { "type": "structure", "members": { "ungraceful": { "target": "com.amazonaws.arcregionswitch#GlobalAuroraUngracefulBehavior", "traits": { "smithy.api#documentation": "The ungraceful behavior. The only valid value is failover, which calls FailoverGlobalCluster with AllowDataLoss set to true and might cause data loss.
Configuration for an Aurora global database execution block in ungraceful mode.
" } }, "com.amazonaws.arcregionswitch#GlobalAuroraUngracefulBehavior": { "type": "enum", "members": { "FAILOVER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failover" } } } }, "com.amazonaws.arcregionswitch#GlobalClusterIdentifier": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[A-Za-z][0-9A-Za-z-:._]*$" } }, "com.amazonaws.arcregionswitch#IamRoleArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z0-9-]*:iam::[0-9]{12}:role/.+$" } }, "com.amazonaws.arcregionswitch#IllegalArgumentException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The request processing has an invalid argument.
", "smithy.api#error": "client", "smithy.api#httpError": 400 } }, "com.amazonaws.arcregionswitch#IllegalStateException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The operation failed because the current state of the resource doesn't allow the operation to proceed.
HTTP Status Code: 400
", "smithy.api#error": "client", "smithy.api#httpError": 400 } }, "com.amazonaws.arcregionswitch#InternalServerException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The request processing has failed because of an unknown error, exception, or failure.
HTTP Status Code: 500
", "smithy.api#error": "server", "smithy.api#httpError": 500 } }, "com.amazonaws.arcregionswitch#KubernetesNamespace": { "type": "string", "traits": { "smithy.api#pattern": "^[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$" } }, "com.amazonaws.arcregionswitch#KubernetesResourceType": { "type": "structure", "members": { "apiVersion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The API version type for the Kubernetes resource.
", "smithy.api#required": {} } }, "kind": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The kind for the Kubernetes resource.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Defines the type of Kubernetes resource to scale in an Amazon EKS cluster.
" } }, "com.amazonaws.arcregionswitch#KubernetesScalingApplication": { "type": "map", "key": { "target": "smithy.api#String" }, "value": { "target": "com.amazonaws.arcregionswitch#RegionalScalingResource" } }, "com.amazonaws.arcregionswitch#KubernetesScalingApps": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#KubernetesScalingApplication" }, "traits": { "smithy.api#length": { "min": 1 } } }, "com.amazonaws.arcregionswitch#KubernetesScalingResource": { "type": "structure", "members": { "namespace": { "target": "com.amazonaws.arcregionswitch#KubernetesNamespace", "traits": { "smithy.api#documentation": "The namespace for the Kubernetes resource.
", "smithy.api#required": {} } }, "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name for the Kubernetes resource.
", "smithy.api#required": {} } }, "hpaName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The hpaname for the Kubernetes resource.
" } } }, "traits": { "smithy.api#documentation": "Defines a Kubernetes resource to scale in an Amazon EKS cluster.
" } }, "com.amazonaws.arcregionswitch#LambdaArn": { "type": "string" }, "com.amazonaws.arcregionswitch#LambdaEventSourceMappingConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "action": { "target": "com.amazonaws.arcregionswitch#EventSourceMappingAction", "traits": { "smithy.api#documentation": "The action to take - whether to enable or disable an event source mapping.
Per-region configuration for which Lambda event source mapping to enable or disable when activating or deactivating a region.
", "smithy.api#required": {} } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#LambdaEventSourceMappingUngraceful", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon Web Services Lambda event source mappings used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#LambdaEventSourceMappingUngraceful": { "type": "structure", "members": { "behavior": { "target": "com.amazonaws.arcregionswitch#LambdaEventSourceMappingUngracefulBehavior", "traits": { "smithy.api#default": "skip", "smithy.api#documentation": "Set to skip to skip executing this event source mapping step during an ungraceful execution.
Specifies whether to skip enabling or disabling an event source mapping during an ungraceful execution.
" } }, "com.amazonaws.arcregionswitch#LambdaEventSourceMappingUngracefulBehavior": { "type": "enum", "members": { "SKIP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "skip" } } } }, "com.amazonaws.arcregionswitch#LambdaList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Lambdas" }, "traits": { "smithy.api#length": { "min": 1, "max": 2 } } }, "com.amazonaws.arcregionswitch#LambdaPayload": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 786432 }, "smithy.api#sensitive": {} } }, "com.amazonaws.arcregionswitch#LambdaUngraceful": { "type": "structure", "members": { "behavior": { "target": "com.amazonaws.arcregionswitch#LambdaUngracefulBehavior", "traits": { "smithy.api#default": "skip", "smithy.api#documentation": "The ungraceful behavior for a Lambda function, which must be set to skip.
Configuration for handling failures when invoking Lambda functions.
" } }, "com.amazonaws.arcregionswitch#LambdaUngracefulBehavior": { "type": "enum", "members": { "SKIP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "skip" } } } }, "com.amazonaws.arcregionswitch#Lambdas": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "arn": { "target": "com.amazonaws.arcregionswitch#LambdaArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Lambda function.
" } }, "payload": { "target": "com.amazonaws.arcregionswitch#LambdaPayload", "traits": { "smithy.api#documentation": "The JSON payload to send to the Lambda function invocation. If you don't specify a payload, Region switch invokes the function with only the execution metadata.
If you provide a JSON object, Region switch merges execution metadata keys (InvokedBy, PlanArn, ExecutionId, StepName) into the top level. If one of your keys has the same name as a metadata key, your key takes precedence.
If you provide any other JSON type (string, number, boolean, or array), Region switch forwards it to the Lambda function unchanged, without adding metadata.
" } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon Web Services Lambda functions used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#ListExecutionEventsMaxResults": { "type": "integer", "traits": { "smithy.api#range": { "min": 1, "max": 100 } } }, "com.amazonaws.arcregionswitch#ListExecutionsMaxResults": { "type": "integer", "traits": { "smithy.api#range": { "min": 1, "max": 100 } } }, "com.amazonaws.arcregionswitch#ListPlanExecutionEvents": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#ListPlanExecutionEventsRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#ListPlanExecutionEventsResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to list plan execution events" }, "smithy.api#documentation": "Lists the events that occurred during a plan execution. These events provide a detailed timeline of the execution process.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "items" }, "smithy.api#readonly": {} } }, "com.amazonaws.arcregionswitch#ListPlanExecutionEventsRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
", "smithy.api#required": {} } }, "maxResults": { "target": "com.amazonaws.arcregionswitch#ListExecutionEventsMaxResults", "traits": { "smithy.api#default": 100, "smithy.api#documentation": "The number of objects that you want to return with this call.
" } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The name of the plan execution event.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#ListPlanExecutionEventsResponse": { "type": "structure", "members": { "items": { "target": "com.amazonaws.arcregionswitch#ExecutionEventList", "traits": { "smithy.api#documentation": "The items in the plan execution event.
" } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
Lists the executions of a Region switch plan. This operation returns information about both current and historical executions.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "items" }, "smithy.api#readonly": {} } }, "com.amazonaws.arcregionswitch#ListPlanExecutionsRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The ARN for the plan.
", "smithy.api#required": {} } }, "maxResults": { "target": "com.amazonaws.arcregionswitch#ListExecutionsMaxResults", "traits": { "smithy.api#default": 100, "smithy.api#documentation": "The number of objects that you want to return with this call.
" } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The state of the plan execution. For example, the plan execution might be In Progress.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#ListPlanExecutionsResponse": { "type": "structure", "members": { "items": { "target": "com.amazonaws.arcregionswitch#AbbreviatedExecutionsList", "traits": { "smithy.api#documentation": "The items in the plan execution to return.
" } }, "nextToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
Lists all Region switch plans in your Amazon Web Services account.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "plans" }, "smithy.api#readonly": {}, "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } }, "smithy.test#smokeTests": [ { "id": "ListPlansSuccess", "params": {}, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.arcregionswitch#ListPlansInRegion": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#ListPlansInRegionRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#ListPlansInRegionResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to list plans in a specific AWS Region using the Region switch Regional data plane" }, "smithy.api#documentation": "Lists all Region switch plans in your Amazon Web Services account that are available in the current Amazon Web Services Region.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "plans" }, "smithy.api#readonly": {} } }, "com.amazonaws.arcregionswitch#ListPlansInRegionRequest": { "type": "structure", "members": { "maxResults": { "target": "com.amazonaws.arcregionswitch#MaxResults", "traits": { "smithy.api#documentation": "The number of objects that you want to return with this call.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The plans that were requested.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The number of objects that you want to return with this call.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The plans that were requested.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
List the Amazon Route 53 health checks.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "healthChecks" }, "smithy.api#readonly": {}, "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#ListRoute53HealthChecksInRegion": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#ListRoute53HealthChecksInRegionRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#ListRoute53HealthChecksInRegionResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#IllegalArgumentException" }, { "target": "com.amazonaws.arcregionswitch#InternalServerException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to list Route 53 health checks created by ARC region switch for a plan in a specific AWS Region using the Region switch Regional data plane" }, "smithy.api#documentation": "List the Amazon Route 53 health checks in a specific Amazon Web Services Region.
", "smithy.api#examples": [ { "title": "Example ListRoute53HealthChecksInRegion", "input": { "arn": "arn:aws:arc-region-switch::123456789012:plan/example:000000", "hostedZoneId": "Z0123456789ABCDEFGHI", "recordName": "my.record.name", "maxResults": 10, "nextToken": "eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ" }, "output": { "healthChecks": [ { "hostedZoneId": "Z0123456789ABCDEFGHI", "recordName": "my.record.name", "healthCheckId": "01234567-8901-abcd-efgh-ijklmnop0123", "status": "healthy", "region": "us-west-2" }, { "hostedZoneId": "Z0123456789ABCDEFGHI", "recordName": "my.record.name", "healthCheckId": "zyxwvuts-rqpo-9876-5432-10nmlkji0123", "status": "healthy", "region": "us-east-1" } ] } } ], "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "healthChecks" }, "smithy.api#readonly": {} } }, "com.amazonaws.arcregionswitch#ListRoute53HealthChecksInRegionRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Arc Region Switch Plan.
", "smithy.api#required": {} } }, "hostedZoneId": { "target": "com.amazonaws.arcregionswitch#Route53HostedZoneId", "traits": { "smithy.api#documentation": "The hosted zone ID for the health checks.
" } }, "recordName": { "target": "com.amazonaws.arcregionswitch#Route53RecordName", "traits": { "smithy.api#documentation": "The record name for the health checks.
" } }, "maxResults": { "target": "com.amazonaws.arcregionswitch#MaxResults", "traits": { "smithy.api#documentation": "The maximum number of results to return in the response.
", "smithy.api#range": { "min": 1, "max": 100 } } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
List of the health checks requested.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "A pagination token. A response may contain no results while still including a nextToken. Continue paginating until nextToken is null to retrieve all results.
The Amazon Resource Name (ARN) of the Amazon Route 53 health check request.
", "smithy.api#required": {} } }, "hostedZoneId": { "target": "com.amazonaws.arcregionswitch#Route53HostedZoneId", "traits": { "smithy.api#documentation": "The hosted zone ID for the health checks.
" } }, "recordName": { "target": "com.amazonaws.arcregionswitch#Route53RecordName", "traits": { "smithy.api#documentation": "The record name for the health checks.
" } }, "maxResults": { "target": "com.amazonaws.arcregionswitch#MaxResults", "traits": { "smithy.api#documentation": "The maximum number of results to return in the response.
", "smithy.api#range": { "min": 1, "max": 100 } } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
List of the health checks requested.
" } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "A pagination token. A response may contain no results while still including a nextToken. Continue paginating until nextToken is null to retrieve all results.
Lists the service quota warnings for the plans that you can access. Region switch creates a warning when the applied quota value in one Region of a plan is lower than the value required for the matching resource in another Region or account in the plan.
Returns the warnings for the plans that you own and for plans that are shared with your account through Resource Access Manager (RAM). To return warnings for specific plans, provide a list of plan Amazon Resource Names (ARNs). Region switch ignores any plan ARN that you can't access. If you don't provide any plan ARNs, Region switch returns the warnings for all of your accessible plans.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "serviceQuotaWarningSummaries" }, "smithy.api#readonly": {} } }, "com.amazonaws.arcregionswitch#ListServiceQuotaWarningsRequest": { "type": "structure", "members": { "planArns": { "target": "com.amazonaws.arcregionswitch#PlanArnList", "traits": { "smithy.api#documentation": "The Amazon Resource Names (ARNs) of the plans to return service quota warnings for. You can specify up to 100 plan ARNs. Region switch ignores any plan ARN that you can't access. If you omit this parameter, Region switch returns the warnings for all of your accessible plans.
" } }, "maxResults": { "target": "com.amazonaws.arcregionswitch#MaxResults", "traits": { "smithy.api#documentation": "The maximum number of results to return with this call. Valid values are 1 to 100. If you don't specify a value, the operation returns up to the maximum number of results.
Specifies that you want to receive the next page of results. Valid only if you received a nextToken response in the previous request. If you did, it indicates that more output is available. Set this parameter to the value provided by the previous call's nextToken response to request the next page of results.
The service quota warnings for the plans that you can access.
", "smithy.api#required": {} } }, "nextToken": { "target": "com.amazonaws.arcregionswitch#NextToken", "traits": { "smithy.api#documentation": "A pagination token. A response may contain no results while still including a nextToken. Continue paginating until nextToken is null to retrieve all results.
Lists the tags attached to a Region switch resource.
", "smithy.api#readonly": {}, "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#ListTagsForResourceRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the resource.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#ListTagsForResourceResponse": { "type": "structure", "members": { "resourceTags": { "target": "com.amazonaws.arcregionswitch#Tags", "traits": { "smithy.api#documentation": "The tags for a resource.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#MaxResults": { "type": "integer", "traits": { "smithy.api#range": { "min": 1, "max": 100 } } }, "com.amazonaws.arcregionswitch#MinimalWorkflow": { "type": "structure", "members": { "action": { "target": "com.amazonaws.arcregionswitch#ExecutionAction", "traits": { "smithy.api#documentation": "The action for a minimal workflow, which can be Activate or Deactivate.
" } }, "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name for a minimal workflow
" } } }, "traits": { "smithy.api#documentation": "A simplified representation of a workflow in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#NeptuneClusterArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:rds:[a-z0-9-]+:\\d{12}:cluster:[A-Za-z][0-9A-Za-z-]{0,62}$" } }, "com.amazonaws.arcregionswitch#NeptuneDefaultBehavior": { "type": "enum", "members": { "SWITCHOVER_ONLY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "switchoverOnly" } }, "FAILOVER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failover" } } } }, "com.amazonaws.arcregionswitch#NeptuneGlobalClusterIdentifier": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 63 }, "smithy.api#pattern": "^[A-Za-z][0-9A-Za-z-]*$" } }, "com.amazonaws.arcregionswitch#NeptuneGlobalDatabaseConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "behavior": { "target": "com.amazonaws.arcregionswitch#NeptuneDefaultBehavior", "traits": { "smithy.api#default": "switchoverOnly", "smithy.api#documentation": "The behavior for a global database, that is, only allow switchover or also allow failover.
", "smithy.api#required": {} } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#NeptuneUngraceful", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } }, "globalClusterIdentifier": { "target": "com.amazonaws.arcregionswitch#NeptuneGlobalClusterIdentifier", "traits": { "smithy.api#documentation": "The global cluster identifier for a Neptune global database.
", "smithy.api#required": {} } }, "regionDatabaseClusterArns": { "target": "com.amazonaws.arcregionswitch#RegionNeptuneClusterArnMap", "traits": { "smithy.api#documentation": "The database cluster Amazon Resource Names (ARNs) for a Neptune global database.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for Amazon Neptune global databases used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#NeptuneUngraceful": { "type": "structure", "members": { "ungraceful": { "target": "com.amazonaws.arcregionswitch#NeptuneUngracefulBehavior", "traits": { "smithy.api#documentation": "The settings for ungraceful execution.
" } } }, "traits": { "smithy.api#documentation": "Configuration for handling failures when performing operations on Neptune global databases.
" } }, "com.amazonaws.arcregionswitch#NeptuneUngracefulBehavior": { "type": "enum", "members": { "FAILOVER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failover" } } } }, "com.amazonaws.arcregionswitch#NextToken": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 } } }, "com.amazonaws.arcregionswitch#ParallelExecutionBlockConfiguration": { "type": "structure", "members": { "steps": { "target": "com.amazonaws.arcregionswitch#Steps", "traits": { "smithy.api#documentation": "The steps for a parallel execution block.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for steps that should be executed in parallel during a Region switch.
" } }, "com.amazonaws.arcregionswitch#Plan": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "description": { "target": "smithy.api#String", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The description for a plan.
" } }, "workflows": { "target": "com.amazonaws.arcregionswitch#WorkflowList", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The workflows for a plan.
", "smithy.api#required": {} } }, "executionRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The execution role for a plan.
", "smithy.api#required": {} } }, "recoveryTimeObjectiveMinutes": { "target": "smithy.api#Integer", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The recovery time objective for a plan.
", "smithy.api#range": { "min": 1, "max": 10080 } } }, "associatedAlarms": { "target": "com.amazonaws.arcregionswitch#AssociatedAlarmMap", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The associated application health alarms for a plan.
" } }, "triggers": { "target": "com.amazonaws.arcregionswitch#TriggerList", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The triggers for a plan.
" } }, "reportConfiguration": { "target": "com.amazonaws.arcregionswitch#ReportConfiguration", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The report configuration for a plan.
" } }, "serviceQuotaChecksEnabled": { "target": "smithy.api#Boolean", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "Indicates whether service quota checks are enabled for the Region switch plan. When enabled, Region switch compares the applied service quota values across the plan's Amazon Web Services Regions and creates a warning when a quota in one Region is lower than the value required for the matching resource in another Region. Service quota checks are advisory and don't prevent you from creating, evaluating, or executing a plan.
" } }, "name": { "target": "com.amazonaws.arcregionswitch#PlanName", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The name for a plan.
", "smithy.api#required": {} } }, "regions": { "target": "com.amazonaws.arcregionswitch#RegionList", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The Amazon Web Services Regions for a plan.
", "smithy.api#required": {} } }, "recoveryApproach": { "target": "com.amazonaws.arcregionswitch#RecoveryApproach", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The recovery approach for a Region switch plan, which can be active/active (activeActive) or active/passive (activePassive).
", "smithy.api#required": {} } }, "primaryRegion": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "aws.cloudformation#cfnMutability": "create-and-read", "smithy.api#documentation": "The primary Region for a plan.
" } }, "owner": { "target": "com.amazonaws.arcregionswitch#AccountId", "traits": { "aws.cloudformation#cfnMutability": "read", "smithy.api#documentation": "The owner of a plan.
", "smithy.api#required": {} } }, "version": { "target": "smithy.api#String", "traits": { "aws.cloudformation#cfnMutability": "read", "smithy.api#documentation": "The version for the plan.
" } }, "updatedAt": { "target": "smithy.api#Timestamp", "traits": { "aws.cloudformation#cfnExcludeProperty": {}, "smithy.api#documentation": "The timestamp when the plan was last updated.
" } } }, "traits": { "smithy.api#documentation": "Represents a Region switch plan. A plan defines the steps required to shift traffic from one Amazon Web Services Region to another.
" } }, "com.amazonaws.arcregionswitch#PlanArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:arc-region-switch::[0-9]{12}:plan/([a-zA-Z0-9](?:[a-zA-Z0-9-]{0,30}[a-zA-Z0-9])?):([a-z0-9]{6})$" } }, "com.amazonaws.arcregionswitch#PlanArnList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#PlanArn" }, "traits": { "smithy.api#length": { "max": 100 } } }, "com.amazonaws.arcregionswitch#PlanList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#AbbreviatedPlan" } }, "com.amazonaws.arcregionswitch#PlanName": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 32 }, "smithy.api#pattern": "^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,30}[a-zA-Z0-9])?$" } }, "com.amazonaws.arcregionswitch#PlanWarnings": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#ResourceWarning" } }, "com.amazonaws.arcregionswitch#RdsCreateCrossRegionReplicaConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross-account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "dbInstanceArnMap": { "target": "com.amazonaws.arcregionswitch#RdsDbInstanceArnMap", "traits": { "smithy.api#documentation": "A map of database instance ARNs for each Region in the plan.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for creating an Amazon RDS cross-Region read replica during post-recovery in a Region switch.
" } }, "com.amazonaws.arcregionswitch#RdsDbInstanceArn": { "type": "string", "traits": { "smithy.api#pattern": "^arn:aws[a-zA-Z-]*:rds:[a-z0-9-]+:\\d{12}:db:[a-zA-Z][a-zA-Z0-9]*(-[a-zA-Z0-9]+)*$" } }, "com.amazonaws.arcregionswitch#RdsDbInstanceArnMap": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#Region" }, "value": { "target": "com.amazonaws.arcregionswitch#RdsDbInstanceArn" } }, "com.amazonaws.arcregionswitch#RdsPromoteReadReplicaConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross-account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "dbInstanceArnMap": { "target": "com.amazonaws.arcregionswitch#RdsDbInstanceArnMap", "traits": { "smithy.api#documentation": "A map of database instance ARNs for each Region in the plan.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for promoting an Amazon RDS read replica to a standalone database instance during a Region switch.
" } }, "com.amazonaws.arcregionswitch#RdsSwitchoverReadReplicaConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross-account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "dbInstanceArnMap": { "target": "com.amazonaws.arcregionswitch#RdsDbInstanceArnMap", "traits": { "smithy.api#documentation": "A map of database instance ARNs for each Region in the plan.
", "smithy.api#required": {} } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#RdsUngraceful", "traits": { "smithy.api#documentation": "The ungraceful execution settings for the configuration.
" } } }, "traits": { "smithy.api#documentation": "Configuration for switching over an Amazon RDS read replica to become the new primary database instance during a Region switch.
" } }, "com.amazonaws.arcregionswitch#RdsUngraceful": { "type": "structure", "members": { "ungraceful": { "target": "com.amazonaws.arcregionswitch#RdsUngracefulBehavior", "traits": { "smithy.api#documentation": "The ungraceful behavior to perform if switching to ungraceful execution.
" } } }, "traits": { "smithy.api#documentation": "The ungraceful execution settings for an Amazon RDS switchover read replica execution block.
" } }, "com.amazonaws.arcregionswitch#RdsUngracefulBehavior": { "type": "enum", "members": { "PROMOTE_READ_REPLICA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "promoteReadReplica" } } }, "traits": { "smithy.api#documentation": "The ungraceful behavior for an Amazon RDS switchover read replica, that is, promote the read replica to a standalone primary.
" } }, "com.amazonaws.arcregionswitch#RecoveryApproach": { "type": "enum", "members": { "ACTIVE_ACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "activeActive" } }, "ACTIVE_PASSIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "activePassive" } } } }, "com.amazonaws.arcregionswitch#RecoveryExecutionId": { "type": "string", "traits": { "smithy.api#pattern": "^[a-z]{2}(-[a-z]+)+-[0-9]+/[0-9a-fA-F]{16}$" } }, "com.amazonaws.arcregionswitch#Region": { "type": "string", "traits": { "smithy.api#pattern": "^[a-z]{2}-[a-z-]+-\\d+$" } }, "com.amazonaws.arcregionswitch#RegionAndRoutingControls": { "type": "map", "key": { "target": "smithy.api#String" }, "value": { "target": "com.amazonaws.arcregionswitch#ArcRoutingControlStates" } }, "com.amazonaws.arcregionswitch#RegionAuroraClusterMap": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#Region" }, "value": { "target": "com.amazonaws.arcregionswitch#AuroraClusterArn" }, "traits": { "smithy.api#documentation": "A map of Region to Aurora database cluster ARN for Aurora Serverless scaling configuration.
", "smithy.api#length": { "min": 2, "max": 2 } } }, "com.amazonaws.arcregionswitch#RegionAuroraInstanceArnMap": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#Region" }, "value": { "target": "com.amazonaws.arcregionswitch#AuroraInstanceArn" }, "traits": { "smithy.api#length": { "min": 1, "max": 2 } } }, "com.amazonaws.arcregionswitch#RegionEventSourceMappingMap": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#Region" }, "value": { "target": "com.amazonaws.arcregionswitch#EventSourceMapping" }, "traits": { "smithy.api#length": { "min": 1, "max": 2 } } }, "com.amazonaws.arcregionswitch#RegionList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Region" }, "traits": { "smithy.api#length": { "min": 2, "max": 2 } } }, "com.amazonaws.arcregionswitch#RegionNeptuneClusterArnMap": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#Region" }, "value": { "target": "com.amazonaws.arcregionswitch#NeptuneClusterArn" }, "traits": { "smithy.api#documentation": "A map of Region to Neptune database cluster ARN for Neptune global database configuration.
", "smithy.api#length": { "min": 2, "max": 2 } } }, "com.amazonaws.arcregionswitch#RegionSsmDocumentMap": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#Region" }, "value": { "target": "com.amazonaws.arcregionswitch#SsmDocumentConfig" }, "traits": { "smithy.api#documentation": "The Systems Manager document and target configuration for each Amazon Web Services Region that the configuration applies to.
", "smithy.api#length": { "min": 1, "max": 2 } } }, "com.amazonaws.arcregionswitch#RegionSwitchPlan": { "type": "resource", "identifiers": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn" } }, "create": { "target": "com.amazonaws.arcregionswitch#CreatePlan" }, "read": { "target": "com.amazonaws.arcregionswitch#GetPlan" }, "update": { "target": "com.amazonaws.arcregionswitch#UpdatePlan" }, "delete": { "target": "com.amazonaws.arcregionswitch#DeletePlan" }, "list": { "target": "com.amazonaws.arcregionswitch#ListPlans" }, "operations": [ { "target": "com.amazonaws.arcregionswitch#ListTagsForResource" }, { "target": "com.amazonaws.arcregionswitch#TagResource" }, { "target": "com.amazonaws.arcregionswitch#UntagResource" } ], "traits": { "aws.api#arn": { "template": "plan/{arn}" }, "aws.cloudformation#cfnResource": { "name": "Plan", "additionalSchemas": [ "com.amazonaws.arcregionswitch#Plan" ] }, "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}" ], "aws.iam#disableConditionKeyInference": {}, "aws.iam#iamResource": { "name": "plan", "relativeDocumentation": "plan.html" } } }, "com.amazonaws.arcregionswitch#RegionSwitchPlanConfiguration": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan configuration.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Configuration for nested Region switch plans. This allows one Region switch plan to trigger another plan as part of its execution.
" } }, "com.amazonaws.arcregionswitch#RegionToRunIn": { "type": "enum", "members": { "ACTIVATING_REGION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "activatingRegion" } }, "DEACTIVATING_REGION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "deactivatingRegion" } }, "ACTIVE_REGION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "activeRegion" } }, "INACTIVE_REGION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "inactiveRegion" } } } }, "com.amazonaws.arcregionswitch#RegionalScalingResource": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#Region" }, "value": { "target": "com.amazonaws.arcregionswitch#KubernetesScalingResource" } }, "com.amazonaws.arcregionswitch#ReportConfiguration": { "type": "structure", "members": { "reportOutput": { "target": "com.amazonaws.arcregionswitch#ReportOutputList", "traits": { "smithy.api#documentation": "The output configuration for the report.
" } } }, "traits": { "smithy.api#documentation": "Configuration for automatic report generation for plan executions. When configured, Region switch automatically generates a report after each plan execution that includes execution events, plan configuration, and CloudWatch alarm states.
" } }, "com.amazonaws.arcregionswitch#ReportOutput": { "type": "union", "members": { "s3ReportOutput": { "target": "com.amazonaws.arcregionswitch#S3ReportOutput", "traits": { "smithy.api#documentation": "Information about a report delivered to Amazon S3.
" } }, "failedReportOutput": { "target": "com.amazonaws.arcregionswitch#FailedReportOutput", "traits": { "smithy.api#documentation": "The details about a failed report generation.
" } } }, "traits": { "smithy.api#documentation": "The output location or cause of a failure in report generation.
" } }, "com.amazonaws.arcregionswitch#ReportOutputConfiguration": { "type": "union", "members": { "s3Configuration": { "target": "com.amazonaws.arcregionswitch#S3ReportOutputConfiguration", "traits": { "smithy.api#documentation": "Configuration for delivering reports to an Amazon S3 bucket.
" } } }, "traits": { "smithy.api#documentation": "Configuration for report output destinations used in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#ReportOutputList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#ReportOutputConfiguration" }, "traits": { "smithy.api#length": { "min": 1, "max": 1 } } }, "com.amazonaws.arcregionswitch#ResourceArn": { "type": "string" }, "com.amazonaws.arcregionswitch#ResourceNotFoundException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The specified resource was not found.
HTTP Status Code: 404
", "smithy.api#error": "client", "smithy.api#httpError": 404 } }, "com.amazonaws.arcregionswitch#ResourceWarning": { "type": "structure", "members": { "workflow": { "target": "com.amazonaws.arcregionswitch#MinimalWorkflow", "traits": { "smithy.api#documentation": "The workflow for the resource warning.
" } }, "version": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The version for the resource warning.
", "smithy.api#required": {} } }, "stepName": { "target": "com.amazonaws.arcregionswitch#StepName", "traits": { "smithy.api#documentation": "The name of the step for the resource warning.
" } }, "resourceArn": { "target": "com.amazonaws.arcregionswitch#ResourceArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the resource.
" } }, "warningStatus": { "target": "com.amazonaws.arcregionswitch#ResourceWarningStatus", "traits": { "smithy.api#documentation": "The status of the resource warning.
", "smithy.api#required": {} } }, "warningUpdatedTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when the warning was last updated.
", "smithy.api#required": {} } }, "warningMessage": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The warning message about what needs to be corrected.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Represents a warning about a resource in a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#ResourceWarningStatus": { "type": "enum", "members": { "ACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "active" } }, "RESOLVED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "resolved" } } } }, "com.amazonaws.arcregionswitch#Resources": { "type": "list", "member": { "target": "smithy.api#String" } }, "com.amazonaws.arcregionswitch#RetryableConflictException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "resourceId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The identifier of the resource involved in the concurrent modification.
" } }, "resourceType": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The type of the resource involved in the concurrent modification.
" } } }, "traits": { "smithy.api#documentation": "The request conflicted with a concurrent modification of the same resource and did not take effect.
", "smithy.api#error": "client", "smithy.api#httpError": 409, "smithy.api#retryable": {} } }, "com.amazonaws.arcregionswitch#RoleArn": { "type": "string" }, "com.amazonaws.arcregionswitch#Route53HealthCheck": { "type": "structure", "members": { "hostedZoneId": { "target": "com.amazonaws.arcregionswitch#Route53HostedZoneId", "traits": { "smithy.api#documentation": "The Amazon Route 53 health check hosted zone ID.
", "smithy.api#required": {} } }, "recordName": { "target": "com.amazonaws.arcregionswitch#Route53RecordName", "traits": { "smithy.api#documentation": "The Amazon Route 53 record name.
", "smithy.api#required": {} } }, "healthCheckId": { "target": "com.amazonaws.arcregionswitch#Route53HealthCheckId", "traits": { "smithy.api#documentation": "The Amazon Route 53 health check ID.
" } }, "status": { "target": "com.amazonaws.arcregionswitch#Route53HealthCheckStatus", "traits": { "smithy.api#documentation": "The Amazon Route 53 health check status.
" } }, "region": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "smithy.api#documentation": "The Amazon Route 53 Region.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The Amazon Route 53 health check.
" } }, "com.amazonaws.arcregionswitch#Route53HealthCheckConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The Amazon Route 53 health check configuration time out (in minutes).
", "smithy.api#range": { "min": 1 } } }, "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "hostedZoneId": { "target": "com.amazonaws.arcregionswitch#Route53HostedZoneId", "traits": { "smithy.api#documentation": "The Amazon Route 53 health check configuration hosted zone ID.
", "smithy.api#required": {} } }, "recordName": { "target": "com.amazonaws.arcregionswitch#Route53RecordName", "traits": { "smithy.api#documentation": "The Amazon Route 53 health check configuration record name.
", "smithy.api#required": {} } }, "recordSets": { "target": "com.amazonaws.arcregionswitch#Route53ResourceRecordSetList", "traits": { "smithy.api#documentation": "The Amazon Route 53 health check configuration record sets.
" } } }, "traits": { "smithy.api#documentation": "The Amazon Route 53 health check configuration.
" } }, "com.amazonaws.arcregionswitch#Route53HealthCheckId": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 64 } } }, "com.amazonaws.arcregionswitch#Route53HealthCheckList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Route53HealthCheck" } }, "com.amazonaws.arcregionswitch#Route53HealthCheckStatus": { "type": "enum", "members": { "HEALTHY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "healthy" } }, "UNHEALTHY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "unhealthy" } }, "UNKNOWN": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "unknown" } } } }, "com.amazonaws.arcregionswitch#Route53HostedZoneId": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 32 } } }, "com.amazonaws.arcregionswitch#Route53RecordName": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 1024 } } }, "com.amazonaws.arcregionswitch#Route53ResourceRecordSet": { "type": "structure", "members": { "recordSetIdentifier": { "target": "com.amazonaws.arcregionswitch#Route53ResourceRecordSetIdentifier", "traits": { "smithy.api#documentation": "The Amazon Route 53 record set identifier.
" } }, "region": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "smithy.api#documentation": "The Amazon Route 53 record set Region.
" } } }, "traits": { "smithy.api#documentation": "The Amazon Route 53 record set.
" } }, "com.amazonaws.arcregionswitch#Route53ResourceRecordSetIdentifier": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 1024 } } }, "com.amazonaws.arcregionswitch#Route53ResourceRecordSetList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Route53ResourceRecordSet" } }, "com.amazonaws.arcregionswitch#RoutingControlArn": { "type": "string" }, "com.amazonaws.arcregionswitch#RoutingControlStateChange": { "type": "enum", "members": { "ON": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "On" } }, "OFF": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Off" } } } }, "com.amazonaws.arcregionswitch#S3ReportOutput": { "type": "structure", "members": { "s3ObjectKey": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The S3 object key where the generated report is stored.
" } } }, "traits": { "smithy.api#documentation": "Information about a report delivered to Amazon S3.
" } }, "com.amazonaws.arcregionswitch#S3ReportOutputConfiguration": { "type": "structure", "members": { "bucketPath": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The S3 bucket name and optional prefix where reports are stored. Format: bucket-name or bucket-name/prefix.
", "smithy.api#length": { "min": 3, "max": 512 }, "smithy.api#pattern": "^(?:s3://)?[a-z0-9][a-z0-9-]{1,61}[a-z0-9](?:/[^/ ][^/]*)*/?$" } }, "bucketOwner": { "target": "com.amazonaws.arcregionswitch#AccountId", "traits": { "smithy.api#documentation": "The Amazon Web Services account ID that owns the S3 bucket. Required to ensure the bucket is still owned by the same expected owner at generation time.
" } } }, "traits": { "smithy.api#documentation": "Configuration for delivering generated reports to an Amazon S3 bucket.
" } }, "com.amazonaws.arcregionswitch#Service": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross account role for a service.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the service.
" } }, "clusterArn": { "target": "com.amazonaws.arcregionswitch#EcsClusterArn", "traits": { "smithy.api#documentation": "The cluster Amazon Resource Name (ARN) for a service.
" } }, "serviceArn": { "target": "com.amazonaws.arcregionswitch#EcsServiceArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) for a service.
" } } }, "traits": { "smithy.api#documentation": "The service for a cross account role.
" } }, "com.amazonaws.arcregionswitch#ServiceList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Service" }, "traits": { "smithy.api#length": { "min": 2, "max": 2 } } }, "com.amazonaws.arcregionswitch#ServiceQuotaWarningStatus": { "type": "enum", "members": { "PENDING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pending" } }, "DENIED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "denied" } }, "INSUFFICIENT_PERMISSIONS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "insufficientPermissions" } }, "MAX_REGION_SWITCH_REQUESTS_EXCEEDED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "maxRegionSwitchRequestsExceeded" } }, "MAX_ACCOUNT_REQUESTS_EXCEEDED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "maxAccountRequestsExceeded" } } }, "traits": { "smithy.api#documentation": "The status of a service quota warning. Valid values:
pending - Region switch submitted a quota increase request that is still open.
denied - The quota increase request was denied.
insufficientPermissions - The plan's execution role is missing a permission that service quota checks require.
maxRegionSwitchRequestsExceeded - Region switch reached its limit on the number of open quota increase requests.
maxAccountRequestsExceeded - The account reached the maximum number of open quota increase requests.
The Amazon Web Services account ID that owns the plan that the warning applies to.
", "smithy.api#required": {} } }, "quotaRegion": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "smithy.api#documentation": "The Amazon Web Services Region that the quota applies to.
", "smithy.api#required": {} } }, "serviceCode": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The service code of the service that the quota belongs to, as defined in Service Quotas. For example, ec2.
The quota code of the quota that the warning applies to, as defined in Service Quotas.
" } }, "quotaName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name of the quota that the warning applies to, as defined in Service Quotas.
" } }, "status": { "target": "com.amazonaws.arcregionswitch#ServiceQuotaWarningStatus", "traits": { "smithy.api#documentation": "The status of the service quota warning.
", "smithy.api#required": {} } }, "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan that the warning applies to.
", "smithy.api#required": {} } }, "requestId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The ID of the quota increase request that Region switch submitted, if it submitted one for this quota.
" } }, "caseId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The ID of the support case associated with the quota increase request, if Region switch submitted one for this quota.
" } }, "warningMessage": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A message that describes the service quota warning.
" } }, "lastCheckedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The time (UTC) when Region switch last checked this quota.
" } }, "warningCreatedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The time (UTC) when Region switch created this warning.
" } } }, "traits": { "smithy.api#documentation": "A service quota warning for a plan. Region switch creates a warning when the applied quota value in one Region of a plan is lower than the value for the matching resource in another Region or account in the plan, or when it can't complete a service quota check.
" } }, "com.amazonaws.arcregionswitch#ServiceQuotaWarningSummaryList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#ServiceQuotaWarningSummary" } }, "com.amazonaws.arcregionswitch#SsmDocumentArn": { "type": "string", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Systems Manager document to run.
", "smithy.api#length": { "min": 20, "max": 256 }, "smithy.api#pattern": "^arn:[a-z0-9\\-]+:ssm:[a-z0-9\\-]+:([0-9]{12})?:document/[a-zA-Z0-9_.\\-]+$" } }, "com.amazonaws.arcregionswitch#SsmDocumentConfig": { "type": "structure", "members": { "crossAccountRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "smithy.api#documentation": "The cross-account role for the configuration.
" } }, "externalId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The external ID (secret key) for the configuration.
" } }, "documentArn": { "target": "com.amazonaws.arcregionswitch#SsmDocumentArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Systems Manager document to run.
", "smithy.api#required": {} } }, "targets": { "target": "com.amazonaws.arcregionswitch#SsmTargetList", "traits": { "smithy.api#documentation": "The target filters that Systems Manager resolves to managed nodes when the command runs. To target specific managed nodes, use the InstanceIds key. You can specify up to five target filters.
The parameters that are passed to this Region's Systems Manager document. You set parameters for each document, so each Region can run its document with its own parameters.
" } }, "documentVersion": { "target": "com.amazonaws.arcregionswitch#SsmDocumentVersion", "traits": { "smithy.api#documentation": "The version of the Systems Manager document to run for this Region. When you omit it, Systems Manager runs the document's default version.
" } } }, "traits": { "smithy.api#documentation": "The Systems Manager document to run and the managed nodes to target for a single Amazon Web Services Region.
" } }, "com.amazonaws.arcregionswitch#SsmDocumentParameters": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#SsmParameterKey" }, "value": { "target": "com.amazonaws.arcregionswitch#SsmParameterValues" }, "traits": { "smithy.api#documentation": "The parameters passed to the Systems Manager document.
", "smithy.api#length": { "max": 30 } } }, "com.amazonaws.arcregionswitch#SsmDocumentVersion": { "type": "string", "traits": { "smithy.api#documentation": "The version of the Systems Manager document to run.
", "smithy.api#length": { "min": 1, "max": 8 }, "smithy.api#pattern": "^([$]LATEST|[$]DEFAULT|[1-9][0-9]*)$" } }, "com.amazonaws.arcregionswitch#SsmParameterKey": { "type": "string", "traits": { "smithy.api#documentation": "The name of a Systems Manager document parameter.
", "smithy.api#length": { "min": 1, "max": 255 } } }, "com.amazonaws.arcregionswitch#SsmParameterValue": { "type": "string", "traits": { "smithy.api#documentation": "A single value supplied for a Systems Manager document parameter.
", "smithy.api#length": { "min": 1, "max": 65535 }, "smithy.api#pattern": "^.{1,65535}$" } }, "com.amazonaws.arcregionswitch#SsmParameterValues": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#SsmParameterValue" }, "traits": { "smithy.api#documentation": "The values supplied for a single Systems Manager document parameter.
", "smithy.api#length": { "min": 1, "max": 50 } } }, "com.amazonaws.arcregionswitch#SsmSendCommandConfiguration": { "type": "structure", "members": { "timeoutMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#default": 60, "smithy.api#documentation": "The timeout value specified for the configuration.
", "smithy.api#range": { "min": 1 } } }, "regionDocuments": { "target": "com.amazonaws.arcregionswitch#RegionSsmDocumentMap", "traits": { "smithy.api#documentation": "The Systems Manager document and target configuration for each Amazon Web Services Region in the plan. Provide an entry for each Amazon Web Services Region that you want the command to run in.
", "smithy.api#required": {} } }, "retryIntervalMinutes": { "target": "smithy.api#Float", "traits": { "smithy.api#documentation": "How often, in minutes, Region switch retries the command if it returns a failure.
", "smithy.api#required": {} } }, "ungraceful": { "target": "com.amazonaws.arcregionswitch#SsmSendCommandUngraceful", "traits": { "smithy.api#documentation": "Specifies the settings that determine how the execution block behaves when the plan runs ungracefully, such as whether to skip the command.
" } } }, "traits": { "smithy.api#documentation": "Configuration for an AWS Systems Manager SendCommand execution block in a Region switch plan. This execution block runs a Systems Manager document on the managed nodes that you target in each Amazon Web Services Region of the plan.
Specifies whether to skip running this command during an ungraceful execution. Set to skip to skip the command.
The ungraceful execution settings for an AWS Systems Manager SendCommand execution block.
The ungraceful behavior for an AWS Systems Manager SendCommand execution block, which must be set to skip.
The target key, such as tag:Environment or InstanceIds.
The values matched by this target key. Multiple values combine with a logical OR.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "A single SendCommand target filter, consisting of a target key and the values matched by that key.
A target key used to select managed nodes, such as tag:Environment or InstanceIds.
The target filters passed to SendCommand. You can specify up to five filters.
A single value matched by a target key.
", "smithy.api#length": { "min": 1, "max": 256 } } }, "com.amazonaws.arcregionswitch#SsmTargetValueList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#SsmTargetValue" }, "traits": { "smithy.api#documentation": "The values matched by a single target key.
", "smithy.api#length": { "min": 1, "max": 50 } } }, "com.amazonaws.arcregionswitch#StartPlanExecution": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#StartPlanExecutionRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#StartPlanExecutionResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#ConflictException" }, { "target": "com.amazonaws.arcregionswitch#IllegalArgumentException" }, { "target": "com.amazonaws.arcregionswitch#IllegalStateException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to start a plan execution" }, "smithy.api#documentation": "Starts the execution of a Region switch plan. You can execute a plan in either graceful or ungraceful mode.
Specifing ungraceful mode either changes the behavior of the execution blocks in a workflow or skips specific execution blocks.
The Amazon Resource Name (ARN) of the plan to execute.
", "smithy.api#required": {} } }, "targetRegion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The Amazon Web Services Region to target with this execution. This is the Region that traffic will be shifted to or from, depending on the action.
", "smithy.api#required": {} } }, "action": { "target": "com.amazonaws.arcregionswitch#ExecutionAction", "traits": { "smithy.api#documentation": "The action to perform. Valid values are activate (to shift traffic to the target Region) or deactivate (to shift traffic away from the target Region).
The plan execution mode. Valid values are graceful, for starting the execution in graceful mode, or ungraceful, for starting the execution in ungraceful mode.
An optional comment explaining why the plan execution is being started.
" } }, "latestVersion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A boolean value indicating whether to use the latest version of the plan. If set to false, you must specify a specific version.
" } }, "recoveryExecutionId": { "target": "com.amazonaws.arcregionswitch#RecoveryExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of the recovery execution that ran in the opposite region post-recovery is ran in. Required when starting a post-recovery execution.
" } }, "clientToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, the service ignores the request and returns the result of the original successful request. If you don't provide a client token, the service automatically generates one. For more information about idempotency, see Making retries safe with idempotent APIs.
", "smithy.api#idempotencyToken": {}, "smithy.api#length": { "min": 1, "max": 128 }, "smithy.api#pattern": "^[\\x21-\\x7E]+$" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#StartPlanExecutionResponse": { "type": "structure", "members": { "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
" } }, "plan": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The details of the Region switch plan.
" } }, "planVersion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The version of the plan, a unique number generated by Region switch.
" } }, "activateRegion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The Amazon Web Services Region to activate.
" } }, "deactivateRegion": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The Amazon Web Services Region to deactivate.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#Step": { "type": "structure", "members": { "name": { "target": "com.amazonaws.arcregionswitch#StepName", "traits": { "smithy.api#documentation": "The name of a step in a workflow.
", "smithy.api#required": {} } }, "description": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The description of a step in a workflow.
" } }, "executionBlockConfiguration": { "target": "com.amazonaws.arcregionswitch#ExecutionBlockConfiguration", "traits": { "smithy.api#documentation": "The configuration for an execution block in a workflow.
", "smithy.api#required": {} } }, "executionBlockType": { "target": "com.amazonaws.arcregionswitch#ExecutionBlockType", "traits": { "smithy.api#documentation": "The type of an execution block in a workflow.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Represents a step in a Region switch plan workflow. Each step performs a specific action during the Region switch process.
" } }, "com.amazonaws.arcregionswitch#StepName": { "type": "string" }, "com.amazonaws.arcregionswitch#StepState": { "type": "structure", "members": { "name": { "target": "com.amazonaws.arcregionswitch#StepName", "traits": { "smithy.api#documentation": "The name of a step in a workflow.
" } }, "status": { "target": "com.amazonaws.arcregionswitch#StepStatus", "traits": { "smithy.api#documentation": "The status of a step in a workflow. For example, a status might be Completed or Pending Approval.
" } }, "startTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when a step started execution.
" } }, "endTime": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when a step endeded execution.
" } }, "stepMode": { "target": "com.amazonaws.arcregionswitch#ExecutionMode", "traits": { "smithy.api#documentation": "The mode for a step execution. The mode can be Graceful or Ungraceful.
" } } }, "traits": { "smithy.api#documentation": "Represents the state of a step in a plan execution.
" } }, "com.amazonaws.arcregionswitch#StepStates": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#StepState" } }, "com.amazonaws.arcregionswitch#StepStatus": { "type": "enum", "members": { "NOT_STARTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "notStarted" } }, "RUNNING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "running" } }, "FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failed" } }, "COMPLETED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "completed" } }, "CANCELLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "canceled" } }, "SKIPPED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "skipped" } }, "PENDING_APPROVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pendingApproval" } } } }, "com.amazonaws.arcregionswitch#Steps": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Step" } }, "com.amazonaws.arcregionswitch#TagKey": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 128 } } }, "com.amazonaws.arcregionswitch#TagKeys": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#TagKey" }, "traits": { "smithy.api#length": { "min": 0, "max": 200 } } }, "com.amazonaws.arcregionswitch#TagResource": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#TagResourceRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#TagResourceResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#InternalServerException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}", "aws:RequestTag/${TagKey}", "aws:TagKeys" ], "aws.iam#iamAction": { "documentation": "Grants permission to tag a resource" }, "smithy.api#documentation": "Adds or updates tags for a Region switch resource. You can assign metadata to your resources in the form of tags, which are key-value pairs.
", "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#TagResourceRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) for a tag that you add to a resource.
", "smithy.api#required": {} } }, "tags": { "target": "com.amazonaws.arcregionswitch#Tags", "traits": { "smithy.api#documentation": "Tags that you add to a resource. You can add a maximum of 50 tags in Region switch.
", "smithy.api#required": {} } } }, "traits": { "aws.api#data": "tagging", "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#TagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#TagValue": { "type": "string", "traits": { "smithy.api#length": { "min": 0, "max": 256 } } }, "com.amazonaws.arcregionswitch#Tags": { "type": "map", "key": { "target": "com.amazonaws.arcregionswitch#TagKey" }, "value": { "target": "com.amazonaws.arcregionswitch#TagValue" }, "traits": { "smithy.api#length": { "min": 0, "max": 200 } } }, "com.amazonaws.arcregionswitch#Trigger": { "type": "structure", "members": { "description": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The description for a trigger.
" } }, "targetRegion": { "target": "com.amazonaws.arcregionswitch#Region", "traits": { "smithy.api#documentation": "The Amazon Web Services Region for a trigger.
", "smithy.api#required": {} } }, "action": { "target": "com.amazonaws.arcregionswitch#WorkflowTargetAction", "traits": { "smithy.api#documentation": "The action to perform when the trigger fires. Valid values include activate and deactivate.
The conditions that must be met for the trigger to fire.
", "smithy.api#required": {} } }, "minDelayMinutesBetweenExecutions": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The minimum time, in minutes, that must elapse between automatic executions of the plan.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Defines a condition that can automatically trigger the execution of a Region switch plan.
" } }, "com.amazonaws.arcregionswitch#TriggerCondition": { "type": "structure", "members": { "associatedAlarmName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name of the CloudWatch alarm associated with the condition.
", "smithy.api#required": {} } }, "condition": { "target": "com.amazonaws.arcregionswitch#AlarmCondition", "traits": { "smithy.api#documentation": "The condition that must be met. Valid values include green and red.
Defines a condition that must be met for a trigger to fire.
" } }, "com.amazonaws.arcregionswitch#TriggerConditionList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#TriggerCondition" }, "traits": { "smithy.api#length": { "min": 1, "max": 10 } } }, "com.amazonaws.arcregionswitch#TriggerList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Trigger" } }, "com.amazonaws.arcregionswitch#UntagResource": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#UntagResourceRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#UntagResourceResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#InternalServerException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#conditionKeys": [ "aws:ResourceTag/${TagKey}", "aws:TagKeys" ], "aws.iam#iamAction": { "documentation": "Grants permission to remove tags from a resource" }, "smithy.api#documentation": "Removes tags from a Region switch resource.
", "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#UntagResourceRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) for a tag you remove a resource from.
", "smithy.api#required": {} } }, "resourceTagKeys": { "target": "com.amazonaws.arcregionswitch#TagKeys", "traits": { "smithy.api#documentation": "Tag keys that you remove from a resource.
", "smithy.api#required": {} } } }, "traits": { "aws.api#data": "tagging", "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#UntagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#UpdatePlan": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#UpdatePlanRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#UpdatePlanResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" }, { "target": "com.amazonaws.arcregionswitch#RetryableConflictException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to update a plan" }, "smithy.api#documentation": "Updates an existing Region switch plan. You can modify the plan's description, workflows, execution role, recovery time objective, associated alarms, and triggers.
", "smithy.rules#staticContextParams": { "UseControlPlaneEndpoint": { "value": true } } } }, "com.amazonaws.arcregionswitch#UpdatePlanExecution": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecutionRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecutionResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#IllegalStateException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to update a plan execution" }, "smithy.api#documentation": "Updates an in-progress plan execution. This operation allows you to modify certain aspects of the execution, such as adding a comment or changing the action.
" } }, "com.amazonaws.arcregionswitch#UpdatePlanExecutionAction": { "type": "enum", "members": { "SWITCH_TO_GRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "switchToGraceful" } }, "SWITCH_TO_UNGRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "switchToUngraceful" } }, "PAUSE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pause" } }, "RESUME": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "resume" } } } }, "com.amazonaws.arcregionswitch#UpdatePlanExecutionRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan with the execution to update.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The execution identifier of a plan execution.
", "smithy.api#required": {} } }, "action": { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecutionAction", "traits": { "smithy.api#documentation": "The action specified for a plan execution, for example, Switch to Graceful or Pause.
", "smithy.api#required": {} } }, "comment": { "target": "com.amazonaws.arcregionswitch#ExecutionComment", "traits": { "smithy.api#documentation": "An optional comment about the plan execution.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#UpdatePlanExecutionResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#UpdatePlanExecutionStep": { "type": "operation", "input": { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecutionStepRequest" }, "output": { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecutionStepResponse" }, "errors": [ { "target": "com.amazonaws.arcregionswitch#AccessDeniedException" }, { "target": "com.amazonaws.arcregionswitch#ResourceNotFoundException" } ], "traits": { "aws.iam#iamAction": { "documentation": "Grants permission to update a plan execution step" }, "smithy.api#documentation": "Updates a specific step in an in-progress plan execution. This operation allows you to modify the step's comment or action.
" } }, "com.amazonaws.arcregionswitch#UpdatePlanExecutionStepAction": { "type": "enum", "members": { "SWITCH_TO_UNGRACEFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "switchToUngraceful" } }, "SKIP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "skip" } } } }, "com.amazonaws.arcregionswitch#UpdatePlanExecutionStepRequest": { "type": "structure", "members": { "planArn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan containing the execution step to update.
", "smithy.api#required": {} } }, "executionId": { "target": "com.amazonaws.arcregionswitch#ExecutionId", "traits": { "smithy.api#documentation": "The unique identifier of the plan execution containing the step to update.
", "smithy.api#required": {} } }, "comment": { "target": "com.amazonaws.arcregionswitch#ExecutionComment", "traits": { "smithy.api#documentation": "An optional comment about the plan execution.
", "smithy.api#required": {} } }, "stepName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name of the execution step to update.
", "smithy.api#required": {} } }, "actionToTake": { "target": "com.amazonaws.arcregionswitch#UpdatePlanExecutionStepAction", "traits": { "smithy.api#documentation": "The updated action to take for the step. This can be used to skip or retry a step.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#UpdatePlanExecutionStepResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#UpdatePlanRequest": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.arcregionswitch#PlanArn", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the plan.
", "smithy.api#required": {} } }, "description": { "target": "smithy.api#String", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The updated description for the Region switch plan.
" } }, "workflows": { "target": "com.amazonaws.arcregionswitch#WorkflowList", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The updated workflows for the Region switch plan.
", "smithy.api#required": {} } }, "executionRole": { "target": "com.amazonaws.arcregionswitch#IamRoleArn", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The updated IAM role ARN that grants Region switch the permissions needed to execute the plan steps.
", "smithy.api#required": {} } }, "recoveryTimeObjectiveMinutes": { "target": "smithy.api#Integer", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The updated target recovery time objective (RTO) in minutes for the plan.
", "smithy.api#range": { "min": 1, "max": 10080 } } }, "associatedAlarms": { "target": "com.amazonaws.arcregionswitch#AssociatedAlarmMap", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The updated CloudWatch alarms associated with the plan.
" } }, "triggers": { "target": "com.amazonaws.arcregionswitch#TriggerList", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The updated conditions that can automatically trigger the execution of the plan.
" } }, "reportConfiguration": { "target": "com.amazonaws.arcregionswitch#ReportConfiguration", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "The updated report configuration for the plan.
" } }, "serviceQuotaChecksEnabled": { "target": "smithy.api#Boolean", "traits": { "aws.cloudformation#cfnMutability": "full", "smithy.api#documentation": "Specifies whether service quota checks are enabled for the Region switch plan.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.arcregionswitch#UpdatePlanResponse": { "type": "structure", "members": { "plan": { "target": "com.amazonaws.arcregionswitch#Plan", "traits": { "smithy.api#documentation": "The details of the updated Region switch plan.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.arcregionswitch#WaitELBTargetGroupHealthy": { "type": "enum", "members": { "ENABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "enabled" } }, "DISABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "disabled" } } } }, "com.amazonaws.arcregionswitch#Workflow": { "type": "structure", "members": { "steps": { "target": "com.amazonaws.arcregionswitch#Steps", "traits": { "smithy.api#documentation": "The steps that make up the workflow.
" } }, "workflowTargetAction": { "target": "com.amazonaws.arcregionswitch#WorkflowTargetAction", "traits": { "smithy.api#documentation": "The action that the workflow performs. Valid values include activate and deactivate.
The Amazon Web Services Region that the workflow targets.
" } }, "workflowDescription": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The description of the workflow.
" } } }, "traits": { "smithy.api#documentation": "Represents a workflow in a Region switch plan. A workflow defines a sequence of steps to execute during a Region switch.
" } }, "com.amazonaws.arcregionswitch#WorkflowList": { "type": "list", "member": { "target": "com.amazonaws.arcregionswitch#Workflow" } }, "com.amazonaws.arcregionswitch#WorkflowTargetAction": { "type": "enum", "members": { "ACTIVATE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "activate" } }, "DEACTIVATE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "deactivate" } }, "POST_RECOVERY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "postRecovery" } } } } } }