CreateNetworkRule -

使用說明

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

錯誤碼

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