本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 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/)》。 # 動作支援以下動作： + [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md) + [DeleteAlternateContact](API_DeleteAlternateContact.md) + [DisableRegion](API_DisableRegion.md) + [EnableRegion](API_EnableRegion.md) + [GetAccountInformation](API_GetAccountInformation.md) + [GetAlternateContact](API_GetAlternateContact.md) + [GetContactInformation](API_GetContactInformation.md) + [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md) + [GetPrimaryEmail](API_GetPrimaryEmail.md) + [GetRegionOptStatus](API_GetRegionOptStatus.md) + [ListRegions](API_ListRegions.md) + [PutAccountName](API_PutAccountName.md) + [PutAlternateContact](API_PutAlternateContact.md) + [PutContactInformation](API_PutContactInformation.md) + [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) # AcceptPrimaryEmailUpdate 接受來自的請求[StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md)，以更新指定帳戶的主要電子郵件地址（也稱為根使用者電子郵件地址）。 ## 請求語法 ``` POST /acceptPrimaryEmailUpdate HTTP/1.1 Content-type: application/json { "AccountId": "string", "Otp": "string", "PrimaryEmail": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** 指定您要使用此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。此操作只能從成員帳戶的管理帳戶或組織的委派管理員帳戶呼叫。管理帳戶無法指定自己的 `AccountId`。類型：字串模式：`\d{12}` 必要：是 ** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** 傳送至 `StartPrimaryEmailUpdate` API 呼叫上`PrimaryEmail`所指定的 OTP 程式碼。類型：字串模式：`[a-zA-Z0-9]{6}` 必要：是 ** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** 用於指定帳戶的新主要電子郵件地址。這必須符合 `StartPrimaryEmailUpdate` API 呼叫`PrimaryEmail`中的。類型：字串長度限制：長度下限為 5。長度上限為 64。必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) ** 擷取已接受的主要電子郵件更新請求的狀態。類型：字串有效值:`PENDING | ACCEPTED` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** ConflictException ** 由於資源目前狀態衝突，無法處理請求。例如，如果您嘗試啟用目前正在停用的區域（處於 DISABLING 狀態），或嘗試將帳戶的根使用者電子郵件變更為已在使用的電子郵件地址，就會發生這種情況。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：409 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** ResourceNotFoundException ** 操作失敗，因為它指定了找不到的資源。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：404 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate) # DeleteAlternateContact 從刪除指定的替代聯絡人 AWS 帳戶。如需如何使用替代聯絡人操作的完整詳細資訊，請參閱[更新您的替代聯絡人 AWS 帳戶](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)。 **注意** 您必須先啟用 AWS 帳戶管理和組織之間的整合 AWS Organizations，才能更新由 AWS 帳戶管理的的替代聯絡資訊。如需詳細資訊，請參閱[啟用 AWS 帳戶管理的受信任存取](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)。 ## 請求語法 ``` POST /deleteAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_DeleteAlternateContact_RequestSyntax) ** 指定您要使用此操作存取或修改之帳戶的 12 位數 AWS 帳戶 ID 號碼。如果您未指定此參數，它會預設為用來呼叫操作的身分 AWS 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分，且指定的帳戶 ID 必須是同一組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，並選擇性地指派[委派管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`；它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請不要指定此參數，並使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) ** 指定要刪除的替代聯絡人。類型：字串有效值:`BILLING | OPERATIONS | SECURITY` 必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** ResourceNotFoundException ** 操作失敗，因為它指定了找不到的資源。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：404 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 範例 ### 範例 1 下列範例會刪除登入資料用於呼叫操作之帳戶的安全替代聯絡人。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact { "AccountName":"MyAccount" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 範例 2 下列範例會刪除組織中指定成員帳戶的帳單替代聯絡人。您必須使用來自組織管理帳戶的登入資料，或來自帳戶管理服務的委派管理員帳戶。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact { "AccountId":"123456789012", "AlternateContactType":"BILLING" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact) # DisableRegion 停用（選擇退出）帳戶的特定區域。 **注意** 停用區域的行為會移除該區域中任何資源的所有 IAM 存取權。 ## 請求語法 ``` POST /disableRegion HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_DisableRegion_RequestSyntax) ** 指定您要透過此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。如果您未指定此參數，它會預設為用於呼叫操作之身分的 Amazon Web Services 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`。它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請勿指定此參數。反之，使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [RegionName](#API_DisableRegion_RequestSyntax) ** 指定指定區域名稱的區域代碼（例如，`af-south-1`)。當您停用區域時， AWS 會執行動作來停用帳戶中的區域，例如銷毀區域中的 IAM 資源。對於大部分帳戶，這個過程需要幾分鐘的時間，但此帳戶可能需要數小時的時間。在停用程序完全完成之前，您無法啟用區域。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** ConflictException ** 由於資源目前狀態衝突，無法處理請求。例如，如果您嘗試啟用目前正在停用的區域（處於 DISABLING 狀態），或嘗試將帳戶的根使用者電子郵件變更為已在使用的電子郵件地址，就會發生這種情況。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：409 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DisableRegion) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion) # EnableRegion 為帳戶啟用（選擇加入）特定區域。 ## 請求語法 ``` POST /enableRegion HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_EnableRegion_RequestSyntax) ** 指定您要透過此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。如果您未指定此參數，它會預設為用於呼叫操作之身分的 Amazon Web Services 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`。它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請勿指定此參數。反之，使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [RegionName](#API_EnableRegion_RequestSyntax) ** 指定指定區域名稱的區域代碼（例如，`af-south-1`)。在啟用區域時， AWS 會執行動作，以便在該區域中準備您的帳戶，例如將您的 IAM 資源分發至該區域。大多數帳戶需要幾分鐘的時間，但可能需要數小時的時間。直到此過程完成之前，您都無法使用區域。此外，在啟用程序完全完成之前，您無法停用區域。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** ConflictException ** 由於資源目前狀態衝突，無法處理請求。例如，如果您嘗試啟用目前正在停用的區域（處於 DISABLING 狀態），或嘗試將帳戶的根使用者電子郵件變更為已在使用的電子郵件地址，就會發生這種情況。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：409 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/EnableRegion) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion) # GetAccountInformation 擷取指定帳戶的相關資訊，包括其帳戶名稱、帳戶 ID 和帳戶建立日期和時間。若要使用此 API，IAM 使用者或角色必須具有 IAM `account:GetAccountInformation` 許可。 ## 請求語法 ``` POST /getAccountInformation HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_GetAccountInformation_RequestSyntax) ** 指定您要使用此操作存取或修改之帳戶的 12 位數 AWS 帳戶 ID 號碼。如果您未指定此參數，它會預設為用來呼叫操作的身分 AWS 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分，且指定的帳戶 ID 必須是同一組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，並可選擇指派[委派管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`；它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請不要指定此參數，並使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "AccountCreatedDate": "string", "AccountId": "string", "AccountName": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) ** 建立帳戶的日期和時間。類型：Timestamp ** [AccountId](#API_GetAccountInformation_ResponseSyntax) ** 指定您要透過此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。此操作只能從成員帳戶的管理帳戶或組織的委派管理員帳戶呼叫。管理帳戶無法指定自己的 `AccountId`。類型：字串模式：`\d{12}` ** [AccountName](#API_GetAccountInformation_ResponseSyntax) ** 帳戶的名稱。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[ -;=?-~]+` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。稍後再次嘗試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 範例 ### 範例 1 下列範例會擷取登入資料用於呼叫操作之帳戶的帳戶資訊。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAccountInformation {} ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AccountId": "123456789012", "AccountName": "MyAccount", "AccountCreatedDate": "2020-11-30T17:44:37Z" } ``` ### 範例 2 下列範例會擷取組織中指定成員帳戶的帳戶資訊。您必須使用來自組織管理帳戶的登入資料，或來自帳戶管理服務的委派管理員帳戶。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAccountInformation { "AccountId": "123456789012" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AccountId": "123456789012", "AccountName": "MyMemberAccount", "AccountCreatedDate": "2020-11-30T17:44:37Z" } ``` ## 另請參閱如需在其中一種語言特定 AWS SDKs 中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation) # GetAlternateContact 擷取連接至的指定替代聯絡人 AWS 帳戶。如需如何使用替代聯絡人操作的完整詳細資訊，請參閱[更新您的替代聯絡人 AWS 帳戶](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)。 **注意** 您必須先啟用 AWS 帳戶管理和組織之間的整合 AWS Organizations，才能更新由 AWS 帳戶管理之的替代聯絡資訊。如需詳細資訊，請參閱[啟用 AWS 帳戶管理的受信任存取](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)。 ## 請求語法 ``` POST /getAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_GetAlternateContact_RequestSyntax) ** 指定您要使用此操作存取或修改之帳戶的 12 位數 AWS 帳戶 ID 號碼。如果您未指定此參數，它會預設為用來呼叫操作的身分 AWS 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分，且指定的帳戶 ID 必須是同一組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，並選擇性地指派[委派管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`；它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請不要指定此參數，並使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) ** 指定您要擷取的替代聯絡人。類型：字串有效值:`BILLING | OPERATIONS | SECURITY` 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "AlternateContact": { "AlternateContactType": "string", "EmailAddress": "string", "Name": "string", "PhoneNumber": "string", "Title": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) ** 包含指定替代聯絡人詳細資訊的結構。類型：[AlternateContact](API_AlternateContact.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。稍後再次嘗試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** ResourceNotFoundException ** 操作失敗，因為它指定了找不到的資源。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：404 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 範例 ### 範例 1 下列範例會擷取其登入資料用於呼叫操作之帳戶的安全替代聯絡人。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAlternateContact { "AlternateContactType":"SECURITY" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AlternateContact":{ "Name":"Anika", "Title":"COO", "EmailAddress":"anika@example.com", "PhoneNumber":"206-555-0198", "AlternateContactType":"Security" } } ``` ### 範例 2 下列範例會擷取組織中指定成員帳戶的操作替代聯絡人。您必須使用來自組織管理帳戶的登入資料，或來自帳戶管理服務的委派管理員帳戶。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAlternateContact { "AccountId":"123456789012", "AlternateContactType":"Operations" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AlternateContact":{ "Name":"Anika", "Title":"COO", "EmailAddress":"anika@example.com", "PhoneNumber":"206-555-0198", "AlternateContactType":"Operations" } } ``` ## 另請參閱如需在其中一種語言特定 AWS SDKs 中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAlternateContact) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact) # GetContactInformation 擷取的主要聯絡資訊 AWS 帳戶。如需如何使用主要聯絡人操作的完整詳細資訊，請參閱[更新主要聯絡人 AWS 帳戶](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)。 ## 請求語法 ``` POST /getContactInformation HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_GetContactInformation_RequestSyntax) ** 指定您要使用此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。如果您未指定此參數，它會預設為用於呼叫操作之身分的 Amazon Web Services 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並可選擇指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`。它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請勿指定此參數。反之，使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "ContactInformation": { "AddressLine1": "string", "AddressLine2": "string", "AddressLine3": "string", "City": "string", "CompanyName": "string", "CountryCode": "string", "DistrictOrCounty": "string", "FullName": "string", "PhoneNumber": "string", "PostalCode": "string", "StateOrRegion": "string", "WebsiteUrl": "string" } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [ContactInformation](#API_GetContactInformation_ResponseSyntax) ** 包含與相關聯的主要聯絡資訊的詳細資訊 AWS 帳戶。類型：[ContactInformation](API_ContactInformation.md) 物件 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** ResourceNotFoundException ** 操作失敗，因為它指定了找不到的資源。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：404 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetContactInformation) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation) # GetGovCloudAccountInformation 擷取連結至指定標準帳戶（如果有的話）的 GovCloud 帳戶相關資訊，包括 GovCloud 帳戶 ID 和狀態。若要使用此 API，IAM 使用者或角色必須具有 IAM `account:GetGovCloudAccountInformation` 許可。 ## 請求語法 ``` POST /getGovCloudAccountInformation HTTP/1.1 Content-type: application/json { "StandardAccountId": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) ** 指定您要使用此操作存取或修改之帳戶的 12 位數 AWS 帳戶 ID 號碼。如果您未指定此參數，它會預設為用來呼叫操作的身分 AWS 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分，且指定的帳戶 ID 必須是同一組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，並選擇性地指派[委派管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`；它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請不要指定此參數，並使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "AccountState": "string", "GovCloudAccountId": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) ** 連結 GovCloud 帳戶的帳戶狀態。類型：字串有效值:`PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) ** 連結 GovCloud 帳戶的 12 位數帳戶 ID 號碼。類型：字串模式：`\d{12}` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** ResourceNotFoundException ** 操作失敗，因為它指定了找不到的資源。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：404 ** ResourceUnavailableException ** 操作失敗，因為它指定了目前無法使用的資源。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：424 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 範例 ### 範例 1 下列範例會擷取其登入資料用於呼叫操作之帳戶的連結 GovCloud 帳戶資訊。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation {} ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json { "GovCloudAccountId": "123456789012", "AccountState": "ACTIVE" } ``` ### 範例 2 下列範例會擷取組織中指定成員帳戶的連結 GovCloud 帳戶資訊。您必須使用來自組織管理帳戶的登入資料，或來自帳戶管理服務的委派管理員帳戶。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation { "StandardAccountId": "111111111111" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json { "GovCloudAccountId": "123456789012", "AccountState": "ACTIVE" } ``` ### 範例 3 下列範例會嘗試擷取未連結至 GovCloud 帳戶之標準帳戶的連結 GovCloud 帳戶資訊。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation { "StandardAccountId": "222222222222" } ``` #### 回應範例 ``` HTTP/1.1 404 Content-Type: application/json { "message":"GovCloud Account ID not found for Standard Account - 222222222222." } ``` ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation) # GetPrimaryEmail 擷取指定帳戶的主要電子郵件地址。 ## 請求語法 ``` POST /getPrimaryEmail HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_GetPrimaryEmail_RequestSyntax) ** 指定您要透過此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。此操作只能從成員帳戶的管理帳戶或組織的委派管理員帳戶呼叫。管理帳戶無法指定自己的 `AccountId`。類型：字串模式：`\d{12}` 必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "PrimaryEmail": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) ** 擷取與指定帳戶相關聯的主要電子郵件地址。類型：字串長度限制：長度下限為 5。長度上限為 64。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** ResourceNotFoundException ** 操作失敗，因為它指定了找不到的資源。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：404 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail) # GetRegionOptStatus 擷取特定區域的選擇加入狀態。 ## 請求語法 ``` POST /getRegionOptStatus HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_GetRegionOptStatus_RequestSyntax) ** 指定您要透過此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。如果您未指定此參數，它會預設為用於呼叫操作之身分的 Amazon Web Services 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`。它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請勿指定此參數。反之，使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [RegionName](#API_GetRegionOptStatus_RequestSyntax) ** 指定指定區域名稱的區域代碼（例如，`af-south-1`)。此函數將傳回您傳遞至此參數的任何區域的狀態。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "RegionName": "string", "RegionOptStatus": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) ** 傳入的區域碼。類型：字串長度限制：長度下限為 1。長度上限為 50。 ** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) ** 區域可以經歷的其中一個潛在狀態（啟用、啟用、停用、停用、啟用\$1By\$1Default)。類型：字串有效值:`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus) # ListRegions 列出指定帳戶的所有區域及其個別選擇加入狀態。或者，可以依 `region-opt-status-contains` 參數篩選此清單。 ## 請求語法 ``` POST /listRegions HTTP/1.1 Content-type: application/json { "AccountId": "string", "MaxResults": number, "NextToken": "string", "RegionOptStatusContains": [ "string" ] } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_ListRegions_RequestSyntax) ** 指定您要透過此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。如果您未指定此參數，它會預設為用於呼叫操作之身分的 Amazon Web Services 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`。它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請勿指定此參數。反之，使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [MaxResults](#API_ListRegions_RequestSyntax) ** 命令輸出中要傳回的項目總數。如果可用的項目總數超過指定的值，`NextToken`則會在命令的輸出中提供。若要繼續分頁，請在後續命令的 `starting-token` 引數中提供 `NextToken` 值。請勿在 CLI AWS 外部直接使用`NextToken`回應元素。如需使用範例，請參閱《 * AWS 命令列界面使用者指南*》中的[分頁](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)。類型：整數有效範圍：最小值為 1。最大值為 50。必要：否 ** [NextToken](#API_ListRegions_RequestSyntax) ** 用於指定開始分頁位置的字符。這是先前截斷的回應`NextToken`中的。如需使用範例，請參閱《 * AWS 命令列界面使用者指南*》中的[分頁](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)。類型：字串長度限制：長度下限為 0。長度上限為 1000。必要：否 ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) ** 區域狀態清單（啟用、啟用、停用、停用、啟用、by\$1default)，可用來篩選指定帳戶的區域清單。例如，傳入 ENABLING 值只會傳回區域狀態為 ENABLING 的區域清單。類型：字串陣列有效值:`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 必要：否 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Regions": [ { "RegionName": "string", "RegionOptStatus": "string" } ] } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [NextToken](#API_ListRegions_ResponseSyntax) ** 如果要傳回更多資料，則會填入此項目。它應該傳遞到的`next-token`請求參數`list-regions`。類型：字串 ** [Regions](#API_ListRegions_ResponseSyntax) ** 這是指定帳戶的區域清單，或者如果使用篩選過的參數，則為符合 `filter` 參數中所設定篩選條件的區域清單。類型：[Region](API_Region.md) 物件陣列 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/ListRegions) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions) # PutAccountName 更新指定帳戶的帳戶名稱。若要使用此 API，IAM 主體必須具有 IAM `account:PutAccountName` 許可。 ## 請求語法 ``` POST /putAccountName HTTP/1.1 Content-type: application/json { "AccountId": "string", "AccountName": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_PutAccountName_RequestSyntax) ** 指定您要使用此操作存取或修改之帳戶的 12 位數 AWS 帳戶 ID 號碼。如果您未指定此參數，它會預設為用來呼叫操作的身分 AWS 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分，而指定的帳戶 ID 必須是同一組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，並選擇性地指派[委派管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`；它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請不要指定此參數，並使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [AccountName](#API_PutAccountName_RequestSyntax) ** 帳戶的名稱。類型：字串長度限制：長度下限為 1。長度上限為 50。模式：`[ -;=?-~]+` 必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 範例 ### 範例 1 下列範例會更新其登入資料用於呼叫操作的帳戶名稱。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAccountName { "AccountName":"MyAccount" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 範例 2 下列範例會更新組織中指定成員帳戶的帳戶名稱。您必須使用來自組織管理帳戶的登入資料，或來自帳戶管理服務的委派管理員帳戶。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAccountName { "AccountId": "123456789012", "AccountName": "MyMemberAccount" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName) # PutAlternateContact 修改連接至的指定替代聯絡人 AWS 帳戶。如需如何使用替代聯絡人操作的完整詳細資訊，請參閱[更新您的替代聯絡人 AWS 帳戶](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)。 **注意** 您必須先啟用 AWS 帳戶管理和組織之間的整合 AWS Organizations，才能更新由 AWS 帳戶管理的的替代聯絡資訊。如需詳細資訊，請參閱[啟用 AWS 帳戶管理的受信任存取](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)。 ## 請求語法 ``` POST /putAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string", "EmailAddress": "string", "Name": "string", "PhoneNumber": "string", "Title": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_PutAlternateContact_RequestSyntax) ** 指定您要使用此操作存取或修改之帳戶的 12 位數 AWS 帳戶 ID 號碼。如果您未指定此參數，它會預設為用來呼叫操作的身分 AWS 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分，而指定的帳戶 ID 必須是同一組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，並選擇性地指派[委派管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`；它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請不要指定此參數，並使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) ** 指定您要建立或更新的替代聯絡人。類型：字串有效值:`BILLING | OPERATIONS | SECURITY` 必要：是 ** [EmailAddress](#API_PutAlternateContact_RequestSyntax) ** 指定替代聯絡人的電子郵件地址。類型：字串長度限制：長度下限為 1。長度上限為 254。模式：`[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*` 必要：是 ** [Name](#API_PutAlternateContact_RequestSyntax) ** 指定替代聯絡人的名稱。類型：字串長度限制：長度下限為 1。長度上限為 64。必要：是 ** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) ** 指定替代聯絡人的電話號碼。類型：字串長度限制：長度下限為 1。長度上限為 25。模式：`[\s0-9()+-]+` 必要：是 ** [Title](#API_PutAlternateContact_RequestSyntax) ** 指定替代聯絡人的標題。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** 由 API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 範例 ### 範例 1 下列範例會為登入資料用於呼叫操作的帳戶設定帳單備用聯絡人。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAlternateContact { "AlternateContactType": "Billing", "Name": "Carlos Salazar", "Title": "CFO", "EmailAddress": "carlos@example.com", "PhoneNumber": "206-555-0199" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 範例 2 下列範例會設定或覆寫組織中指定成員帳戶的帳單替代聯絡人。您必須使用來自組織管理帳戶的登入資料，或來自帳戶管理服務的委派管理員帳戶。 #### 請求範例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAlternateContact { "AccountId": "123456789012", "AlternateContactType": "Billing", "Name": "Carlos Salazar", "Title": "CFO", "EmailAddress": "carlos@example.com", "PhoneNumber": "206-555-0199" } ``` #### 回應範例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAlternateContact) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact) # PutContactInformation 更新的主要聯絡資訊 AWS 帳戶。如需如何使用主要聯絡人操作的完整詳細資訊，請參閱[更新主要聯絡人 AWS 帳戶](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)。 ## 請求語法 ``` POST /putContactInformation HTTP/1.1 Content-type: application/json { "AccountId": "string", "ContactInformation": { "AddressLine1": "string", "AddressLine2": "string", "AddressLine3": "string", "City": "string", "CompanyName": "string", "CountryCode": "string", "DistrictOrCounty": "string", "FullName": "string", "PhoneNumber": "string", "PostalCode": "string", "StateOrRegion": "string", "WebsiteUrl": "string" } } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_PutContactInformation_RequestSyntax) ** 指定您要使用此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。如果您未指定此參數，它會預設為用於呼叫操作之身分的 Amazon Web Services 帳戶。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)，並選擇性地指派[委派管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。管理帳戶無法指定自己的 `AccountId`。它必須藉由不包含 `AccountId` 參數，在獨立內容中呼叫操作。若要在非組織成員的帳戶上呼叫此操作，請勿指定此參數。反之，使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。類型：字串模式：`\d{12}` 必要：否 ** [ContactInformation](#API_PutContactInformation_RequestSyntax) ** 包含與相關聯的主要聯絡資訊的詳細資訊 AWS 帳戶。類型：[ContactInformation](API_ContactInformation.md) 物件必要：是 ## 回應語法 ``` HTTP/1.1 200 ``` ## 回應元素如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutContactInformation) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation) # StartPrimaryEmailUpdate 開始更新指定帳戶主要電子郵件地址的程序。 ## 請求語法 ``` POST /startPrimaryEmailUpdate HTTP/1.1 Content-type: application/json { "AccountId": "string", "PrimaryEmail": "string" } ``` ## URI 請求參數請求不會使用任何 URI 參數。 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) ** 指定您要使用此操作存取或修改之 AWS 帳戶的 12 位數帳戶 ID 號碼。若要使用此參數，發起人必須是[組織管理帳戶](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)或委派管理員帳戶中的身分。指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須[啟用所有功能](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)，且組織必須針對帳戶管理服務啟用[受信任存取](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)，並選擇性地指派[委派的管理員](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)帳戶。此操作只能從成員帳戶的管理帳戶或組織的委派管理員帳戶呼叫。管理帳戶無法指定自己的 `AccountId`。類型：字串模式：`\d{12}` 必要：是 ** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) ** 要在指定帳戶中使用的新主要電子郵件地址（也稱為根使用者電子郵件地址）。類型：字串長度限制：長度下限為 5。長度上限為 64。必要：是 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "Status": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) ** 主要電子郵件更新請求的狀態。類型：字串有效值:`PENDING | ACCEPTED` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** AccessDeniedException ** 操作失敗，因為呼叫身分沒有所需的最低許可。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：403 ** ConflictException ** 由於資源目前狀態衝突，無法處理請求。例如，如果您嘗試啟用目前正在停用的區域（處於 DISABLING 狀態），或嘗試將帳戶的根使用者電子郵件變更為已在使用的電子郵件地址，就會發生這種情況。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：409 ** InternalServerException ** 由於內部發生錯誤，操作失敗 AWS。請稍後重試您的操作。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：500 ** ResourceNotFoundException ** 操作失敗，因為它指定了找不到的資源。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：404 ** TooManyRequestsException ** 操作失敗，因為呼叫次數太頻繁且超過節流限制。 ** errorType ** API Gateway 填入`x-amzn-ErrorType`回應標頭的值。 HTTP 狀態碼：429 ** ValidationException ** 操作失敗，因為其中一個輸入參數無效。 ** fieldList ** 偵測到無效項目的欄位。 ** message ** 通知您有關請求無效內容的訊息。 ** reason ** 驗證失敗的原因。 HTTP 狀態碼：400 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate) # 其他服務中的相關動作 AWS 下列操作與相關， AWS 帳戶管理但屬於命名空間的一部分 AWS Organizations ： + [CreateAccount](API_CreateAccount.md) + [CreateGovCloudAccount](API_CreateGovCloudAccount.md) + [DescribeAccount](API_DescribeAccount.md) # CreateAccount `CreateAccount` API 操作僅適用於由 AWS Organizations 服務管理的組織內容。API 操作定義在該服務的命名空間中。如需詳細資訊，請參閱 *AWS Organizations API 參考*中的 [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html)。 # CreateGovCloudAccount `CreateGovCloudAccount` API 操作僅適用於由 AWS Organizations 服務管理的組織內容。API 操作定義在該服務的命名空間中。如需詳細資訊，請參閱《 *AWS Organizations API 參考*》中的 [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html)。 # DescribeAccount `DescribeAccount` API 操作僅適用於由 AWS Organizations 服務管理的組織內容。API 操作定義在該服務的命名空間中。如需詳細資訊，請參閱 *AWS Organizations API 參考*中的 [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html)。 # 資料類型目前支援下列資料類型： + [AlternateContact](API_AlternateContact.md) + [ContactInformation](API_ContactInformation.md) + [Region](API_Region.md) + [ValidationExceptionField](API_ValidationExceptionField.md) # AlternateContact 包含與帳戶相關聯之替代聯絡人詳細資訊的 AWS 結構 ## 目錄 ** AlternateContactType ** 替代聯絡人的類型。類型：字串有效值:`BILLING | OPERATIONS | SECURITY` 必要：否 ** EmailAddress ** 與此替代聯絡人相關聯的電子郵件地址。類型：字串長度限制：長度下限為 1。長度上限為 254。模式：`[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*` 必要：否 ** Name ** 與此替代聯絡人相關聯的名稱。類型：字串長度限制：長度下限為 1。長度上限為 64。必要：否 ** PhoneNumber ** 與此替代聯絡人相關聯的電話號碼。類型：字串長度限制：長度下限為 1。長度上限為 25。模式：`[\s0-9()+-]+` 必要：否 ** Title ** 與此替代聯絡人相關聯的標題。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs 中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact) # ContactInformation 包含與相關聯的主要聯絡資訊的詳細資訊 AWS 帳戶。 ## 目錄 ** AddressLine1 ** 主要聯絡人地址的第一行。類型：字串長度限制：長度下限為 1。長度上限為 60。必要：是 ** City ** 主要聯絡地址的城市。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：是 ** CountryCode ** 主要聯絡地址的 ISO-3166 雙字母國家/地區代碼。類型：字串長度限制：固定長度為 2。必要：是 ** FullName ** 主要聯絡人地址的完整名稱。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：是 ** PhoneNumber ** 主要聯絡資訊的電話號碼。號碼將會經過驗證，而且在某些國家/地區會檢查是否啟用。類型：字串長度限制：長度下限為 1。長度上限為 20。模式：`[+][\s0-9()-]+` 必要：是 ** PostalCode ** 主要聯絡人地址的郵遞區號。類型：字串長度限制：長度下限為 1。長度上限為 20。必要：是 ** AddressLine2 ** 主要聯絡人地址的第二行，如果有的話。類型：字串長度限制：長度下限為 1。長度上限為 60。必要：否 ** AddressLine3 ** 主要聯絡地址的第三行，如果有的話。類型：字串長度限制：長度下限為 1。長度上限為 60。必要：否 ** CompanyName ** 與主要聯絡資訊相關聯的公司名稱，如果有的話。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：否 ** DistrictOrCounty ** 主要聯絡地址的區域或郡，如果有的話。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：否 ** StateOrRegion ** 主要聯絡人地址的狀態或區域。如果郵寄地址位於美國 (US) 內，此欄位的值可以是兩個字元的狀態碼（例如 `NJ`) 或完整狀態名稱（例如 `New Jersey`)。下列國家/地區需要此欄位：`US`、`CA`、`GB`、`DE`、`IN`、 `JP`和 `BR`。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：否 ** WebsiteUrl ** 與主要聯絡資訊相關聯的網站 URL，如果有的話。類型：字串長度限制：長度下限為 1。長度上限為 256。必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation) # Region 這是表達指定帳戶之區域的結構，由名稱和選擇加入狀態組成。 ## 目錄 ** RegionName ** 指定區域的區域代碼（例如 `us-east-1`)。類型：字串長度限制：長度下限為 1。長度上限為 50。必要：否 ** RegionOptStatus ** 區域可以經歷的可能狀態之一（啟用、啟用、停用、停用、啟用\$1By\$1Default)。類型：字串有效值:`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 必要：否 ## 另請參閱如需在其中一種語言特定 AWS SDKs 中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region) # ValidationExceptionField 輸入不符合指定欄位中 AWS 服務指定的限制條件。 ## 目錄 ** message ** 有關驗證例外狀況的訊息。類型：字串必要：是 ** name ** 偵測到無效項目的欄位名稱。類型：字串必要：是 ## 另請參閱如需在其中一種語言特定 AWS SDKs 中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField) # 常見參數以下清單內含所有動作用來簽署 Signature 第 4 版請求的參數以及查詢字串。任何專屬於特定動作的參數則列於該動作的主題中。如需 Signature 第 4 版的詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。 **X-Amz-Algorithm** 建立請求簽章時所使用的雜湊演算法。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串有效值:`AWS4-HMAC-SHA256` 必要：有條件 **X-Amz-Credential** 憑證範圍值，此為一個字串，其中包含您的存取金鑰、日期、您的目標區域、您請求的服務，以及終止字串 (“aws4\$1request”)。值以下列格式表示：*access\$1key*/*YYYYMMDD*/*region*/*service*/aws4\$1request。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[建立已簽署的 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串必要：有條件 **X-Amz-Date** 用來建立簽署的日期。格式必須是 ISO 8601 基本格式 (YYYYMMDD'T'HHMMSS'Z')。例如，以下日期時間是有效的 X-Amz-Date 值：`20120325T120000Z` 條件：對所有請求而言，X-Amz-Date 皆為選用，可用來覆寫用於簽署請求的日期。如果規定日期標頭採用 ISO 8601 基本格式，則不需要 X-Amz-Date。當使用 X-Amz-Date 時，其一律會覆寫日期標頭的值。如需詳細資訊，請參閱《*IAM 使用者指南*》中的 [AWS API 請求簽章的元素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)。類型：字串必要：有條件 **X-Amz-Security-Token** 透過呼叫 AWS Security Token Service () 取得的臨時安全字符AWS STS。如需支援 AWS STS的臨時安全憑證的服務清單，請參閱《IAM 使用者指南》**中的[可搭配 IAM 運作的AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)。條件：如果您使用來自的臨時安全登入資料 AWS STS，則必須包含安全字符。類型：字串必要：有條件 **X-Amz-Signature** 指定從要簽署的字串和衍生的簽署金鑰中計算出的十六進位編碼簽章。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串必要：有條件 **X-Amz-SignedHeaders** 指定納入作為標準請求一部分的所有 HTTP 標頭。如需指定已簽章標頭的詳細資訊，請參閱《*IAM 使用者指南*》中的[建立已簽章的 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)。條件：當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時，應指定此參數。類型：字串必要：有條件 # 常見錯誤類型本節列出 AWS 此服務可能傳回的常見錯誤類型。並非所有服務都會傳回此處列出的所有錯誤類型。如需此服務之 API 動作的特定錯誤，請參閱該 API 動作的主題。 **AccessDeniedException** 您沒有執行此動作的許可。確認您的 IAM 政策包含必要的許可。 HTTP 狀態碼：403 **ExpiredTokenException** 請求中包含的安全字符已過期。請求新的安全字符，然後再試一次。 HTTP 狀態碼：403 **IncompleteSignature** 請求簽章不符合 AWS 標準。確認您使用的是有效的 AWS 登入資料，而且您的請求格式正確。如果您使用的是開發套件，請確保其為最新版本。 HTTP 狀態碼：403 **InternalFailure** 由於內部伺服器問題，目前無法處理請求。請稍後再試。如果問題仍然存在，請聯絡 AWS Support。 HTTP 狀態碼：500 **MalformedHttpRequestException** 無法處理請求內文。這通常發生在無法使用指定的內容編碼演算法解壓縮請求內文時。確認內容編碼標頭符合使用的壓縮格式。 HTTP 狀態碼：400 **NotAuthorized** 您沒有執行此動作的許可。確認您的 IAM 政策包含必要的許可。 HTTP 狀態碼：401 **OptInRequired** AWS 您的帳戶需要訂閱此服務。確認您已在帳戶中啟用服務。 HTTP 狀態碼：403 **RequestAbortedException** 在傳回回應之前，請求已中止。這通常發生在用戶端關閉連線時。 HTTP 狀態碼：400 **RequestEntityTooLargeException** 請求實體太大。減少請求內文的大小，然後再試一次。 HTTP 狀態碼：413 **RequestTimeoutException** 請求逾時。伺服器未在預期的時間範圍內收到完整的請求。請再試一次。 HTTP 狀態碼：408 **ServiceUnavailable** 此服務暫時無法使用。請稍後再試。 HTTP 狀態碼：503 **ThrottlingException** 您的請求率太高。 AWS SDKs 會自動重試收到此例外狀況的請求。減少請求的頻率。 HTTP 狀態碼：400 **UnknownOperationException** 無法辨識動作或操作。確認動作名稱拼寫正確，且您所使用的 API 版本支援此名稱。 HTTP 狀態碼：404 **UnrecognizedClientException** 您提供的 X.509 憑證或 AWS 存取金鑰 ID 不存在於我們的記錄中。確認您使用的是有效的登入資料，而且尚未過期。 HTTP 狀態碼：403 **ValidationError** 輸入不符合必要的格式或限制條件。檢查是否包含所有必要參數，以及值是否有效。 HTTP 狀態碼：400 # 提出 HTTP 查詢請求以呼叫 API 本節包含有關使用查詢 API for AWS Account Management 的一般資訊。如需 API 操作和錯誤的詳細資訊，請參閱 [API 參考](api-reference.md)。 **注意** 您可以使用其中一個 AWS SDKs，而不是直接呼叫 AWS 帳戶管理查詢 API。 AWS SDKs包含適用於各種程式設計語言和平台 (Java、Ruby、.NET、iOS、Android 等）的程式庫和範本程式碼。SDKs提供便捷的方式來建立對 AWS Account Management 和的程式設計存取 AWS。例如，開發套件會負責的工作諸如以密碼演算法簽署請求、管理錯誤以及自動重試請求。如需 AWS SDKs 的相關資訊，包括如何下載和安裝，請參閱[適用於 Amazon Web Services 的工具](https://aws.amazon.com/tools)。使用 AWS 帳戶管理的查詢 API，您可以呼叫服務動作。查詢 API 請求是 HTTPS 請求，必須包含 `Action` 參數以指出要執行的操作。 AWS 帳戶管理支援 `GET`和所有操作的`POST`請求。也就是說，API 不需要您`GET`針對某些動作和其他動作使用 `POST` 。不過，`GET`請求受限於 URL 的限制大小。雖然此限制取決於瀏覽器，但一般限制為 2，048 個位元組。因此，對於需要較大大小的查詢 API 請求，您必須使用 `POST`請求。回應為 XML 文件。如需回應的詳細資訊，請參閱 [API 參考](api-reference.md)中個別動作的頁面。 **Topics** + [端點](#endpoints) + [必要的 HTTPS](#IAMHTTPSRequired) + [簽署 AWS 帳戶管理 API 請求](#SigVersion) ## 端點 AWS Account Management 有一個託管在美國東部（維吉尼亞北部）的全域 API 端點。 AWS 區域如需所有服務的 AWS 端點和區域的詳細資訊，請參閱《》中的[區域和端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)*AWS 一般參考*。 ## 必要的 HTTPS 由於查詢 API 可以傳回安全性登入資料等敏感資訊，因此您必須使用 HTTPS 來加密所有 API 請求。 ## 簽署 AWS 帳戶管理 API 請求請求必須使用存取金鑰 ID 和私密存取金鑰簽署。強烈建議您不要將 AWS 根帳戶登入資料用於 AWS 帳戶管理的日常工作。您可以使用 AWS Identity and Access Management (IAM) 使用者的登入資料或臨時登入資料，例如搭配 IAM 角色使用的登入資料。若要簽署 API 請求，您必須使用 AWS Signature 第 4 版。如需使用 Signature 第 4 版的詳細資訊，請參閱《*IAM 使用者指南*》中的[簽署 AWS API 請求](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)。如需詳細資訊，請參閱下列內容： + [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 帳戶管理中的資源。 + [IAM 暫時性安全憑證](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) – 描述如何建立和使用暫時性安全憑證。