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

DNS ファイアウォール ACL の追加

操作説明

この API は、NAT ファイアウォールを通過するトラフィックを許可、拒否、または監視するポリシーを作成します。

今すぐお試しください

この 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

write

* DNS ファイアウォールポリシー

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
SourceIp	string	任意	リクエストの送信元 IP アドレス。	140.205.118.97
Lang	string	任意	リクエストとレスポンスの言語。有効な値： - zh：中国語 - en：英語	zh
AclAction	string	必須	アクセス制御ポリシーに一致するトラフィックに適用するアクション。有効な値： accept：トラフィックを許可します。 drop：トラフィックをドロップします。 log：トラフィックを監視します。	log
Description	string	必須	アクセス制御ポリシーの説明。	test
Destination	string	必須	アクセス制御ポリシーの送信先アドレス。 DestinationType が `net` の場合、このパラメーターには送信先 CIDR ブロックを指定します。例：`1.2.3.4/24`。 DestinationType が `group` の場合、このパラメーターには送信先アドレス帳の名前を指定します。例：`db_group`。 DestinationType が `domain` の場合、このパラメーターには宛先ドメイン名を指定します。例：`.aliyuncs.com`。 DestinationType* が `location` の場合、このパラメーターには送信先リージョンを指定します。ロケーションコードの詳細は、ドキュメントをご参照ください。例：`["BJ11", "ZB"]`。	db_group
DestinationType	string	必須	アクセス制御ポリシーの送信先アドレスのタイプ。有効な値： net：送信先 CIDR ブロック group：送信先アドレス帳 domain：宛先ドメイン名	domain
Direction	string	任意	アクセス制御ポリシーで制御するトラフィックの方向。有効な値： in：インバウンドトラフィック out：アウトバウンドトラフィック	out
Source	string	必須	アクセス制御ポリシーの送信元アドレス。 SourceType が `net` の場合、このパラメーターには送信元 CIDR ブロックを指定します。例：`10.2.XX.XX/24`。 SourceType が `group` の場合、このパラメーターには送信元アドレス帳の名前を指定します。例：`db_group`。	192.168.0.223/32
SourceType	string	必須	アクセス制御ポリシーの送信元アドレスのタイプ。有効な値： net：送信元 CIDR ブロック group：送信元アドレス帳	net
Priority	string	必須	アクセス制御ポリシーの優先度。値が小さいほど優先度が高くなります。	1
Release	string	必須	アクセス制御ポリシーを有効化するかどうかを指定します。有効な値： true：アクセス制御ポリシーを有効化します。 false：アクセス制御ポリシーを無効化します。	true
IpVersion	string	必須	ポリシーがサポートする IP バージョン。有効な値： 4：IPv4 6：IPv6 列挙値: 4 : IPv4 6 : IPv6	4

レスポンスフィールド

フィールド	型	説明	例
	オブジェクト
AclUuid	文字列	アクセスコントロールリストの ID です。	f88dae6f-XXX-XXX-613de9ab2be8
RequestId	文字列	リクエスト ID です。	71209DFE-XXX-XXX-52B4A4E9DA3B

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	ErrorParametersUid	The aliUid parameter is invalid.	aliUid パラメーターが無効です。
400	ErrorDBSelect	An error occurred while querying database.	データベースのクエリ中にエラーが発生しました。
400	ErrorParameterIpVersion	The IP version is invalid.	IP バージョンが無効です。
400	ErrorParametersSource	The source is invalid.	ソースが無効です。
400	ErrorParametersDestination	The Destination parameter is invalid.	Destination パラメーターが無効です。
400	ErrorParametersAction	The action is invalid.	アクションが無効です。
400	ErrorParametersNewOrder	The newOrder is invalid.	newOrder が無効です。
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.	JSON のエンコーディング中にエラーが発生しました。
400	ErrorAclExtendedCountExceed	ACL or extended ACL rules are not matched.	ACL または拡張 ACL ルールが一致しません。
400	ErrorAclRuleDuplicate	acl rule duplicate.	同じポリシーが存在します。
400	ErrorUUIDNew	The UUID is invalid.	UUID が無効です。

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

変更履歴

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