Kueri informasi tentang koneksi VPN-Cloud Enterprise Network-Alibaba Cloud

Anda dapat memanggil operasi ListTransitRouterVpnAttachments untuk mengkueri informasi koneksi VPN, seperti status, ID koneksi IPsec-VPN, dan metode penagihan.

Deskripsi operasi

Operasi ListTransitRouterVpnAttachments mendukung metode kueri berikut:

Masukkan hanya TransitRouterAttachmentId untuk mengkueri koneksi VPN tertentu.
Masukkan hanya TransitRouterId untuk mengkueri semua koneksi VPN yang terkait dengan router transit tertentu.
Masukkan CenId dan RegionId untuk mengkueri koneksi VPN di wilayah tertentu dari instans Cloud Enterprise Network (CEN) yang ditentukan.

Saat memanggil operasi ListTransitRouterVpnAttachments, pastikan Anda memasukkan nilai parameter yang valid. Jika parameter yang dimasukkan tidak valid, sistem akan mengembalikan RequestId tetapi tidak mengembalikan informasi koneksi VPN yang dikueri.

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:ListTransitRouterVpnAttachments

list

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouterVpnAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/*

TransitRouterVpnAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
CenId	string	No	ID instans CEN.	cen-rsgxs8ng2awen2****
RegionId	string	No	ID wilayah tempat router transit ditempatkan. Untuk informasi selengkapnya, lihat DescribeChildInstanceRegions.	cn-hangzhou
TransitRouterAttachmentId	string	No	ID koneksi VPN.	tr-attach-a6p8voaodog5c0****
TransitRouterId	string	No	ID router transit.	tr-p0wm740vjnbaprv0m****
MaxResults	integer	No	Jumlah entri yang dikembalikan per halaman. Nilai default: 20.	20
NextToken	string	No	Token yang digunakan untuk kueri berikutnya. Nilai yang valid: Jika ini adalah kueri pertama Anda atau tidak ada kueri berikutnya yang akan dikirim, Anda tidak perlu menentukan parameter ini. Jika kueri berikutnya akan dikirim, atur nilainya ke nilai NextToken yang dikembalikan dari panggilan API sebelumnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
Tag	array<object>	No	Tag instans CEN. Anda dapat mengkueri maksimal 20 tag sekaligus.
	object	No
Key	string	No	Kunci tag. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 64 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag juga tidak boleh mengandung `http://` atau `https://` . Anda dapat menentukan hingga 20 kunci tag.	tagtest
Value	string	No	Nilai tag. Nilai tag dapat berupa string kosong atau string dengan panjang maksimal 128 karakter. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://` . Setiap kunci tag harus memiliki nilai tag yang unik. Anda dapat menentukan hingga 20 nilai tag.	value_A1

Elemen respons

Element	Type	Description	Example
	object	Respons.
NextToken	string	Token yang digunakan untuk kueri berikutnya. Nilai yang valid: Jika NextToken kosong, berarti tidak ada kueri berikutnya yang akan dikirim. Jika nilai NextToken dikembalikan, nilai tersebut merupakan token yang digunakan untuk kueri berikutnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	ID permintaan.	3D5530D2-3BBB-524E-8E98-59AB06A250E4
TotalCount	integer	Jumlah total entri.	1
MaxResults	integer	Jumlah entri yang dikembalikan per halaman.	20
TransitRouterAttachments	array<object>	Daftar koneksi VPN.
	array<object>	Informasi tentang koneksi VPN.
CreationTime	string	Waktu pembuatan koneksi VPN. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mmZ. Waktu ditampilkan dalam UTC.	2022-07-08T08:45Z
Status	string	Status koneksi VPN. Attached: Koneksi VPN telah disambungkan. Attaching: Koneksi VPN sedang dalam proses penyambungan. Detaching: Koneksi VPN sedang dalam proses pemutusan.	Attached
TransitRouterAttachmentId	string	ID koneksi VPN.	tr-attach-a6p8voaodog5c0****
TransitRouterId	string	ID router transit.	tr-p0wm740vjnbaprv0m****
ResourceType	string	Tipe resource koneksi VPN. Nilainya ditetapkan sebagai VPN, yang menunjukkan bahwa router transit terhubung ke koneksi IPsec-VPN.	VPN
VpnOwnerId	integer	ID Akun Alibaba Cloud tempat koneksi IPsec-VPN berada.	1210123456123456
VpnId	string	ID koneksi IPsec-VPN.	vco-p0wtu1xgd0l7fjo7k****
TransitRouterAttachmentDescription	string	Deskripsi koneksi VPN.	desctest
VpnRegionId	string	ID wilayah tempat koneksi IPsec-VPN ditempatkan. Untuk informasi selengkapnya, lihat DescribeRegions.	cn-hangzhou
AutoPublishRouteEnabled	boolean	Menunjukkan apakah router transit secara otomatis mengiklankan rute ke koneksi IPsec-VPN. Nilai yang valid: true: diaktifkan. false: dinonaktifkan.	true
TransitRouterAttachmentName	string	Nama koneksi VPN.	nametest
Zones	array<object>	Daftar zona tempat koneksi VPN ditempatkan.
	object	Zona tempat koneksi VPN ditempatkan.
ZoneId	string	ID zona. Untuk informasi selengkapnya, lihat DescribeZones.	cn-hangzhou-h
Tags	array<object>	Daftar tag.
	object
Key	string	Kunci tag.	test
Value	string	Nilai tag.	value_A1
ChargeType	string	Metode penagihan koneksi VPN. Nilainya ditetapkan sebagai POSTPAY, yang menunjukkan metode penagihan pay-as-you-go.	POSTPAY
CenId	string	ID instans CEN.	cen-j3jzhw1zpau2km****
OrderType	string	Pihak yang membayar instance jaringan. Nilai yang valid: PayByCenOwner: Biaya instance jaringan dibayar oleh akun pemilik instans CEN. PayByResourceOwner: Biaya instance jaringan dibayar oleh akun pemilik instance jaringan.	PayByCenOwner

Contoh

Respons sukses

JSONformat

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "3D5530D2-3BBB-524E-8E98-59AB06A250E4",
  "TotalCount": 1,
  "MaxResults": 20,
  "TransitRouterAttachments": [
    {
      "CreationTime": "2022-07-08T08:45Z",
      "Status": "Attached",
      "TransitRouterAttachmentId": "tr-attach-a6p8voaodog5c0****",
      "TransitRouterId": "tr-p0wm740vjnbaprv0m****",
      "ResourceType": "VPN",
      "VpnOwnerId": 1210123456123456,
      "VpnId": "vco-p0wtu1xgd0l7fjo7k****",
      "TransitRouterAttachmentDescription": "desctest",
      "VpnRegionId": "cn-hangzhou",
      "AutoPublishRouteEnabled": true,
      "TransitRouterAttachmentName": "nametest",
      "Zones": [
        {
          "ZoneId": "cn-hangzhou-h"
        }
      ],
      "Tags": [
        {
          "Key": "test",
          "Value": "value_A1"
        }
      ],
      "ChargeType": "POSTPAY",
      "CenId": "cen-j3jzhw1zpau2km****\n",
      "OrderType": "PayByCenOwner"
    }
  ]
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParam.NextToken	The specified NextToken is invalid.	The error message returned because the NextToken parameter is set to an invalid value.
400	IllegalParam.TrInstance	The specified TransitRouter is invalid.	The error message returned because the TransitRouter parameter is set to an invalid value.
400	IllegalParam.Region	The specified Region is invalid.	The error message returned because the specified region is invalid.
400	IllegalParam.CenId	The specified CenId is invalid.	The error message returned because the ID of the CEN instance is invalid.
400	IllegalParam.CenIdOrRegionId	The specified CenId or RegionId is invalid.	The error message returned because the specified CEN instance ID or region ID is invalid.
400	IllegalParam.TransitRouterId	The specified TransitRouterId is illegal.	The error message returned because the specified transit router ID is invalid.
400	IllegalParam.MaxResults	The specified MaxResults is invalid.
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.