AddDnsFirewallPolicy - Cloud Firewall - Alibaba Cloud ドキュメントセンター

DNS ファイアウォールのアクセス制御リスト (ACL) を追加します。

操作説明

DNS ファイアウォールを通過するトラフィックを許可、拒否、またはモニターするための DNS ファイアウォールコントロールポリシーを作成します。

クォータの説明

DNS ファイアウォールポリシーは、DNS ポリシーテーブル内で独立してカウントされます（IP バージョンごとに別々にカウント）が、インターネットアクセスの制御ポリシーと同じクォータ上限を共有します（Cloud Firewall のエディションによって決定）。単一のポリシー展開後のアドレス組み合わせ数が上限を超える場合、またはユーザーポリシーの総数が上限を超える場合、エラー ErrorAclExtendedCountExceed (-200139) が返されます。

説明

DescribeAclCheckQuota によって返される値は、ACL ポリシーチェック（検査）回数のクォータであり、ファイアウォールポリシー数クォータとは無関係です。この値を使用して、この操作のクォータが十分かどうかを予測することはできません。ファイアウォールポリシー数のクォータは、Cloud Firewall コンソールで確認してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-cloudfirewall:AddDnsFirewallPolicy

get

*DnsFirewallPolicy。

acs:yundun-cloudfirewall::{#accountId}:dnsfirewallpolicy/*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SourceIp	string	任意	リクエストのソース IP アドレス。	140.205.118.97
Lang	string	任意	リクエストおよび応答の言語。有効な値: zh: 中国語 en: 英語	zh
AclAction	string	必須	コントロールポリシー内のトラフィックに対して Cloud Firewall が実行する操作。有効な値: accept: 許可。 drop: 拒否。 log: ログ。	log
Description	string	必須	コントロールポリシーの説明。	指定されたドメイン名を許可
Destination	string	必須	コントロールポリシーの送信先アドレス。 DestinationType が net に設定されている場合、Destination は送信先 CIDR ブロックです。例: 1.2.3.4/24。 DestinationType が group に設定されている場合、Destination は送信先アドレス帳名です。例: db_group。 DestinationType が domain に設定されている場合、Destination は送信先ドメイン名です。例: .aliyuncs.com。 DestinationType* が location に設定されている場合、Destination は送信先エリアです（後述のエリア位置エンコーディングを参照）。例: ["BJ11", "ZB"]。	db_group
DestinationType	string	必須	DNS ファイアウォールコントロールポリシーにおける送信先アドレスのタイプ。group（送信先アドレス帳）および domain（送信先ドメイン名）のみがサポートされています。net および CIDR アドレスは、この操作には該当なしです。	domain
Direction	string	任意	DNS ファイアウォールコントロールポリシーのトラフィックの方向。説明このパラメーターはバックエンドで検証されません。DNS ファイアウォールポリシーを作成または変更する場合、方向は常に out（アウトバウンド）として保存されます。in を渡してもエラーは発生せず、効果もありません。DNS ファイアウォールはアウトバウンドポリシーのみをサポートしています。	out
Source	string	必須	コントロールポリシーのソースアドレス。有効な値: SourceType が `net` に設定されている場合、Source はソース CIDR ブロックです。例: 10.2.XX.XX/24。 SourceType が `group` に設定されている場合、Source はソースアドレス帳名です。例: db_group。	192.168.0.223/32
SourceType	string	必須	コントロールポリシーにおけるソースアドレスのタイプ。有効な値: net: ソース CIDR ブロック group: ソースアドレス帳	net
Priority	string	必須	DNS ファイアウォールポリシーのポリシー優先度。有効な値: 1～20000。値が小さいほど、ポリシー優先度が高くなります。	1
Release	string	必須	コントロールポリシーの有効ステータス。作成後、ポリシーはデフォルトで有効になります。有効な値: true: コントロールポリシーを有効にします。 false: コントロールポリシーを無効にします。	true
IpVersion	string	必須	IP アドレスのバージョン。有効な値: 4: IPv4 6: IPv6 列挙値: 4 : IPv4 6 : IPv6	4

レスポンスフィールド

フィールド	型	説明	例
	object
AclUuid	string	コントロールポリシーの一意の ID。	f88dae6f-XXX-XXX-613de9ab2be8
RequestId	string	リクエスト ID。	71209DFE-XXX-XXX-52B4A4E9DA3B

例

成功レスポンス

JSONJSON

{
  "AclUuid": "f88dae6f-XXX-XXX-613de9ab2be8",
  "RequestId": "71209DFE-XXX-XXX-52B4A4E9DA3B"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	ErrorParametersUid	The aliUid parameter is invalid.
400	ErrorDBSelect	An error occurred while querying database.
400	ErrorParameterIpVersion	The IP version is invalid.
400	ErrorParametersSource	The source is invalid.
400	ErrorParametersDestination	The Destination parameter is invalid.
400	ErrorParametersAction	The action is invalid.
400	ErrorParametersNewOrder	The newOrder is invalid.
400	ErrorParameters	Parameters error.
400	ErrorAddressCountExceed	The maximum number of addresses is exceeded.
400	ErrorDBInsert	An error occurred while performing an insert operation in the database.
400	ErrorRecordLog	An error occurred while updating the operation log.
400	ErrorMarshalJSON	An error occurred while encoding JSON.
400	ErrorAclExtendedCountExceed	ACL or extended ACL rules are not matched.
400	ErrorAclRuleDuplicate	acl rule duplicate.
400	ErrorUUIDNew	The UUID is invalid.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。