DescribePrefixListAttributes - - Centre de documentation Alibaba Cloud

Cette rubrique explique comment interroger les détails d'une liste de préfixes, notamment son nom, sa famille d'adresses, le nombre maximal d'entrées et les détails des entrées.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. L'outil génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribePrefixListAttributes	Opération à effectuer. Définissez la valeur sur DescribePrefixListAttributes.
RegionId	String	Oui	cn-chengdu	ID de région de la liste de préfixes. Appelez l'opération DescribeRegions pour obtenir la liste des régions disponibles.
PrefixListId	String	Oui	pl-x1j1k5ykzqlixdcy****	ID de la liste de préfixes.

Paramètres de réponse

Paramètre	Type	Exemple	Description
CreationTime	String	2021-02-20T07:11Z	Date et heure de création de la liste de préfixes.
MaxEntries	Integer	10	Nombre maximal d'entrées que la liste de préfixes peut contenir.
RequestId	String	38793DB8-A4B2-4AEC-BFD3-111234E9188D	ID de la requête.
Description	String	This is description.	Description de la liste de préfixes.
AddressFamily	String	IPv4	Famille d'adresses IP de la liste de préfixes. Valeurs possibles : IPv4 IPv6
PrefixListName	String	PrefixListNameSample	Nom de la liste de préfixes.
PrefixListId	String	pl-x1j1k5ykzqlixdcy****	ID de la liste de préfixes.
Entries	Array of Entry		Détails des entrées de la liste de préfixes.
Entry
Description	String	Description Sample 01	Description de l'entrée dans la liste de préfixes.
Cidr	String	192.168.1.0/24	Bloc CIDR de l'entrée dans la liste de préfixes.

Exemples

Exemple de requête

http(s)://ecs.aliyuncs.com/?Action=DescribePrefixListAttributes
&RegionId=cn-chengdu
&PrefixListId=pl-x1j1k5ykzqlixdcy****
&<Common request parameters>

Exemple de réponse réussie

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribePrefixListAttributesResponse>
    <CreationTime>2021-02-20T07:11Z</CreationTime>
    <MaxEntries>10</MaxEntries>
    <RequestId>38793DB8-A4B2-4AEC-BFD3-111234E9188D</RequestId>
    <Description>This is description.</Description>
    <AddressFamily>IPv4</AddressFamily>
    <PrefixListName>PrefixListNameSample</PrefixListName>
    <PrefixListId>pl-x1j1k5ykzqlixdcy****</PrefixListId>
    <Entries>
        <Description>Description Sample 01</Description>
        <Cidr>192.168.1.0/24</Cidr>
    </Entries>
</DescribePrefixListAttributesResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "CreationTime" : "2021-02-20T07:11Z",
  "MaxEntries" : 10,
  "RequestId" : "38793DB8-A4B2-4AEC-BFD3-111234E9188D",
  "Description" : "This is description.",
  "AddressFamily" : "IPv4",
  "PrefixListName" : "PrefixListNameSample",
  "PrefixListId" : "pl-x1j1k5ykzqlixdcy****",
  "Entries" : [ {
    "Description" : "Description Sample 01",
    "Cidr" : "192.168.1.0/24"
  } ]
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.	La liste de préfixes spécifiée n'existe pas.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.