ListTrafficMarkingPolicies - - Centre de documentation Alibaba Cloud

Consulte les détails des stratégies de marquage du trafic, tels que l'état et la priorité des stratégies de marquage du trafic.

Description de l'opération

Lorsque vous appelez l'opération ListTrafficMarkingPolicies :

Vous devez spécifier au moins l'un des paramètres TransitRouterId et TrafficMarkingPolicyId.
Si vous ne spécifiez pas d'identifiant de stratégie de marquage du trafic (c'est-à-dire que vous ne spécifiez pas de valeur pour le paramètre TrafficMarkingPolicyId), l'opération renvoie uniquement les informations sur la stratégie de marquage du trafic en fonction des valeurs des paramètres TransitRouterId, TrafficMarkingPolicyName et TrafficMarkingPolicyDescription. Les informations sur les règles de classification du trafic sous la stratégie de marquage du trafic ne sont pas renvoyées (c'est-à-dire que la réponse ne contient pas le champ TrafficMatchRules).
Si vous spécifiez un identifiant de stratégie de marquage du trafic (c'est-à-dire que vous spécifiez une valeur pour le paramètre TrafficMarkingPolicyId), l'opération renvoie les informations sur la stratégie de marquage du trafic ainsi que les informations sur les règles de classification du trafic sous la stratégie de marquage du trafic (c'est-à-dire que la réponse contient le champ TrafficMatchRules). Si le champ TrafficMatchRules est un tableau vide, aucune règle de classification du trafic n'existe sous la stratégie de marquage du trafic actuelle.

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.

cen:ListTrafficMarkingPolicies

list

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
TransitRouterId	string	Non	L'identifiant de l'instance de routeur de transit.	tr-bp1rmwxnk221e3fas****
TrafficMarkingPolicyId	string	Non	L'identifiant de la stratégie de marquage du trafic.	tm-iz5egnyitxiroq****
TrafficMarkingPolicyName	string	Non	Le nom de la stratégie de marquage du trafic.\n\nLe nom peut être vide ou comporter de 1 à 128 caractères et ne peut pas commencer par http:// ou https://.	nametest
TrafficMarkingPolicyDescription	string	Non	La description de la stratégie de marquage du trafic.\n\nLa description peut être vide ou comporter de 1 à 256 caractères et ne peut pas commencer par http:// ou https://.	desctest
MaxResults	integer	Non	Le nombre d'entrées par page pour une requête paginée. Valeurs valides : 1 à 100. Valeur par défaut : 20.	20
NextToken	string	Non	Le jeton de pagination. Valeurs valides : Vous n'avez pas besoin de spécifier ce paramètre pour la première requête ou si aucune requête ultérieure n'existe. Si une requête ultérieure existe, définissez la valeur sur la valeur NextToken renvoyée par l'appel d'API précédent.	FFmyTO70tTpLG6I3FmYAXGKPd****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
NextToken	string	Le jeton de pagination. Si NextToken est vide, il n'existe aucune requête ultérieure. Si NextToken est renvoyé, la valeur indique le jeton pour la requête suivante.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	L'identifiant de la requête.	699989E4-64A0-5F78-8B93-CDB32D98971F
TotalCount	integer	Le nombre total d'entrées renvoyées.	1
MaxResults	integer	Le nombre d'entrées par page pour une requête paginée.	20
TrafficMarkingPolicies	array<object>	La liste des stratégies de marquage du trafic.
	array<object>	Les informations sur la stratégie de marquage du trafic.
TrafficMarkingPolicyStatus	string	L'état de la stratégie de marquage du trafic. Creating : La stratégie est en cours de création. Active : La stratégie est active. Modifying : La stratégie est en cours de modification. Deleting : La stratégie est en cours de suppression.	Creating
TrafficMarkingPolicyId	string	L'identifiant de la stratégie de marquage du trafic.	tm-iz5egnyitxiroq****
MarkingDscp	integer	La valeur DSCP de la stratégie de marquage du trafic.	5
TrafficMarkingPolicyName	string	Le nom de la stratégie de marquage du trafic.	nametest
Priority	integer	La priorité de la stratégie de marquage du trafic.\n\nUne valeur plus petite indique une priorité plus élevée.	5
TrafficMarkingPolicyDescription	string	La description de la stratégie de marquage du trafic.	desctest
TrafficMatchRules	array<object>	La liste des règles de classification du trafic.
	object	Les informations sur la règle de classification du trafic.
MatchDscp	integer	La valeur DSCP du paquet de trafic.\n\n>Si la valeur MatchDscp est -1, toute valeur DSCP est mise en correspondance.	6
DstCidr	string	Le bloc CIDR de destination du paquet de trafic. Les adresses IPv4 et IPv6 sont prises en charge.	192.168.120.0/24
TrafficMatchRuleDescription	string	La description de la règle de classification du trafic.	desctest
Protocol	string	Le type de protocole du paquet de trafic.\n\n> La stratégie de marquage du trafic prend en charge la mise en correspondance de plusieurs types de protocoles. Pour plus de détails sur chaque type de protocole, reportez-vous à la documentation correspondante.	HTTP
TrafficMatchRuleId	string	L'identifiant de la règle de classification du trafic.	tm-rule-fa9kgq1e90rmhc****
SrcCidr	string	Le bloc CIDR source du paquet de trafic. Les adresses IPv4 et IPv6 sont prises en charge.	192.168.10.0/24
TrafficMatchRuleName	string	Le nom de la règle de classification du trafic.	nametest
TrafficMatchRuleStatus	string	L'état de la règle de classification du trafic. Creating : La règle est en cours de création. Active : La règle est active. Deleting : La règle est en cours de suppression.	Creating
AddressFamily	string	Le type d'adresse. Valeurs valides : IPv4, IPv6 ou vide.	IPv4
DstPortRange	array	La plage de ports de destination à mettre en correspondance par la règle de classification du trafic.
	integer	La plage de ports de destination ciblée par la règle de classification du trafic. L'opération renvoie deux numéros de port de destination : Si les deux numéros de port de destination sont identiques, par exemple 80 et 80, la règle de classification du trafic fait correspondre le trafic au port de destination 80. `Si les deux numéros de port de destination sont -1, la règle de classification du trafic fait correspondre le trafic à n'importe quel port de destination.` Si les deux numéros de port de destination sont différents, par exemple 1 et 200, la règle de classification du trafic fait correspondre le trafic aux ports de destination compris dans la plage de 1 à 200.	80,80
SrcPortRange	array	La plage de ports source à mettre en correspondance par la règle de classification du trafic.
	integer	La plage de ports source à faire correspondre par la règle de classification du trafic. L'opération renvoie deux numéros de port source : Si les deux numéros de port source sont identiques, par exemple 80 et 80, la règle de classification du trafic fait correspondre le trafic avec le port source 80. `Si les deux numéros de port source sont -1, la règle de classification du trafic fait correspondre le trafic avec n'importe quel port source.` Si les deux numéros de port source sont différents, par exemple 1 et 200, la règle de classification du trafic fait correspondre le trafic avec les ports source dans la plage de 1 à 200.	1,200
TransitRouterId	string	L'identifiant de l'instance de routeur de transit.	tr-ccni***

Exemples

JSON format

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "699989E4-64A0-5F78-8B93-CDB32D98971F",
  "TotalCount": 1,
  "MaxResults": 20,
  "TrafficMarkingPolicies": [
    {
      "TrafficMarkingPolicyStatus": "Creating",
      "TrafficMarkingPolicyId": "tm-iz5egnyitxiroq****",
      "MarkingDscp": 5,
      "TrafficMarkingPolicyName": "nametest",
      "Priority": 5,
      "TrafficMarkingPolicyDescription": "desctest",
      "TrafficMatchRules": [
        {
          "MatchDscp": 6,
          "DstCidr": "192.168.120.0/24",
          "TrafficMatchRuleDescription": "desctest",
          "Protocol": "HTTP",
          "TrafficMatchRuleId": "tm-rule-fa9kgq1e90rmhc****",
          "SrcCidr": "192.168.10.0/24",
          "TrafficMatchRuleName": "nametest",
          "TrafficMatchRuleStatus": "Creating",
          "AddressFamily": "IPv4",
          "DstPortRange": [
            0
          ],
          "SrcPortRange": [
            0
          ]
        }
      ],
      "TransitRouterId": "tr-ccni***"
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	MissingParam.TransitRouterIdOrTrafficMarkingPolicyId	Either TransitRouterId or TrafficMarkingPolicyId must be specified.
400	IllegalParam.NextToken	The specified NextToken is invalid.
400	InvalidName	Name is invalid.
400	InvalidDescription	Description is invalid.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.

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

Notes de version

Consultez Notes de version pour la liste complète.