創建掛載點。
接口說明
- 在使用 CreateMountTarget 接口創建掛載點時部分資源的生成是異步完成的。因此在執行 CreateMountTarget 接口成功后，請先調用 DescribeMountTargets 接口查詢掛載點狀態，當掛載點狀態為 Active 后再執行掛載文件系統操作，否則可能會掛載失敗。
- 調用此接口將自動創建操作所需的 NAS 服務關聯角色。更多信息，請參見管理 NAS 服務關聯角色。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| nas:CreateMountTarget | create | *FileSystem acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}*VSwitch acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| FileSystemId | string | 是 | 文件系統 ID。
說明
僅中國站支持 CPFS 文件系統。
| 174494**** |
| AccessGroupName | string | 否 | 權限組名稱。 當目標文件系統為通用型 NAS 或極速型 NAS 時，此參數必填。 默認權限組：DEFAULT_VPC_GROUP_NAME（專有網絡默認權限組）。 | vpc-test |
| NetworkType | string | 是 | 掛載點網絡類型。取值為 Vpc，表示專有網絡。 | Vpc |
| VpcId | string | 否 | 專有網絡 ID。 當網絡類型是專有網絡，此字段必填且有意義。 例如： NetworkType=VPC 時，VpcId 為必填項。 | vpc-2zesj9afh3y518k9o**** |
| VSwitchId | string | 否 | 交換機 ID。 當網絡類型是專有網絡，此字段必填且有意義。 例如： NetworkType=VPC 時，VSwitchId 為必填項。 | vsw-2zevmwkwyztjuoffg**** |
| SecurityGroupId | string | 否 | 安全組 ID。 | sg-bp1fg655nh68xyz9**** |
| EnableIpv6 | boolean | 否 | 是否創建 IPv6 掛載點。 取值：
說明
當前僅極速型 NAS 中國內地各地域支持 IPv6 功能，且該文件系統需要開啟 IPv6 功能。
| true |
| DryRun | boolean | 否 | 校驗是否有存量掛載點。僅支持校驗 CPFS 文件系統。 預檢操作會幫助您檢查參數有效性、校驗庫存等，并不會實際創建掛載點，也不會產生費用。
| false |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "70EACC9C-D07A-4A34-ADA4-77506C42****",
"MountTargetDomain": "174494b666-x****.cn-hangzhou.nas.aliyuncs.com",
"MountTargetExtra": {
"DualStackMountTargetDomain": "174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com"
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 202 | RequestAccepted | The request has been accepted by the server. | 請求已被后端接受。 |
| 400 | InvalidFileSystem.NotsupportedIPv6 | The file system does not support IPv6. | 該文件系統不支持IPv6。 |
| 400 | InvalidVSwitch.Ipv6NotTurnOn | The VSwitch you are currently using has not enabled the IPv6 function. Please enable this function first and try again. | 您當前使用的交換機不支持IPv6功能，請開啟此功能后重試。 |
| 400 | IdempotentParameterMismatch | The same client token was passed in to different parameters. | 相同的ClientToken傳入了不同的參數。 |
| 400 | MissingParameter.AccessGroupName | You must specify AccessGroupName when you create a standard or extreme file system mount target. | 創建通用型或極速型文件系統掛載點時權限組參數必填。 |
| 400 | InvalidVSwitchId.IpNotEnough | The number of the specified VSwitch IP address is insufficient. | 指定的交換機IP數量不足。 |
| 400 | InvalidParameter.ConflictVpcCidr | The specified VPC CIDR conflicts with the server. | 指定的VPC網段與服務端沖突。 |
| 400 | DryRunOperation | The request is validated with DryRun flag set. | 請求校驗通過。 |
| 400 | SubAccount.NoStandardSLRPermission | The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasStandard. Please authorize the RAM user the permission ram:CreateServiceLinkedRole. | 當前RAM用戶沒有權限創建AliyunServiceRoleForNasStandard SLR角色，請授權RAM用戶ram:CreateServiceLinkedRole權限。 |
| 403 | OperationDenied.InvalidState | The operation is not permitted when the status is processing. | 狀態處理中不允許此操作。 |
| 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 | InvalidMountTarget.AlreadyExisted | The specified mount target already exists. | 指定的掛載點已經存在。 |
| 403 | Resource.OutOfStock | The inventory of the specified zone is insufficient. | 指定的可用區庫存不足。 |
| 403 | OperationDenied.MountTargetExceedLimit | The maximum number of mount target in the specified file system is exceeded. | 當前文件系統的掛載點達到上限。 |
| 404 | InvalidParameter.VswNotFound | The specified VSwitch does not exist. | 指定的虛擬交換機不存在。 |
| 404 | InvalidParameter.VpcNotFound | The specified VPC does not exist. | 指定的VPC網絡不存在。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的文件系統不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-09-25 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |