CreateAccessPoint

建立 EFS 存取點。存取點是 EFS 檔案系統的應用程式特定檢視，會將作業系統使用者和群組，以及檔案系統路徑套用至透過存取點提出的任何檔案系統請求。該作業系統使用者和群組會覆寫 NFS 用戶端提供的任何身分資訊。檔案系統路徑會公開以作為存取點的根目錄。使用存取點的應用程式只能在其專屬目錄及子目錄中存取資料。若要進一步了解，請參閱使用 EFS 存取點掛載檔案系統。

注意

在相同檔案系統上，如果快速連續傳送多個建立存取點的請求，而且檔案系統已接近 1,000 個存取點極限，您可能遇到系統對這些請求限流。這是為了確保檔案系統不會超過指定的存取點限制。

這項操作需要 elasticfilesystem:CreateAccessPoint 動作的許可。

將存取點標記在建立上。若標籤於建立動作中指定，IAM 會針對 elasticfilesystem:TagResource 動作執行其他授權，以確認使用者具備建立標籤的許可。因此，您必須授予使用 elasticfilesystem:TagResource 動作的明確許可。如需詳細資訊，請參閱在建立期間授予標記資源的許可。

請求語法


POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "FileSystemId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI 請求參數

請求不會使用任何 URI 參數。

請求主體

請求接受採用 JSON 格式的下列資料。

ClientToken

Amazon EFS 用來確保等冪建立的字串 (最多 64 個 ASCII 字元)。

類型：字串

長度限制：長度下限為 1。長度上限為 64。

模式：.+

必要：是

FileSystemId

存取點提供存取的 EFS 檔案系統 ID。

類型：字串

長度限制：長度上限為 128。

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

必要：是

PosixUser

適用於所有檔案系統請求的操作系統使用者和群組，其中請求使用存取點提出。

類型：PosixUser 物件

必要：否

RootDirectory

存取點在 EFS 檔案系統上公開的目錄，即爲 NFS 用戶端透過該存取點存取 EFS 檔案系統的根目錄。使用存取點的用戶端只能存取根目錄及子目錄。如果 RootDirectory > Path 指定不存在，Amazon EFS 會在用戶端連線到存取點時建立目錄並應用 CreationInfo 設定。指定 RootDirectory 時，您必須提供 Path 和 CreationInfo。

只有在您已為目錄提供下 CreationInfo列項目 OwnUid、OwnGID 和許可時，Amazon EFS 才會建立根目錄。如果您未提供此資訊，則 Amazon EFS 不會建立根目錄。如果根目錄不存在，嘗試使用存取點掛載將會失敗。

類型：RootDirectory 物件

必要：否

Tags

建立與存取點關聯的標籤。每一個標記都是金鑰對數值，每一個金鑰必須唯一。如需詳細資訊，請參閱《 AWS 一般參考指南》中的標記 AWS 資源。

類型：Tag 物件陣列

必要：否

回應語法


HTTP/1.1 200
Content-type: application/json

{
   "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"
      }
   ]
}