기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
HTTP 쿼리 요청을 통한 API 호출
이 섹션에는 쿼리 API 사용에 대한 일반적인 정보가 포함되어 있습니다 AWS Organizations. API 작업 및 오류에 대한 자세한 정보는 AWS Organizations API 참조를 참조하세요.
참고
AWS Organizations 쿼리 API를 직접 호출하는 AWS 대신 SDKs. AWS SDKs는 다양한 프로그래밍 언어 및 플랫폼(Java, Ruby, .NET, iOS, Android 등)을 위한 라이브러리 및 샘플 코드로 구성됩니다. SDKs는 AWS Organizations 및에 프로그래밍 방식으로 액세스할 수 있는 편리한 방법을 제공합니다 AWS. 예를 들어 SDK는 요청에 암호화 방식으로 서명, 오류 관리 및 자동으로 요청 재시도와 같은 작업을 처리합니다. 다운로드 및 설치 방법을 포함하여 AWS SDKs에 대한 자세한 내용은 Amazon Web Services용 도구를
용 쿼리 API AWS Organizations 를 사용하면 서비스 작업을 호출할 수 있습니다. 쿼리 API 요청은 수행할 작업을 나타내는 Action 파라미터를 포함해야 하는 HTTPS 요청입니다.는 모든 작업에 대해 GET 및 POST 요청을 AWS Organizations 지원합니다. 즉, API 사용 시 어떤 작업에는 GET을 사용하고 또 어떤 작업에는 POST를 사용할 필요가 없습니다. 하지만 GET 요청에는 URL 크기 제한이 적용됩니다. 제한은 브라우저에 따라 다르지만, 일반적으로 2,048바이트입니다. 따라서 더 큰 크기가 필요한 쿼리 API 요청의 경우 POST 요청을 사용해야 합니다.
응답은 XML 문서입니다. 응답에 대한 자세한 정보는 AWS Organizations API 참조의 개별 작업 페이지를 참조하세요.
엔드포인트
AWS Organizations 에는 미국 동부(버지니아 북부) 리전에서 호스팅되는 단일 글로벌 API 엔드포인트가 있습니다.
모든 서비스의 AWS 엔드포인트 및 리전에 대한 자세한 내용은의 리전 엔드포인트를 참조하세요AWS 일반 참조.
HTTPS 필요
쿼리 API는 보안 자격 증명과 같이 민감한 정보를 반환하므로 HTTPS를 이용해 모든 API 요청을 암호화해야 합니다.
AWS Organizations API 요청 서명
액세스 키 ID와 보안 액세스 키를 사용하여 요청에 서명해야 합니다. 일상적인 작업에는 AWS 계정 루트 사용자 자격 증명을 사용하지 않는 것이 좋습니다 AWS Organizations. 그 대신 사용자나 역할의 보안 인증 정보를 사용하면 됩니다.
API 요청에 서명하려면 AWS 서명 버전 4를 사용해야 합니다. 서명 버전 4 사용에 대한 자세한 내용은 IAM 사용 설명서의 AWS API 요청 서명을 참조하세요.
AWS Organizations 는 서명 버전 2와 같은 이전 버전을 지원하지 않습니다.
자세한 내용은 다음 자료를 참조하세요.
-
AWS 보안 자격 증명 - 액세스에 사용할 수 있는 자격 증명 유형에 대한 일반적인 정보를 제공합니다 AWS.
-
IAM의 보안 모범 사례 - IAM 서비스를 사용하여의 리소스를 포함한 AWS 리소스를 보호하는 데 도움이 되는 제안을 제공합니다 AWS Organizations.
-
IAM의 임시 자격 증명 – 임시 보안 자격 증명을 생성하고 사용하는 방법에 대해 설명합니다.
