本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 应用程序恢复控制器的代码示例 AWS SDKs
以下代码示例展示了如何将应用程序恢复控制器与 AWS 软件开发套件 (SDK) 配合使用。
*操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
有关 S AWS DK 开发者指南和代码示例的完整列表，请参阅[将此服务与 AWS SDK 配合使用](sdk-general-information-section.md)。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。
**Contents**
+ [基本功能](service_code_examples_basics.md)
+ [操作](service_code_examples_actions.md)
+ [`GetRoutingControlState`](example_route53-recovery-cluster_GetRoutingControlState_section.md)
+ [`UpdateRoutingControlState`](example_route53-recovery-cluster_UpdateRoutingControlState_section.md)
# 应用程序恢复控制器的基本示例 AWS SDKs
以下代码示例展示了如何将 Amazon Route 53 应用程序恢复控制器的基础知识与配合使用 AWS SDKs。
**Contents**
+ [操作](service_code_examples_actions.md)
+ [`GetRoutingControlState`](example_route53-recovery-cluster_GetRoutingControlState_section.md)
+ [`UpdateRoutingControlState`](example_route53-recovery-cluster_UpdateRoutingControlState_section.md)
# 应用程序恢复控制器使用的操作 AWS SDKs
以下代码示例演示了如何使用执行单个应用程序恢复控制器操作 AWS SDKs。每个示例都包含一个指向的链接 GitHub，您可以在其中找到有关设置和运行代码的说明。
以下示例仅包括最常用的操作。有关完整列表，请参阅 [Amazon Route 53 应用程序恢复控制器 API 参考](https://docs.aws.amazon.com/routing-control/latest/APIReference/Welcome.html)。
**Topics**
+ [`GetRoutingControlState`](example_route53-recovery-cluster_GetRoutingControlState_section.md)
+ [`UpdateRoutingControlState`](example_route53-recovery-cluster_UpdateRoutingControlState_section.md)
# 与 AWS SDK `GetRoutingControlState` 配合使用
以下代码示例演示如何使用 `GetRoutingControlState`。
------
#### [ Java ]
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53recoverycluster#code-examples)中查找完整示例，了解如何进行设置和运行。
```
public static GetRoutingControlStateResponse getRoutingControlState(List clusterEndpoints,
String routingControlArn) {
// As a best practice, we recommend choosing a random cluster endpoint to get or
// set routing control states.
// For more information, see
// https://docs.aws.amazon.com/r53recovery/latest/dg/route53-arc-best-practices.html#route53-arc-best-practices.regional
Collections.shuffle(clusterEndpoints);
for (ClusterEndpoint clusterEndpoint : clusterEndpoints) {
try {
System.out.println(clusterEndpoint);
Route53RecoveryClusterClient client = Route53RecoveryClusterClient.builder()
.endpointOverride(URI.create(clusterEndpoint.endpoint()))
.region(Region.of(clusterEndpoint.region())).build();
return client.getRoutingControlState(
GetRoutingControlStateRequest.builder()
.routingControlArn(routingControlArn).build());
} catch (Exception exception) {
System.out.println(exception);
}
}
return null;
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[GetRoutingControlState](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53-recovery-cluster-2019-12-02/GetRoutingControlState)*中的。
------
#### [ Python ]
**适用于 Python 的 SDK（Boto3）**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/route53-recovery-cluster#code-examples)中查找完整示例，了解如何进行设置和运行。
```
import boto3
def create_recovery_client(cluster_endpoint):
"""
Creates a Boto3 Route 53 Application Recovery Controller client for the specified
cluster endpoint URL and AWS Region.
:param cluster_endpoint: The cluster endpoint URL and Region.
:return: The Boto3 client.
"""
return boto3.client(
"route53-recovery-cluster",
endpoint_url=cluster_endpoint["Endpoint"],
region_name=cluster_endpoint["Region"],
)
def get_routing_control_state(routing_control_arn, cluster_endpoints):
"""
Gets the state of a routing control. Cluster endpoints are tried in
sequence until the first successful response is received.
:param routing_control_arn: The ARN of the routing control to look up.
:param cluster_endpoints: The list of cluster endpoints to query.
:return: The routing control state response.
"""
# As a best practice, we recommend choosing a random cluster endpoint to get or set routing control states.
# For more information, see https://docs.aws.amazon.com/r53recovery/latest/dg/route53-arc-best-practices.html#route53-arc-best-practices.regional
random.shuffle(cluster_endpoints)
for cluster_endpoint in cluster_endpoints:
try:
recovery_client = create_recovery_client(cluster_endpoint)
response = recovery_client.get_routing_control_state(
RoutingControlArn=routing_control_arn
)
return response
except Exception as error:
print(error)
raise error
```
+ 有关 API 的详细信息，请参阅适用[GetRoutingControlState](https://docs.aws.amazon.com/goto/boto3/route53-recovery-cluster-2019-12-02/GetRoutingControlState)于 *Python 的AWS SDK (Boto3) API 参考*。
------
#### [ SAP ABAP ]
**适用于 SAP ABAP 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/r5v#code-examples)中查找完整示例，了解如何进行设置和运行。
```
CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
DATA lo_exception TYPE REF TO /aws1/cx_rt_generic.
DATA lo_session TYPE REF TO /aws1/cl_rt_session_base.
DATA lo_client TYPE REF TO /aws1/if_r5v.
DATA lt_endpoints TYPE TABLE OF string.
DATA lv_endpoint TYPE string.
DATA lv_region TYPE /aws1/rt_region_id.
" Parse the comma-separated cluster endpoints
" Expected format: "https://endpoint1.com|us-west-2,https://endpoint2.com|us-east-1"
SPLIT iv_cluster_endpoints AT ',' INTO TABLE lt_endpoints.
" As a best practice, shuffle cluster endpoints to distribute load
" For more information, see https://docs.aws.amazon.com/r53recovery/latest/dg/route53-arc-best-practices.html#route53-arc-best-practices.regional
" For simplicity, we'll try them in order (shuffling can be added if needed)
" Try each endpoint in order
LOOP AT lt_endpoints INTO lv_endpoint.
TRY.
" Parse endpoint and region from the format "url|region"
DATA(lv_pos) = find( val = lv_endpoint sub = '|' ).
IF lv_pos > 0.
DATA(lv_url) = substring( val = lv_endpoint len = lv_pos ).
lv_region = substring( val = lv_endpoint off = lv_pos + 1 ).
ELSE.
" If no region specified, use default
lv_url = lv_endpoint.
lv_region = 'us-east-1'.
ENDIF.
" Create session for this region
lo_session = /aws1/cl_rt_session_aws=>create( cv_pfl ).
" Create client with the specific endpoint
lo_client = create_recovery_client(
iv_endpoint = lv_url
iv_region = lv_region
io_session = lo_session ).
" Try to get the routing control state
oo_result = lo_client->getroutingcontrolstate(
iv_routingcontrolarn = iv_routing_control_arn ).
" If successful, return the result
RETURN.
CATCH /aws1/cx_r5vendpttmpyunavailex INTO DATA(lo_endpoint_ex).
" This endpoint is temporarily unavailable, try the next one
lo_exception = lo_endpoint_ex.
CONTINUE.
CATCH /aws1/cx_r5vaccessdeniedex
/aws1/cx_r5vinternalserverex
/aws1/cx_r5vresourcenotfoundex
/aws1/cx_r5vthrottlingex
/aws1/cx_r5vvalidationex
/aws1/cx_rt_generic INTO lo_exception.
" For other errors, re-raise immediately
RAISE EXCEPTION lo_exception.
ENDTRY.
ENDLOOP.
" If we get here, all endpoints failed - re-raise the last exception
IF lo_exception IS BOUND.
RAISE EXCEPTION lo_exception.
ENDIF.
```
+ 有关 API 的详细信息，请参阅适用[GetRoutingControlState](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)于 S *AP 的AWS SDK ABAP API 参考*。
------
有关 S AWS DK 开发者指南和代码示例的完整列表，请参阅[将此服务与 AWS SDK 配合使用](sdk-general-information-section.md)。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。
# 与 AWS SDK `UpdateRoutingControlState` 配合使用
以下代码示例演示如何使用 `UpdateRoutingControlState`。
------
#### [ Java ]
**适用于 Java 的 SDK 2.x**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53recoverycluster#code-examples)中查找完整示例，了解如何进行设置和运行。
```
public static UpdateRoutingControlStateResponse updateRoutingControlState(List clusterEndpoints,
String routingControlArn,
String routingControlState) {
// As a best practice, we recommend choosing a random cluster endpoint to get or
// set routing control states.
// For more information, see
// https://docs.aws.amazon.com/r53recovery/latest/dg/route53-arc-best-practices.html#route53-arc-best-practices.regional
Collections.shuffle(clusterEndpoints);
for (ClusterEndpoint clusterEndpoint : clusterEndpoints) {
try {
System.out.println(clusterEndpoint);
Route53RecoveryClusterClient client = Route53RecoveryClusterClient.builder()
.endpointOverride(URI.create(clusterEndpoint.endpoint()))
.region(Region.of(clusterEndpoint.region()))
.build();
return client.updateRoutingControlState(
UpdateRoutingControlStateRequest.builder()
.routingControlArn(routingControlArn).routingControlState(routingControlState).build());
} catch (Exception exception) {
System.out.println(exception);
}
}
return null;
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[UpdateRoutingControlState](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53-recovery-cluster-2019-12-02/UpdateRoutingControlState)*中的。
------
#### [ Python ]
**适用于 Python 的 SDK（Boto3）**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/route53-recovery-cluster#code-examples)中查找完整示例，了解如何进行设置和运行。
```
import boto3
def create_recovery_client(cluster_endpoint):
"""
Creates a Boto3 Route 53 Application Recovery Controller client for the specified
cluster endpoint URL and AWS Region.
:param cluster_endpoint: The cluster endpoint URL and Region.
:return: The Boto3 client.
"""
return boto3.client(
"route53-recovery-cluster",
endpoint_url=cluster_endpoint["Endpoint"],
region_name=cluster_endpoint["Region"],
)
def update_routing_control_state(
routing_control_arn, cluster_endpoints, routing_control_state
):
"""
Updates the state of a routing control. Cluster endpoints are tried in
sequence until the first successful response is received.
:param routing_control_arn: The ARN of the routing control to update the state for.
:param cluster_endpoints: The list of cluster endpoints to try.
:param routing_control_state: The new routing control state.
:return: The routing control update response.
"""
# As a best practice, we recommend choosing a random cluster endpoint to get or set routing control states.
# For more information, see https://docs.aws.amazon.com/r53recovery/latest/dg/route53-arc-best-practices.html#route53-arc-best-practices.regional
random.shuffle(cluster_endpoints)
for cluster_endpoint in cluster_endpoints:
try:
recovery_client = create_recovery_client(cluster_endpoint)
response = recovery_client.update_routing_control_state(
RoutingControlArn=routing_control_arn,
RoutingControlState=routing_control_state,
)
return response
except Exception as error:
print(error)
```
+ 有关 API 的详细信息，请参阅适用[UpdateRoutingControlState](https://docs.aws.amazon.com/goto/boto3/route53-recovery-cluster-2019-12-02/UpdateRoutingControlState)于 *Python 的AWS SDK (Boto3) API 参考*。
------
#### [ SAP ABAP ]
**适用于 SAP ABAP 的 SDK**
还有更多相关信息 GitHub。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/r5v#code-examples)中查找完整示例，了解如何进行设置和运行。
```
CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
DATA lo_exception TYPE REF TO /aws1/cx_rt_generic.
DATA lo_session TYPE REF TO /aws1/cl_rt_session_base.
DATA lo_client TYPE REF TO /aws1/if_r5v.
DATA lt_endpoints TYPE TABLE OF string.
DATA lv_endpoint TYPE string.
DATA lv_region TYPE /aws1/rt_region_id.
" Parse the comma-separated cluster endpoints
" Expected format: "https://endpoint1.com|us-west-2,https://endpoint2.com|us-east-1"
SPLIT iv_cluster_endpoints AT ',' INTO TABLE lt_endpoints.
" As a best practice, shuffle cluster endpoints to distribute load
" For more information, see https://docs.aws.amazon.com/r53recovery/latest/dg/route53-arc-best-practices.html#route53-arc-best-practices.regional
" For simplicity, we'll try them in order (shuffling can be added if needed)
" Try each endpoint in order
LOOP AT lt_endpoints INTO lv_endpoint.
TRY.
" Parse endpoint and region from the format "url|region"
DATA(lv_pos) = find( val = lv_endpoint sub = '|' ).
IF lv_pos > 0.
DATA(lv_url) = substring( val = lv_endpoint len = lv_pos ).
lv_region = substring( val = lv_endpoint off = lv_pos + 1 ).
ELSE.
" If no region specified, use default
lv_url = lv_endpoint.
lv_region = 'us-east-1'.
ENDIF.
" Create session for this region
lo_session = /aws1/cl_rt_session_aws=>create( cv_pfl ).
" Create client with the specific endpoint
lo_client = create_recovery_client(
iv_endpoint = lv_url
iv_region = lv_region
io_session = lo_session ).
" Try to update the routing control state
oo_result = lo_client->updateroutingcontrolstate(
iv_routingcontrolarn = iv_routing_control_arn
iv_routingcontrolstate = iv_routing_control_state
it_safetyrulestooverride = it_safety_rules_override ).
" If successful, return the result
RETURN.
CATCH /aws1/cx_r5vendpttmpyunavailex INTO DATA(lo_endpoint_ex).
" This endpoint is temporarily unavailable, try the next one
lo_exception = lo_endpoint_ex.
CONTINUE.
CATCH /aws1/cx_r5vaccessdeniedex
/aws1/cx_r5vconflictexception
/aws1/cx_r5vinternalserverex
/aws1/cx_r5vresourcenotfoundex
/aws1/cx_r5vthrottlingex
/aws1/cx_r5vvalidationex
/aws1/cx_rt_generic INTO lo_exception.
" For other errors, re-raise immediately
RAISE EXCEPTION lo_exception.
ENDTRY.
ENDLOOP.
" If we get here, all endpoints failed - re-raise the last exception
IF lo_exception IS BOUND.
RAISE EXCEPTION lo_exception.
ENDIF.
```
+ 有关 API 的详细信息，请参阅适用[UpdateRoutingControlState](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)于 S *AP 的AWS SDK ABAP API 参考*。
------
有关 S AWS DK 开发者指南和代码示例的完整列表，请参阅[将此服务与 AWS SDK 配合使用](sdk-general-information-section.md)。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。