Interface ArcRegionSwitchClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.
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. You can test your plans in practice mode before using them in a real recovery scenario.
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.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptiondefault ApprovePlanExecutionStepResponseapprovePlanExecutionStep(Consumer<ApprovePlanExecutionStepRequest.Builder> approvePlanExecutionStepRequest) Approves a step in a plan execution that requires manual approval.default ApprovePlanExecutionStepResponseapprovePlanExecutionStep(ApprovePlanExecutionStepRequest approvePlanExecutionStepRequest) Approves a step in a plan execution that requires manual approval.static ArcRegionSwitchClientBuilderbuilder()Create a builder that can be used to configure and create aArcRegionSwitchClient.default CancelPlanExecutionResponsecancelPlanExecution(Consumer<CancelPlanExecutionRequest.Builder> cancelPlanExecutionRequest) Cancels an in-progress plan execution.default CancelPlanExecutionResponsecancelPlanExecution(CancelPlanExecutionRequest cancelPlanExecutionRequest) Cancels an in-progress plan execution.static ArcRegionSwitchClientcreate()Create aArcRegionSwitchClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CreatePlanResponsecreatePlan(Consumer<CreatePlanRequest.Builder> createPlanRequest) Creates a new Region switch plan.default CreatePlanResponsecreatePlan(CreatePlanRequest createPlanRequest) Creates a new Region switch plan.default DeletePlanResponsedeletePlan(Consumer<DeletePlanRequest.Builder> deletePlanRequest) Deletes a Region switch plan.default DeletePlanResponsedeletePlan(DeletePlanRequest deletePlanRequest) Deletes a Region switch plan.default GetPlanResponsegetPlan(Consumer<GetPlanRequest.Builder> getPlanRequest) Retrieves detailed information about a Region switch plan.default GetPlanResponsegetPlan(GetPlanRequest getPlanRequest) Retrieves detailed information about a Region switch plan.default GetPlanEvaluationStatusResponsegetPlanEvaluationStatus(Consumer<GetPlanEvaluationStatusRequest.Builder> getPlanEvaluationStatusRequest) Retrieves the evaluation status of a Region switch plan.default GetPlanEvaluationStatusResponsegetPlanEvaluationStatus(GetPlanEvaluationStatusRequest getPlanEvaluationStatusRequest) Retrieves the evaluation status of a Region switch plan.default GetPlanEvaluationStatusIterablegetPlanEvaluationStatusPaginator(Consumer<GetPlanEvaluationStatusRequest.Builder> getPlanEvaluationStatusRequest) This is a variant ofgetPlanEvaluationStatus(software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusRequest)operation.default GetPlanEvaluationStatusIterablegetPlanEvaluationStatusPaginator(GetPlanEvaluationStatusRequest getPlanEvaluationStatusRequest) This is a variant ofgetPlanEvaluationStatus(software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusRequest)operation.default GetPlanExecutionResponsegetPlanExecution(Consumer<GetPlanExecutionRequest.Builder> getPlanExecutionRequest) Retrieves detailed information about a specific plan execution.default GetPlanExecutionResponsegetPlanExecution(GetPlanExecutionRequest getPlanExecutionRequest) Retrieves detailed information about a specific plan execution.default GetPlanExecutionIterablegetPlanExecutionPaginator(Consumer<GetPlanExecutionRequest.Builder> getPlanExecutionRequest) This is a variant ofgetPlanExecution(software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionRequest)operation.default GetPlanExecutionIterablegetPlanExecutionPaginator(GetPlanExecutionRequest getPlanExecutionRequest) This is a variant ofgetPlanExecution(software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionRequest)operation.default GetPlanInRegionResponsegetPlanInRegion(Consumer<GetPlanInRegionRequest.Builder> getPlanInRegionRequest) Retrieves information about a Region switch plan in a specific Amazon Web Services Region.default GetPlanInRegionResponsegetPlanInRegion(GetPlanInRegionRequest getPlanInRegionRequest) Retrieves information about a Region switch plan in a specific Amazon Web Services Region.default ListPlanExecutionEventsResponselistPlanExecutionEvents(Consumer<ListPlanExecutionEventsRequest.Builder> listPlanExecutionEventsRequest) Lists the events that occurred during a plan execution.default ListPlanExecutionEventsResponselistPlanExecutionEvents(ListPlanExecutionEventsRequest listPlanExecutionEventsRequest) Lists the events that occurred during a plan execution.default ListPlanExecutionEventsIterablelistPlanExecutionEventsPaginator(Consumer<ListPlanExecutionEventsRequest.Builder> listPlanExecutionEventsRequest) This is a variant oflistPlanExecutionEvents(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsRequest)operation.default ListPlanExecutionEventsIterablelistPlanExecutionEventsPaginator(ListPlanExecutionEventsRequest listPlanExecutionEventsRequest) This is a variant oflistPlanExecutionEvents(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsRequest)operation.default ListPlanExecutionsResponselistPlanExecutions(Consumer<ListPlanExecutionsRequest.Builder> listPlanExecutionsRequest) Lists the executions of a Region switch plan.default ListPlanExecutionsResponselistPlanExecutions(ListPlanExecutionsRequest listPlanExecutionsRequest) Lists the executions of a Region switch plan.default ListPlanExecutionsIterablelistPlanExecutionsPaginator(Consumer<ListPlanExecutionsRequest.Builder> listPlanExecutionsRequest) This is a variant oflistPlanExecutions(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsRequest)operation.default ListPlanExecutionsIterablelistPlanExecutionsPaginator(ListPlanExecutionsRequest listPlanExecutionsRequest) This is a variant oflistPlanExecutions(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsRequest)operation.default ListPlansResponselistPlans(Consumer<ListPlansRequest.Builder> listPlansRequest) Lists all Region switch plans in your Amazon Web Services account.default ListPlansResponselistPlans(ListPlansRequest listPlansRequest) Lists all Region switch plans in your Amazon Web Services account.default ListPlansInRegionResponselistPlansInRegion(Consumer<ListPlansInRegionRequest.Builder> listPlansInRegionRequest) Lists all Region switch plans in your Amazon Web Services account that are available in the current Amazon Web Services Region.default ListPlansInRegionResponselistPlansInRegion(ListPlansInRegionRequest listPlansInRegionRequest) Lists all Region switch plans in your Amazon Web Services account that are available in the current Amazon Web Services Region.default ListPlansInRegionIterablelistPlansInRegionPaginator(Consumer<ListPlansInRegionRequest.Builder> listPlansInRegionRequest) This is a variant oflistPlansInRegion(software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionRequest)operation.default ListPlansInRegionIterablelistPlansInRegionPaginator(ListPlansInRegionRequest listPlansInRegionRequest) This is a variant oflistPlansInRegion(software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionRequest)operation.default ListPlansIterablelistPlansPaginator(Consumer<ListPlansRequest.Builder> listPlansRequest) This is a variant oflistPlans(software.amazon.awssdk.services.arcregionswitch.model.ListPlansRequest)operation.default ListPlansIterablelistPlansPaginator(ListPlansRequest listPlansRequest) This is a variant oflistPlans(software.amazon.awssdk.services.arcregionswitch.model.ListPlansRequest)operation.default ListRoute53HealthChecksResponselistRoute53HealthChecks(Consumer<ListRoute53HealthChecksRequest.Builder> listRoute53HealthChecksRequest) List the Amazon Route 53 health checks.default ListRoute53HealthChecksResponselistRoute53HealthChecks(ListRoute53HealthChecksRequest listRoute53HealthChecksRequest) List the Amazon Route 53 health checks.default ListRoute53HealthChecksIterablelistRoute53HealthChecksPaginator(Consumer<ListRoute53HealthChecksRequest.Builder> listRoute53HealthChecksRequest) This is a variant oflistRoute53HealthChecks(software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksRequest)operation.default ListRoute53HealthChecksIterablelistRoute53HealthChecksPaginator(ListRoute53HealthChecksRequest listRoute53HealthChecksRequest) This is a variant oflistRoute53HealthChecks(software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksRequest)operation.default ListTagsForResourceResponselistTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Lists the tags attached to a Region switch resource.default ListTagsForResourceResponselistTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags attached to a Region switch resource.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationstatic ServiceMetadatadefault StartPlanExecutionResponsestartPlanExecution(Consumer<StartPlanExecutionRequest.Builder> startPlanExecutionRequest) Starts the execution of a Region switch plan.default StartPlanExecutionResponsestartPlanExecution(StartPlanExecutionRequest startPlanExecutionRequest) Starts the execution of a Region switch plan.default TagResourceResponsetagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds or updates tags for a Region switch resource.default TagResourceResponsetagResource(TagResourceRequest tagResourceRequest) Adds or updates tags for a Region switch resource.default UntagResourceResponseuntagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes tags from a Region switch resource.default UntagResourceResponseuntagResource(UntagResourceRequest untagResourceRequest) Removes tags from a Region switch resource.default UpdatePlanResponseupdatePlan(Consumer<UpdatePlanRequest.Builder> updatePlanRequest) Updates an existing Region switch plan.default UpdatePlanResponseupdatePlan(UpdatePlanRequest updatePlanRequest) Updates an existing Region switch plan.default UpdatePlanExecutionResponseupdatePlanExecution(Consumer<UpdatePlanExecutionRequest.Builder> updatePlanExecutionRequest) Updates an in-progress plan execution.default UpdatePlanExecutionResponseupdatePlanExecution(UpdatePlanExecutionRequest updatePlanExecutionRequest) Updates an in-progress plan execution.default UpdatePlanExecutionStepResponseupdatePlanExecutionStep(Consumer<UpdatePlanExecutionStepRequest.Builder> updatePlanExecutionStepRequest) Updates a specific step in an in-progress plan execution.default UpdatePlanExecutionStepResponseupdatePlanExecutionStep(UpdatePlanExecutionStepRequest updatePlanExecutionStepRequest) Updates a specific step in an in-progress plan execution.default ArcRegionSwitchWaiterwaiter()Create an instance ofArcRegionSwitchWaiterusing this client.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
approvePlanExecutionStep
default ApprovePlanExecutionStepResponse approvePlanExecutionStep(ApprovePlanExecutionStepRequest approvePlanExecutionStepRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
approvePlanExecutionStepRequest-- Returns:
- Result of the ApprovePlanExecutionStep operation returned by the service.
- See Also:
-
approvePlanExecutionStep
default ApprovePlanExecutionStepResponse approvePlanExecutionStep(Consumer<ApprovePlanExecutionStepRequest.Builder> approvePlanExecutionStepRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
ApprovePlanExecutionStepRequest.Builderavoiding the need to create one manually viaApprovePlanExecutionStepRequest.builder()- Parameters:
approvePlanExecutionStepRequest- AConsumerthat will call methods onApprovePlanExecutionStepRequest.Builderto create a request.- Returns:
- Result of the ApprovePlanExecutionStep operation returned by the service.
- See Also:
-
cancelPlanExecution
default CancelPlanExecutionResponse cancelPlanExecution(CancelPlanExecutionRequest cancelPlanExecutionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
cancelPlanExecutionRequest-- Returns:
- Result of the CancelPlanExecution operation returned by the service.
- See Also:
-
cancelPlanExecution
default CancelPlanExecutionResponse cancelPlanExecution(Consumer<CancelPlanExecutionRequest.Builder> cancelPlanExecutionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
CancelPlanExecutionRequest.Builderavoiding the need to create one manually viaCancelPlanExecutionRequest.builder()- Parameters:
cancelPlanExecutionRequest- AConsumerthat will call methods onCancelPlanExecutionRequest.Builderto create a request.- Returns:
- Result of the CancelPlanExecution operation returned by the service.
- See Also:
-
createPlan
default CreatePlanResponse createPlan(CreatePlanRequest createPlanRequest) throws AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
createPlanRequest-- Returns:
- Result of the CreatePlan operation returned by the service.
- See Also:
-
createPlan
default CreatePlanResponse createPlan(Consumer<CreatePlanRequest.Builder> createPlanRequest) throws AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
CreatePlanRequest.Builderavoiding the need to create one manually viaCreatePlanRequest.builder()- Parameters:
createPlanRequest- AConsumerthat will call methods onCreatePlanRequest.Builderto create a request.- Returns:
- Result of the CreatePlan operation returned by the service.
- See Also:
-
deletePlan
default DeletePlanResponse deletePlan(DeletePlanRequest deletePlanRequest) throws ResourceNotFoundException, IllegalStateException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
deletePlanRequest-- Returns:
- Result of the DeletePlan operation returned by the service.
- See Also:
-
deletePlan
default DeletePlanResponse deletePlan(Consumer<DeletePlanRequest.Builder> deletePlanRequest) throws ResourceNotFoundException, IllegalStateException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
DeletePlanRequest.Builderavoiding the need to create one manually viaDeletePlanRequest.builder()- Parameters:
deletePlanRequest- AConsumerthat will call methods onDeletePlanRequest.Builderto create a request.- Returns:
- Result of the DeletePlan operation returned by the service.
- See Also:
-
getPlan
default GetPlanResponse getPlan(GetPlanRequest getPlanRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, ArcRegionSwitchException Retrieves detailed information about a Region switch plan. You must specify the ARN of the plan.
- Parameters:
getPlanRequest-- Returns:
- Result of the GetPlan operation returned by the service.
- See Also:
-
getPlan
default GetPlanResponse getPlan(Consumer<GetPlanRequest.Builder> getPlanRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, ArcRegionSwitchException Retrieves detailed information about a Region switch plan. You must specify the ARN of the plan.
This is a convenience which creates an instance of the
GetPlanRequest.Builderavoiding the need to create one manually viaGetPlanRequest.builder()- Parameters:
getPlanRequest- AConsumerthat will call methods onGetPlanRequest.Builderto create a request.- Returns:
- Result of the GetPlan operation returned by the service.
- See Also:
-
getPlanEvaluationStatus
default GetPlanEvaluationStatusResponse getPlanEvaluationStatus(GetPlanEvaluationStatusRequest getPlanEvaluationStatusRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
getPlanEvaluationStatusRequest-- Returns:
- Result of the GetPlanEvaluationStatus operation returned by the service.
- See Also:
-
getPlanEvaluationStatus
default GetPlanEvaluationStatusResponse getPlanEvaluationStatus(Consumer<GetPlanEvaluationStatusRequest.Builder> getPlanEvaluationStatusRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
GetPlanEvaluationStatusRequest.Builderavoiding the need to create one manually viaGetPlanEvaluationStatusRequest.builder()- Parameters:
getPlanEvaluationStatusRequest- AConsumerthat will call methods onGetPlanEvaluationStatusRequest.Builderto create a request.- Returns:
- Result of the GetPlanEvaluationStatus operation returned by the service.
- See Also:
-
getPlanEvaluationStatusPaginator
default GetPlanEvaluationStatusIterable getPlanEvaluationStatusPaginator(GetPlanEvaluationStatusRequest getPlanEvaluationStatusRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
getPlanEvaluationStatus(software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanEvaluationStatusIterable responses = client.getPlanEvaluationStatusPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.GetPlanEvaluationStatusIterable responses = client .getPlanEvaluationStatusPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanEvaluationStatusIterable responses = client.getPlanEvaluationStatusPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getPlanEvaluationStatus(software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusRequest)operation.- Parameters:
getPlanEvaluationStatusRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
getPlanEvaluationStatusPaginator
default GetPlanEvaluationStatusIterable getPlanEvaluationStatusPaginator(Consumer<GetPlanEvaluationStatusRequest.Builder> getPlanEvaluationStatusRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
getPlanEvaluationStatus(software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanEvaluationStatusIterable responses = client.getPlanEvaluationStatusPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.GetPlanEvaluationStatusIterable responses = client .getPlanEvaluationStatusPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanEvaluationStatusIterable responses = client.getPlanEvaluationStatusPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getPlanEvaluationStatus(software.amazon.awssdk.services.arcregionswitch.model.GetPlanEvaluationStatusRequest)operation.
This is a convenience which creates an instance of the
GetPlanEvaluationStatusRequest.Builderavoiding the need to create one manually viaGetPlanEvaluationStatusRequest.builder()- Parameters:
getPlanEvaluationStatusRequest- AConsumerthat will call methods onGetPlanEvaluationStatusRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
getPlanExecution
default GetPlanExecutionResponse getPlanExecution(GetPlanExecutionRequest getPlanExecutionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Retrieves detailed information about a specific plan execution. You must specify the plan ARN and execution ID.
- Parameters:
getPlanExecutionRequest-- Returns:
- Result of the GetPlanExecution operation returned by the service.
- See Also:
-
getPlanExecution
default GetPlanExecutionResponse getPlanExecution(Consumer<GetPlanExecutionRequest.Builder> getPlanExecutionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Retrieves detailed information about a specific plan execution. You must specify the plan ARN and execution ID.
This is a convenience which creates an instance of the
GetPlanExecutionRequest.Builderavoiding the need to create one manually viaGetPlanExecutionRequest.builder()- Parameters:
getPlanExecutionRequest- AConsumerthat will call methods onGetPlanExecutionRequest.Builderto create a request.- Returns:
- Result of the GetPlanExecution operation returned by the service.
- See Also:
-
getPlanExecutionPaginator
default GetPlanExecutionIterable getPlanExecutionPaginator(GetPlanExecutionRequest getPlanExecutionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
getPlanExecution(software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanExecutionIterable responses = client.getPlanExecutionPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.GetPlanExecutionIterable responses = client .getPlanExecutionPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanExecutionIterable responses = client.getPlanExecutionPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getPlanExecution(software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionRequest)operation.- Parameters:
getPlanExecutionRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
getPlanExecutionPaginator
default GetPlanExecutionIterable getPlanExecutionPaginator(Consumer<GetPlanExecutionRequest.Builder> getPlanExecutionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
getPlanExecution(software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanExecutionIterable responses = client.getPlanExecutionPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.GetPlanExecutionIterable responses = client .getPlanExecutionPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.GetPlanExecutionIterable responses = client.getPlanExecutionPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
getPlanExecution(software.amazon.awssdk.services.arcregionswitch.model.GetPlanExecutionRequest)operation.
This is a convenience which creates an instance of the
GetPlanExecutionRequest.Builderavoiding the need to create one manually viaGetPlanExecutionRequest.builder()- Parameters:
getPlanExecutionRequest- AConsumerthat will call methods onGetPlanExecutionRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
getPlanInRegion
default GetPlanInRegionResponse getPlanInRegion(GetPlanInRegionRequest getPlanInRegionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
getPlanInRegionRequest-- Returns:
- Result of the GetPlanInRegion operation returned by the service.
- See Also:
-
getPlanInRegion
default GetPlanInRegionResponse getPlanInRegion(Consumer<GetPlanInRegionRequest.Builder> getPlanInRegionRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
GetPlanInRegionRequest.Builderavoiding the need to create one manually viaGetPlanInRegionRequest.builder()- Parameters:
getPlanInRegionRequest- AConsumerthat will call methods onGetPlanInRegionRequest.Builderto create a request.- Returns:
- Result of the GetPlanInRegion operation returned by the service.
- See Also:
-
listPlanExecutionEvents
default ListPlanExecutionEventsResponse listPlanExecutionEvents(ListPlanExecutionEventsRequest listPlanExecutionEventsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists the events that occurred during a plan execution. These events provide a detailed timeline of the execution process.
- Parameters:
listPlanExecutionEventsRequest-- Returns:
- Result of the ListPlanExecutionEvents operation returned by the service.
- See Also:
-
listPlanExecutionEvents
default ListPlanExecutionEventsResponse listPlanExecutionEvents(Consumer<ListPlanExecutionEventsRequest.Builder> listPlanExecutionEventsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists the events that occurred during a plan execution. These events provide a detailed timeline of the execution process.
This is a convenience which creates an instance of the
ListPlanExecutionEventsRequest.Builderavoiding the need to create one manually viaListPlanExecutionEventsRequest.builder()- Parameters:
listPlanExecutionEventsRequest- AConsumerthat will call methods onListPlanExecutionEventsRequest.Builderto create a request.- Returns:
- Result of the ListPlanExecutionEvents operation returned by the service.
- See Also:
-
listPlanExecutionEventsPaginator
default ListPlanExecutionEventsIterable listPlanExecutionEventsPaginator(ListPlanExecutionEventsRequest listPlanExecutionEventsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlanExecutionEvents(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionEventsIterable responses = client.listPlanExecutionEventsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionEventsIterable responses = client .listPlanExecutionEventsPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionEventsIterable responses = client.listPlanExecutionEventsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlanExecutionEvents(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsRequest)operation.- Parameters:
listPlanExecutionEventsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPlanExecutionEventsPaginator
default ListPlanExecutionEventsIterable listPlanExecutionEventsPaginator(Consumer<ListPlanExecutionEventsRequest.Builder> listPlanExecutionEventsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlanExecutionEvents(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionEventsIterable responses = client.listPlanExecutionEventsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionEventsIterable responses = client .listPlanExecutionEventsPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionEventsIterable responses = client.listPlanExecutionEventsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlanExecutionEvents(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionEventsRequest)operation.
This is a convenience which creates an instance of the
ListPlanExecutionEventsRequest.Builderavoiding the need to create one manually viaListPlanExecutionEventsRequest.builder()- Parameters:
listPlanExecutionEventsRequest- AConsumerthat will call methods onListPlanExecutionEventsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPlanExecutions
default ListPlanExecutionsResponse listPlanExecutions(ListPlanExecutionsRequest listPlanExecutionsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists the executions of a Region switch plan. This operation returns information about both current and historical executions.
- Parameters:
listPlanExecutionsRequest-- Returns:
- Result of the ListPlanExecutions operation returned by the service.
- See Also:
-
listPlanExecutions
default ListPlanExecutionsResponse listPlanExecutions(Consumer<ListPlanExecutionsRequest.Builder> listPlanExecutionsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists the executions of a Region switch plan. This operation returns information about both current and historical executions.
This is a convenience which creates an instance of the
ListPlanExecutionsRequest.Builderavoiding the need to create one manually viaListPlanExecutionsRequest.builder()- Parameters:
listPlanExecutionsRequest- AConsumerthat will call methods onListPlanExecutionsRequest.Builderto create a request.- Returns:
- Result of the ListPlanExecutions operation returned by the service.
- See Also:
-
listPlanExecutionsPaginator
default ListPlanExecutionsIterable listPlanExecutionsPaginator(ListPlanExecutionsRequest listPlanExecutionsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlanExecutions(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionsIterable responses = client.listPlanExecutionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionsIterable responses = client .listPlanExecutionsPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionsIterable responses = client.listPlanExecutionsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlanExecutions(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsRequest)operation.- Parameters:
listPlanExecutionsRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPlanExecutionsPaginator
default ListPlanExecutionsIterable listPlanExecutionsPaginator(Consumer<ListPlanExecutionsRequest.Builder> listPlanExecutionsRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlanExecutions(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionsIterable responses = client.listPlanExecutionsPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionsIterable responses = client .listPlanExecutionsPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlanExecutionsIterable responses = client.listPlanExecutionsPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlanExecutions(software.amazon.awssdk.services.arcregionswitch.model.ListPlanExecutionsRequest)operation.
This is a convenience which creates an instance of the
ListPlanExecutionsRequest.Builderavoiding the need to create one manually viaListPlanExecutionsRequest.builder()- Parameters:
listPlanExecutionsRequest- AConsumerthat will call methods onListPlanExecutionsRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPlans
default ListPlansResponse listPlans(ListPlansRequest listPlansRequest) throws AwsServiceException, SdkClientException, ArcRegionSwitchException Lists all Region switch plans in your Amazon Web Services account.
- Parameters:
listPlansRequest-- Returns:
- Result of the ListPlans operation returned by the service.
- See Also:
-
listPlans
default ListPlansResponse listPlans(Consumer<ListPlansRequest.Builder> listPlansRequest) throws AwsServiceException, SdkClientException, ArcRegionSwitchException Lists all Region switch plans in your Amazon Web Services account.
This is a convenience which creates an instance of the
ListPlansRequest.Builderavoiding the need to create one manually viaListPlansRequest.builder()- Parameters:
listPlansRequest- AConsumerthat will call methods onListPlansRequest.Builderto create a request.- Returns:
- Result of the ListPlans operation returned by the service.
- See Also:
-
listPlansPaginator
default ListPlansIterable listPlansPaginator(ListPlansRequest listPlansRequest) throws AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlans(software.amazon.awssdk.services.arcregionswitch.model.ListPlansRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansIterable responses = client.listPlansPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlansIterable responses = client.listPlansPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlansResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansIterable responses = client.listPlansPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlans(software.amazon.awssdk.services.arcregionswitch.model.ListPlansRequest)operation.- Parameters:
listPlansRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPlansPaginator
default ListPlansIterable listPlansPaginator(Consumer<ListPlansRequest.Builder> listPlansRequest) throws AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlans(software.amazon.awssdk.services.arcregionswitch.model.ListPlansRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansIterable responses = client.listPlansPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlansIterable responses = client.listPlansPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlansResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansIterable responses = client.listPlansPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlans(software.amazon.awssdk.services.arcregionswitch.model.ListPlansRequest)operation.
This is a convenience which creates an instance of the
ListPlansRequest.Builderavoiding the need to create one manually viaListPlansRequest.builder()- Parameters:
listPlansRequest- AConsumerthat will call methods onListPlansRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPlansInRegion
default ListPlansInRegionResponse listPlansInRegion(ListPlansInRegionRequest listPlansInRegionRequest) throws AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists all Region switch plans in your Amazon Web Services account that are available in the current Amazon Web Services Region.
- Parameters:
listPlansInRegionRequest-- Returns:
- Result of the ListPlansInRegion operation returned by the service.
- See Also:
-
listPlansInRegion
default ListPlansInRegionResponse listPlansInRegion(Consumer<ListPlansInRegionRequest.Builder> listPlansInRegionRequest) throws AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists all Region switch plans in your Amazon Web Services account that are available in the current Amazon Web Services Region.
This is a convenience which creates an instance of the
ListPlansInRegionRequest.Builderavoiding the need to create one manually viaListPlansInRegionRequest.builder()- Parameters:
listPlansInRegionRequest- AConsumerthat will call methods onListPlansInRegionRequest.Builderto create a request.- Returns:
- Result of the ListPlansInRegion operation returned by the service.
- See Also:
-
listPlansInRegionPaginator
default ListPlansInRegionIterable listPlansInRegionPaginator(ListPlansInRegionRequest listPlansInRegionRequest) throws AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlansInRegion(software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansInRegionIterable responses = client.listPlansInRegionPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlansInRegionIterable responses = client .listPlansInRegionPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansInRegionIterable responses = client.listPlansInRegionPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlansInRegion(software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionRequest)operation.- Parameters:
listPlansInRegionRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listPlansInRegionPaginator
default ListPlansInRegionIterable listPlansInRegionPaginator(Consumer<ListPlansInRegionRequest.Builder> listPlansInRegionRequest) throws AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listPlansInRegion(software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansInRegionIterable responses = client.listPlansInRegionPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListPlansInRegionIterable responses = client .listPlansInRegionPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListPlansInRegionIterable responses = client.listPlansInRegionPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listPlansInRegion(software.amazon.awssdk.services.arcregionswitch.model.ListPlansInRegionRequest)operation.
This is a convenience which creates an instance of the
ListPlansInRegionRequest.Builderavoiding the need to create one manually viaListPlansInRegionRequest.builder()- Parameters:
listPlansInRegionRequest- AConsumerthat will call methods onListPlansInRegionRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listRoute53HealthChecks
default ListRoute53HealthChecksResponse listRoute53HealthChecks(ListRoute53HealthChecksRequest listRoute53HealthChecksRequest) throws ResourceNotFoundException, AccessDeniedException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException List the Amazon Route 53 health checks.
- Parameters:
listRoute53HealthChecksRequest-- Returns:
- Result of the ListRoute53HealthChecks operation returned by the service.
- See Also:
-
listRoute53HealthChecks
default ListRoute53HealthChecksResponse listRoute53HealthChecks(Consumer<ListRoute53HealthChecksRequest.Builder> listRoute53HealthChecksRequest) throws ResourceNotFoundException, AccessDeniedException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException List the Amazon Route 53 health checks.
This is a convenience which creates an instance of the
ListRoute53HealthChecksRequest.Builderavoiding the need to create one manually viaListRoute53HealthChecksRequest.builder()- Parameters:
listRoute53HealthChecksRequest- AConsumerthat will call methods onListRoute53HealthChecksRequest.Builderto create a request.- Returns:
- Result of the ListRoute53HealthChecks operation returned by the service.
- See Also:
-
listRoute53HealthChecksPaginator
default ListRoute53HealthChecksIterable listRoute53HealthChecksPaginator(ListRoute53HealthChecksRequest listRoute53HealthChecksRequest) throws ResourceNotFoundException, AccessDeniedException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listRoute53HealthChecks(software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListRoute53HealthChecksIterable responses = client.listRoute53HealthChecksPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListRoute53HealthChecksIterable responses = client .listRoute53HealthChecksPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListRoute53HealthChecksIterable responses = client.listRoute53HealthChecksPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listRoute53HealthChecks(software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksRequest)operation.- Parameters:
listRoute53HealthChecksRequest-- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listRoute53HealthChecksPaginator
default ListRoute53HealthChecksIterable listRoute53HealthChecksPaginator(Consumer<ListRoute53HealthChecksRequest.Builder> listRoute53HealthChecksRequest) throws ResourceNotFoundException, AccessDeniedException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException This is a variant of
listRoute53HealthChecks(software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksRequest)operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle making service calls for you.When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
2) Using For loopsoftware.amazon.awssdk.services.arcregionswitch.paginators.ListRoute53HealthChecksIterable responses = client.listRoute53HealthChecksPaginator(request); responses.stream().forEach(....);{ @code software.amazon.awssdk.services.arcregionswitch.paginators.ListRoute53HealthChecksIterable responses = client .listRoute53HealthChecksPaginator(request); for (software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksResponse response : responses) { // do something; } }3) Use iterator directlysoftware.amazon.awssdk.services.arcregionswitch.paginators.ListRoute53HealthChecksIterable responses = client.listRoute53HealthChecksPaginator(request); responses.iterator().forEachRemaining(....);Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listRoute53HealthChecks(software.amazon.awssdk.services.arcregionswitch.model.ListRoute53HealthChecksRequest)operation.
This is a convenience which creates an instance of the
ListRoute53HealthChecksRequest.Builderavoiding the need to create one manually viaListRoute53HealthChecksRequest.builder()- Parameters:
listRoute53HealthChecksRequest- AConsumerthat will call methods onListRoute53HealthChecksRequest.Builderto create a request.- Returns:
- A custom iterable that can be used to iterate through all the response pages.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) throws ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists the tags attached to a Region switch resource.
- Parameters:
listTagsForResourceRequest-- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
listTagsForResource
default ListTagsForResourceResponse listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) throws ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException Lists the tags attached to a Region switch resource.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request.- Returns:
- Result of the ListTagsForResource operation returned by the service.
- See Also:
-
startPlanExecution
default StartPlanExecutionResponse startPlanExecution(StartPlanExecutionRequest startPlanExecutionRequest) throws ResourceNotFoundException, IllegalStateException, AccessDeniedException, IllegalArgumentException, AwsServiceException, SdkClientException, ArcRegionSwitchException Starts the execution of a Region switch plan. You can execute a plan in either PRACTICE or RECOVERY mode.
In PRACTICE mode, the execution simulates the steps without making actual changes to your application's traffic routing. In RECOVERY mode, the execution performs actual changes to shift traffic between Regions.
- Parameters:
startPlanExecutionRequest-- Returns:
- Result of the StartPlanExecution operation returned by the service.
- See Also:
-
startPlanExecution
default StartPlanExecutionResponse startPlanExecution(Consumer<StartPlanExecutionRequest.Builder> startPlanExecutionRequest) throws ResourceNotFoundException, IllegalStateException, AccessDeniedException, IllegalArgumentException, AwsServiceException, SdkClientException, ArcRegionSwitchException Starts the execution of a Region switch plan. You can execute a plan in either PRACTICE or RECOVERY mode.
In PRACTICE mode, the execution simulates the steps without making actual changes to your application's traffic routing. In RECOVERY mode, the execution performs actual changes to shift traffic between Regions.
This is a convenience which creates an instance of the
StartPlanExecutionRequest.Builderavoiding the need to create one manually viaStartPlanExecutionRequest.builder()- Parameters:
startPlanExecutionRequest- AConsumerthat will call methods onStartPlanExecutionRequest.Builderto create a request.- Returns:
- Result of the StartPlanExecution operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(TagResourceRequest tagResourceRequest) throws ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
tagResourceRequest-- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
tagResource
default TagResourceResponse tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) throws ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request.- Returns:
- Result of the TagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(UntagResourceRequest untagResourceRequest) throws ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException Removes tags from a Region switch resource.
- Parameters:
untagResourceRequest-- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
untagResource
default UntagResourceResponse untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) throws ResourceNotFoundException, InternalServerException, AwsServiceException, SdkClientException, ArcRegionSwitchException Removes tags from a Region switch resource.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request.- Returns:
- Result of the UntagResource operation returned by the service.
- See Also:
-
updatePlan
default UpdatePlanResponse updatePlan(UpdatePlanRequest updatePlanRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, ArcRegionSwitchException Updates an existing Region switch plan. You can modify the plan's description, workflows, execution role, recovery time objective, associated alarms, and triggers.
- Parameters:
updatePlanRequest-- Returns:
- Result of the UpdatePlan operation returned by the service.
- See Also:
-
updatePlan
default UpdatePlanResponse updatePlan(Consumer<UpdatePlanRequest.Builder> updatePlanRequest) throws ResourceNotFoundException, AwsServiceException, SdkClientException, ArcRegionSwitchException Updates an existing Region switch plan. You can modify the plan's description, workflows, execution role, recovery time objective, associated alarms, and triggers.
This is a convenience which creates an instance of the
UpdatePlanRequest.Builderavoiding the need to create one manually viaUpdatePlanRequest.builder()- Parameters:
updatePlanRequest- AConsumerthat will call methods onUpdatePlanRequest.Builderto create a request.- Returns:
- Result of the UpdatePlan operation returned by the service.
- See Also:
-
updatePlanExecution
default UpdatePlanExecutionResponse updatePlanExecution(UpdatePlanExecutionRequest updatePlanExecutionRequest) throws ResourceNotFoundException, IllegalStateException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
- Parameters:
updatePlanExecutionRequest-- Returns:
- Result of the UpdatePlanExecution operation returned by the service.
- See Also:
-
updatePlanExecution
default UpdatePlanExecutionResponse updatePlanExecution(Consumer<UpdatePlanExecutionRequest.Builder> updatePlanExecutionRequest) throws ResourceNotFoundException, IllegalStateException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException 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.
This is a convenience which creates an instance of the
UpdatePlanExecutionRequest.Builderavoiding the need to create one manually viaUpdatePlanExecutionRequest.builder()- Parameters:
updatePlanExecutionRequest- AConsumerthat will call methods onUpdatePlanExecutionRequest.Builderto create a request.- Returns:
- Result of the UpdatePlanExecution operation returned by the service.
- See Also:
-
updatePlanExecutionStep
default UpdatePlanExecutionStepResponse updatePlanExecutionStep(UpdatePlanExecutionStepRequest updatePlanExecutionStepRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Updates a specific step in an in-progress plan execution. This operation allows you to modify the step's comment or action.
- Parameters:
updatePlanExecutionStepRequest-- Returns:
- Result of the UpdatePlanExecutionStep operation returned by the service.
- See Also:
-
updatePlanExecutionStep
default UpdatePlanExecutionStepResponse updatePlanExecutionStep(Consumer<UpdatePlanExecutionStepRequest.Builder> updatePlanExecutionStepRequest) throws ResourceNotFoundException, AccessDeniedException, AwsServiceException, SdkClientException, ArcRegionSwitchException Updates a specific step in an in-progress plan execution. This operation allows you to modify the step's comment or action.
This is a convenience which creates an instance of the
UpdatePlanExecutionStepRequest.Builderavoiding the need to create one manually viaUpdatePlanExecutionStepRequest.builder()- Parameters:
updatePlanExecutionStepRequest- AConsumerthat will call methods onUpdatePlanExecutionStepRequest.Builderto create a request.- Returns:
- Result of the UpdatePlanExecutionStep operation returned by the service.
- See Also:
-
waiter
Create an instance ofArcRegionSwitchWaiterusing this client.Waiters created via this method are managed by the SDK and resources will be released when the service client is closed.
- Returns:
- an instance of
ArcRegionSwitchWaiter
-
create
Create aArcRegionSwitchClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aArcRegionSwitchClient. -
serviceMetadata
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-