創建一條網絡控制規則,設置允許訪問KMS的私網IP或私網網段。
使用說明
自建應用進行密碼運算操作、獲取憑據值前,需要通過應用身份憑證(ClientKey)訪問KMS實例。創建應用接入點AAP和身份憑證(ClientKey)的整體流程如下:
1. 創建網絡控制規則:設置允許訪問KMS的私網IP或私網網段。即本文介紹的內容。
2. 創建權限策略:設置允許應用訪問的密鑰和憑據,并綁定網絡控制規則。更多信息,請參見CreatePolicy。
3. 創建應用接入點:設置認證方式,并綁定權限策略。更多信息,請參見CreateApplicationAccessPoint。
4. 創建應用身份憑證(ClientKey):設置ClientKey的加密口令、有效期,并綁定應用接入點。更多信息,請參見CreateClientKey。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | CreateNetworkRule | 要執行的操作。取值:CreateNetworkRule。 |
Name | String | 是 | networkrule_test | 網絡控制規則名稱。 |
Type | String | 是 | Private | 網絡類型。 取值僅支持Private,即僅支持私網IP。 |
Description | String | 否 | networkrule description | 描述信息。 |
SourcePrivateIp | String | 否 | ["192.10.XX.XX","192.168.XX.XX/24"] | 私網IP地址或者私網網段,各個IP地址間用半角逗號(,)分隔。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
Type | String | Private | 網絡類型。 |
RequestId | String | 3bf02f7a-015b-4f93-be0f-cc043fda2dd3 | 本次調用請求的ID,是由阿里云為該請求生成的唯一標識符,可用于排查和定位問題。 |
Description | String | networkrule description | 描述信息。 |
SourcePrivateIp | String | ["192.10.XX.XX","192.168.XX.XX/24"] | 私網IP地址或者私網網段。 |
Name | String | networkrule_test | 網絡控制規則的名稱。 |
Arn | String | acs:kms:cn-hangzhou:119285303511****:network/networkrule_test | 網絡控制規則的ARN。 |
示例
請求示例
http(s)://[Endpoint]/?Action=CreateNetworkRule
&Name=networkrule_test
&Type=Private
&Description=networkrule description
&SourcePrivateIp=["192.10.XX.XX","192.168.XX.XX/24"]
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateNetworkRuleResponse>
<Type>Private</Type>
<RequestId>3bf02f7a-015b-4f93-be0f-cc043fda2dd3</RequestId>
<Description>networkrule description</Description>
<SourcePrivateIp>["192.10.XX.XX","192.168.XX.XX/24"]</SourcePrivateIp>
<Name>networkrule_test</Name>
<Arn>acs:kms:cn-hangzhou:119285303511****:network/networkrule_test</Arn>
</CreateNetworkRuleResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Type" : "Private",
"RequestId" : "3bf02f7a-015b-4f93-be0f-cc043fda2dd3",
"Description" : "networkrule description",
"SourcePrivateIp" : "[\"192.10.XX.XX\",\"192.168.XX.XX/24\"]",
"Name" : "networkrule_test",
"Arn" : "acs:kms:cn-hangzhou:119285303511****:network/networkrule_test"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?