CreateTransitRouterPrefixListAssociation - Cloud Enterprise Network

Menyambungkan tabel rute dari Transit Router edisi perusahaan dengan daftar prefiks.

Deskripsi operasi

Untuk menyambungkan Transit Router edisi perusahaan dengan prefiks rute, Anda harus memenuhi persyaratan berikut:

Anda memahami batasan dan catatan kompatibilitas rute dari daftar prefiks. Untuk informasi selengkapnya, lihat Prefix lists.
Daftar prefiks telah dibuat. Untuk informasi selengkapnya, lihat CreateVpcPrefixList.
Jika daftar prefiks dan Transit Router edisi perusahaan berada di bawah Akun Alibaba Cloud yang berbeda, daftar prefiks tersebut harus dibagikan ke Akun Alibaba Cloud pemilik Transit Router edisi perusahaan. Untuk informasi selengkapnya, lihat Resource sharing dan API references for resource sharing.

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

cen:CreateTransitRouterPrefixListAssociation

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini melalui klien, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token klien hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan request ID sebagai client token. Request ID mungkin berbeda untuk setiap permintaan.	123e4567-e89b-12d3-a456-4266****
RegionId	string	Yes	ID wilayah tempat router transit ditempatkan. Anda dapat memanggil operasi DescribeChildInstanceRegions untuk mengambil daftar wilayah terbaru.	cn-hangzhou
TransitRouterId	string	Yes	ID router transit.	tr-6ehx7q2jze8ch5ji0****
NextHopType	string	No	Tipe lompatan berikutnya. Nilai yang valid: BlackHole: menentukan bahwa semua blok CIDR dalam daftar prefiks adalah rute blackhole. Paket yang ditujukan ke blok CIDR tersebut akan dibuang. VPC: menentukan koneksi virtual private cloud (VPC) sebagai lompatan berikutnya. VBR: menentukan koneksi Virtual Border Router (VBR) sebagai lompatan berikutnya. TR: menentukan koneksi antar-wilayah sebagai lompatan berikutnya. ECR: menentukan koneksi Express Connect Router (ECR) sebagai lompatan berikutnya.	VPC
PrefixListId	string	Yes	ID daftar prefiks.	pl-6ehtn5kqxgeyy08fi****
TransitRouterTableId	string	Yes	ID tabel rute router transit.	vtb-6ehgc262hr170qgyc****
NextHop	string	Yes	ID koneksi lompatan berikutnya. Untuk menentukan semua blok CIDR dalam daftar prefiks sebagai rute blackhole, atur parameter ini ke BlackHole.	tr-attach-flbq507rg2ckrj****
OwnerUid	integer	No	ID Akun Alibaba Cloud pemilik daftar prefiks.	1210123456123456
DryRun	boolean	No	Menentukan apakah hanya menjalankan dry run tanpa benar-benar melakukan permintaan. Nilai yang valid: true: hanya menjalankan dry run. Sistem memeriksa permintaan terhadap potensi masalah, termasuk nilai parameter yang hilang, sintaksis permintaan yang salah, dan batas layanan. Jika permintaan gagal dalam dry run, kode kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): menjalankan dry run dan mengirim permintaan. Catatan Parameter ini tidak sedang digunakan.	false

Elemen respons

Element	Type	Description	Example
	object	Respons.
RequestId	string	ID permintaan.	0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	NoPermission.AliyunServiceRolePolicyForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	The error message returned because you do not have the permissions to create the service-linked role whose role name is AliyunServiceRolePolicyForCEN and service name is cen.aliyuncs.com. You must acquire the ram:CreateServiceLinkedRole permission before you can create the service-linked role.
400	ResourceNotSupport.CCN	CCN not support prefix list.	The error message returned because prefix lists are not supported by CCN instances.
400	ResourceNotFound.PrefixlistCidrs	Can not find any cidr of specified prefix list.	The error message returned because the specified prefix list does not contain a CIDR block.
400	ResourceNotFound.Nexthop	The specified nexthop instance is not exsit.	The error message returned because the specified next hop does not exist.
400	ResourceExisted.PrefixlistAssociation	The prefix list has been already associated with this route table.	The error message returned because the specified prefix list is already associated with a route table.
400	ResourceNotFound.PrefixlistAssociation	The prefix list is not associated with this route table.
400	ResourceConflict.Route	Some of the prefixes of the prefix list are conflicted with exsited routes.
400	MultipleFound.PrefixlistAssociation	multiple same prefix association record found.	The error message returned because multiple configuration duplicates exist in the system.
400	QuotaReached.Route	The quota of the route table is not enough for the request prefix list.
400	InvalidStatus.PrefixlistAssociation	The prefix list association is not in a valid state for the operation.	The error message returned because the status of the specified prefix list does not support this operation. Try again later.
400	NotSupport.TrType	The basic tr type is not support for this operation.	The error message returned because this operation is not supported by Basic Edition transit routers.
400	InvalidValue.PrefixlistCidr	Invalid cidr exist in the specified prefixlist.	The error message returned because the specified prefix list contains an invalid CIDR block.
400	ResourceNotSupport.Nexthop	The specified nexthop instance type is not support for the operation.	The error message returned because this operation is not supported by the specified next hop.
400	ResourceMismatch.Nexthop	The specified nexthop and nexthop type mismatched.	The error message returned because the specified next hop or next hop type is invalid.
400	ResourceNotFound.PrefixList	The specified prefixlist does not found.	The error message returned because the specified prefix list does not exist.
400	OperationDenied.SystemPrefixList	SystemPrefixList can not be operated.	The error message returned because this operation is not supported by the system prefix list.
400	OperationFailed.OperateShareResource	Operate share prefixlist failed.	The error message returned because the specified prefix list failed to be shared.
400	InvalidStatus.Prefixlist	Prefixlist is not in a operate status.	The error message returned because the status of the specified prefix list does not support this operation.
400	RegionNotSupport.Prefixlist	Prefixlist association are not supported in this region.	The error message returned because the feature is not supported in the specified region.
400	OperationFailed.TransitRouterNotExist	Operation failed because transit router not exist.	The error message returned because the specified transit router does not exist.
400	IncorrectStatus.RouteTable	RouteTable status is invalid.	The error message returned because the operation is not supported when the specified route table is in an unstable state.
400	IllegalParam.TransitRouterTableId	The specified Route Table ID is invalid.	The Route Table ID is invalid.
400	OperationDenied.ECSPrefixList	Associate ECS PrefixList is not supported.	Associate ECS PrefixList is not supported.
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.
404	InvalidRouteTableId.NotFound	The specified RouteTableId is not found.	The specified route table ID does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.