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