翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
指定されたアカウントの主要な E メールアドレス (ルートユーザーの E メールアドレスとも呼ばれる) を更新するために、StartPrimaryEmailUpdate から発信されたリクエストを受け入れます。
リクエストの構文
POST /acceptPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string
",
"Otp": "string
",
"PrimaryEmail": "string
"
}
URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- AccountId
-
このオペレーションでアクセスまたは変更する AWS アカウントの 12 桁のアカウント ID 番号を指定します。このパラメータを使用するには、呼び出し元が組織の管理アカウントまたは委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織はすべての機能を有効にして、アカウント管理サービス用の有効な信頼されたアクセスを持つ必要があり、オプションとして委任管理者アカウントが割り当てられます。
このオペレーションは、メンバーアカウントに対して、組織の管理アカウントまたは委任管理者アカウントからのみ呼び出すことができます。
注記
管理アカウントは、自身の
AccountId
を指定することはできません。型: 文字列
Pattern:
^\d{12}$
必須: はい
- Otp
-
StartPrimaryEmailUpdate
API コールで指定されたPrimaryEmail
に送信される OTP コード。型: 文字列
Pattern:
^[a-zA-Z0-9]{6}$
必須: はい
- PrimaryEmail
-
指定されたアカウントで使用する新しい主要 E メールアドレス。これは、
StartPrimaryEmailUpdate
API コールからのPrimaryEmail
と一致する必要があります。型: 文字列
長さの制限: 最小長は 5。最大長は 64 文字です。
必須: はい
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"Status": "string"
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- Status
-
受け入れられた主要 E メール更新リクエストのステータスを取得します。
型: 文字列
有効な値:
PENDING | ACCEPTED
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
HTTP ステータスコード: 403
- ConflictException
-
リソースの現在のステータスが競合しているため、リクエストを処理できませんでした。例えば、現在無効化中 (DISABLING ステータス) のリージョンを有効化しようとした場合や、アカウントのルートユーザーの E メールを、既に使用している E メールアドレスに変更しようとした場合にこれが発生します。
HTTP ステータスコード: 409
- InternalServerException
-
AWS への内部エラーのため、操作が失敗しました。後でもう一度操作をお試しください。
HTTP ステータスコード:500
- ResourceNotFoundException
-
見つからないリソースが指定されているため、操作が失敗しました。
HTTP ステータスコード: 404
- TooManyRequestsException
-
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
HTTP ステータスコード: 429
- ValidationException
-
入力パラメータのいずれかが無効であるため、操作が失敗しました。
HTTP ステータスコード:400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。