DescribeAccessPoints - Amazon Elastic File System
リクエストの構文URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

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

DescribeAccessPoints

AccessPointId が指定されている場合、特定の Amazon EFS アクセスポイントの説明を返します。を指定するEFSとFileSystemId、そのファイルシステムのすべてのアクセスポイントの説明が返されます。リクエストには、AccessPointId または FileSystemId のどちらかを指定できますが、両方を指定することはできません。

このオペレーションには、elasticfilesystem:DescribeAccessPoints アクションに対する許可が必要です。

リクエストの構文

GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

URI リクエストパラメータ

リクエストでは、次のURIパラメータを使用します。

AccessPointId

（オプション) レスポンスで記述するEFSアクセスポイントを指定します。 と相互に排他的ですFileSystemId。

長さの制限：最大長は 128 です。

パターン：^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

FileSystemId

（オプション) を指定するとFileSystemId、 はそのファイルシステムのすべてのアクセスポイントEFSを返します。 と相互に排他的ですAccessPointId。

長さの制限：最大長は 128 です。

パターン：^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

MaxResults

(オプション）ファイルシステムのすべてのアクセスポイントを取得する際に、オプションで MaxItems パラメータを指定して、応答で返されるオブジェクトの数を制限することができます。デフォルト値は 100 です。

有効な範囲: 最小値 は 1 です。

NextToken

NextToken は応答がページ割りされている場合に存在します。後続のリクエストで NextMarker を使うと、次のページのアクセスポイントの説明を取得することができます。

長さの制限：最小長は 1 です。最大長は 128 です。

Pattern: .+

リクエストボディ

リクエストにリクエスト本文がありません。

レスポンスの構文

HTTP/1.1 200
Content-type: application/json

{
   "AccessPoints": [ 
      { 
         "AccessPointArn": "string",
         "AccessPointId": "string",
         "ClientToken": "string",
         "FileSystemId": "string",
         "LifeCycleState": "string",
         "Name": "string",
         "OwnerId": "string",
         "PosixUser": { 
            "Gid": number,
            "SecondaryGids": [ number ],
            "Uid": number
         },
         "RootDirectory": { 
            "CreationInfo": { 
               "OwnerGid": number,
               "OwnerUid": number,
               "Permissions": "string"
            },
            "Path": "string"
         },
         "Tags": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      }
   ],
   "NextToken": "string"
}

レスポンス要素

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

以下のデータは、 サービスによって JSON 形式で返されます。

AccessPoints

アクセスポイントの説明の配列。

型: AccessPointDescription オブジェクトの配列

NextToken

応答で返されるよりも多くのアクセスポイントがある場合に表示されます。後続のリクエスト NextMarker で を使用して、追加の説明を取得できます。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

パターン：.+

エラー

AccessPointNotFound

指定されたAccessPointId値がリクエスタの に存在しない場合に返されます AWS アカウント。

HTTP ステータスコード: 404

BadRequest

リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。

HTTP ステータスコード: 400

FileSystemNotFound

指定されたFileSystemId値がリクエスタの に存在しない場合に返されます AWS アカウント。

HTTP ステータスコード: 404

InternalServerError

サーバー側でエラーが発生した場合に返されます。

HTTP ステータスコード: 500

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。