ListRegions - AWS 계정 관리

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

ListRegions

지정된 계정의 모든 리전과 해당 옵트인 상태를 나열합니다. 선택적으로 이 목록은 region-opt-status-contains 파라미터로 필터링할 수 있습니다.

Request Syntax

POST /listRegions HTTP/1.1 Content-type: application/json { "AccountId": "string", "MaxResults": number, "NextToken": "string", "RegionOptStatusContains": [ "string" ] }

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

AccountId

이 작업으로 액세스하거나 수정하려는 AWS 계정의 12자리 계정 ID 번호를 지정합니다. 이 파라미터를 지정하지 않으면 작업을 호출하는 데 사용되는 자격 증명의 기본값은 Amazon Web Services 계정입니다. 이 파라미터를 사용하려면 발신자가 조직의 관리 계정 또는 위임된 관리자 계정의 자격 증명이어야 합니다. 지정된 계정 ID는 동일한 조직의 멤버 계정이어야 합니다. 조직은 모든 기능을 활성화해야 하며, 계정 관리 서비스에 대해 신뢰할 수 있는 액세스가 활성화되어 있어야 하고, 선택 사항으로 위임된 관리자 계정이 할당되어 있어야 합니다.

참고

관리 계정은 자체 AccountId를 지정할 수 없습니다. AccountId 파라미터를 포함하지 않고 독립 실행형 컨텍스트에서 작업을 호출해야 합니다.

조직의 멤버가 아닌 계정에서 이 작업을 호출하려면 이 파라미터를 지정하지 마세요. 대신 연락처가 검색하거나 수정하려는 계정에 속한 자격 증명을 사용하여 작업을 호출합니다.

유형: String

패턴: ^\d{12}$

Required: No

MaxResults

명령의 출력에서 반환되는 항목의 총 수입니다. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우 명령의 출력에 NextToken이 제공됩니다. 페이지 매김을 재개하려면 후속 명령의 starting-token 인수에 NextToken 값을 제공합니다. AWS CLI 외부에서 직접 NextToken 응답 요소를 사용하면 안 됩니다. 사용 예시는 AWS 명령줄 인터페이스 사용 설명서페이지 매김 섹션을 참조하세요.

타입: 정수

유효 범위: 최소값 1. 최대값 50.

필수 항목 여부: 아니요

NextToken

페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답에서 도출된 NextToken입니다. 사용 예시는 AWS 명령줄 인터페이스 사용 설명서페이지 매김 섹션을 참조하세요.

유형: 문자열

길이 제한: 최소 길이는 0. 최대 길이는 1,000입니다.

필수 항목 여부: 아니요

RegionOptStatusContains

지정된 계정의 리전 목록을 필터링하는 데 사용할 리전 상태 목록(활성화 중, 활성화됨, 비활성화 중, 비활성화됨, 기본값으로 활성화됨)입니다. 예를 들어 ENABLING 값을 전달하면 리전 상태가 ENABLING인 리전 목록만 반환됩니다.

타입: 문자열 배열

유효 값: ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT

필수 항목 여부: 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Regions": [ { "RegionName": "string", "RegionOptStatus": "string" } ] }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

NextToken

반환해야 할 데이터가 더 있는 경우 이 데이터가 채워집니다. list-regionsnext-token 요청 파라미터로 전달해야 합니다.

유형: 문자열

Regions

지정된 계정의 리전 목록이거나 필터링된 파라미터가 사용된 경우 filter 파라미터에 설정된 필터 기준과 일치하는 리전 목록입니다.

타입: Region 객체 배열

Errors

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.

AccessDeniedException

호출 자격 증명에 최소 필수 권한이 없어 작업이 실패했습니다.

HTTP 상태 코드: 403

InternalServerException

AWS 내부 오류로 인해 작업이 실패했습니다. 나중에 작업을 다시 시도하세요.

HTTP 상태 코드: 500

TooManyRequestsException

너무 잦은 호출 및 스로틀 제한 초과로 인해 작업이 실패했습니다.

HTTP 상태 코드: 429

ValidationException

입력 파라미터 중 하나가 유효하지 않아 작업이 실패했습니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.