ListPrefixLists - - Centre de documentation Alibaba Cloud

Débogage

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

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ListPrefixLists	Opération à effectuer. Définissez la valeur sur ListPrefixLists.
PrefixListIds.N	String	No	pl-0b7hwu67****	ID de la liste de préfixes.
NextToken	String	No	FFmyTO70tTpLG6I3FmYAXGKPd****	Jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Valeurs possibles : Ne spécifiez pas ce paramètre pour la première requête. Spécifiez le jeton obtenu lors de la requête précédente comme valeur de NextToken.
MaxResults	Long	No	20	Nombre d'entrées par page. Valeurs possibles : 1 à 100. Valeur par défaut : 20.
ResourceGroupId	String	No	rg-bp67acfmxazb4ph****	ID du groupe de ressources auquel appartient la liste de préfixes.
Tags.N.Key	String	No	FinanceDept	Clé du tag N à ajouter à la ressource. Vous pouvez spécifier jusqu'à 20 clés de tag. La clé de tag ne peut pas être une chaîne vide. La clé de tag peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par `aliyun` ou `acs:`, ni contenir `http://` ou `https://`.
Tags.N.Value	String	No	FinanceJoshua	Valeur du tag N à ajouter à la ressource. Vous pouvez spécifier jusqu'à 20 valeurs de tag. La valeur de tag peut être une chaîne vide. La valeur de tag peut comporter jusqu'à 128 caractères et ne peut pas contenir `http://` ou `https://`. Elle ne peut pas commencer par `aliyun` ou `acs:`.
RegionId	String	Yes	cn-hangzhou	ID de la région où vous souhaitez interroger les listes de préfixes. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
PrefixListName	String	No	name	Nom de la liste de préfixes à interroger. Le nom doit comporter entre 1 et 128 caractères et ne peut pas commencer par `http://` ou `https://`.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	DF72F7BB-5DFA-529C-887E-B0BB70D89C4F	ID de la requête.
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	Jeton de pagination. Utilisez-le dans la requête suivante pour récupérer une nouvelle page de résultats. Valeurs possibles : Si aucune valeur n'est renvoyée pour NextToken, il n'y a pas de page suivante. Si une valeur est renvoyée pour NextToken, utilisez cette valeur comme jeton pour la requête suivante.
TotalCount	Long	1	Nombre total d'entrées renvoyées.
MaxResults	Long	20	Nombre d'entrées par page. Valeurs possibles : 1 à 100. Valeur par défaut : 20.
PrefixLists	Array of PrefixList		Informations sur les listes de préfixes.
PrefixListId	String	pl-m5estsqsdqwg88hjf****	ID de la liste de préfixes.
PrefixListName	String	test	Nom de la liste de préfixes.
PrefixListDescription	String	Created with oss service by system.	Description de la liste de préfixes.
IpVersion	String	IPV4	Version IP de la liste de préfixes. Valeurs possibles : IPv4 IPV6
CreationTime	String	2022-07-12T14:22:32Z	Date et heure de création de la liste de préfixes.
CidrBlocks	Array of String	100 115.XX.XX/24	Bloc CIDR spécifié dans la liste de préfixes.
ShareType	String	Shared	Indique si la liste de préfixes est partagée. Valeurs possibles : Shared Si la valeur renvoyée est vide, la liste de préfixes n'est pas partagée.
MaxEntries	Integer	10	Nombre maximal de blocs CIDR que vous pouvez spécifier dans la liste de préfixes.
Status	String	Created	État de la liste de préfixes. Valeurs possibles : Created Deleted Modifying
OwnerId	String	1210123456123456	Compte Alibaba Cloud auquel appartient la liste de préfixes.
PrefixListStatus	String	Created	État de la liste de préfixes. Valeurs possibles : Created Deleted Modifying Remarque Ce paramètre est identique au paramètre Status.
RegionId	String	cn-hangzhou	ID de la région de la liste de préfixes.
ResourceGroupId	String	rg-bp67acfmxazb4ph****	ID du groupe de ressources auquel appartient la liste de préfixes.
Tags	Array of Tag		Liste des tags.
Key	String	FinanceDept	Clé du tag N.
Value	String	FinanceJoshua	Valeur du tag N.

Exemples

Exemple de requête

http(s)://[Endpoint]/?Action=ListPrefixLists
&PrefixListIds=["pl-0b7hwu67****"]
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=20
&ResourceGroupId=rg-bp67acfmxazb4ph****
&Tags=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&RegionId=cn-hangzhou
&PrefixListName=name
&Common request parameters

Exemple de réponse réussie

Format XML

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

<ListPrefixListsResponse>
    <RequestId>DF72F7BB-5DFA-529C-887E-B0BB70D89C4F</RequestId>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <TotalCount>1</TotalCount>
    <MaxResults>20</MaxResults>
    <PrefixLists>
        <PrefixListId>pl-m5estsqsdqwg88hjf****</PrefixListId>
        <PrefixListName>test</PrefixListName>
        <PrefixListDescription>Created with oss service by system.</PrefixListDescription>
        <IpVersion>IPV4</IpVersion>
        <CreationTime>2022-07-12T14:22:32Z</CreationTime>
        <CidrBlocks>100.115.XX.XX/24</CidrBlocks>
        <ShareType>Shared</ShareType>
        <MaxEntries>10</MaxEntries>
        <Status>Created</Status>
        <OwnerId>1210123456123456</OwnerId>
        <PrefixListStatus>Created</PrefixListStatus>
        <RegionId>cn-hangzhou</RegionId>
        <ResourceGroupId>rg-bp67acfmxazb4ph****</ResourceGroupId>
        <Tags>
            <Key>FinanceDept</Key>
            <Value>FinanceJoshua</Value>
        </Tags>
    </PrefixLists>
</ListPrefixListsResponse>

Format JSON

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

{
  "RequestId" : "DF72F7BB-5DFA-529C-887E-B0BB70D89C4F",
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount" : 1,
  "MaxResults" : 20,
  "PrefixLists" : [ {
    "PrefixListId" : "pl-m5estsqsdqwg88hjf****",
    "PrefixListName" : "test",
    "PrefixListDescription" : "Created with oss service by system.",
    "IpVersion" : "IPV4",
    "CreationTime" : "2022-07-12T14:22:32Z",
    "CidrBlocks" : [ "100.115.XX.XX/24" ],
    "ShareType" : "Shared",
    "MaxEntries" : 10,
    "Status" : "Created",
    "OwnerId" : "1210123456123456",
    "PrefixListStatus" : "Created",
    "RegionId" : "cn-hangzhou",
    "ResourceGroupId" : "rg-bp67acfmxazb4ph****",
    "Tags" : [ {
      "Key" : "FinanceDept",
      "Value" : "FinanceJoshua"
    } ]
  } ]
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	IllegalParam.NextToken	The specified NextToken is invalid.	NextToken est défini sur une valeur non valide.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.