翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# StartPrimaryEmailUpdate
<a name="API_StartPrimaryEmailUpdate"></a>

指定されたアカウントの主要 E メールアドレスを更新するプロセスを開始します。

## リクエストの構文
<a name="API_StartPrimaryEmailUpdate_RequestSyntax"></a>

```
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "PrimaryEmail": "string"
}
```

## URI リクエストパラメータ
<a name="API_StartPrimaryEmailUpdate_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_StartPrimaryEmailUpdate_RequestBody"></a>

リクエストは以下の JSON 形式のデータを受け入れます。

 ** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-AccountId"></a>
このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント 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` を指定することはできません。
タイプ: 文字列  
Pattern: `\d{12}`   
必須: はい

 ** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-PrimaryEmail"></a>
指定されたアカウントで使用する新しい主要 E メールアドレス (ルートユーザーの E メールアドレスとも呼ばれる)。  
タイプ: 文字列  
長さの制限: 最小長は 5。最大長 64  
必須: はい

## レスポンスの構文
<a name="API_StartPrimaryEmailUpdate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}
```

## レスポンス要素
<a name="API_StartPrimaryEmailUpdate_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-response-Status"></a>
主要 E メールの更新リクエストのステータス。  
型: 文字列  
有効な値：`PENDING | ACCEPTED`

## エラー
<a name="API_StartPrimaryEmailUpdate_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** AccessDeniedException **   
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。    
 ** errorType **   
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403

 ** ConflictException **   
リソースの現在のステータスが競合しているため、リクエストを処理できませんでした。例えば、現在無効化中 (DISABLING ステータス) のリージョンを有効化しようとした場合や、アカウントのルートユーザーの E メールを、既に使用している E メールアドレスに変更しようとした場合にこれが発生します。    
 ** 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

## 以下の資料も参照してください。
<a name="API_StartPrimaryEmailUpdate_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate)