CreateApplicationAccessPoint_密钥管理服务(Key Management Service)-阿里云帮助中心

使用说明

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

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

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

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

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	CreateApplicationAccessPoint	要执行的操作。取值：CreateApplicationAccessPoint。
Name	String	是	aap_test	应用接入点名称。
Description	String	否	aap description	描述信息。
AuthenticationMethod	String	否	ClientKey	认证方式。目前仅支持ClientKey。
Policies	String	是	["kst-hzz62ee817bvyyr5x**.efkd","kst-hzz62ee817bvyyr5x**.eyyp"]	绑定的权限策略。说明每个应用接入点最多允许绑定3个权限策略。

返回数据

名称	类型	示例值	描述
RequestId	String	bcfefe15-46f0-44a3-bd96-3d422474b71a	本次调用请求的ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。
Description	String	aap description	描述信息。
Policies	String	["kst-hzz62ee817bvyyr5x**.efkd","kst-hzz62ee817bvyyr5x**.eyyp"]	绑定的权限策略。
Name	String	aap_test	应用接入点名称。
Arn	String	acs:kms:cn-hangzhou:119285303511****:applicationaccesspoint/aap_test	应用接入点的ARN。
AuthenticationMethod	String	ClientKey	认证方式。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateApplicationAccessPoint
&Name=aap_test
&Description=aap description
&AuthenticationMethod=ClientKey
&Policies=["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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"
}

错误码

HttpCode	错误码	错误信息	描述
409	Rejected.ResourceExist	The request was rejected because the resource already exists.	资源已存在。

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