本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateAccessPoint 建立 EFS 存取點。存取點是 EFS 檔案系統的應用程式特定檢視，會將作業系統使用者和群組，以及檔案系統路徑套用至透過存取點提出的任何檔案系統請求。該作業系統使用者和群組會覆寫 NFS 用戶端提供的任何身分資訊。檔案系統路徑會公開以作為存取點的根目錄。使用存取點的應用程式只能在其專屬目錄及子目錄中存取資料。除非您請求增加，否則檔案系統最多可以有 10，000 個存取點。若要進一步了解，請參閱[使用 EFS 存取點掛載檔案系統](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html)。 **注意** 如果在同一個檔案系統上傳送多個建立存取點的請求，且檔案系統接近存取點的限制，您可能會遇到這些請求的限流回應。這是為了確保檔案系統不會超過指定的存取點限制。 這項操作需要 `elasticfilesystem:CreateAccessPoint` 動作的許可。 將存取點標記在建立上。若標籤於建立動作中指定，IAM 會針對 `elasticfilesystem:TagResource` 動作執行其他授權，以確認使用者具備建立標籤的許可。因此，您必須授予使用 `elasticfilesystem:TagResource` 動作的明確許可。如需詳細資訊，請參閱[在建立期間授予標記資源的許可](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html)。 ## 請求語法 ``` 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](#API_CreateAccessPoint_RequestSyntax) ** Amazon EFS 用來確保等冪建立的字串 (最多 64 個 ASCII 字元)。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` 必要：是 ** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) ** 存取點提供存取的 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](#API_CreateAccessPoint_RequestSyntax) ** 適用於所有檔案系統請求的操作系統使用者和群組，其中請求使用存取點提出。 類型：[PosixUser](API_PosixUser.md) 物件 必要：否 ** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) ** 存取點在 EFS 檔案系統上公開的目錄，即爲 NFS 用戶端透過該存取點存取 EFS 檔案系統的根目錄。使用存取點的用戶端只能存取根目錄及子目錄。如果 `RootDirectory` > `Path` 指定不存在，Amazon EFS 會在用戶端連線到存取點時建立目錄並應用 `CreationInfo` 設定。指定 `RootDirectory` 時，您必須提供 `Path` 和 `CreationInfo`。 只有在您提供目錄的 CreationInfo：OwnUid、OwnGID 和許可時，Amazon EFS 才會建立根目錄。如果您未提供此資訊，則 Amazon EFS 不會建立根目錄。如果根目錄不存在，嘗試使用存取點掛載將會失敗。 類型：[RootDirectory](API_RootDirectory.md) 物件 必要：否 ** [Tags](#API_CreateAccessPoint_RequestSyntax) ** 建立與存取點關聯的標籤。每一個標記都是金鑰對數值，每一個金鑰必須唯一。如需詳細資訊，請參閱《 * AWS 一般參考指南*》中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。 類型：[Tag](API_Tag.md) 物件陣列 必要：否 ## 回應語法 ``` 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" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) ** 與存取點關聯的唯一 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度上限為 128。 模式：`^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$` ** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) ** 由 Amazon EFS 指派的存取點 ID。 類型：字串 長度限制：長度上限為 128。 模式：`^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) ** 請求中指定的不透明字串，以確保等冪建立。 類型：字串 長度限制：長度下限為 1。長度上限為 64。 模式：`.+` ** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) ** 存取點套用至 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})$` ** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) ** 識別存取點的生命周期階段。 類型：字串 有效值:`creating | available | updating | deleting | deleted | error` ** [Name](#API_CreateAccessPoint_ResponseSyntax) ** 存取點的名稱。這是 `Name` 標籤的值。 類型：字串 ** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) ** 識別 AWS 帳戶 擁有存取點資源的 。 類型：字串 長度限制：長度上限為 14。 模式：`^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) ** 完整的 POSIX 身分識別，包括存取點上的使用者 ID、群組 ID 和次要群組 ID，這些 ID 適用於 NFS 用戶端使用存取點的所有檔案作業。 類型：[PosixUser](API_PosixUser.md) 物件 ** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) ** 存取點在 EFS 檔案系統上公開的目錄，即爲 NFS 用戶端透過該存取點存取 EFS 檔案系統的根目錄。 類型：[RootDirectory](API_RootDirectory.md) 物件 ** [Tags](#API_CreateAccessPoint_ResponseSyntax) ** 與存取點相關聯的標籤，顯示為「標籤」物件的陣列。 類型：[Tag](API_Tag.md) 物件陣列 ## 錯誤 ** AccessPointAlreadyExists ** 如果您嘗試創建的存取點已經存在，並使用您在請求中提供的創建權杖，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** AccessPointLimitExceeded ** 如果 AWS 帳戶 已建立每個檔案系統允許的存取點數量上限，則傳回。如需詳細資訊，請參閱 [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region)。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：403 ** BadRequest ** 如果請求格式錯誤或包含錯誤，例如無效的參數值或缺少必要參數，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：400 ** FileSystemNotFound ** 如果指定的`FileSystemId`值不存在於請求者的 中，則傳回 AWS 帳戶。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：404 ** IncorrectFileSystemLifeCycleState ** 如果檔案系統的生命週期狀態不是「可用」，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：409 ** InternalServerError ** 如果伺服器端發生錯誤，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：500 ** ThrottlingException ** 當 `CreateAccessPoint` API 動作呼叫太快且檔案系統上的存取點數目接近 [120 的限制](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region)，則傳回。 ** ErrorCode ** 錯誤代碼是一個字串，專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。 ** Message ** 錯誤訊息包含錯誤狀況的一般英文描述，目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時，會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密，而且經過適當的國際化，所以很可能會忽略錯誤訊息。 HTTP 狀態碼：429 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)