本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 提出 HTTP 查詢請求以呼叫 API
<a name="orgs_query-requests"></a>

本節包含有關使用查詢 API 的一般資訊 AWS Organizations。如需 API 操作和錯誤的詳細資訊，請參閱 [AWS Organizations API 參考](https://docs.aws.amazon.com/organizations/latest/APIReference/)。

**注意**  
您可以使用其中一個 AWS SDKs，而不是直接呼叫 AWS Organizations 查詢 API。 AWS SDKs包含適用於各種程式設計語言和平台 (Java、Ruby、.NET、iOS、Android 等） 的程式庫和範本程式碼。SDKs提供便捷的方式來建立 AWS Organizations 和 的程式設計存取 AWS。例如，開發套件會負責的工作諸如以密碼演算法簽署請求、管理錯誤以及自動重試請求。如需 AWS SDKs 的相關資訊，包括如何下載和安裝，請參閱[適用於 Amazon Web Services 的工具](https://aws.amazon.com/tools/)。

的查詢 API AWS Organizations 可讓您呼叫 服務動作。查詢 API 請求是 HTTPS 請求，必須包含 `Action` 參數以指出要執行的操作。 AWS Organizations 支援所有操作的 GET 和 POST 請求。也就是說，API 不會要求您在某些動作上使用 GET，在其他動作上使用 POST。不過，GET 請求受限於 URL 的限制大小。此限制取決於瀏覽器，但一般限制為 2048 個位元組。因此，對於需要較大流量的查詢 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 Signature 第 4 版。如需使用 Signature 第 4 版的詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。

AWS Organizations 不支援舊版，例如 Signature 第 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) – 描述如何建立和使用暫時性安全憑證。