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

# HTTP クエリリクエストを作成して API を呼び出す
<a name="query-requests"></a>

このセクションでは、 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)

## エンドポイント
<a name="endpoints"></a>

AWS アカウント管理には、米国東部 (バージニア北部) でホストされている単一のグローバル API エンドポイントがあります AWS リージョン。

すべてのサービスの AWS エンドポイントとリージョンの詳細については、の[「リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html)」を参照してください*AWS 全般のリファレンス*。

## HTTPS の必要性
<a name="IAMHTTPSRequired"></a>

クエリ API は、セキュリティ認証情報などの機密情報を返す可能性があるので、必ず HTTPS を使用してすべての API リクエストを暗号化する必要があります。

## AWS アカウント管理 API リクエストの署名
<a name="SigVersion"></a>

リクエストには、アクセスキー 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) － 一時的なセキュリティ認証情報の作成方法と使用方法を説明します。