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檔案系統識別碼。

類型：字串

長度限制：長度上限為 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戶端檔案系統的根目錄。使用存取點的用戶端只能存取根目錄及子目錄。如果 RootDirectory > Path 指定的不存在，Amazon 會EFS建立它，並在用戶端連線到存取點時套用CreationInfo設定。指定 RootDirectory 時，您必須提供 Path 和 CreationInfo。

只有在您已提供目錄的 CreationInfo： OwnUid、擁有和許可時GID，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"
      }
   ]
}