創建接入點。
接口說明
- 在使用 CreateAccessPoint 接口創建接入點時部分資源的生成是異步完成的。因此在執行 CreateAccessPoint 接口成功后，請先調用 DescribeAccessPoints 或者 DescribeAccessPoint 接口查詢接入點狀態，當接入點狀態為 Active 后再執行掛載文件系統操作，否則可能會掛載失敗。
- 僅通用型 NAS NFS 協議文件系統支持該功能。
- 如果開啟 RAM 策略（EnabledRam），需要配置對應的 RAM 權限，具體請參考管理接入點。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| 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 | 否 | 屬主用戶 ID。 當 RootDirectory 目錄不存在時，該參數必填。 | 1 |
| OwnerGroupId | integer | 否 | 屬主用戶組 ID。 當 RootDirectory 目錄不存在時，該參數必填。 | 1 |
| Permission | string | 否 | POSIX 權限。默認值為“0755”。限制：必須以 0 開頭的四位八進制數字。 當填寫 OwnerUserId 和 OwnerGroupId 參數后，此字段生效。 | 0755 |
| PosixUserId | integer | 否 | Posix 用戶 ID。 | 123 |
| PosixGroupId | integer | 否 | Posix 用戶組 ID。 | 123 |
| PosixSecondaryGroupIds | string | 否 | 第二用戶組。多個用戶組 ID 時，使用半角逗號（,）分隔。 | 123,345 |
返回參數
示例
正常返回示例
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. | 指定的交換機不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史