创建一个应用接入点。
使用说明
自建应用进行密码运算操作、获取凭据值前，需要通过应用身份凭证（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. | 资源已存在。 |
访问错误中心查看更多错误码。