DescribeDnsFirewallPolicy - - Centre de documentation Alibaba Cloud

Consulte la liste des listes de contrôle d'accès (ACL) du pare-feu DNS.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

yundun-cloudfirewall:DescribeDnsFirewallPolicy

get

*DnsFirewallPolicy

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SourceIp	string	Non	L'adresse IP source de la requête.	140.205.118.XXX
Lang	string	Non	La langue des messages de réponse. Valeurs valides : zh (chinois) et en (anglais).	zh
Lang	string	Non	La langue des messages de réponse. Valeurs valides : zh (chinois) et en (anglais).	zh
CurrentPage	string	Oui	Le numéro de page à renvoyer. Valeur par défaut : 1.	1
PageSize	string	Oui	Le nombre d'entrées à renvoyer sur chaque page.	10
Source	string	Non	L'adresse source dans la stratégie de pare-feu DNS. La correspondance approximative est prise en charge. Remarque La valeur de Source peut être un bloc CIDR ou un carnet d'adresses.	192.0.XX.XX/24
Destination	string	Non	L'adresse de destination dans la stratégie de pare-feu DNS. La correspondance approximative est prise en charge. Remarque La valeur de Destination peut être un bloc CIDR, un nom de domaine ou un carnet d'adresses.	10.2.XX.XX/24
Description	string	Non	La description de la stratégie de pare-feu DNS.	test
AclAction	string	Non	L'action effectuée sur le trafic correspondant à la stratégie de pare-feu DNS. Valeurs valides : accept : autorise le trafic. drop : refuse le trafic. log : surveille le trafic. Remarque Si vous ne spécifiez pas ce paramètre, les stratégies de tous les types d'action sont interrogées.	accept
Release	string	Non	L'état de la stratégie de contrôle d'accès. La stratégie est activée par défaut après sa création. Valeurs valides : true : active la stratégie de contrôle d'accès. false : désactive la stratégie de contrôle d'accès.	true
AclUuid	string	Non	L'identifiant unique de la règle de pare-feu.	b6c8f905-2eb6-442a-ba35-9416e****
IpVersion	string	Non	La version IP prise en charge. Valeurs valides : 4 : IPv4 6 : IPv6 Valeurs valides : 4 : IPv4 6 : IPv6	4

Éléments de réponse

Élément	Type	Description	Exemple
	object
PageNo	string	Le numéro de page.	1
PageSize	string	Le nombre d'entrées par page.	10
RequestId	string	L'identifiant de la requête.	0A4ACDE9-9F9F-56C1-B3B7-60971BA1****
TotalCount	string	Le nombre total d'entrées.	10
Policys	array<object>	Les stratégies de contrôle d'accès du pare-feu DNS.
	object	La stratégie de contrôle d'accès du pare-feu DNS.
Direction	string	La direction du trafic à laquelle s'applique la stratégie de contrôle d'accès. Valeurs valides : in : trafic entrant out : trafic sortant	in
DestinationGroupType	string	Le type de carnet d'adresses de destination dans la stratégie de contrôle d'accès. Valeurs valides : ip : un carnet d'adresses IP domain : un carnet d'adresses de domaine	ip
HitLastTime	integer	La dernière fois que la stratégie a été déclenchée. La valeur est un horodatage UNIX. Unité : secondes.	1579261141
Destination	string	L'adresse de destination dans la stratégie de contrôle d'accès. Valeurs valides : Si DestinationType est `net`, la valeur de ce paramètre est un bloc CIDR de destination. Si DestinationType est `domain`, la valeur de ce paramètre est un domaine de destination. Si DestinationType est `group`, la valeur de ce paramètre est le nom d'un carnet d'adresses de destination.	x.x.x.x/32
SourceType	string	Le type d'adresse source dans la stratégie de contrôle d'accès. Valeurs valides : net : un bloc CIDR source group : un carnet d'adresses source	net
AclUuid	string	L'identifiant unique de la stratégie de contrôle d'accès.	01281255-d220-4db1-8f4f-c4df221a****
Priority	integer	La priorité de la stratégie de contrôle d'accès. Une valeur plus petite indique une priorité plus élevée.	110
Source	string	L'adresse source dans la stratégie de contrôle d'accès. Valeurs valides : Si SourceType est `net`, la valeur de ce paramètre est un bloc CIDR source. Exemple : 192.0.XX.XX/24. Si SourceType est `group`, la valeur de ce paramètre est le nom d'un carnet d'adresses source. Exemple : db_group. Si SourceType est `location`, la valeur de ce paramètre est un emplacement. Pour plus d'informations sur les valeurs valides de ce paramètre, consultez AddControlPolicy. Exemple : ["BJ11", "ZB"].	192.0.XX.XX/24
DestinationType	string	Le type d'adresse de destination dans la stratégie de contrôle d'accès. Valeurs valides : net : bloc CIDR de destination group : carnet d'adresses de destination domain : domaine de destination location : emplacement de destination	net
HitTimes	integer	Le nombre de déclenchements de la stratégie de contrôle d'accès.	100
IpVersion	integer	La version IP prise en charge par la stratégie de contrôle d'accès. Valeurs valides : 4 : IPv4 6 : IPv6	6
Description	string	La description de la stratégie de contrôle d'accès.	test
SourceGroupType	string	Le type de carnet d'adresses source dans la stratégie de contrôle d'accès. Valeurs valides : ip : un carnet d'adresses IP tag : un carnet d'adresses de balises domain : un carnet d'adresses de domaine threat : un carnet d'adresses de renseignements sur les menaces backsrc : un carnet d'adresses de retour à l'origine	ip
AclAction	string	L'action effectuée sur le trafic correspondant à la stratégie de contrôle d'accès. Valeurs valides : accept : autorise le trafic. drop : refuse le trafic. log : surveille le trafic.	accept
Release	string	Indique si la stratégie de contrôle d'accès est activée. Après la création d'une stratégie, celle-ci est activée par défaut. Valeurs valides : true : activée false : désactivée	true
DestinationAddrs	array	Les adresses de destination dans le carnet d'adresses.
	string	Les adresses de destination dans le carnet d'adresses.	192.0.XX.XX/24
SourceAddrs	array	Les adresses source.
	string	L'adresse source.	10.2.XX.XX/24

Exemples

JSON format

{
  "PageNo": "1",
  "PageSize": "10",
  "RequestId": "0A4ACDE9-9F9F-56C1-B3B7-60971BA1****",
  "TotalCount": "10",
  "Policys": [
    {
      "Direction": "in",
      "DestinationGroupType": "ip",
      "HitLastTime": 1579261141,
      "Destination": "x.x.x.x/32",
      "SourceType": "net",
      "AclUuid": "01281255-d220-4db1-8f4f-c4df221a****",
      "Priority": 110,
      "Source": "192.0.XX.XX/24",
      "DestinationType": "net",
      "HitTimes": 100,
      "IpVersion": 6,
      "Description": "test",
      "SourceGroupType": "ip",
      "AclAction": "accept",
      "Release": "true",
      "DestinationAddrs": [
        "192.0.XX.XX/24\n"
      ],
      "SourceAddrs": [
        "10.2.XX.XX/24\n"
      ]
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	ErrorParametersUid	The aliUid parameter is invalid.	The aliUid parameter is invalid.
400	ErrorDBSelect	An error occurred while querying database.	An error occurred while querying database.
400	ErrorParameterIpVersion	The IP version is invalid.	The IP version is invalid.
400	ErrorParametersSource	The source is invalid.	The source is invalid.
400	ErrorParametersAction	The action is invalid.	The action is invalid.
400	ErrorParametersNewOrder	The newOrder is invalid.	The newOrder is invalid.
400	ErrorParametersPageSizeOrNo	Either pageSize or pageNo is invalid.	Either pageSize or pageNo is invalid.
400	ErrorMarshalJSON	An error occurred while encoding JSON.	An error occurred while encoding JSON.
400	ErrorParametersDestination	The Destination parameter is invalid.	The Destination parameter is invalid.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.