Tüm Ürünler
Search
Belge Merkezi

:DescribePrefixLists

Son Güncelleme:Sep 30, 2026

Bir veya daha fazla ön ek listesinin bilgilerini sorgular.

Açıklama

Sorgulanacak AddressFamily, PrefixListId.N ve PrefixListName istek parametrelerini belirtebilirsiniz. Belirtilen parametreler arasında mantıksal VE ilişkisi bulunur. Yalnızca belirtilen parametreler filtreleme koşullarına dahil edilir.

Hata Ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parameter Type Required Example Description
Action String Yes DescribePrefixLists

Gerçekleştirmek istediğiniz işlem. Değeri DescribePrefixLists olarak ayarlayın.

RegionId String Yes cn-chengdu

Bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

PrefixListName String No PrefixListNameSample

Ön ek listesinin adı.

NextToken String No AAAAAdDWBF2****

Sorgu belirteci. Değeri, DescribePrefixLists işleminin önceki çağrısından döndürülen NextToken değeri olarak ayarlayın. Bu işlemi ilk kez çağırırken bu parametreyi boş bırakın.

MaxResults Integer No 10

Her sayfada döndürülecek giriş sayısı.

Maksimum değer: 100.

Varsayılan değer: 10.

AddressFamily String No IPv4

Ön ek listesinin IP adres ailesi. Geçerli değerler:

  • IPv4
  • IPv6

Bu parametre varsayılan olarak boştur; bu durum, tüm ön ek listelerinin sorgulandığını gösterir.

PrefixListId.N String No pl-x1j1k5ykzqlixdcy****

N. ön ek listesinin kimliği. N için geçerli değerler: 0 ila 100.

Yanıt parametreleri

Parameter Type Example Description
NextToken String AAAAAdDWBF2****

Bu çağrıda döndürülen sorgu belirteci. Dönüş değeri boşsa başka veri döndürülmez.

RequestId String 38793DB8-A4B2-4AEC-BFD3-111234E9188D

İsteğin kimliği.

PrefixLists Array of PrefixList

Ön ek listeleriyle ilgili ayrıntılar.

PrefixList
CreationTime String 2021-02-20T07:11Z

Ön ek listesinin oluşturulduğu zaman.

AssociationCount Integer 1

İlişkilendirilmiş kaynakların sayısı.

MaxEntries Integer 20

Ön ek listesinin içerebileceği maksimum giriş sayısı.

Description String This is description.

Ön ek listesinin açıklaması.

AddressFamily String IPv4

Ön ek listesinin IP adres ailesi. Geçerli değerler:

  • IPv4
  • IPv6
PrefixListName String PrefixListNameSample

Ön ek listesinin adı.

PrefixListId String pl-x1j1k5ykzqlixdcy****

Ön ek listesinin kimliği.

Örnekler

Örnek istekler

http(s)://ecs.aliyuncs.com/?Action=DescribePrefixLists
&RegionId=cn-chengdu
&PrefixListName=PrefixListNameSample
&NextToken=AAAAAdDWBF2****
&MaxResults=10
&AddressFamily=IPv4
&PrefixListId=["pl-x1j1k5ykzqlixdcy****"]
&<Common request parameters>

Örnek yanıt

XML formatı

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

<DescribePrefixListsResponse>
    <NextToken>AAAAAdDWBF2****</NextToken>
    <RequestId>38793DB8-A4B2-4AEC-BFD3-111234E9188D</RequestId>
    <PrefixLists>
        <CreationTime>2021-02-20T07:11Z</CreationTime>
        <AssociationCount>1</AssociationCount>
        <MaxEntries>20</MaxEntries>
        <Description>This is description.</Description>
        <AddressFamily>IPv4</AddressFamily>
        <PrefixListName>PrefixListNameSample</PrefixListName>
        <PrefixListId>pl-x1j1k5ykzqlixdcy****</PrefixListId>
    </PrefixLists>
</DescribePrefixListsResponse>

JSON formatı

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

{
  "NextToken" : "AAAAAdDWBF2****",
  "RequestId" : "38793DB8-A4B2-4AEC-BFD3-111234E9188D",
  "PrefixLists" : [ {
    "CreationTime" : "2021-02-20T07:11Z",
    "AssociationCount" : 1,
    "MaxEntries" : 20,
    "Description" : "This is description.",
    "AddressFamily" : "IPv4",
    "PrefixListName" : "PrefixListNameSample",
    "PrefixListId" : "pl-x1j1k5ykzqlixdcy****"
  } ]
}

Hata kodları

HTTP status code

Error code

Error message

Description

400

InvalidParameter

%s

Belirtilen bir parametre geçersiz olduğu için döndürülen hata mesajı.

400

LimitExceed.PrefixListId

The specified number of PrefixListId exceeds the limit.

Maksimum ön ek listesi sayısına ulaşıldığı için döndürülen hata mesajı.

Hata kodlarının listesi için API Error Center adresini ziyaret edin.