調用CreateIpMappingRule接口創建授權規則IP的重定向功能。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| IoTCloudConnectorId | string | 是 | 云連接器實例 ID。 | iotcc-bp1odcab8tmno0hdq**** |
| DestinationIp | string | 是 | 重定向的目標 IP 地址。 | 192.168.10.8 |
| MappingIp | string | 是 | 需要進行重定向的 IP 地址。 | 47.0.XX.XX |
| IpMappingRuleName | string | 否 | 需要進行 IP 重定向的授權規則名稱。 名稱長度為 2~128 個字符，以大小寫字母或中文開頭，可包含數字、半角句號（.）、下劃線（_）和短劃線（-）。 | name |
| IpMappingRuleDescription | string | 否 | 需要進行 IP 重定向的授權規則描述。 長度為 2~256 個字符，必須以字母或中文開頭，但不能以 | description |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。
| 123e4567-e89b-12d3-a456-426655440000 |
| DryRun | boolean | 否 | 是否只預檢此次請求。取值：
| false |
| RegionId | string | 是 | 實例所在的地域 ID。 您可以通過調用 ListRegions 接口獲取地域 ID。 | cn-hangzhou |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
"IpMappingRuleId": "im-irrp3bzuu5nrbx****"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Forbidden.RAM | Ram user does not have permission to perform this operation. | RAM用戶無權限執行此操作。 |
| 400 | OperationDenied.DomainFeatureDisabled | The operation is not allowed because of domain feature disabled. | - |
| 400 | IllegalParam.Destination | The param of Destination is illegal. | Destination無效 |
| 400 | ResourceAlreadyExist.AuthorizationRule | The specified resource of AuthorizationRule already exists. | 規則已經存在 |
| 400 | Conflict.Param | The param is conflict. | - |
| 400 | Conflict.Cidr | The cidr is conflict. | - |
| 400 | ResourceNotFound.IoTCloudConnector | The param of IoTCloudConnectorId is illegal. | IoTCloudConnectorId參數非法 |
| 400 | QuotaExceeded.sourceCidrLimit | The quota of SourceCidrsPerAuthorizationRule is exceeded | SourceCidrsPerAuthorizationRule quota超出 |
| 400 | IllegalParam | The param is illegal. | 參數非法 |
| 400 | QuotaExceeded.authorizationRuleInstanceLimit | The quota of AuthorizationRulePerIotCC is exceeded | - |
| 400 | IllegalParamFormat | The param is illegal. | - |
| 400 | ResourceInConfiguring.IoTCloudConnector | The specified resource of IoTCloudConnector is configuring, please try again later. | iotcc狀態非穩態，或者鎖沖突 |
| 400 | OperationDenied.DomainInHumanNetwork | The operation is not allowed because of domain or CIDR in human network. | 配置的域名或者網段在人聯網里面，不被允許。 |
| 400 | OperationDenied.CIDRMaskTooLarge | The operation is not allowed because of CIDR too large. | CIDR掩碼太大了。 |
訪問錯誤中心查看更多錯誤碼。