CreateApplicationAccessPoint
創(chuàng)建一個(gè)應(yīng)用接入點(diǎn)。
使用說(shuō)明
自建應(yīng)用進(jìn)行密碼運(yùn)算操作、獲取憑據(jù)值前，需要通過(guò)應(yīng)用身份憑證（ClientKey）訪問(wèn)KMS實(shí)例。創(chuàng)建應(yīng)用接入點(diǎn)AAP和身份憑證（ClientKey）的整體流程如下：
1. 創(chuàng)建網(wǎng)絡(luò)控制規(guī)則：設(shè)置允許訪問(wèn)KMS的私網(wǎng)IP或私網(wǎng)網(wǎng)段。更多信息，請(qǐng)參見(jiàn)CreateNetworkRule。
2. 創(chuàng)建權(quán)限策略：設(shè)置允許應(yīng)用訪問(wèn)的密鑰和憑據(jù)，并綁定網(wǎng)絡(luò)控制規(guī)則。更多信息，請(qǐng)參見(jiàn)CreatePolicy。
3. 創(chuàng)建應(yīng)用接入點(diǎn)：設(shè)置認(rèn)證方式，并綁定權(quán)限策略。即本文介紹的內(nèi)容。
4. 創(chuàng)建應(yīng)用身份憑證（ClientKey）：設(shè)置ClientKey的加密口令、有效期，并綁定應(yīng)用接入點(diǎn)。更多信息，請(qǐng)參見(jiàn)CreateClientKey。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
|
名稱(chēng) |
類(lèi)型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | CreateApplicationAccessPoint | 要執(zhí)行的操作。取值：CreateApplicationAccessPoint。 |
| Name | String | 是 | aap_test | 應(yīng)用接入點(diǎn)名稱(chēng)。 |
| Description | String | 否 | aap description | 描述信息。 |
| AuthenticationMethod | String | 否 | ClientKey | 認(rèn)證方式。目前僅支持ClientKey。 |
| Policies | String | 是 | ["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"] | 綁定的權(quán)限策略。 說(shuō)明 每個(gè)應(yīng)用接入點(diǎn)最多允許綁定3個(gè)權(quán)限策略。 |
返回?cái)?shù)據(jù)
名稱(chēng) |
類(lèi)型 |
示例值 |
描述 |
| RequestId | String | bcfefe15-46f0-44a3-bd96-3d422474b71a | 本次調(diào)用請(qǐng)求的ID，是由阿里云為該請(qǐng)求生成的唯一標(biāo)識(shí)符，可用于排查和定位問(wèn)題。 |
| Description | String | aap description | 描述信息。 |
| Policies | String | ["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"] | 綁定的權(quán)限策略。 |
| Name | String | aap_test | 應(yīng)用接入點(diǎn)名稱(chēng)。 |
| Arn | String | acs:kms:cn-hangzhou:119285303511****:applicationaccesspoint/aap_test | 應(yīng)用接入點(diǎn)的ARN。 |
| AuthenticationMethod | String | ClientKey | 認(rèn)證方式。 |
示例
請(qǐng)求示例
http(s)://[Endpoint]/?Action=CreateApplicationAccessPoint
&Name=aap_test
&Description=aap description
&AuthenticationMethod=ClientKey
&Policies=["kst-hzz62ee817bvyyr5x****.efkd","kst-hzz62ee817bvyyr5x****.eyyp"]
&公共請(qǐng)求參數(shù)正常返回示例
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"
}錯(cuò)誤碼
|
HttpCode |
錯(cuò)誤碼 |
錯(cuò)誤信息 |
描述 |
| 409 | Rejected.ResourceExist | The request was rejected because the resource already exists. | 資源已存在。 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。