기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GetRegionOptStatus
특정 지역의 옵트인 상태를 검색합니다.
요청 구문
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- AccountId
-
이 작업을 통해 액세스하거나 AWS 계정 수정하려는 12자리 계정 ID 번호를 지정합니다. 이 매개 변수를 지정하지 않으면 작업을 호출하는 데 사용되는 ID가 기본값으로 사용됩니다. AWS 계정 이 매개 변수를 사용하려면 호출자가 조직의 관리 계정에 있는 ID 또는 위임된 관리자 계정이어야 합니다. 또한 지정된 계정 ID는 같은 조직의 구성원 계정이어야 합니다. 조직에 모든 기능이 활성화되어 있어야 하고, 조직에 계정 관리 서비스에 대해 신뢰할 수 있는 액세스가 활성화되어 있어야 하며, 선택적으로 위임된 관리자 계정을 할당해야 합니다.
참고
관리 계정은 자체
AccountId계정을 지정할 수 없습니다.AccountId매개변수를 포함하지 않고 독립형 컨텍스트에서 작업을 호출해야 합니다.조직의 구성원이 아닌 계정에서 이 작업을 호출하려면 이 매개 변수를 지정하지 마세요. 대신 연락처를 검색하거나 수정하려는 계정의 ID를 사용하여 오퍼레이션을 호출하세요.
유형: String
패턴:
^\d{12}$필수 여부: 아니요
- RegionName
-
지정된 지역 이름 (예:) 의 지역 코드를 지정합니다.
af-south-1이 함수는 이 매개변수에 전달한 모든 지역의 상태를 반환합니다.유형: String
길이 제약: 최소 길이 1. 최대 길이 50.
필수 여부: 예
응답 구문
HTTP/1.1 200
Content-type: application/json
{
"RegionName": "string",
"RegionOptStatus": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- RegionName
-
전달된 지역 코드입니다.
유형: String
길이 제약: 최소 길이 1. 최대 길이 50.
- RegionOptStatus
-
지역이 겪을 수 있는 잠재적 상태 중 하나입니다 (활성화, 활성화, 비활성화, 비활성화, Enabled_By_Default).
유형: String
유효한 값:
ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT
오류
모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- AccessDeniedException
-
발신 ID에 필요한 최소 권한이 없어서 작업이 실패했습니다.
HTTP 상태 코드: 403
- InternalServerException
-
내부 오류로 인해 작업이 실패했습니다AWS. 나중에 작업을 다시 시도하세요.
HTTP 상태 코드: 500
- TooManyRequestsException
-
너무 자주 호출되어 스로틀 한도를 초과하여 작업이 실패했습니다.
HTTP 상태 코드: 429
- ValidationException
-
입력 매개 변수 중 하나가 유효하지 않아 작업이 실패했습니다.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요:
