

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

# API リファレンス
<a name="api-reference"></a>

アカウント管理 (`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/)を参照してください。