翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon EFS API
Amazon EFS API は、[HTTP (RFC 2616)](https://www.ietf.org/rfc/rfc2616.txt) に基づくネットワークプロトコルです。各 API コールについて、ファイルシステムを管理する AWS リージョン の リージョン固有の Amazon EFS API エンドポイントへの HTTP リクエストを行います。API は、HTTP リクエスト/応答本文に JSON (RFC 4627) ドキュメントを使用します。
Amazon EFS API は RPC モデルです。このモデルでは、オペレーションの固定の設定があり、各オペレーションの構文は、事前に操作しなくてもクライアントに知られています。次のセクションでは、理論上の RPC 表記を使用する各 API オペレーションについて説明します。それぞれには、オンラインでは表示されないオペレーション名があります。各オペレーションでは、トピックが HTTP リクエスト要素のマッピングを指定します。
リクエストがマッピングされる特定のAmazon EFSオペレーションは、リクエストのメソッド（GET、PUT、POST、またはDELETE）と、Request-URIがマッチする様々なパターンの組み合わせによって決定されます。オペレーションが PUT または POST の場合、Amazon EFSは Request-URI パスセグメント、クエリ パラメータ、およびリクエストボディ内のJSON オブジェクトからコール引数を抽出します。
**注記**
`CreateFileSystem` といったオペレーション名はオンラインには表示されませんが、これらのオペレーション名は AWS Identity and Access Management (IAM) ポリシーにとって意味があります。詳細については、「[Amazon EFS のためのアイデンティティとアクセス管理](security-iam.md)」を参照してください。
オペレーション名は、コマンドラインツールのコマンド名や AWS SDK API の要素にも使用されます。たとえば、`CreateFileSystem` オペレーションにマッピングする `create-file-system` という AWS CLI コマンドがあります。
オペレーション名は、Amazon EFS API コールの AWS CloudTrail ログ内にも表示されます。
## API エンドポイント
エンドポイントは、AWS ウェブサービスのエントリポイントとなる URL です。Amazon EFS は以下のエンドポイントタイプをサポートします。
+ IPv4 エンドポイント
+ デュアルスタック (IPv4 および IPv6) エンドポイント
+ [FIPS エンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html#FIPS-endpoints)
リクエストを行うと、使用するエンドポイントを指定できます。エンドポイントを指定しない場合、デフォルトで IPv4 エンドポイントが使用されます。別のエンドポイントタイプを使用するには、リクエストで指定する必要があります。これを行う方法の例については、「[エンドポイントの指定](#endpoints-specifying)」を参照してください。使用可能なエンドポイントの表については、「[Amazon EFS のエンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/elasticfilesystem.html)」を参照してください。
### IPv4 エンドポイント
IPv4 エンドポイントは IPv4 トラフィックのみをサポートします。IPv4 エンドポイントは、全リージョンで利用できます。IPv4 エンドポイントの形式は、リージョンによって異なります。
+ AWS 商用リージョンの IPv4 エンドポイントの場合、形式は `elasticfilesystem.{{region}}.amazonaws.com` です。
例えば、`elasticfilesystem.us-west-2.amazonaws.com` をエンドポイントとして指定した場合、リクエストは 米国西部 (オレゴン) リージョン (us-west-2) のエンドポイントに転送されます。
+ 中国リージョンの IPv4 エンドポイントの場合、形式は `elasticfilesystem.{{region}}.amazonaws.com.rproxy.govskope.us.cn` です。
例えば、中国 (北京) リージョンの Amazon EFS API エンドポイントは `elasticfilesystem---cn-north-1.amazonaws.com.rproxy.govskope.us.cn` です。
### デュアルスタック (IPv4 および IPv6) エンドポイント
デュアルスタックエンドポイントは、IPv4 と IPv6 トラフィックの両方をサポートします。デュアルスタックエンドポイントにリクエストを行うと、エンドポイント URL は、ネットワークとクライアントが使用するプロトコルに応じて IPv6 または IPv4 アドレスに解決されます。デュアルスタックエンドポイントの形式は、リージョンによって異なります。
+ AWS 商用リージョンのデュアルスタックエンドポイントの場合、形式は `efs.{{aws-region}}.api.aws` です。
例えば、米国西部 (オレゴン) リージョン (us-west-2) のデュアルスタックエンドポイントは `efs.eu-west-2.api.aws` です。
+ 中国リージョンのデュアルスタックエンドポイントの場合、形式は `efs.{{region}}.api.amazonwebservices.com.rproxy.govskope.us.cn` です。
例えば、中国 (北京) リージョンのデュアルスタックエンドポイントは `efs---cn-north-1---api.amazonwebservices.com.rproxy.govskope.us.cn` です。
### エンドポイントの指定
次の例は、Amazon EFS の AWS CLI を使用して米国西部 (北カリフォルニア) リージョン (us-west-1) のエンドポイントを指定する方法を示しています。
IPv4
```
aws efs get-rest-apis --region us-west-1 --endpoint-url https://{{elasticfilesystem.us-west-1.amazonaws.com}}
```
デュアルスタック
```
aws efs get-rest-apis --region us-west-1 --endpoint-url https://{{efs.us-west-1.api.aws}}
```
## API バージョン
コールに使用される API のバージョンは、リクエスト URI の最初のパスセグメントにより特定されます。この形式は ISO 8601 の日付になります。例については、「[CreateFileSystem](API_CreateFileSystem.md)」を参照してください。
ドキュメントでは、API バージョン 2015-02-01 について説明されています。
## 関連トピック
以下のセクションでは、API オペレーション、認証リクエスト用の署名を作成する方法、IAM ポリシーを使用して、これらの API オペレーションのためのアクセス許可を付与する方法を説明します。
+ [Amazon EFS のためのアイデンティティとアクセス管理](security-iam.md)
+ [アクション](API_Operations.md)
+ [データ型](API_Types.md)
## Amazon EFS のクエリ API リクエスト率の使用
Amazon EFS API のリクエストはリージョンごとに各 AWS アカウント に対してスロットルされ、サービスパフォーマンスの向上に役立ちます。Amazon EFS API コールはすべて、アプリケーション、AWS CLI、Amazon EFS コンソールのいずれから発信されたかにかかわらず、許可される API リクエスト率の最大値を超えることはできません。最大 API リクエスト率は AWS リージョン 間で異なる場合があります。API リクエストは、基盤となる AWS アカウント に属性があります。
API リクエストがそのカテゴリの API リクエスト率を超過する場合、`ThrottlingException` エラーコードが返されます。このエラーを回避するには、アプリケーションが API リクエストを再試行する率を低くします。これは、ポーリングの際に注意深くし、エクスポネンシャルバックオフの再試行を使用することにより行えます。
### ポーリング
アプリケーションにより API オペレーションを繰り返しコールして、ステータスの更新をチェックする必要がある場合があります。ポーリングを開始する前に、リクエストの予想完了時間を指定します。ポーリングを開始するとき、連続するリクエストの間に適切なスリープ間隔を使用します。最良の結果を得るには、漸増スリープ間隔を使用します。
### 再試行またはバッチ処理
アプリケーションは、API リクエストが失敗した後に再試行するか、複数のリソースを処理する必要がある場合があります (たとえば、Amazon EFS ファイルシステムすべて)。API リクエストの率を下げるには、連続するリクエストの間に適切なスリープ間隔を使用します。最良の結果を得るには、漸増または可変スリープ間隔を使用します。
### スリープ間隔の計算
API リクエストをポーリングまたは再試行する必要がある場合は、エクスポネンシャルバックオフ アルゴリズムを使用して API コール間のスリープ間隔を計算することをお勧めします。エクスポネンシャルバックオフの背後にある考え方は、連続したエラー応答の再試行間の待機時間を徐々に長く使用することです。詳細およびこのアルゴリズムの実装の例については、「*Amazon Web Services 全般のリファレンス*」の「[再試行動作](https://docs.aws.amazon.com/general/latest/gr/api-retries.html)」を参照してください。