本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # API 參考 Account Management (`account`) 命名空間中的 API 操作可讓您修改 AWS 帳戶。 每個 都 AWS 帳戶 支援具有帳戶相關資訊的中繼資料，包括最多三個與該帳戶相關聯的替代聯絡人的相關資訊。這些是與 帳戶[根使用者](root-user.md)相關聯的電子郵件地址的補充。您只能指定下列其中一個與 帳戶相關聯的聯絡類型。 + 帳單聯絡人 + 操作聯絡人 + 安全聯絡人 根據預設，本指南中討論的 API 操作會直接套用至呼叫操作的帳戶。帳戶中呼叫 操作的[身分](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)通常是 IAM 角色或 IAM 使用者，且必須具有 IAM 政策所套用的許可，才能呼叫 API 操作。或者，您可以從管理帳戶中的身分呼叫這些 API AWS Organizations 操作，並為組織成員的任何 AWS 帳戶 指定帳戶 ID 號碼。 **API 版本** 此版本的帳戶 API 參考會記錄帳戶管理 API 2021-02-01 版。 **注意** 除了直接使用 API 之外，您也可以使用其中一個 AWS SDKs，其中包含適用於各種程式設計語言和平台 (Java、Ruby、.NET、iOS、Android 等） 的程式庫和範本程式碼。SDKs提供便捷的方式來建立對 AWS Organizations 的程式設計存取。例如，SDKs會處理密碼編譯簽署請求、管理錯誤，以及自動重試請求。如需 AWS SDKs 的詳細資訊，包括如何下載和安裝，請參閱[適用於 Amazon Web Services 的工具](https://console.aws.amazon.com/)。 我們建議您使用 AWS SDKs 對帳戶管理服務進行程式設計 API 呼叫。不過，您也可以使用帳戶管理查詢 API 直接呼叫帳戶管理 Web 服務。若要進一步了解帳戶管理查詢 API，請參閱《帳戶管理使用者指南[提出 HTTP 查詢請求以呼叫 API](query-requests.md)》中的 。Organizations 支援所有動作的 GET 和 POST 請求。也就是說，API 不會要求您在某些動作上使用 GET，在其他動作上使用 POST。不過，GET 請求受限於 URL 的限制大小。因此，對於需要較大大小的操作，請使用 POST 請求。 **簽署請求** 當您傳送 HTTP 請求到 時 AWS，您必須簽署請求， AWS 才能識別傳送請求的對象。您可以使用 AWS 存取金鑰簽署請求，其中包含存取金鑰 ID 和私密存取金鑰。強烈建議您不要為根帳戶建立存取金鑰。擁有根帳戶存取金鑰的任何人，都能不受限制地存取您帳戶中的所有資源。反之，請為具有管理權限的 IAM 使用者建立存取金鑰。另一個選項是使用 AWS Security Token Service 來產生臨時安全登入資料，並使用這些登入資料來簽署請求。 若要簽署請求，建議您使用 Signature 第 4 版。如果您有使用 Signature 第 2 版的現有應用程式，則不需要將其更新為使用 Signature 第 4 版。不過，有些操作現在需要 Signature 第 4 版。需要第 4 版的操作文件指出此需求。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。 當您使用 AWS 命令列界面 (AWS CLI) 或其中一個 AWS SDKs 來向 發出請求時 AWS，這些工具會自動使用您在設定工具時指定的存取金鑰來簽署請求。 **帳戶管理的支援和意見回饋** 我們誠摯歡迎您提供意見回饋。請將您的意見傳送至 [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com)，或在[帳戶管理支援論壇](https://forums.aws.amazon.com/forum.jspa?forumID=219)中張貼您的意見回饋和問題。如需 AWS 支援論壇的詳細資訊，請參閱[論壇說明](https://forums.aws.amazon.com/help.jspa)。 **如何呈現範例** Account Management 傳回做為請求回應的 JSON 會以單一長字串傳回，沒有換行或格式化空格。本指南中的範例會同時顯示換行和空格，以改善可讀性。當範例輸入參數也會導致超出畫面的長字串時，我們會插入換行符號以增強可讀性。您應該一律以單一 JSON 文字字串的形式提交輸入。 **記錄 API 請求** Account Management 支援 CloudTrail，這項服務會記錄 的 AWS API 呼叫 AWS 帳戶 ，並將日誌檔案交付至 Amazon S3 儲存貯體。透過使用 CloudTrail 收集的資訊，您可以判斷哪些請求已成功向帳戶管理提出、誰提出請求、何時提出請求等。如需 Account Management 及其對 CloudTrail 支援的詳細資訊，請參閱 [使用 記錄 AWS 帳戶管理 API 呼叫 AWS CloudTrail](monitoring-cloudtrail.md)。欲進一步了解 CloudTrail，包括如何將其開啟並尋找您的日誌檔案，請參閱《[AWS CloudTrail 使用者指南](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)》。