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

# HTTP 쿼리 요청을 통한 API 호출
<a name="orgs_query-requests"></a>

이 섹션에는 쿼리 API 사용에 대한 일반적인 정보가 포함되어 있습니다 AWS Organizations. API 작업 및 오류에 대한 자세한 정보는 [AWS Organizations API 참조](https://docs.aws.amazon.com/organizations/latest/APIReference/)를 참조하세요.

**참고**  
 AWS Organizations 쿼리 API를 직접 호출하는 AWS 대신 SDKs. AWS SDKs는 다양한 프로그래밍 언어 및 플랫폼(Java, Ruby, .NET, iOS, Android 등)을 위한 라이브러리와 샘플 코드로 구성됩니다. SDKs는 AWS Organizations 및에 프로그래밍 방식으로 액세스할 수 있는 편리한 방법을 제공합니다 AWS. 예를 들어 SDK는 요청에 암호화 방식으로 서명, 오류 관리 및 자동으로 요청 재시도와 같은 작업을 처리합니다. 다운로드 및 설치 방법을 포함하여 AWS SDKs에 대한 자세한 내용은 [Amazon Web Services용 도구를](https://aws.amazon.com/tools/) 참조하세요.

용 쿼리 API AWS Organizations 를 사용하면 서비스 작업을 호출할 수 있습니다. 쿼리 API 요청은 수행할 작업을 나타내는 `Action` 파라미터를 포함해야 하는 HTTPS 요청입니다.는 모든 작업에 대해 GET 및 POST 요청을 AWS Organizations 지원합니다. 즉, API 사용 시 어떤 작업에는 GET을 사용하고 또 어떤 작업에는 POST를 사용할 필요가 없습니다. 하지만 GET 요청에는 URL 크기 제한이 적용됩니다. 제한은 브라우저에 따라 다르지만, 일반적으로 2,048바이트입니다. 따라서 더 큰 크기가 필요한 쿼리 API 요청의 경우 POST 요청을 사용해야 합니다.

응답은 XML 문서입니다. 응답에 대한 자세한 정보는 [AWS Organizations API 참조](https://docs.aws.amazon.com/organizations/latest/APIReference/)의 개별 작업 페이지를 참조하세요.

**Topics**
+ [엔드포인트](#OrgsEndpoints)
+ [HTTPS 필요](#IAMHTTPSRequired)
+ [AWS Organizations API 요청 서명](#SigVersion)

## 엔드포인트
<a name="OrgsEndpoints"></a>

AWS Organizations 에는 미국 동부(버지니아 북부) 리전에서 호스팅되는 단일 글로벌 API 엔드포인트가 있습니다.

모든 서비스의 AWS 엔드포인트 및 리전에 대한 자세한 내용은의 [리전 엔드포인트](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints)를 참조하세요*AWS 일반 참조*.

## HTTPS 필요
<a name="IAMHTTPSRequired"></a>

쿼리 API는 보안 자격 증명과 같이 민감한 정보를 반환하므로 HTTPS를 이용해 모든 API 요청을 암호화해야 합니다.

## AWS Organizations API 요청 서명
<a name="SigVersion"></a>

액세스 키 ID와 보안 액세스 키를 사용하여 요청에 서명해야 합니다. 일상적인 작업에 자격 AWS 계정 루트 사용자 증명을 사용하지 않는 것이 좋습니다 AWS Organizations. 그 대신 사용자나 역할의 보안 인증 정보를 사용하면 됩니다.

API 요청에 서명하려면 AWS 서명 버전 4를 사용해야 합니다. 서명 버전 4 사용에 대한 자세한 내용은 *IAM 사용 설명서*의 [AWS API 요청 서명을](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) 참조하세요.

AWS Organizations 는 서명 버전 2와 같은 이전 버전을 지원하지 않습니다.

자세한 내용은 다음을 참조하세요.
+ [AWS 보안 자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) - 액세스에 사용할 수 있는 자격 증명 유형에 대한 일반 정보를 제공합니다 AWS.
+ [IAM의 보안 모범 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) - IAM 서비스를 사용하여의 리소스를 포함한 AWS 리소스를 보호하는 데 도움이 되는 제안을 제공합니다 AWS Organizations.
+ [IAM의 임시 자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) – 임시 보안 자격 증명을 생성하고 사용하는 방법에 대해 설명합니다.