建立一個應用存取點。
介面說明
-
RAM 使用者或 RAM 角色調用該 OpenAPI 需要被授與權限策略詳情,請參見存取控制。
-
自建應用進行密碼運算操作、擷取憑據值前,需要通過應用身份憑證(ClientKey)訪問 KMS 執行個體。建立應用存取點 AAP 和身份憑證(ClientKey)的整體流程如下:
建立網路控制規則:設定允許訪問 KMS 的私網 IP 或私網網段。更多資訊,請參見 CreateNetworkRule 。
建立權限原則:設定允許應用訪問的密鑰和憑據,並綁定網路控制規則。更多資訊,請參見 CreatePolicy 。
建立應用存取點:設定認證方式,並綁定權限原則。即本文介紹的內容。
建立應用身份憑證(ClientKey):設定 ClientKey 的加密口令、有效期間,並綁定應用存取點。更多資訊,請參見 CreateClientKey 。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| 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. | 資源已存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。