기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 를 사용하여 라우팅 제어 및 상태 나열 및 업데이트 AWS CLI
<a name="getting-started-cli-routing.control-state"></a>

Amazon Application Recovery Controller(ARC) 리소스(예: 클러스터, 라우팅 제어, 컨트롤 패널)를 생성한 후 클러스터와 상호 작용하여 장애 조치에 대한 라우팅 제어 상태를 나열하고 업데이트할 수 있습니다.

생성한 각 클러스터에 대해 ARC는 클러스터 엔드포인트 세트를 5개의 AWS 리전당 하나씩 제공합니다. 클러스터를 호출하여 라우팅 제어 상태를 `On` 또는 로 검색하거나 설정할 때 이러한 리전 엔드포인트( AWS 리전 및 엔드포인트 URL) 중 하나를 지정해야 합니다`Off`. 를 사용하여 라우팅 제어 상태를 AWS CLI가져오거나 업데이트할 때 리전 엔드포인트 외에도이 섹션`--region`의 예제와 같이 리전 엔드포인트의 도 지정해야 합니다.

모든 리전 클러스터 엔드포인트를 사용할 수 있습니다. 시스템이 리전 엔드포인트를 순환하도록 설정하고, 사용 가능한 각 엔드포인트로 재시도할 수 있도록 준비하는 것이 좋습니다. 클러스터 엔드포인트를 순서대로 시도하는 방법을 보여주는 코드 샘플은 [AWS SDKs를 사용하는 애플리케이션 복구 컨트롤러에 대한 작업](service_code_examples_actions.md) 섹션을 참조하세요.

사용에 대한 자세한 내용은 AWS CLI 명령 AWS CLI참조를 참조하세요. 라우팅 제어 API 작업 목록 및 자세한 정보 링크는 [라우팅 제어 API 작업](actions.routing-control.md) 섹션을 참조하세요.

**중요**  
Amazon Route 53 콘솔에서 라우팅 제어 상태를 업데이트할 수 있지만 AWS CLI 또는 AWS SDK를 사용하여 [라우팅 제어 상태를 업데이트](routing-control.update.api.md)하는 것이 좋습니다. ARC는 ARC 라우팅 제어 데이터 영역을 통해 트래픽을 다시 라우팅하고 셀 간에 장애 조치를 수행하는 데 있어 최고의 신뢰성을 제공합니다. ARC를 사용하여 장애 조치를 수행하는 방법에 대한 자세한 권장 사항은 [ARC 라우팅 제어 모범 사례](route53-arc-best-practices.regional.md) 섹션을 참조하세요.

라우팅 제어를 생성하면 상태가 `Off`로 설정됩니다. 즉, 트래픽이 해당 라우팅 제어의 대상 셀로 라우팅되지 않습니다. `get-routing-control-state` 명령을 실행하여 라우팅 제어의 상태를 확인할 수 있습니다.

지정할 리전 및 엔드포인트를 결정하려면 `describe-clusters` 명령을 실행하여 `ClusterEndpoints`를 확인합니다. 각 `ClusterEndpoint`에는 라우팅 제어 상태를 가져오거나 업데이트하는 데 사용할 수 있는 리전 및 해당 엔드포인트가 포함되어 있습니다. * [DescribeCluster](https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster-clusterarn.html)는 복구 제어 구성 API 작업입니다. ARC리전 클러스터 엔드포인트의 로컬 사본을 북마크에 보관하거나 엔드포인트를 재시도하는 데 사용하는 자동화 코드로 하드코딩하여 보관하는 것이 좋습니다.*

## 1. 라우팅 제어 나열
<a name="getting-started-cli-routing.view-rc"></a>

매우 안정적인 ARC 데이터 영역 엔드포인트를 사용하여 라우팅 제어 및 라우팅 제어 상태를 볼 수 있습니다.

1. 특정 컨트롤 패널의 라우팅 제어를 나열합니다. 컨트롤 패널을 지정하지 않으면 `list-routing-controls`는 클러스터의 모든 라우팅 제어를 반환합니다.

```
aws route53-recovery-cluster list-routing-controls --control-panel-arn \
        arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456 \ 
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{
    "RoutingControls": [{
        "ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
        "ControlPanelName": "ExampleControlPanel",
        "RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
        "RoutingControlName": "RCOne",
        "RoutingControlState": "On"
    },
    {
        "ControlPanelArn": "arn:aws:route53-recovery-control::023759465626:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
        "ControlPanelName": "ExampleControlPanel",
        "RoutingControlArn": "arn:aws:route53-recovery-control::023759465626:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/zzzzxxxxyyyy123456",
        "RoutingControlName": "RCTwo",
        "RoutingControlState": "Off"
    }
]
```

## 2. 라우팅 제어 확인하기
<a name="getting-started-cli-routing.get-rc"></a>

2. 라우팅 제어 상태를 가져옵니다.

```
aws route53-recovery-cluster get-routing-control-state --routing-control-arn \
        arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567 \
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
    "RoutingControlName": "RCOne",
    "RoutingControlState": "On"
}
```

## 2. 라우팅 제어 업데이트
<a name="getting-started-cli-routing.update-rc"></a>

라우팅 제어로 제어되는 대상 엔드포인트로 트래픽을 라우팅하려면 라우팅 제어 상태를 `On`으로 업데이트합니다. `update-routing-control-state` 명령을 실행하여 라우팅 제어 상태를 업데이트합니다. (요청이 성공하면 응답이 비어 있습니다.)

2a. 라우팅 제어 상태를 업데이트합니다.

```
aws route53-recovery-cluster update-routing-control-state \
        --routing-control-arn \
        arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567 \
        --routing-control-state On \
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{}
```

한 번의 API 직접 호출로 여러 라우팅 제어를 동시에 업데이트할 수 있습니다. `update-routing-control-states` (요청이 성공하면 응답이 비어 있습니다.)

2b. 여러 라우팅 제어 상태를 한 번에 업데이트(일괄 업데이트)합니다.

```
aws route53-recovery-cluster update-routing-control-states \
        --update-routing-control-state-entries \
        '[{"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
        "RoutingControlState": "Off"}, \
        {"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/hijklmnop987654321",
        "RoutingControlState": "On"}]' \
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{}
```