修改NAT防火墻安全訪問控制策略的配置信息。
接口說明
本接口一般用于修改流量通過 NAT 防火墻方式為放行、拒絕或觀察的訪問控制策略的配置信息。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
yundun-cloudfirewall:ModifyNatFirewallControlPolicy | update | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Lang | string | 否 | 請求和接收消息的語言類型。取值:
| zh |
AclAction | string | 是 | 安全訪問控制策略中流量通過云防火墻的方式。取值:
| log |
Description | string | 是 | 訪問控制策略的描述信息。支持模糊查詢。 說明
不設置該參數表示查詢所有策略的描述信息。
| 描述信息 |
DestPort | string | 否 | VPC 邊界防火墻訪問控制策略中流量訪問的目的端口。 說明
當 DestPortType 為 port 時,設置該參數。
| 80 |
Destination | string | 是 | 安全訪問控制策略中的目的地址。
| x.x.x.x/32 |
DestinationType | string | 是 | 安全訪問控制策略中的目的地址類型。取值:
| net |
NatGatewayId | string | 是 | NAT 網關的 ID。 | ngw-xxxxxx |
Proto | string | 是 | 安全訪問控制策略中流量訪問的安全協議類型。支持的應用類型有以下幾種:
說明
ANY 表示策略應用在所有類型的應用中。
說明
訪問的目的地址為域名類型的威脅情報地址簿或云服務地址簿時,可選配置 TCP 協議。選擇 TCP 時,應用可選 HTTP/HTTPS/SMTP/SMTPS/SSL 五種。
| TCP |
Source | string | 是 | 訪問控制策略中的源地址。取值:
| 10.2.XX.XX/24 |
AclUuid | string | 是 | 訪問控制策略的唯一標識 ID。 刪除安全訪問控制策略,需要提供該策略的唯一標識 ID。您可調用 DescribeNatFirewallControlPolicy 接口獲取該 ID。 | 63ab1c02-926a-4d1b-9ef7-***** |
Direction | string | 否 | 訪問控制策略的流量方向。取值:
| out |
SourceType | string | 是 | 訪問控制策略中的源地址類型。取值:
| net |
DestPortType | string | 否 | 安全訪問控制策略中訪問流量的目的端口類型。
| port |
DestPortGroup | string | 否 | 訪問控制策略中訪問流量的目的端口地址簿名稱。 | my_dest_port_group |
Release | string | 否 | 安全訪問控制策略的狀態。取值:
| true |
ApplicationNameList | array | 否 | 應用名稱 | |
string | 否 | 訪問控制策略支持的應用類型列表。 | ANY | |
DomainResolveType | string | 否 | 訪問控制策略的域名解析方式。取值:
| 0 |
RepeatType | string | 否 | 訪問控制策略的策略有效期的重復類型。取值:
| Permanent |
RepeatDays | array | 否 | 訪問控制策略的策略有效期的重復日期集合。
說明
RepeatType 設置為 Weekly 時,RepeatDays 不允許重復。
說明
RepeatType 設置為 Monthly 時,RepeatDays 不允許重復。
| |
long | 否 | 訪問控制策略的策略有效期的重復日期。 說明
RepeatType 設置為 Weekly 時,取值范圍:0~6,每周開始于周日。
RepeatType 設置為 Monthly 時,取值范圍:1~31。
| 1 | |
RepeatStartTime | string | 否 | 訪問控制策略的策略有效期的重復開始時間。例如:08:00,必須為整點或半點時間,且小于重復結束時間至少半小時。 說明
當 RepeatType 為 Permanent、None 時,RepeatStartTime 為空。當 RepeatType 為 Daily、Weekly、Monthly 時,RepeatStartTime 必須有值,您需要設置重復開始時間。
| 08:00 |
RepeatEndTime | string | 否 | 訪問控制策略的策略有效期的重復結束時間。例如:23:30,必須為整點或半點時間,且大于重復開始時間至少半小時。 說明
當 RepeatType 為 Permanent、None 時,RepeatEndTime 為空。當 RepeatType 為 Daily、Weekly、Monthly 時,RepeatEndTime 必須有值,您需要設置重復結束時間。
| 23:30 |
StartTime | long | 否 | 訪問控制策略的策略有效期的開始時間。使用秒級時間戳格式表示。必須為整點或半點時間,且小于結束時間至少半小時。 說明
當 RepeatType 為 Permanent 時,StartTime 為空。當 RepeatType 為 None、Daily、Weekly、Monthly 時,StartTime 必須有值,您需要設置開始時間。
| 1694761200 |
EndTime | long | 否 | 訪問控制策略的策略有效期的結束時間。使用秒級時間戳格式表示。必須為整點或半點時間,且大于開始時間至少半小時。 說明
當 RepeatType 為 Permanent 時,EndTime 為空。當 RepeatType 為 None、Daily、Weekly、Monthly 時,EndTime 必須有值,您需要設置結束時間。
| 1694764800 |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "3768197C-E6E8-52CD-8358-*****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | ErrorParametersUid | The aliUid parameter is invalid. | aliUid 不合法 |
400 | ErrorDBSelect | An error occurred while querying database. | 內部錯誤:數據庫查詢錯誤 |
400 | ErrorParametersAppId | The AppId parameter is incorrect. | AppId不正確 |
400 | ErrorParametersSource | The source is invalid. | 無效的來源 |
400 | ErrorParametersProto | The protocol is invalid. | 無效的協議 |
400 | ErrorParametersDestination | The Destination parameter is invalid. | Destination參數非法 |
400 | ErrorParametersDestPort | The dst_port is invalid. | 無效的目的端口 |
400 | ErrorParametersAction | The action is invalid. | 無效的動作 |
400 | ErrorAddressCountExceed | The maximum number of addresses is exceeded. | 地址簿內地址數量超出上限 |
400 | ErrorAclNotExist | The ACL does not exist. | ACL不存在 |
400 | ErrorRecordLog | An error occurred while updating the operation log. | 寫日志失敗 |
400 | ErrorParametersDestinationCount | Exceeding the number of countries in a single ACL. | 超出一條ACL選取區域個數, 建議拆分成多條ACL |
400 | ErrorAclExtendedCountExceed | ACL or extended ACL rules are not matched. | ACL或擴展ACL規格超出限制 |
400 | ErrorAclEffectiveTimeNonPermanent | ACL rule is not allowed to update status when effective is not permanent. | Acl策略生效時間非永久時,不允許更新狀態。 |
400 | ErrorParametersNatGatewayId | Invalid parameters NatGatewayId. | 請求參數NatGatewayId不合法或不存在。 |
400 | ErrorUUIDNew | The UUID is invalid. | 內部錯誤:UUID錯誤 |
400 | ErrorParameterIpVersion | The IP version is invalid. | IP版本參數錯誤 |
400 | ErrorParametersDirection | The direction is invalid. | 無效的方向 |
400 | ErrorDomainResolve | An error occurred while resolving the domain. | 域名解析錯誤 |
400 | ErrorParameters | Parameters error. | 參數錯誤。 |
400 | ErrorDBInsert | An error occurred while performing an insert operation in the database. | 內部錯誤:數據庫插入錯誤 |
400 | ErrorDBUpdate | internal error: sql updat. | 請求錯誤,數據庫更新失敗。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-08-22 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-12-07 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-10-12 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |