创建接入点。
接口说明
- 在使用 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. | 指定的交换机不存在。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|
暂无变更历史