영역 이동과 AWS CLI 함께 사용하는 예

이 섹션에서는 Amazon Application Recovery Controller (ARC) 에서 영역 이동 기능을 사용하기 AWS Command Line Interface 위해 를 사용하여 작업을 사용하는 영역 이동을 사용하는 API 간단한 애플리케이션 예제를 살펴봅니다. 이 예제는 를 사용하여 영역 이동을 처리하는 방법에 대한 기본적인 이해를 개발하는 데 도움을 주기 위한 것입니다. CLI

영역 이동을 ARC 통해 지원되는 리소스의 트래픽을 가용 영역에서 일시적으로 다른 가용 영역으로 이동하여 애플리케이션이 다른 가용 영역과 함께 정상적으로 작동할 수 있습니다. AWS 리전현재 영역 전환은 영역 간 로드 밸런싱이 꺼진 상태의 Network Load Balancer 및 Application Load Balancer를 지원됩니다.

AWS Command Line Interface를 사용하여 영역 전환을 시작하는 예를 살펴보겠습니다. AWS CLI 를 사용하여 영역 전환을 업데이트할 수도 있습니다(예: 새 만료 설정). 모든 영역 전환은 일시적이므로 처음에는 3일 이내에 만료되도록 설정해야 합니다. 하지만 나중에 영역 전환을 업데이트하여 새 만료를 설정할 수 있습니다.

사용에 대한 자세한 내용은 명령 AWS CLI참조를 참조하십시오.AWS CLI 영역 이동 API 동작 목록과 자세한 정보 링크는 을 참조하십시오구역 이동 작업 API.

영역 전환 시작

명령을 사용하여 영역 이동을 CLI 시작할 수 있습니다. start-zonal-shift

aws arc-zonal-shift start-zonal-shift \
      --resource-identifier="arn:aws:testservice::111122223333:ExampleALB123456890" \
      --away-from="usw2-az1" \
      --expires-in="5m" \
      --comment="Shifting traffic away from USW2-AZ1"

{
   "zonalShiftId": "2222222-3333-444-1111",
   "resourceIdentifier": "arn:aws:testservice::111122223333:ExampleALB123456890",
   "awayFrom": "usw2-az1",
   "expiryTime": 2022-11-14T01:40:42+00:00,
   "startTime": 2022-11-14T01:35:42+00:00,
   "status": "ACTIVE",
   "comment": "Shifting traffic away from USW2-AZ1"
}

관리 리소스 가져오기

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

aws arc-zonal-shift get-managed-resource \
   --resource-identifier="arn:aws:testservice::111122223333:ExampleALB123456890

{
    "arn": "arn:aws:testservice::111122223333:ExampleALB123456890",
    "name": "TestResource",
    "appliedWeights": {
        "usw2-az1": 1.0,
        "usw2-az2": 1.0,
        "usw2-az3": 1.0
    },
    "zonalShifts": []
}

관리 리소스 나열

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

aws arc-zonal-shift list-managed-resources 

{
    "items": [
        {
            "arn": "arn:aws:testservice::111122223333:ExampleALB123456890",
            "name": "TestResource",
            "availabilityZones": [
                "usw2-az1",
                "usw2-az2",
                "usw2-az3"
            ]
        }
    ]
}

영역 전환 나열

명령을 사용하여 계정의 영역 이동을 나열할 수 있습니다. CLI list-zonal-shifts

aws arc-zonal-shift list-zonal-shifts 

{
    "items": [
        {
            "zonalShiftId": "2222222-3333-444-1111",
            "resourceIdentifier": "arn:aws:testservice::111122223333:ExampleALB123456890",
            "awayFrom": "usw2-az1",
            "expiryTime": 2022-11-15T09:10:42+00:00,
            "startTime": 2022-11-13T01:35:42+00:00,
            "status": "ACTIVE",
            "comment": "Shifting traffic away from USW2-AZ1"
        }
    ]
}

영역 전환 업데이트

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

aws arc-zonal-shift update-zonal-shift \
   --zonal-shift-id="="arn:aws:testservice::111122223333:ExampleALB123456890" \
   --expires-in="1h" \
   --comment="Still shifting traffic away from USW2-AZ1"

{
    "zonalShiftId": "2222222-3333-444-1111",
    "resourceIdentifier": "arn:aws:testservice::111122223333:ExampleALB123456890",
    "awayFrom": "usw2-az1",
    "expiryTime": 2022-11-15T10:35:42+00:00,
    "startTime": 2022-11-15T09:35:42+00:00,
    "status": "ACTIVE",
    "comment": "Still shifting traffic away from USW2-AZ1"
}

영역 전환 취소

명령을 사용하여 영역 이동을 CLI 취소할 수 있습니다. cancel-zonal-shift

aws arc-zonal-shift cancel-zonal-shift \
   --zonal-shift-id="="arn:aws:testservice::111122223333:ExampleALB123456890" 

{
    "zonalShiftId": "2222222-3333-444-1111",
    "resourceIdentifier": "arn:aws:testservice::111122223333:ExampleALB123456890",
    "awayFrom": "usw2-az1",
    "expiryTime": 2022-11-15T10:35:42+00:00,
    "startTime": 2022-11-15T09:35:42+00:00,
    "status": "CANCELED",
    "comment": "Shifting traffic away from USW2-AZ1"
}