アクセスポイントの作成 - Amazon Elastic File System

アクセスポイントの作成

アクセスポイントは一度作成すると変更できません。ファイルシステムには、最大 1,000 のアクセスポイントまで入力できます。EFS アクセスポイントの詳細については、「Amazon EFS アクセスポイントの使用」を参照してください。

AWS Management Console、AWS Command Line Interface (AWS CLI) および Amazon EFS API と SDK を使用して、Amazon EFS アクセスポイントを作成および削除できます。アクセスポイントは一度作成すると変更できません。ファイルシステムには、最大 1,000 のアクセスポイントまで入力できます。

注記

同じファイルシステム上にアクセスポイントを作成する複数のリクエストが連続して送信され、ファイルシステムが 1,000 アクセスポイントの制限に近づくと、これらのリクエストに対するスロットリングレスポンスが調整される場合があります。これは、ファイルシステムが指定されたアクセスポイントのクォータを超えないようにするためです。

  1. Amazon Elastic File System コンソール (https://console.aws.amazon.com/efs/) を開きます。

  2. [アクセスポイント]を選択して、[アクセスポイント] ウィンドウを開きます。

  3. [アクセスポイントの作成] を選択して、[アクセスポイントの作成] ページを表示します。

    また、[ファイルシステム] を選択して、[アクセスポイントの作成] ページを開くこともできます。[ファイルシステム名]または[ファイルシステムID]を選択し、その後[アクセスポイント]および[アクセスポイントの作成]を選択して、そのファイルシステム用のアクセスポイントを作成します。

    1. [Details (詳細)] パネルに、次の情報を入力します。

      • ファイルシステム - ファイルシステム名または ID を入力し、一致するファイルシステムを選択します。入力フィールドを選択したときに表示されるリストからファイルシステムを選択することもできます。

      • (オプション) [Name (名前)] - アクセスポイントの名前を入力します。

      • (オプション)[Root directory path(ルートディレクトリパス)]— アクセスポイントのルートディレクトリを指定できます。デフォルトのアクセスポイントのルートは /です。ルートディレクトリパスを入力するには、次の形式 /foo/bar を使用します。詳細については、「アクセスポイントを使用したルートディレクトリの適用」を参照してください。

    2. (オプション)[POSIX ユーザー] パネルでは、アクセスポイントを使用する NFS クライアントによるすべてのファイル操作に対して、ユーザーおよびグループ情報を適用するために使用している、完全な [POSIX ID] を指定できます。詳細については、「アクセスポイントを使用したユーザー ID の適用」を参照してください。

      • ユーザー ID – ユーザーのPOSIXユーザーIDを数値で入力します。

      • グループ ID – ユーザーのPOSIXグループIDを数値で入力します。

      • セカンダリグループ ID— セカンダリグループ ID のカンマ区切りリスト（オプション）を入力します。

    3. (オプション) ルートディレクトリの作成許可では、Amazon EFS がルートディレクトリパスを作成するときに使用するアクセス許可を指定できます (指定がされており、ルートディレクトリがまだ存在しない場合)。詳細については、「アクセスポイントを使用したルートディレクトリの適用」を参照してください。

      注記

      ルートディレクトリの所有権とアクセス許可を指定せず、ルートディレクトリがまだ存在しない場合、EFS はルートディレクトリを作成しません。アクセスポイントを使用してファイルシステムをマウントしようとすると、失敗します。

      • 所有者ユーザー ID - ルートディレクトリの所有者として使用する POSIX ユーザー ID を数値で入力します。

      • 所有者グループ ID - ルートディレクトリの所有者グループとして使用する POSIX グループ ID を数値で入力します。

      • アクセス許可 - ディレクトリの Unix モードを入力します。一般的な設定は 755 です。アクセスポイントユーザーがマウントできるように、実行ビットが設定されていることを確認します。

  4. [アクセスポイントの作成] を選択して、この設定を使用したアクセスポイントを作成します。

以下の例では、create-access-point CLI コマンドを使用して EFS ファイルシステムのアクセスポイントを作成します。同等の API コマンドは CreateAccessPoint です。

aws efs create-access-point --file-system-id fs-abcdef0123456789a --client-token 010102020-3 \
--root-directory “Path=/efs/mobileapp/east,CreationInfo={OwnerUid=0,OwnerGid=11,Permissions=775}” \
--posix-user “Uid=22,Gid=4” \
--tags Key=Name,Value=east-users

リクエストが成功すると、CLI はアクセスポイントの記述で応答します。

{
    "ClientToken": "010102020-3",
    "Name": "east-users",
    "AccessPointId": "fsap-abcd1234ef5678901",
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111122223333:access-point/fsap-abcd1234ef5678901",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "creating",
    "OwnerId": "111122223333",
    "PosixUser": { 
      "Gid": 4,
      "Uid": 22
    },
    "RootDirectory": {
    "CreationInfo": { 
         "OwnerGid": 0,
         "OwnerUid": 11,
         "Permissions": "775"
      },
        "Path": "/efs/mobileapp/east",        
    },
    "Tags": []
}
注記

同じファイルシステム上にアクセスポイントを作成する複数のリクエストが連続して送信され、ファイルシステムが 1,000 アクセスポイントの制限に近づくと、これらのリクエストに対するスロットリングレスポンスが調整される場合があります。これは、ファイルシステムが指定されたアクセスポイントのクォータを超えないようにするためです。