建立存取點。
介面說明
在使用 CreateAccessPoint 介面建立存取點時部分資源的產生是非同步完成的。因此在執行 CreateAccessPoint 介面成功後，請先調用 DescribeAccessPoints 或者 DescribeAccessPoint 介面查詢存取點狀態，當存取點狀態為 Active 後再執行掛載檔案系統操作，否則可能會掛載失敗。
僅通用型 NAS NFS 協議檔案系統支援該功能。
如果開啟 RAM 策略（EnabledRam），需要配置對應的 RAM 許可權，具體請參考管理存取點。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
nas:CreateAccessPoint |
create |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| FileSystemId |
string |
是 |
檔案系統 ID。 |
31a8e4**** |
| AccessGroup |
string |
是 |
許可權組名稱。 當目標檔案系統為通用型 NAS，此參數必填。 預設許可權組：DEFAULT_VPC_GROUP_NAME（專用網路預設許可權組）。 |
DEFAULT_VPC_GROUP_NAME |
| VswId |
string |
是 |
交換器 ID。 |
vsw-2zevmwkwyztjuoffg**** |
| VpcId |
string |
是 |
專用網路 ID。 |
vpc-2zesj9afh3y518k9o**** |
| AccessPointName |
string |
否 |
存取點名稱。 |
test |
| RootDirectory |
string |
否 |
存取點根目錄。 預設值為“/”， 如果存取點目錄不存在，則還需要填寫 OwnerUserId 和 OwnerGroupId 參數。 |
/ |
| EnabledRam |
boolean |
否 |
是否啟用 RAM 策略。 取值：
說明
啟用存取點 RAM 策略以後，預設禁止所有 RAM 帳號使用存取點掛載和訪問資料，您需要為帳號進行授權開放對應存取權限，並通過存取點進行掛載訪問。禁用後，存取點允許匿名掛載。關於如何配置存取點許可權，關於如何配置存取點許可權，請參見配置存取點策略。 |
false |
| OwnerUserId |
integer |
否 |
屬主使用者識別碼。 當 RootDirectory 目錄不存在時，該參數必填。 |
1 |
| OwnerGroupId |
integer |
否 |
屬主使用者組 ID。 當 RootDirectory 目錄不存在時，該參數必填。 |
1 |
| Permission |
string |
否 |
POSIX 許可權。預設值為“0755”。限制：必須以 0 開頭的四位八位元字。 當填寫 OwnerUserId 和 OwnerGroupId 參數後，此欄位生效。 |
0755 |
| PosixUserId |
integer |
否 |
Posix 使用者識別碼。 |
123 |
| PosixGroupId |
integer |
否 |
Posix 使用者組 ID。 |
123 |
| PosixSecondaryGroupIds |
string |
否 |
第二使用者組。多個使用者組 ID 時，使用半形逗號（,）分隔。 |
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 不存在，請先建立Virtual Private Cloud。 |
| 404 | InvalidVswitch.NotFound | The specified VSwitch does not exist. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。