創(chuàng)建或編輯網(wǎng)站業(yè)務(wù)精確訪問控制規(guī)則。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級別：是指每個(gè)操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| yundun-ddoscoo:ModifyWebPreciseAccessRule | update |
|
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ResourceGroupId | string | 否 | DDoS 高防實(shí)例在資源管理產(chǎn)品中所屬的資源組 ID。默認(rèn)為空，即屬于默認(rèn)資源組。 | rg-acfm2pz25js**** |
| Domain | string | 是 | 網(wǎng)站業(yè)務(wù)的域名。 說明
域名必須已配置網(wǎng)站業(yè)務(wù)轉(zhuǎn)發(fā)規(guī)則。您可以調(diào)用 DescribeDomains 查詢所有域名。
| example.aliyundoc.com |
| Rules | string | 是 | 精確訪問控制規(guī)則的配置，使用 JSON 格式的字符串表述，具體結(jié)構(gòu)如下。
| [{"action":"block","name":"testrule","condition":[{"field":"uri","match_method":"contain","content":"/test/123"}]}] |
| Expires | integer | 否 | 規(guī)則有效期。單位：秒。規(guī)則的匹配動作為阻斷時(shí)（action 為 block）生效，在規(guī)則有效期內(nèi)阻斷訪問請求。不傳入該參數(shù)表示永久生效。 | 600 |
field 和 match_method 的取值及對應(yīng)關(guān)系
| 匹配字段（field） | 描述 | 適用的邏輯符（match_method） |
|---|---|---|
| ip | 訪問請求的來源 IP。 | belong ：屬于 nbelong ：不屬于 |
| uri | 訪問請求的 URI 地址。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 regular ：正則匹配 |
| referer | 訪問請求的來源網(wǎng)址，即該訪問請求是從哪個(gè)頁面跳轉(zhuǎn)產(chǎn)生的。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 nexist ：不存在 regular ：正則匹配 |
| user-agent | 發(fā)起訪問請求的客戶端的瀏覽器標(biāo)識、渲染引擎標(biāo)識和版本信息等瀏覽器相關(guān)信息。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 regular ：正則匹配 |
| params | 訪問請求的 URL 地址中的參數(shù)部分，通常指 URL 中”?”后面的部分。例如，demo.aliyundoc.com/index.html?action=login中的action=login就是參數(shù)部分。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 |
| cookie | 訪問請求中的 Cookie 信息。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 nexist ：不存在 |
| content-type | 訪問請求指定的響應(yīng) HTTP 內(nèi)容類型，即 MIME 類型信息。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 |
| x-forwarded-for | 訪問請求的客戶端真實(shí) IP。X-Forwarded-For（XFF）用來識別通過 HTTP 代理或負(fù)載均衡方式轉(zhuǎn)發(fā)的訪問請求的客戶端最原始的 IP 地址的 HTTP 請求頭字段，只有通過 HTTP 代理或者負(fù)載均衡服務(wù)器轉(zhuǎn)發(fā)的訪問請求才會包含該項(xiàng)。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 nexist ：不存在 regular ：正則匹配 |
| content-length | 訪問請求的所包含的字節(jié)數(shù)。 | vless ：值小于 vequal ：值等于 vgreat ：值大于 |
| post-body | 訪問請求的內(nèi)容信息。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 regular ：正則匹配 |
| http-method | 訪問請求的方法，如 GET、POST 等。 | equal ：等于 nequal ：不等于 |
| header | 訪問請求的頭部信息，用于自定義 HTTP 頭部字段。 | contain ：包含 ncontain ：不包含 equal ：等于 nequal ：不等于 lless ：長度小于 lequal ：長度等于 lgreat ：長度大于 nexist ：不存在 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "F908E959-ADA8-4D7B-8A05-FF2F67F50964"
}錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。