本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
GetGovCloudAccountInformation
擷取連結至指定標準帳戶 （如果有的話） 的 GovCloud 帳戶相關資訊，包括 GovCloud 帳戶 ID 和狀態。若要使用此 API，IAM 使用者或角色必須具有 IAM account:GetGovCloudAccountInformation 許可。
請求語法
POST /getGovCloudAccountInformation HTTP/1.1
Content-type: application/json
{
"StandardAccountId": "string"
}URI 請求參數
請求不會使用任何 URI 參數。
請求主體
請求接受採用 JSON 格式的下列資料。
- StandardAccountId
-
指定您要使用此操作存取或修改之帳戶的 12 位數 AWS 帳戶 ID 號碼。
如果您未指定此參數，它會預設為用來呼叫 操作的身分 AWS 帳戶。
若要使用此參數，發起人必須是組織管理帳戶或委派管理員帳戶中的身分，而指定的帳戶 ID 必須是同一組織中的成員帳戶。組織必須啟用所有功能，且組織必須針對帳戶管理服務啟用受信任存取，並可選擇指派委派管理員帳戶。
注意
管理帳戶無法指定自己的
AccountId；它必須藉由不包含AccountId參數，在獨立內容中呼叫 操作。若要在非組織成員的帳戶上呼叫此操作，請不要指定此參數，並使用屬於您想要擷取或修改其聯絡人之帳戶的身分來呼叫操作。
類型：字串
模式：
\d{12}必要：否
回應語法
HTTP/1.1 200
Content-type: application/json
{
"AccountState": "string",
"GovCloudAccountId": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- AccountState
-
連結 GovCloud 帳戶的帳戶狀態。
類型：字串
有效值:
PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED - GovCloudAccountId
-
連結 GovCloud 帳戶的 12 位數帳戶 ID 號碼。
類型：字串
模式：
\d{12}
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- 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 的詳細資訊，請參閱下列內容：
