本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
GetPrimaryEmail
擷取指定帳戶的主要電子郵件地址。
請求語法
POST /getPrimaryEmail HTTP/1.1
Content-type: application/json
{
"AccountId": "string
"
}
URI 請求參數
請求不會使用任何 URI 參數。
請求主體
請求接受採用 JSON 格式的下列資料。
- AccountId
-
指定您要透過此作業存取或修改的 12 位數帳號 ID 號碼。 AWS 帳戶 若要使用此參數,來電者必須是組織管理帳戶中的身分識別或委派的系統管理員帳戶。指定的帳號 ID 必須是相同組織中的成員帳戶。組織必須啟用所有功能,且組織必須啟用帳戶管理服務的受信任存取權,並選擇性地指派委派管理員帳戶。
此作業只能從成員帳戶的管理帳戶或組織的委派系統管理員帳戶呼叫。
注意
管理帳戶無法指定自己的帳戶
AccountId
。類型:String
模式:
^\d{12}$
必要:是
回應語法
HTTP/1.1 200
Content-type: application/json
{
"PrimaryEmail": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- PrimaryEmail
-
擷取與指定帳戶相關聯的主要電子郵件地址。
類型:字串
長度約束:最小長度為 5。長度上限為 64。
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- AccessDeniedException
-
作業失敗,因為呼叫識別沒有必要的最低權限。
HTTP 狀態碼:403
- InternalServerException
-
作業失敗,因為內部的錯誤 AWS。請稍後再試一次。
HTTP 狀態碼:500
- ResourceNotFoundException
-
作業失敗,因為它指定了找不到的資源。
HTTP 狀態碼:404
- TooManyRequestsException
-
作業失敗,因為呼叫頻率太頻繁且超過節流限制。
HTTP 狀態碼:429
- ValidationException
-
作業失敗,因為其中一個輸入參數無效。
HTTP 狀態碼:400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: