全部产品
Search
文档中心

密钥管理服务:CreateApplicationAccessPoint - 创建应用接入点

更新时间:Aug 28, 2026

创建一个应用接入点。

接口说明

  • RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情,请参见访问控制

  • 自建应用进行密码运算操作、获取凭据值前,需要通过应用身份凭证(ClientKey)访问 KMS 实例。创建应用接入点 AAP 和身份凭证(ClientKey)的整体流程如下:

    1. 创建网络控制规则:设置允许访问 KMS 的私网 IP 或私网网段。更多信息,请参见 CreateNetworkRule

    2. 创建权限策略:设置允许应用访问的密钥和凭据,并绑定网络控制规则。更多信息,请参见 CreatePolicy

    3. 创建应用接入点:设置认证方式,并绑定权限策略。即本文介绍的内容。

    4. 创建应用身份凭证(ClientKey):设置 ClientKey 的加密口令、有效期,并绑定应用接入点。更多信息,请参见 CreateClientKey

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

Name

string

应用接入点名称。

aap_test

Description

string

描述信息。

aap description

AuthenticationMethod

string

认证方式。目前仅支持 ClientKey。

ClientKey

Policies

string

绑定的权限策略。

说明

每个应用接入点最多允许绑定 3 个权限策略。

["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"]

返回参数

名称

类型

描述

示例值

object

RequestId

string

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

bcfefe15-46f0-44a3-bd96-3d422474b71a

Description

string

描述信息。

aap description

Policies

string

绑定的权限策略。

["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"]

Name

string

应用接入点名称。

aap_test

Arn

string

应用接入点的 ARN。

acs:kms:cn-hangzhou:119285303511****:applicationaccesspoint/aap_test

AuthenticationMethod

string

认证方式。

ClientKey

示例

正常返回示例

JSON格式

{
  "RequestId": "bcfefe15-46f0-44a3-bd96-3d422474b71a",
  "Description": "aap description",
  "Policies": "[\"kst-hzz62ee817bvyyr5x****.efkd\",\"kst-hzz62ee817bvyyr5x****.eyyp\"]",
  "Name": "aap_test",
  "Arn": "acs:kms:cn-hangzhou:119285303511****:applicationaccesspoint/aap_test",
  "AuthenticationMethod": "ClientKey"
}

错误码

HTTP status code

错误码

错误信息

描述

409 Rejected.ResourceExist The request was rejected because the resource already exists. 资源已存在。

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情