CreateApplicationAccessPoint -

使用說明

自建應用進行密碼運算操作、擷取憑據值前，需要通過應用身份憑證（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.	資源已存在。

訪問錯誤中心查看更多錯誤碼。