建立存取點。
介面說明
在使用 CreateAccessPoint 介面建立存取點時，部分資源的產生是非同步完成的。因此在執行 CreateAccessPoint 介面成功後，請先呼叫 DescribeAccessPoints 或 DescribeAccessPoint 介面查詢存取點狀態，當存取點狀態為 Active 後再執行掛載檔案系統操作，否則可能會掛載失敗。
僅通用型 NAS NFS 通訊協定檔案系統支援此功能。
如果開啟 RAM 策略（EnabledRam），需要設定對應的 RAM 權限，具體請參考管理存取點。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
nas:CreateAccessPoint |
create |
*All Resource
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| FileSystemId |
string |
是 |
檔案系統 ID。 |
31a8e4**** |
| AgenticSpaceId |
string |
否 |
AgenticSpace Id。 說明
Agentic 檔案系統必填。 |
agentic-229oypxjgpau2**** |
| AccessGroup |
string |
否 |
權限群組名稱。 當目標檔案系統為通用型 NAS 時，此參數必填。 預設權限群組：DEFAULT_VPC_GROUP_NAME（專用網路預設權限群組）。 說明
Agentic 檔案系統不支援。 |
DEFAULT_VPC_GROUP_NAME |
| VswId |
string |
是 |
交換器 ID。 |
vsw-2zevmwkwyztjuoffg**** |
| VpcId |
string |
是 |
專用網路 ID。 |
vpc-2zesj9afh3y518k9o**** |
| AccessPointName |
string |
否 |
存取點名稱。 |
test |
| RootDirectory |
string |
否 |
存取點根目錄。 預設值為「/」，如果存取點目錄不存在，則還需要填寫 OwnerUserId 和 OwnerGroupId 參數。 說明
Agentic 檔案系統不支援。 |
/ |
| EnabledRam |
boolean |
否 |
是否啟用 RAM 策略。 取值：
說明
啟用存取點 RAM 策略以後，預設禁止所有 RAM 帳號使用存取點掛載和存取資料，您需要為帳號進行授權開放對應存取權限，並透過存取點進行掛載存取。停用後，存取點允許匿名掛載。關於如何設定存取點權限，請參見設定存取點策略。 說明
Agentic 檔案系統時，取值必須為 true。 |
false |
| OwnerUserId |
integer |
否 |
屬主使用者 ID。 當 RootDirectory 目錄不存在時，該參數必填。 說明
Agentic 檔案系統不支援。 |
1 |
| OwnerGroupId |
integer |
否 |
屬主使用者群組 ID。 當 RootDirectory 目錄不存在時，該參數必填。 說明
Agentic 檔案系統不支援。 |
1 |
| Permission |
string |
否 |
POSIX 權限。預設值為「0755」。限制：必須以 0 開頭的四位八進位數字。 當填寫 OwnerUserId 和 OwnerGroupId 參數後，此欄位生效。 說明
Agentic 檔案系統不支援。 |
0755 |
| PosixUserId |
integer |
否 |
Posix 使用者 ID。 說明
Agentic 檔案系統不支援。 |
123 |
| PosixGroupId |
integer |
否 |
Posix 使用者群組 ID。 說明
Agentic 檔案系統不支援。 |
123 |
| PosixSecondaryGroupIds |
string |
否 |
第二使用者群組。多個使用者群組 ID 時，使用半形逗號（,）分隔。 說明
Agentic 檔案系統不支援。 |
123,345 |
| Tag |
array<object> |
否 |
存取點標籤清單。 |
|
|
object |
否 |
存取點標籤清單。 |
||
| Key |
string |
否 |
標籤鍵。 限制：
|
TestKey |
| Value |
string |
否 |
標籤值。 限制：
|
TestValue |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
請求 ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| AccessPoint |
object |
存取點。 |
|
| AccessPointDomain |
string |
存取點網域。 |
ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com |
| AccessPointId |
string |
存取點 ID。 |
ap-ie15yd**** |
樣本
正常返回樣本
JSON格式
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****\n",
"AccessPoint": {
"AccessPointDomain": "ap-ie15ydanoz.001014****-w****.cn-hangzhou.nas.aliyuncs.com",
"AccessPointId": "ap-ie15yd****"
}
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidRequest | The request is invalid. | 請求無效。 |
| 403 | InvalidProtocolType.NotSupported | The specified protocol type does not supported. | 指定的通訊協定類型不支援。 |
| 403 | InvalidRamRole.NotExist | The specified RAM role does not exist. | 指定的 RAM 角色不存在。 |
| 403 | InvalidRamRole.NoPermission | The specified RAM role does not have sufficient permission. | 指定的 RAM 角色權限不足。 |
| 403 | OperationDenied.AccessPointCountsExceeded | The maxium number of access point has reached its limits. | 當前檔案系統的接入點達到上限。 |
| 404 | InvalidAccessGroup.NotFound | The specified AccessGroup does not exist. | 您指定的權限群組不存在或已刪除。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的檔案系統不存在。 |
| 404 | InvalidVpc.NotFound | The specified Vpc is not found. | 您指定的 VPC 不存在，請先建立專有網路 VPC。 |
| 404 | InvalidVswitch.NotFound | The specified VSwitch does not exist. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。