アクセスポイントの作成

フォーカスモード

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

Amazon EFS アクセスポイントを作成および削除するには、、 AWS Command Line Interface （AWS CLI） AWS Management Console、Amazon EFS API および SDKsを使用します。アクセスポイントは一度作成すると変更できません。ファイルシステムは、引き上げをリクエストしない限り、最大 10,000 個のアクセスポイントを持つことができます。

注記

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

EFS アクセスポイントの詳細については、「Amazon EFS アクセスポイントの使用」を参照してください。

Amazon Elastic File System コンソールの https://console.aws.amazon.com/efs/ を開いてください。
[アクセスポイント]を選択して、[アクセスポイント] ウィンドウを開きます。
[アクセスポイントの作成] を選択して、[アクセスポイントの作成] ページを表示します。

また、[ファイルシステム] を選択して、[アクセスポイントの作成] ページを開くこともできます。[ファイルシステム名]または[ファイルシステム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 です。アクセスポイントユーザーがマウントできるように、実行ビットが設定されていることを確認します。
[アクセスポイントの作成] を選択して、この設定を使用したアクセスポイントを作成します。

アクセスポイントの作成 (コンソール)

Amazon Elastic File System コンソールの https://console.aws.amazon.com/efs/ を開いてください。
[アクセスポイント]を選択して、[アクセスポイント] ウィンドウを開きます。
[アクセスポイントの作成] を選択して、[アクセスポイントの作成] ページを表示します。

また、[ファイルシステム] を選択して、[アクセスポイントの作成] ページを開くこともできます。[ファイルシステム名]または[ファイルシステム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 です。アクセスポイントユーザーがマウントできるように、実行ビットが設定されていることを確認します。
[アクセスポイントの作成] を選択して、この設定を使用したアクセスポイントを作成します。

以下の例では、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": []
}

注記

アクセスポイントの作成 (CLI)


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": []
}