翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# API リファレンス
アカウント管理 (`account`) 名前空間の API オペレーションを使用すると、 を変更できます AWS アカウント。
すべての は、アカウントに関連付けられた最大 3 つの代替連絡先に関する情報を含む、アカウントに関する情報を含むメタデータ AWS アカウント をサポートします。これらは、アカウントの[ルートユーザー](root-user.md)に関連付けられている E メールアドレスに加えて指定されます。アカウントに関連付けられている次の各連絡先タイプのいずれか 1 つのみを指定できます。
+ 請求に関するお問い合わせ先
+ 操作問い合わせ先
+ セキュリティ問い合わせ先
デフォルトでは、このガイドで説明する API 操作は、操作を呼び出すアカウントに直接適用されます。操作を呼び出しているアカウントの[アイデンティティ](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)は、通常 IAM ロールまたは IAM ユーザーがあり、API 操作を呼び出すには IAM ポリシーによって適用されるアクセス権限が必要です。または、管理アカウントの ID からこれらの API オペレーションを AWS Organizations 呼び出し、組織のメンバー AWS アカウント である のアカウント ID 番号を指定することもできます。
**API バージョン**
このバージョンの「アカウント API リファレンス」には、「アカウント管理 API バージョン 2021-02-01」と記載されています。
**注記**
API を直接使用する代わりに、 AWS SDKs のいずれかを使用できます。SDK は、さまざまなプログラミング言語とプラットフォーム (Java、Ruby、.NET、iOS、Android など) のライブラリとサンプルコードで構成されます。SDKs を使用すると、 AWS Organizations へのプログラムによるアクセスを簡単に作成できます。例えば、SDK では暗号を使用して要求に署名したり、エラーを管理したり、要求を自動的に再試行したりすることができます。 AWS SDKs[「Amazon Web Services のツール](https://console.aws.amazon.com/)」を参照してください。
アカウント管理サービスに対してプログラムによる API コールを行うには、 AWS SDKs を使用することをお勧めします。ただし、アカウント管理クエリ API を使用して、アカウント管理 Web サービスを直接呼び出すこともできます。アカウント管理クエリ API の詳細については、「アカウント管理ユーザーガイド」の「[HTTP クエリリクエストを作成して API を呼び出す](query-requests.md)」を参照してください。組織はすべてのアクションの GET リクエストと POST リクエストをサポートしています。つまり、API は、あるアクションに対しては GET を、他のアクションに対しては POST をといった使い分けを必要としません。しかしながら、GET リクエストは URL のサイズに制限があります。したがって、より大きなサイズを必要とする操作の場合は、POST リクエストを使用します。
**リクエストへの署名**
HTTP リクエストを に送信するときは AWS、 がリクエストを送信したユーザー AWS を識別できるように、リクエストに署名する必要があります。アクセスキー ID とシークレット AWS アクセスキーで構成されるアクセスキーを使用してリクエストに署名します。ルートアカウントのアクセスキーを作成しないことを強くお勧めします。ルートアカウントのアクセスキーを持っていれば誰でも、アカウントのすべてのリソースに無制限にアクセスできます。代わりに、管理権限を持つ IAM ユーザーのアクセスキーを作成します。別のオプションとして、 AWS Security Token Service を使用して一時的なセキュリティ認証情報を生成し、それらの認証情報を使用してリクエストに署名します。
リクエストをサインアップする際には、署名バージョン 4 の使用が推奨されます。Signature バージョン 2 を使用する既存のアプリケーションがある場合は、Signature バージョン 4 を使用するために更新する必要はありません。ただし、一部の操作では、Signature バージョン 4 が必要です。バージョン 4 を必要とする操作のドキュメントには、この要件が示されています。詳細については、*IAM ユーザーガイド*[の AWS API リクエストの署名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)を参照してください。
コマンドラインインターフェイス (AWS CLI) またはいずれかの AWS SDKs AWS を使用してリクエストを行うと AWS、これらのツールはツールの設定時に指定したアクセスキーを使用してリクエストに自動的に署名します。
**アカウント管理のサポートとフィードバック**
ご意見をお待ちしております。コメントを [feedback-awsaccounts@amazon.com]](mailto://feedback-awsaccounts@amazon.com) 宛てに送信するか、[アカウント管理サポートフォーラム](https://forums.aws.amazon.com/forum.jspa?forumID=219)にフィードバックと質問を掲載してください。 AWS サポートフォーラムの詳細については、[「フォーラムのヘルプ](https://forums.aws.amazon.com/help.jspa)」を参照してください。
**例が提示される方法**
リクエストに対する応答としてアカウント管理によって返される JSON は、改行や書式空白を含まない単一の長い文字列として返されます。読みやすさを向上させるために、このガイドの例には改行と空白の両方を示します。入力パラメータの例で画面を超えて長い文字列が生成される場合は、読みやすさを向上させるために改行を挿入します。入力は常に 1 つの JSON テキスト文字列として送信する必要があります。
**API リクエストの記録**
アカウント管理は、 の AWS API コールを記録 AWS アカウント し、ログファイルを Amazon S3 バケットに配信するサービスである CloudTrail をサポートします。 Amazon S3 CloudTrail によって収集された情報を使用して、アカウント管理に対してどのようなリクエストが行われたか (リクエストの実行者、実行日など) を判断できます。アカウント管理と CloudTrail のサポートの詳細については、「[を使用した AWS アカウント管理 API コールのログ記録 AWS CloudTrail](monitoring-cloudtrail.md)」を参照してください。CloudTrail の詳細 (有効にする方法、ログファイルを検索する方法を含む) については、[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)を参照してください。
# アクション
以下のアクションがサポートされています:
+ [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md)
+ [DeleteAlternateContact](API_DeleteAlternateContact.md)
+ [DisableRegion](API_DisableRegion.md)
+ [EnableRegion](API_EnableRegion.md)
+ [GetAccountInformation](API_GetAccountInformation.md)
+ [GetAlternateContact](API_GetAlternateContact.md)
+ [GetContactInformation](API_GetContactInformation.md)
+ [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md)
+ [GetPrimaryEmail](API_GetPrimaryEmail.md)
+ [GetRegionOptStatus](API_GetRegionOptStatus.md)
+ [ListRegions](API_ListRegions.md)
+ [PutAccountName](API_PutAccountName.md)
+ [PutAlternateContact](API_PutAlternateContact.md)
+ [PutContactInformation](API_PutContactInformation.md)
+ [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md)
# AcceptPrimaryEmailUpdate
指定されたアカウントの主要な E メールアドレス (ルートユーザーの E メールアドレスとも呼ばれる) を更新するために、[StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) から発信されたリクエストを受け入れます。
## リクエストの構文
```
POST /acceptPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"Otp": "string",
"PrimaryEmail": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
このオペレーションでアクセスまたは変更 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}`
必須: はい
** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
`StartPrimaryEmailUpdate` API コールで指定された `PrimaryEmail` に送信される OTP コード。
タイプ: 文字列
Pattern: `[a-zA-Z0-9]{6}`
必須: はい
** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
指定されたアカウントで使用する新しい主要 E メールアドレス。これは、`StartPrimaryEmailUpdate` API コールからの `PrimaryEmail` と一致する必要があります。
タイプ: 文字列
長さの制限: 最小長は 5。最大長 64
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "string"
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) **
受け入れられた主要 E メール更新リクエストのステータスを取得します。
型: 文字列
有効な値：`PENDING | ACCEPTED`
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](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
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
# DeleteAlternateContact
指定された代替連絡先を から削除します AWS アカウント。
代替連絡先オペレーションの使用方法については、「[AWS アカウントの代替連絡先を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)」を参照してください。
**注記**
AWS アカウント が管理する の代替連絡先情報を更新する前に AWS Organizations、まず AWS アカウント管理と Organizations の統合を有効にする必要があります。詳細については、「[AWS アカウント管理用の信頼されたアクセスの有効化](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)」を参照してください。
## リクエストの構文
```
POST /deleteAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_DeleteAlternateContact_RequestSyntax) **
このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。
このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。
このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。
管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。
組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) **
削除する代替連絡先を指定します。
型: 文字列
有効な値：`BILLING | OPERATIONS | SECURITY`
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
```
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** 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
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 例
### 例 1
次の例では、操作の呼び出しに使用される認証情報を持つアカウントのセキュリティ代替連絡先を削除します。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact
{
"AccountName":"MyAccount"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### 例 2
次の例では、組織内の指定されたメンバーアカウントの請求代行連絡先を削除します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"BILLING"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact)
# DisableRegion
アカウントの特定のリージョンを無効化 (オプトアウト) します。
**注記**
リージョンを無効化すると、そのリージョンに存在するリソースへのすべての IAM アクセスが削除されます。
## リクエストの構文
```
POST /disableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_DisableRegion_RequestSyntax) **
このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](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` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。
組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [RegionName](#API_DisableRegion_RequestSyntax) **
特定のリージョン名のリージョンコードを指定します (例: `af-south-1`)。リージョンを無効にすると、 AWS は、リージョン内の IAM リソースを破棄するなど、アカウント内のそのリージョンを非アクティブ化するアクションを実行します。ほとんどのアカウントでは、このプロセスに数分かかりますが、数時間かかることがあります。無効化プロセスが完全に完了するまで、そのリージョンを有効化することはできません。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
```
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](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
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DisableRegion)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion)
# EnableRegion
アカウントに対して特定のリージョンを有効化 (オプトイン) します。
## リクエストの構文
```
POST /enableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_EnableRegion_RequestSyntax) **
このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](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` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。
組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [RegionName](#API_EnableRegion_RequestSyntax) **
特定のリージョン名のリージョンコードを指定します (例: `af-south-1`)。リージョンを有効にすると、そのリージョンへの IAM リソースの配信など、 AWS がそのリージョンでアカウントを準備するためのアクションを実行します。このプロセスは、ほとんどのアカウントでは数分で完了しますが、数時間かかることもあります。このプロセスが完了するまでそのリージョンを使用することはできません。さらに、有効化プロセスが完全に完了するまで、そのリージョンを無効化することはできません。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
```
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](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
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/EnableRegion)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion)
# GetAccountInformation
アカウント名、アカウント ID、アカウント作成日時など、指定されたアカウントに関する情報を取得します。この API を使用するには、IAM ユーザーまたはロールに `account:GetAccountInformation` IAM アクセス許可が必要です。
## リクエストの構文
```
POST /getAccountInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_GetAccountInformation_RequestSyntax) **
このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。
このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。
このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。
管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。
組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"AccountCreatedDate": "string",
"AccountId": "string",
"AccountName": "string"
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) **
アカウントが作成された日時。
タイプ: タイムスタンプ
** [AccountId](#API_GetAccountInformation_ResponseSyntax) **
このオペレーションでアクセスまたは変更 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` を指定することはできません。
タイプ: 文字列
パターン: `\d{12}`
** [AccountName](#API_GetAccountInformation_ResponseSyntax) **
アカウントの名前。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
パターン: `[ -;=?-~]+`
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403
** InternalServerException **
内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 500
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 例
### 例 1
次の例では、オペレーションの呼び出しに使用される認証情報を持つアカウントのアカウント情報を取得します。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
{}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
### 例 2
次の例では、組織内の指定されたメンバーアカウントのアカウント情報を取得します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
{
"AccountId": "123456789012"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation)
# GetAlternateContact
にアタッチされた指定された代替連絡先を取得します AWS アカウント。
代替連絡先オペレーションの使用方法については、「[AWS アカウントの代替連絡先を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)」を参照してください。
**注記**
AWS アカウント が管理する の代替連絡先情報を更新する前に AWS Organizations、まず AWS アカウント管理と Organizations の統合を有効にする必要があります。詳細については、「[AWS アカウント管理用の信頼されたアクセスの有効化](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)」を参照してください。
## リクエストの構文
```
POST /getAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_GetAlternateContact_RequestSyntax) **
このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。
このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。
このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。
管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。
組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) **
取得する代替連絡先を指定します。
型: 文字列
有効な値：`BILLING | OPERATIONS | SECURITY`
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"AlternateContact": {
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "string"
}
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) **
指定された代替連絡先の詳細を含む構造体。
型: [AlternateContact](API_AlternateContact.md) オブジェクト
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** 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
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 例
### 例 1
次の例では、操作の呼び出しに使用される認証情報を持つアカウントのセキュリティ代替連絡先を取得します。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact
{
"AlternateContactType":"SECURITY"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Security"
}
}
```
### 例 2
次の例では、組織内の指定されたメンバーアカウントの操作に関する代替連絡先を取得します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"Operations"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Operations"
}
}
```
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact)
# GetContactInformation
AWS アカウントの主要連絡先情報を取得します。
主要連絡先オペレーションの使用方法については、「[AWS アカウントの主要連絡先情報を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)」を参照してください。
## リクエストの構文
```
POST /getContactInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_GetContactInformation_RequestSyntax) **
このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](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` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。
組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"ContactInformation": {
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"City": "string",
"CompanyName": "string",
"CountryCode": "string",
"DistrictOrCounty": "string",
"FullName": "string",
"PhoneNumber": "string",
"PostalCode": "string",
"StateOrRegion": "string",
"WebsiteUrl": "string"
}
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [ContactInformation](#API_GetContactInformation_ResponseSyntax) **
AWS アカウントに関連付けられた主要連絡先情報の詳細が含まれます。
型: [ContactInformation](API_ContactInformation.md) オブジェクト
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** 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
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetContactInformation)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation)
# GetGovCloudAccountInformation
GovCloud アカウント ID と状態など、指定された標準アカウント (存在する場合) にリンクされた GovCloud アカウントに関する情報を取得します。この API を使用するには、IAM ユーザーまたはロールに `account:GetGovCloudAccountInformation` IAM アクセス許可が必要です。
## リクエストの構文
```
POST /getGovCloudAccountInformation HTTP/1.1
Content-type: application/json
{
"StandardAccountId": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) **
このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。
このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。
このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。
管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。
組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"AccountState": "string",
"GovCloudAccountId": "string"
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) **
リンクされた GovCloud アカウントのアカウント状態。
型: 文字列
有効な値：`PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED`
** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **
リンクされた GovCloud アカウントの 12 桁のアカウント ID 番号。
タイプ: 文字列
パターン: `\d{12}`
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** 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 を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation)
# GetPrimaryEmail
指定されたアカウントの主要 E メールアドレスを取得します。
## リクエストの構文
```
POST /getPrimaryEmail HTTP/1.1
Content-type: application/json
{
"AccountId": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_GetPrimaryEmail_RequestSyntax) **
このオペレーションでアクセスまたは変更 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}`
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"PrimaryEmail": "string"
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) **
指定されたアカウントに関連付けられている主要 E メールアドレスを取得します。
タイプ: 文字列
長さの制限: 最小長は 5。最大長 64
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** 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
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail)
# GetRegionOptStatus
特定のリージョンのオプトインステータスを取得します。
## リクエストの構文
```
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_GetRegionOptStatus_RequestSyntax) **
このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](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` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。
組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [RegionName](#API_GetRegionOptStatus_RequestSyntax) **
特定のリージョン名のリージョンコードを指定します (例: `af-south-1`)。この関数は、このパラメータに渡されたリージョンのステータスを返します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"RegionName": "string",
"RegionOptStatus": "string"
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) **
渡されたリージョンコード。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) **
リージョンが取り得るステータスの 1 つ (有効、有効化中、無効、無効化中、デフォルトで有効)。
型: 文字列
有効な値：`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403
** InternalServerException **
内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 500
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus)
# ListRegions
特定のアカウントのすべてのリージョンと、それぞれのオプトインステータスをリストします。オプションで、このリストを `region-opt-status-contains` パラメータでフィルタリングできます。
## リクエストの構文
```
POST /listRegions HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"MaxResults": number,
"NextToken": "string",
"RegionOptStatusContains": [ "string" ]
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_ListRegions_RequestSyntax) **
このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](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` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。
組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [MaxResults](#API_ListRegions_RequestSyntax) **
コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で `NextToken` が提供されます。ページ分割を再開するには、後続コマンドの `starting-token` 引数で `NextToken` 値を指定します。 AWS CLI の外部で`NextToken`レスポンス要素を直接使用しないでください。使用例については、* AWS 「 コマンドラインインターフェイスユーザーガイド*」の[「ページ分割](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)」を参照してください。
タイプ: 整数
有効範囲: 最小値 は 1 です。最大値は 50 です。
必須: いいえ
** [NextToken](#API_ListRegions_RequestSyntax) **
ページ分割の開始場所を指定するために使用されるトークン。これは、以前に切り捨てられた応答からの `NextToken` です。使用例については、* AWS 「 コマンドラインインターフェイスユーザーガイド*」の[「ページ分割](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)」を参照してください。
タイプ: 文字列
長さの制約: 最小長は 0 です。最大長 1,000
必須: いいえ
** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) **
特定のアカウントのリージョンのリストをフィルタリングするために使用するリージョンステータス (有効化中、有効、無効化中、無効、デフォルトで有効) のリスト。例えば、値 ENABLING を渡すと、リージョンステータスが ENABLING であるリージョンのリストのみが返されます。
型: 文字列の配列
有効な値: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
必須：いいえ
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Regions": [
{
"RegionName": "string",
"RegionOptStatus": "string"
}
]
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [NextToken](#API_ListRegions_ResponseSyntax) **
返されるデータがさらにある場合、これが設定されます。`list-regions` の `next-token` リクエストパラメータに渡す必要があります。
タイプ: 文字列
** [Regions](#API_ListRegions_ResponseSyntax) **
これは、特定のアカウントのリージョンのリストです。あるいは、フィルタリングされたパラメータが使用された場合は、`filter` パラメータで設定されたフィルタ条件に一致するリージョンのリストです。
型: [Region](API_Region.md) オブジェクトの配列
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403
** InternalServerException **
内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 500
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/ListRegions)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions)
# PutAccountName
指定されたアカウントのアカウント名を更新します。この API を使用するには、IAM プリンシパルに `account:PutAccountName` IAM アクセス許可が必要です。
## リクエストの構文
```
POST /putAccountName HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AccountName": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_PutAccountName_RequestSyntax) **
このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。
このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。
このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。
管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。
組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [AccountName](#API_PutAccountName_RequestSyntax) **
アカウントの名前。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
パターン: `[ -;=?-~]+`
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
```
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403
** InternalServerException **
内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 500
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 例
### 例 1
次の例では、オペレーションの呼び出しに使用される認証情報を持つアカウント名を更新します。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
{
"AccountName":"MyAccount"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### 例 2
次の例では、組織内の指定されたメンバーアカウントのアカウント名を更新します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName)
# PutAlternateContact
にアタッチされている指定された代替連絡先を変更します AWS アカウント。
代替連絡先オペレーションの使用方法については、「[AWS アカウントの代替連絡先を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)」を参照してください。
**注記**
AWS アカウント が管理する の代替連絡先情報を更新する前に AWS Organizations、まず AWS アカウント管理と Organizations の統合を有効にする必要があります。詳細については、「[AWS アカウント管理用の信頼されたアクセスの有効化](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)」を参照してください。
## リクエストの構文
```
POST /putAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_PutAlternateContact_RequestSyntax) **
このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。
このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。
このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。
管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。
組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) **
作成または更新する代替連絡先を指定します。
型: 文字列
有効な値：`BILLING | OPERATIONS | SECURITY`
必須: はい
** [EmailAddress](#API_PutAlternateContact_RequestSyntax) **
代替連絡先の電子メールアドレスを指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 254 です。
パターン: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`
必須: はい
** [Name](#API_PutAlternateContact_RequestSyntax) **
代替連絡先の名前を指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長 64
必須: はい
** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) **
代替連絡先の電話番号を指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 25 です。
パターン: `[\s0-9()+-]+`
必須: はい
** [Title](#API_PutAlternateContact_RequestSyntax) **
代替連絡先のタイトルを指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
```
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403
** InternalServerException **
内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 500
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 例
### 例 1
次の例では、操作の呼び出しに使用される認証情報を持つアカウントの請求代行連絡先を設定します。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact
{
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### 例 2
次の例では、組織内の指定されたメンバーアカウントの請求代行連絡先を設定または上書きします。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。
#### リクエスト例
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact
{
"AccountId": "123456789012",
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### レスポンス例
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact)
# PutContactInformation
AWS アカウントの主要連絡先情報を更新します。
主要連絡先オペレーションの使用方法については、「[AWS アカウントの主要連絡先情報を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)」を参照してください。
## リクエストの構文
```
POST /putContactInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"ContactInformation": {
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"City": "string",
"CompanyName": "string",
"CountryCode": "string",
"DistrictOrCounty": "string",
"FullName": "string",
"PhoneNumber": "string",
"PostalCode": "string",
"StateOrRegion": "string",
"WebsiteUrl": "string"
}
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_PutContactInformation_RequestSyntax) **
このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](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/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。
管理アカウントは、自身の `AccountId` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。
組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。
タイプ: 文字列
パターン: `\d{12}`
必須: いいえ
** [ContactInformation](#API_PutContactInformation_RequestSyntax) **
AWS アカウントに関連付けられた主要連絡先情報の詳細が含まれます。
型: [ContactInformation](API_ContactInformation.md) オブジェクト
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
```
## レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。
** AccessDeniedException **
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403
** InternalServerException **
内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 500
** TooManyRequestsException **
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。
** errorType **
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429
** ValidationException **
入力パラメータのいずれかが無効であるため、操作が失敗しました。
** fieldList **
無効なエントリが検出されたフィールド。
** message **
リクエストのどの部分が無効だったかを知らせるメッセージ。
** reason **
検証が失敗した理由。
HTTP ステータスコード: 400
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutContactInformation)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation)
# StartPrimaryEmailUpdate
指定されたアカウントの主要 E メールアドレスを更新するプロセスを開始します。
## リクエストの構文
```
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"PrimaryEmail": "string"
}
```
## URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
## リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **
このオペレーションでアクセスまたは変更 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) **
指定されたアカウントで使用する新しい主要 E メールアドレス (ルートユーザーの E メールアドレスとも呼ばれる)。
タイプ: 文字列
長さの制限: 最小長は 5。最大長 64
必須: はい
## レスポンスの構文
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "string"
}
```
## レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **
主要 E メールの更新リクエストのステータス。
型: 文字列
有効な値：`PENDING | ACCEPTED`
## エラー
すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](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
## 以下の資料も参照してください。
言語固有の 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)
# 他の AWS サービスの関連アクション
以下のオペレーションは に関連しています AWS アカウント管理 が、 AWS Organizations 名前空間の一部です。
+ [CreateAccount](API_CreateAccount.md)
+ [CreateGovCloudAccount](API_CreateGovCloudAccount.md)
+ [DescribeAccount](API_DescribeAccount.md)
# CreateAccount
`CreateAccount` API オペレーションは、 AWS Organizations サービスによって管理される組織のコンテキストでのみ使用できます。API 操作は、そのサービスの名前空間に定義されています。
詳細については、*AWS Organizations API リファレンス*の「[CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html)」を参照してください。
# CreateGovCloudAccount
`CreateGovCloudAccount` API オペレーションは、 AWS Organizations サービスによって管理される組織のコンテキストでのみ使用できます。API 操作は、そのサービスの名前空間に定義されています。
詳細については、*AWS Organizations API リファレンス*の「[CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html)」を参照してください。
# DescribeAccount
`DescribeAccount` API オペレーションは、 AWS Organizations サービスによって管理される組織のコンテキストでのみ使用できます。API 操作は、そのサービスの名前空間に定義されています。
詳細については、*AWS Organizations API リファレンス*の「[DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html)」を参照してください。
# データ型
以下のデータ型 (タイプ) がサポートされています。
+ [AlternateContact](API_AlternateContact.md)
+ [ContactInformation](API_ContactInformation.md)
+ [Region](API_Region.md)
+ [ValidationExceptionField](API_ValidationExceptionField.md)
# AlternateContact
AWS アカウントに関連付けられた代替連絡先の詳細を含む構造
## 内容
** AlternateContactType **
代替連絡先のタイプ。
型: 文字列
有効な値：`BILLING | OPERATIONS | SECURITY`
必須：いいえ
** EmailAddress **
この代替連絡先に関連付けられているメールアドレス。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 254 です。
パターン: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`
必須: いいえ
** Name **
この代替連絡先に関連付けられている名前。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長 64
必須: いいえ
** PhoneNumber **
この代替連絡先に関連付けられている電話番号。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 25 です。
パターン: `[\s0-9()+-]+`
必須: いいえ
** Title **
この代替連絡先に関連付けられているタイトル。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: いいえ
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact)
# ContactInformation
AWS アカウントに関連付けられた主要連絡先情報の詳細が含まれます。
## 内容
** AddressLine1 **
主要連絡先住所の最初の行。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 60 です。
必須: はい
** City **
主要連絡先住所の都市。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: はい
** CountryCode **
主要連絡先住所の ISO-3166 の 2 文字の国コード。
タイプ: 文字列
長さの制限: 固定長は 2 です。
必須: はい
** FullName **
主要連絡先住所の正式名称。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: はい
** PhoneNumber **
主要連絡先情報の電話番号。この番号は検証され、一部の国では有効化の確認も行われます。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 20 です。
パターン: `[+][\s0-9()-]+`
必須: はい
** PostalCode **
主要連絡先住所の郵便番号。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 20 です。
必須: はい
** AddressLine2 **
主要連絡先住所の 2 行目 (ある場合)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 60 です。
必須: いいえ
** AddressLine3 **
主要連絡先住所の 3 行目 (ある場合)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 60 です。
必須: いいえ
** CompanyName **
主要連絡先情報に関連付けられている会社の名前 (ある場合)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: いいえ
** DistrictOrCounty **
主要連絡先住所の地区または郡 (ある場合)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: いいえ
** StateOrRegion **
主要連絡先住所の都道府県または地域。郵送先住所が米国 (US) 内にある場合、このフィールドの値は 2 文字の州コード (例: `NJ`) または州の正式名称 (例: `New Jersey`) のいずれかを使用できます。このフィールドは、`US`、`CA`、`GB`、`DE`、`JP`、`IN`、および `BR` の各国では必須です。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: いいえ
** WebsiteUrl **
主要連絡先情報に関連付けられているウェブサイトの URL (ある場合)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 256 です。
必須: いいえ
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation)
# Region
これは、特定のアカウントのリージョンを表す構造であり、名前とオプトインステータスで構成されています。
## 内容
** RegionName **
特定のリージョンのリージョンコード (例: `us-east-1`)。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: いいえ
** RegionOptStatus **
リージョンが取り得るステータスの 1 つ (有効、有効化中、無効、無効化中、デフォルトで有効)。
型: 文字列
有効な値：`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
必須: いいえ
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region)
# ValidationExceptionField
入力が、指定されたフィールドで AWS サービスによって指定された制約を満たせませんでした。
## 内容
** message **
検証例外に関するメッセージ。
タイプ: 文字列
必須: はい
** name **
無効なエントリが検出されたフィールド名。
タイプ: 文字列
必須: はい
## 以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField)
# 共通パラメータ
次のリストには、すべてのアクションが署名バージョン 4 リクエストにクエリ文字列で署名するために使用するパラメータを示します。アクション固有のパラメータは、アクションのトピックに示されています。署名バージョン 4 の詳細については、*IAM ユーザーガイド*[の AWS API リクエストの署名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)を参照してください。
**X-Amz-Algorithm**
リクエストの署名を作成するのに使用したハッシュアルゴリズム。
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。
型: 文字列
有効な値：`AWS4-HMAC-SHA256`
必須: 条件による
**X-Amz-Credential**
認証情報スコープの値で、アクセスキー、日付、対象とするリージョン、リクエストしているサービス、および終了文字列 ("aws4\$1request") を含む文字列です。値は次の形式で表現されます: [*access\$1key*/*YYYYMMDD*/*リージョン*/*サービス*/aws4\$1request]。
詳細については、*IAM* [ユーザーガイドの「署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。
型: 文字列
必須: 条件による
**X-Amz-Date**
署名を作成するときに使用する日付です。形式は ISO 8601 基本形式の YYYYMMDD'T'HHMMSS'Z' でなければなりません。例えば、日付 `20120325T120000Z` は、有効な X-Amz-Date の値です。
条件: X-Amz-Date はすべてのリクエストに対してオプションです。署名リクエストで使用する日付よりも優先される日付として使用できます。ISO 8601 ベーシック形式で日付ヘッダーが指定されている場合、X-Amz-Date は必要ありません。X-Amz-Date を使用すると、常に Date ヘッダーの値よりも優先されます。詳細については、*IAM ユーザーガイド*[の AWS API リクエスト署名の要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)を参照してください。
タイプ: 文字列
必須: 条件による
**X-Amz-Security-Token**
AWS Security Token Service () の呼び出しによって取得された一時的なセキュリティトークンAWS STS。 AWS STSの一時的なセキュリティ認証情報をサポートするサービスのリストについては、「IAM ユーザーガイド」の「[IAM と連携するAWS のサービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。
条件: から一時的なセキュリティ認証情報を使用している場合は AWS STS、セキュリティトークンを含める必要があります。
タイプ: 文字列
必須: 条件による
**X-Amz-Signature**
署名する文字列と派生署名キーから計算された 16 進符号化署名を指定します。
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。
型: 文字列
必須: 条件による
**X-Amz-SignedHeaders**
正規リクエストの一部として含まれていたすべての HTTP ヘッダーを指定します。署名付きヘッダーの指定の詳細については、*IAM* [ユーザーガイドの「署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。
条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。
型: 文字列
必須: 条件による
# 一般的なエラータイプ
このセクションでは、この AWS サービスが返す可能性のある一般的なエラータイプを一覧表示します。すべてのサービスが、ここにリストされているすべてのエラータイプを返すわけではありません。このサービスの API アクションに固有のエラーについては、その API アクションのトピックを参照してください。
**AccessDeniedException**
このアクションを実行するためのアクセス許可がありません。IAM ポリシーに必要なアクセス許可が含まれていることを確認します。
HTTP ステータスコード: 403
**ExpiredTokenException**
リクエストに含まれるセキュリティトークンの有効期限が切れています。新しいセキュリティトークンをリクエストして、もう一度試してください。
HTTP ステータスコード: 403
**IncompleteSignature**
リクエスト署名が AWS 標準に準拠していません。有効な AWS 認証情報を使用し、リクエストの形式が適切であることを確認します。SDK を使用している場合は、最新の状態であることを確認します。
HTTP ステータスコード: 403
**InternalFailure**
内部サーバーの問題のため、リクエストは現在処理できません。後でもう一度お試しください。問題が解決しない場合は、 AWS サポートにお問い合わせください。
HTTP ステータスコード: 500
**MalformedHttpRequestException**
リクエスト本文を処理できません。これは通常、指定されたコンテンツエンコーディングアルゴリズムを使用してリクエストボディを解凍できない場合に発生します。コンテンツエンコーディングヘッダーが、使用される圧縮形式と一致していることを確認します。
HTTP ステータスコード: 400
**NotAuthorized**
このアクションを実行するアクセス許可がありません。IAM ポリシーに必要なアクセス許可が含まれていることを確認します。
HTTP ステータスコード: 401
**OptInRequired**
AWS アカウントには、このサービスのサブスクリプションが必要です。アカウントでサービスが有効になっていることを確認します。
HTTP ステータスコード: 403
**RequestAbortedException**
リクエストは、レスポンスが返される前に中止されました。これは通常、クライアントが接続を閉じたときに発生します。
HTTP ステータスコード: 400
**RequestEntityTooLargeException**
リクエストエンティティが大きすぎます。リクエスト本文のサイズを小さくして、もう一度試してください。
HTTP ステータスコード: 413
**RequestTimeoutException**
リクエストがタイムアウトしました。サーバーは、予想される期間内に完全なリクエストを受信しませんでした。もう一度試してください。
HTTP ステータスコード: 408
**ServiceUnavailable**
サービスが一時的に使用できません 後でもう一度お試しください。
HTTP ステータスコード: 503
**ThrottlingException**
リクエストの頻度が多すぎます。 AWS SDKsこの例外を受け取るリクエストを自動的に再試行します。リクエストの頻度を少なくしてください。
HTTP ステータスコード: 400
**UnknownOperationException**
アクションまたはオペレーションは認識されません。アクション名のスペルが正しく、使用している API バージョンでサポートされていることを確認します。
HTTP ステータスコード: 404
**UnrecognizedClientException**
指定した X.509 証明書または AWS アクセスキー ID がレコードに存在しません。有効な認証情報を使用し、有効期限が切れていないことを確認します。
HTTP ステータスコード: 403
**ValidationError**
入力が必要な形式または制約を満たしていません。すべての必須パラメータが含まれ、値が有効であることを確認します。
HTTP ステータスコード: 400
# HTTP クエリリクエストを作成して API を呼び出す
このセクションでは、 AWS アカウント管理用の クエリ API の使用に関する一般的な情報について説明します。API 操作とエラーの詳細については、「[API リファレンス](api-reference.md)」を参照してください。
**注記**
AWS アカウント管理クエリ API を直接呼び出す代わりに、いずれかの AWS SDKs を使用できます。 AWS SDKs は、さまざまなプログラミング言語とプラットフォーム (Java、Ruby、.NET、iOS、Android など) 用のライブラリとサンプルコードで構成されています。SDKs を使用すると、 AWS アカウント管理と へのプログラムによるアクセスを簡単に作成できます AWS。例えば、SDK は要求への暗号を使用した署名、エラーの管理、要求の自動的な再試行などのタスクを処理します。 AWS SDKs[「Amazon Web Services のツール](https://aws.amazon.com/tools)」を参照してください。
AWS アカウント管理用の Query API を使用すると、サービスアクションを呼び出すことができます。クエリ API リクエストは、実行するオペレーションを示す `Action`パラメータを含む必要がある HTTPS リクエストです。 AWS アカウント管理は、すべてのオペレーションの `GET` および `POST`リクエストをサポートします。つまり、API は、あるアクションには `GET`、別のアクションには `POST` というような使い分けを必要としません。ただし、`GET` リクエストには URL サイズの制限があります。この制限はブラウザによって異なり、通常は 2,048 バイトです。したがって、大きなサイズを必要とするクエリ API リクエストでは、`POST` リクエストを使用する必要があります。
レスポンスは XML 文書です。レスポンスの詳細については、[API リファレンス](api-reference.md) の個々のアクションページを参照してください。
**Topics**
+ [エンドポイント](#endpoints)
+ [HTTPS の必要性](#IAMHTTPSRequired)
+ [AWS アカウント管理 API リクエストの署名](#SigVersion)
## エンドポイント
AWS アカウント管理には、米国東部 (バージニア北部) でホストされている単一のグローバル API エンドポイントがあります AWS リージョン。
すべてのサービスの AWS エンドポイントとリージョンの詳細については、の[「リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html)」を参照してください*AWS 全般のリファレンス*。
## HTTPS の必要性
クエリ API は、セキュリティ認証情報などの機密情報を返す可能性があるので、必ず HTTPS を使用してすべての API リクエストを暗号化する必要があります。
## AWS アカウント管理 API リクエストの署名
リクエストには、アクセスキー ID およびシークレットアクセスキーによる署名が必要です。 AWS アカウント管理の日常業務には、 AWS ルートアカウントの認証情報を使用しないことを強くお勧めします。 AWS Identity and Access Management (IAM) ユーザーの認証情報、または IAM ロールで使用する などの一時的な認証情報を使用できます。
API リクエストに署名するには、 AWS 署名バージョン 4 を使用する必要があります。署名バージョン 4 の使用の詳細については、*IAM ユーザーガイド*[の AWS API リクエストの署名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)を参照してください。
詳細については次を参照してください:
+ [AWS セキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) － AWSへのアクセスに使用できる認証情報の種類に関する一般的な情報を提供します。
+ [IAM のセキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) – IAM サービスを使用して、 AWS アカウント管理のリソースを含む AWS リソースを保護するための提案を提供します。
+ [IAM での一時的なセキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) － 一時的なセキュリティ認証情報の作成方法と使用方法を説明します。