ListPrefixLists - Virtual Private Cloud - Alibaba Cloud Documentation Center

Mengkueri detail daftar awalan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vpc:ListPrefixLists

list

PrefixList

acs:vpc:{#regionId}:{#accountId}:prefixlist/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
PrefixListIds	array	No	ID daftar awalan. Nilai valid untuk N: 1 hingga 100. Anda dapat mengkueri hingga 100 daftar awalan sekaligus.	pl-m5estsqsdqwg88hjf****
	string	No	ID instans daftar awalan.	pl-0b7hwu67****
NextToken	string	No	Token untuk kueri berikutnya. Nilai valid: Jika ini adalah kueri pertama atau tidak ada kueri berikutnya yang diperlukan, kosongkan parameter ini. Jika kueri berikutnya diperlukan, atur nilai ke nilai NextToken yang dikembalikan dari panggilan API sebelumnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	No	Jumlah entri yang dikembalikan pada setiap halaman. Nilai valid: 1 hingga 100. Nilai default: 20.	20
ResourceGroupId	string	No	ID kelompok sumber daya tempat daftar awalan berada.	rg-bp67acfmxazb4ph****
Tags	array<object>	No	Daftar tag.
	object	No	Daftar tag.
Key	string	No	Kunci tag resource. Anda dapat menentukan hingga 20 kunci tag. Jika Anda menentukan parameter ini, Anda tidak dapat menentukan string kosong. Panjang kunci tag dapat mencapai 128 karakter. Tidak dapat dimulai dengan `aliyun` atau `acs:`, dan tidak dapat mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag resource. Anda dapat menentukan hingga 20 nilai tag. Jika Anda menentukan parameter ini, Anda dapat menentukan string kosong. Panjang nilai tag dapat mencapai 128 karakter. Tidak dapat dimulai dengan `aliyun` atau `acs:`, dan tidak dapat mengandung `http://` atau `https://`.	FinanceJoshua
RegionId	string	Yes	ID wilayah daftar awalan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
PrefixListName	string	No	Nama daftar awalan. Nama harus memiliki panjang 1 hingga 128 karakter, dan tidak dapat dimulai dengan `http://` atau `https://`.	name

Elemen respons

Element	Type	Description	Example
	object	ID permintaan.
RequestId	string	ID permintaan.	DF72F7BB-5DFA-529C-887E-B0BB70D89C4F
NextToken	string	Token untuk kueri berikutnya. Nilai valid: Jika NextToken kosong, tidak ada kueri berikutnya yang diperlukan. Jika NextToken memiliki nilai kembali, nilai tersebut menunjukkan token untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
TotalCount	integer	Jumlah total daftar awalan yang dikembalikan.	1
MaxResults	integer	Jumlah entri yang dikembalikan pada setiap halaman. Nilai valid: 1 hingga 100. Nilai default: 20.	20
PrefixLists	array<object>	Detail daftar awalan.
	array<object>	Detail daftar awalan.
PrefixListId	string	ID daftar awalan.	pl-m5estsqsdqwg88hjf****
PrefixListName	string	Nama daftar awalan.	test
PrefixListDescription	string	Deskripsi daftar awalan.	Created with oss service by system.
IpVersion	string	Versi IP daftar awalan. Nilai valid: IPV4: IPv4. IPV6: IPv6.	IPV4
CreationTime	string	Waktu saat daftar awalan dibuat. Waktu ditampilkan dalam UTC dan mengikuti standar ISO 8601 dalam format YYYY-MM-DDThh:mm:ssZ.	2022-07-12T14:22:32Z
CidrBlocks	array	Informasi blok Classless Inter-Domain Routing daftar awalan.
	string	Informasi blok Classless Inter-Domain Routing daftar awalan.	100.115.XX.XX/24
ShareType	string	Tipe berbagi daftar awalan. Nilai valid: Shared: Daftar awalan dibagikan. Empty: Daftar awalan tidak dibagikan.	Shared
MaxEntries	integer	Jumlah entri maksimum untuk Classless Inter-Domain Routing dalam daftar awalan.	10
Status	string	Status daftar awalan. Nilai valid: Created: Daftar awalan dibuat. Deleted: Daftar awalan dihapus. Modifying: Daftar awalan sedang dimodifikasi.	Created
OwnerId	string	Akun Alibaba Cloud tempat daftar awalan berada.	1210123456123456
PrefixListStatus	string	Status daftar awalan. Nilai valid: Created: Daftar awalan dibuat. Deleted: Daftar awalan dihapus. Modifying: Daftar awalan sedang dimodifikasi. Catatan Parameter ini memiliki arti dan nilai valid yang sama dengan Status.	Created
RegionId	string	ID wilayah daftar awalan.	cn-hangzhou
ResourceGroupId	string	ID kelompok sumber daya tempat daftar awalan berada.	rg-bp67acfmxazb4ph****
Tags	array<object>	Daftar tag.
	object	Daftar tag.
Key	string	Kunci tag.	FinanceDept
Value	string	Nilai tag.	FinanceJoshua
PrefixListType	string	Tipe daftar awalan.	Custom

Contoh

Respons sukses

JSONformat

{
  "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"
        }
      ],
      "PrefixListType": "Custom"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParam.NextToken	The specified NextToken is invalid.	Parameter NextToken tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.