DescribeVpcFirewallPrecheckDetail - - Centre de documentation Alibaba Cloud

Obtient les détails de la pré-vérification d'un pare-feu VPC.

Description de l'opération

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 10 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération à une fréquence appropriée.

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

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Lang	string	Non	Le type de langue. Valeurs valides : zh (par défaut) : chinois. en : anglais.	zh
NetworkInstanceType	string	Non	Le type de l'instance réseau. Valeurs valides : cen_firewall : pare-feu CEN édition basique cen_tr_firewall : pare-feu CEN-TR	cen_firewall
VpcId	string	Non	L'identifiant de l'instance connectée au VPC. Vous devez spécifier au moins l'un des paramètres VpcId et TransitRouterId. Spécifiez VpcId lors de l'interrogation d'un pare-feu édition basique, ou spécifiez TransitRouterId lors de l'interrogation d'un scénario de routage de transit (TR). Si aucun n'est spécifié, ErrorParameters est renvoyé.	vpc-2zev8s8rxao33xt****
Region	string	Non	L'identifiant de la région. Ce paramètre est obligatoire. S'il n'est pas spécifié, ErrorParameters est renvoyé.	cn-hangzhou
CenId	string	Non	L'identifiant de l'instance Cloud Enterprise Network (CEN).	cen-hxsqf2bv6di1a****
TransitRouterId	string	Non	L'identifiant de l'instance de routeur de transit. Vous devez spécifier au moins l'un des paramètres VpcId et TransitRouterId. Spécifiez VpcId lors de l'interrogation d'un pare-feu édition basique, ou spécifiez TransitRouterId lors de l'interrogation d'un scénario de routeur de transit (TR). Si aucun n'est spécifié, ErrorParameters est renvoyé.	tr-2vcn4u2g86tm72****
MemberUid	string	Non	L'UID des comptes membres de Cloud Firewall.	134388541648****

Éléments de réponse

Élément	Type	Description	Exemple
	object
IsFound	boolean	Indique si la tâche existe.	false
PrecheckDetail	object	Les détails de la pré-vérification.
NetworkInstanceId	string	L'identifiant de l'instance réseau.	vpc-m5emh0w6v2e15****
RegionNo	string	L'identifiant de la région.	cn-shanghai
FirewallId	string	L'identifiant de l'instance de pare-feu.	vfw-tr-7a9c8901ed394****
PrecheckTimestamp	string	L'horodatage de la pré-vérification.	1715136000
PrecheckStatus	string	L'état de la pré-vérification. Valeurs valides : running : la pré-vérification est en cours. passed : la pré-vérification a réussi. failed : la pré-vérification a échoué.	failed
PrecheckEntityGroups	array<object>	La liste des groupes d'entités de pré-vérification.
	array<object>	La liste des groupes d'entités de pré-vérification.
Name	string	The precheck instance name.	test
PrecheckEntities	array<object>	The execution details of each precheck item.
	object	The execution details of each precheck item.
Name	string	The precheck item name.	Precheck test
Status	string	The status of each precheck item. Valid values: running: The precheck is in progress. passed: The precheck passed. failed: The precheck failed.	passed
Info	string	The information about the precheck failure.	VPC Firewall Quota Full
Suggestion	string	The suggested action.	The VPC firewall quota is full. We recommend that you increase the firewall quota
PrecheckEntityGroupStatus	string	The precheck status. Valid values: running passed failed	running
FailedCount	integer	The number of precheck rules that failed.	3
RequestId	string	L'identifiant de la requête.	4FB718F0-CC04-5A12-B17B-188CFC3F****

Exemples

JSON format

{
  "IsFound": false,
  "PrecheckDetail": {
    "NetworkInstanceId": "vpc-m5emh0w6v2e15****",
    "RegionNo": "cn-shanghai",
    "FirewallId": "vfw-tr-7a9c8901ed394****",
    "PrecheckTimestamp": "1715136000",
    "PrecheckStatus": "failed",
    "PrecheckEntityGroups": [
      {
        "Name": "test",
        "PrecheckEntities": [
          {
            "Name": "Precheck test",
            "Status": "passed",
            "Info": "VPC Firewall Quota Full",
            "Suggestion": "The VPC firewall quota is full. We recommend that you increase the firewall quota"
          }
        ],
        "PrecheckEntityGroupStatus": "running",
        "FailedCount": 3
      }
    ]
  },
  "RequestId": "4FB718F0-CC04-5A12-B17B-188CFC3F****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	ErrorAliUid	Aliuid invalid.
400	ErrorInvalidMemberUid	Member uid is invalid
400	ErrorRegionNoError	Region is error, please reselect
400	ErrorParameters	A parameter error occurred.
400	ErrorDBSelectError	A database select error occurred.
400	ErrorPreCheckDoing	Pre-check in progress, please try again later.
400	MissingParameter.VpcIdOrTransitRouterId	Either VpcId or TransitRouterId must be provided.

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

Notes de version

Consultez Notes de version pour la liste complète.