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
İ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 |
| 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:
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:
|
| 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.