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

# 영역 전환과 AWS CLI 함께를 사용하는 예
<a name="getting-started-cli-zonalshift"></a>

이 섹션에서는 영역 전환을 사용하고 AWS Command Line Interface 를 사용하여 API 작업을 사용하는 Amazon Application Recovery Controller(ARC)의 영역 전환 기능을 사용하는 애플리케이션 예제를 제공합니다. 이 예제는 CLI를 통해 영역 전환을 사용하는 방법을 기본적으로 이해하는 데 도움을 주기 위한 것입니다.

Amazon Application Recovery Controller(ARC)의 영역 전환을 통해 로드 밸런서의 트래픽을 일시적으로 가용 영역에서 다른 가용 영역으로 이동할 수 있으므로 애플리케이션이 AWS 리전의 다른 가용 영역에서도 정상적으로 계속 작동할 수 있습니다.

모든 영역 전환은 일시적이므로 처음에는 3일 이내에 만료되도록 설정해야 합니다. 하지만 나중에 영역 전환을 업데이트하여 새 만료를 설정할 수 있습니다.

사용에 대한 자세한 내용은 [AWS CLI 명령](https://docs.aws.amazon.com/cli/latest/reference/arc-zonal-shift/index.html) AWS CLI참조를 참조하세요. 영역 전환 API 작업 목록 및 자세한 정보 링크는 [영역 전환 API 작업](actions.zonalshift.md) 섹션을 참조하세요.

## 영역 전환 시작
<a name="getting-started-cli-zonalshift.start-zonal-shift"></a>

`start-zonal-shift` 명령을 사용하여 CLI에서 영역 전환을 시작할 수 있습니다.

```
aws arc-zonal-shift start-zonal-shift \
       --resource-identifier arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05 \
       --away-from use1-az1 \
       --expires-in 10m \
       --comment "Shifting traffic away from use1-az1"
```

```
{
    "awayFrom": "use1-az1",
    "comment": "Shifting traffic away from use1-az1",
    "expiryTime": "2024-12-17T21:37:26-08:00",
    "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
    "startTime": "2024-12-17T21:27:26-08:00",
    "status": "ACTIVE",
    "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38"
}
```

## 관리 리소스 가져오기
<a name="getting-started-cli-zonalshift.get-managed-resource"></a>

`get-managed-resource` 명령을 사용하여 CLI에서 관리 리소스에 대한 정보를 가져올 수 있습니다.

```
aws arc-zonal-shift get-managed-resource \
       --resource-identifier arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05
```

```
{
    "appliedWeights": {
        "use1-az1": 0.0,
        "use1-az2": 1.0,
        "use1-az6": 1.0
    },
    "arn": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
    "autoshifts": [],
    "name": "Testing",
    "zonalAutoshiftStatus": "DISABLED",
    "zonalShifts": [
        {
            "appliedStatus": "APPLIED",
            "awayFrom": "use1-az1",
            "comment": "Shifting traffic away from use1-az1",
            "expiryTime": "2024-12-17T21:37:26-08:00",
            "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
            "startTime": "2024-12-17T21:27:26-08:00",
            "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38"
            "shiftType": "MANUAL"
        }
    ]
}
```

## 관리 리소스 나열
<a name="getting-started-cli-zonalshift.list-managed-resource"></a>

`list-managed-resources` 명령을 사용하여 CLI에서 계정의 관리 리소스를 나열할 수 있습니다.

```
aws arc-zonal-shift list-managed-resources 
```

```
{
    "items": [
        {
            "appliedWeights": {
                "use1-az1": 0.0,
                "use1-az2": 1.0,
                "use1-az6": 1.0
            },
            "arn": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
            "autoshifts": [],
            "availabilityZones": [
                "use1-az1",
                "use1-az2",
                "use1-az6"
            ],
            "name": "Testing",
            "practiceRunStatus": "DISABLED",
            "zonalAutoshiftStatus": "DISABLED",
            "zonalShifts": [
                {
                    "appliedStatus": "APPLIED",
                    "awayFrom": "use1-az1",
                    "comment": "Shifting traffic away from use1-az1",
                    "expiryTime": "2024-12-17T21:37:26-08:00",
                    "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
                    "startTime": "2024-12-17T21:27:26-08:00",
                    "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38"
                }
            ]
        }
    ]
}
```

## 영역 전환 목록
<a name="getting-started-cli-zonalshift.list-zonal-shifts"></a>

`list-zonal-shifts` 명령을 사용하여 CLI를 통해 계정의 영역 전환을 나열할 수 있습니다.

```
aws arc-zonal-shift list-zonal-shifts 
```

```
{
    "items": [
        {
            "awayFrom": "use1-az1",
            "comment": "Shifting traffic away from use1-az1",
            "expiryTime": "2024-12-17T21:37:26-08:00",
            "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
            "startTime": "2024-12-17T21:27:26-08:00",
            "status": "ACTIVE",
            "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38"
        }
    ]
}
```

## 영역 전환 업데이트
<a name="getting-started-cli-zonalshift.update-zonal-shift"></a>

`update-zonal-shift` 명령을 사용하여 CLI로 영역 전환을 업데이트할 수 있습니다.

```
aws arc-zonal-shift update-zonal-shift \  
       --zonal-shift-id 9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38 \
       --expires-in 1h \
       --comment "Still shifting traffic away from use1-az1"
```

```
{
    "awayFrom": "use1-az1",
    "comment": "Still shifting traffic away from use1-az1",
    "expiryTime": "2024-12-17T22:29:38-08:00",
    "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
    "startTime": "2024-12-17T21:27:26-08:00",
    "status": "ACTIVE",
    "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38"
}
```

## 영역 전환 취소
<a name="getting-started-cli-zonalshift.cancel-zonal-shift"></a>

`cancel-zonal-shift` 명령을 사용하여 CLI에서 영역 전환을 취소할 수 있습니다.

```
aws arc-zonal-shift cancel-zonal-shift \
       --zonal-shift-id 9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38
```

```
{
    "awayFrom": "use1-az1",
    "comment": "Still shifting traffic away from use1-az1",
    "expiryTime": "2024-12-17T22:29:38-08:00",
    "resourceIdentifier": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/app/Testing/5a19403ecd42dc05",
    "startTime": "2024-12-17T21:27:26-08:00",
    "status": "CANCELED",
    "zonalShiftId": "9ac9ec1e-1df1-0755-3dc5-8cf573cd9c38"
}
```