更新时间:2026-08-18 GMT+08:00
分享

创建接入点 - CreateAccessPoint

功能介绍

用于创建接入点

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    kms:accessPoint:create

    Write

    accessPoint *

    -

    -

    -

URI

POST /v1.0/{project_id}/kms/access-points

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID。可参考获取项目ID获取。

约束限制:

不涉及

取值范围:

以IAM服务接口返回值为准,字符长度32-32。

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及

取值范围:

IAM服务查询用户Token接口为准

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

keyspace_id

String

参数解释:

接入点归属的可信密钥空间ID

约束限制:

UUID格式,满足正则表达式^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

取值范围:

不涉及

默认取值:

不涉及

access_point_name

String

参数解释:

接入点的名称

约束限制:

满足正则表达式^[a-zA-Z0-9:/_-]{1,255}$

取值范围:

1-255

默认取值:

不涉及

type

Integer

参数解释:

接入点的类型

约束限制:

不涉及

取值范围:

  • 1:ECS

  • 2:CCE

  • 3:Custom

默认取值:

不涉及

identity

String

参数解释:

接入点的唯一标志

约束限制:

ECS接入点填入ecs_id

CCE接入点填入CCE集群公钥信息

Custom接入点无需填写,创建Custom接入点后,会生成一对密钥对,可以下载私钥,使用私钥签名,服务端验证签名

取值范围:

不涉及

默认取值:

不涉及

cluster_id

String

参数解释:

创建CCE接入点时必填,CCE集群ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

description

String

参数解释:

接入点描述信息

约束限制:

不涉及

取值范围:

1-255

默认取值:

不涉及

响应参数

状态码:201

表4 响应Body参数

参数

参数类型

描述

access_point_id

String

参数解释:

创建的接入点ID

取值范围:

不涉及

请求示例

响应示例

状态码

状态码

描述

201

请求已成功

错误码

请参见错误码

相关文档