DescribeOutgoingDomain - - Centre de documentation Alibaba Cloud

Consulte les informations sur les noms de domaine des connexions sortantes.

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:DescribeOutgoingDomain

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	La langue du message de requête. Valeurs valides :	zh
StartTime	string	Oui	L'heure de début de la requête. La valeur est un horodatage UNIX en secondes.	1656664560
EndTime	string	Oui	L'heure de fin de la requête. La valeur est un horodatage UNIX en secondes.	1656750960
PageSize	string	Non	Le nombre d'entrées par page dans une requête paginée.	10
CurrentPage	string	Non	Le numéro de page à renvoyer dans une requête paginée.	1
CategoryId	string	Non	La catégorie de produit. Valeur par défaut : vide. Valeurs valides :	All
Domain	string	Non	Le nom de domaine des connexions sortantes.	www.aliyundoc.com
PublicIP	string	Non	L'adresse IP publique de l'instance ECS qui initie la connexion sortante.	192.0.XX.XX
Sort	string	Non	L'ordre de tri basé sur le champ spécifié. Valeurs valides :	SessionCount
Order	string	Non	La méthode de tri. Valeurs valides :	desc
TagIdNew	string	Non	L'identifiant de la balise de renseignement. Valeurs valides :	AliYun
DataType	string	Non	La source des statistiques de trafic. Valeur par défaut : pare-feu Internet. Valeurs valides :	nat
IsAITraffic	string	Non	Indique si seules les statistiques sur le trafic accédant aux services d'IA doivent être collectées. Valeur par défaut : no. Valeurs valides :	true

Éléments de réponse

Élément	Type	Description	Exemple
	object
TotalCount	integer	Le nombre total de domaines sortants.	132
RequestId	string	L'identifiant de la requête.	F0F82705-CFC7-5F83-86C8-A063892F****
DomainList	array<object>	La liste des domaines sortants.
	array<object>	La liste des domaines sortants.
AclCoverage	string	Indique si la stratégie de contrôle d'accès fournit une couverture. Valeurs valides :	Uncovered
Domain	string	Le nom de domaine des connexions sortantes.	www.aliyundoc.com
AclRecommendDetail	string	Les détails de la recommandation ACL.	RecommendedRelease
HasAclRecommend	boolean	Indique si une recommandation ACL existe. Valeurs valides :	true
InBytes	integer	Le trafic entrant.	3214
CategoryName	string	Le nom de la catégorie du produit. Valeurs valides :	Produit Alibaba Cloud
RuleName	string	Le nom de la règle ACL.	acl-name
RuleId	string	L'identifiant de la règle ACL.	add-dfadf-f****
SessionCount	integer	Le nombre de requêtes.	12
GroupName	string	Le nom du groupe de la règle.	group-name
SecuritySuggest	string	La stratégie de sécurité pour le domaine sortant. Valeurs valides :	pass
OutBytes	integer	Le trafic sortant.	4582
AclStatus	string	L'état de santé de la stratégie de contrôle d'accès. Valeurs valides :	Normal
IsMarkNormal	boolean	Indique si le domaine sortant est marqué comme normal. Valeurs valides :	true
CategoryId	string	L'identifiant de la catégorie du produit. Valeurs valides :	Aliyun
AddressGroupUUID	string	L'UUID du carnet d'adresses.	fdad-fdafa-dafa-dfa****
AddressGroupName	string	Le nom du carnet d'adresses.	Carnet d'adresses sortant
CategoryClassId	string	La catégorisation du label de renseignement. Valeurs valides :	Trusted
Business	string	L'activité du site web.	Aliyun
HasAcl	string	Indique si une ACL couvre la gestion de ce nom de domaine. Valeurs valides :	true
Organization	string	Le nom de l'organisation.	Alibaba Cloud Computing Limited
SecurityReason	string	La raison de sécurité.	Stratégie intelligente : le nom de domaine cible appartient à Aliyun Computing Co., Ltd. et son activité principale est Aliyun. Aucun risque de sécurité n'a été détecté. Il peut être utilisé pour configurer une liste blanche sortante
TotalBytes	string	Le trafic total. Unité : octets.	800
TagList	array<object>	La liste des balises.
	object	L'objet de la liste des balises.
RiskLevel	integer	The risk assessment level. Valid values: 1: Low. 2: Medium. 3: High.	3
TagName	string	The tag name.	tag-name
TagId	string	The intelligence tags label ID.	AliYun
TagDescribe	string	The tag description.	tag-describe
ClassId	string	The categorization of the intelligence tags label. Valid values: Suspicious: Suspicious. Malicious: Malicious. Trusted: Trusted.	Trusted
ApplicationNameList	array	Les noms des applications.
	string	La liste des noms d'applications.	HTTP
AssetCount	integer	Le nombre total de ressources avec des connexions sortantes.	20
PrivateAssetCount	integer	Le nombre total de ressources de réseau privé avec des connexions sortantes.	20
ApplicationPortList	array<object>	La liste des ports d'application.
	object
Port	integer		443
ApplicationName	string		HTTP

Exemples

JSON format

{
  "TotalCount": 132,
  "RequestId": "F0F82705-CFC7-5F83-86C8-A063892F****",
  "DomainList": [
    {
      "AclCoverage": "Uncovered",
      "Domain": "www.aliyundoc.com",
      "AclRecommendDetail": "RecommendedRelease",
      "HasAclRecommend": true,
      "InBytes": 3214,
      "CategoryName": "阿里云产品",
      "RuleName": "acl-name",
      "RuleId": "add-dfadf-f****",
      "SessionCount": 12,
      "GroupName": "group-name",
      "SecuritySuggest": "pass",
      "OutBytes": 4582,
      "AclStatus": "Normal",
      "IsMarkNormal": true,
      "CategoryId": "Aliyun",
      "AddressGroupUUID": "fdad-fdafa-dafa-dfa****",
      "AddressGroupName": "Outreach Address Book",
      "CategoryClassId": "Trusted",
      "Business": "Aliyun",
      "HasAcl": "true",
      "Organization": "Alibaba Cloud Computing Limited\n",
      "SecurityReason": "Smart policy: The target domain name belongs to Aliyun Computing Co., Ltd., and its main business is Aliyun. No security risks have been found. It can be used to configure an outreach whitelist.",
      "TotalBytes": "800",
      "TagList": [
        {
          "RiskLevel": 3,
          "TagName": "tag-name",
          "TagId": "AliYun",
          "TagDescribe": "tag-describe",
          "ClassId": "Trusted"
        }
      ],
      "ApplicationNameList": [
        "HTTP"
      ],
      "AssetCount": 20,
      "PrivateAssetCount": 20,
      "ApplicationPortList": [
        {
          "Port": 443,
          "ApplicationName": "HTTP"
        }
      ]
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	ErrorAliUid	Aliuid invalid.
400	ErrorTimeError	The time is invalid.
400	ErrorDBSelectError	A database select error occurred.
400	ErrorIntervalError	The interval is invalid.
400	ErrorIpFormat	The IP address is invalid.
400	ErrorSecuritySuggest	The security suggest is invalid.
400	ErrorSortError	The sort is invalid.
400	ErrorOrderFailed	The order is invalid.
400	ErrorPageNo	Either page number or page size is invalid.
400	ErrorDomainName	The domain name is invalid.
400	ErrorDataTypeError	The data type is invalid.
400	ErrorMarshalJSON	internal error.

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

Notes de version

Consultez Notes de version pour la liste complète.