CreateNetworkPath - Network Intelligence Service

Membuat jalur jaringan untuk analisis keterjangkauan.

Deskripsi operasi

Anda dapat memanggil operasi CreateNetworkPath untuk membuat jalur jaringan dalam berbagai skenario jaringan dan antar berbagai resource. Setelah dibuat, parameter jalur tersebut disimpan untuk analisis berulang.
Anda dapat membuat hingga 100 jalur jaringan dalam satu Akun Alibaba Cloud.

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

nis:CreateNetworkPath

create

*NetworkPath

acs:nis:*:{#accountId}:networkpath/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah dari jalur jaringan yang ingin Anda buat.	cn-hangzhou
NetworkPathName	string	Yes	Nama jalur jaringan.	ecs2PublicIp
SourceId	string	Yes	ID resource sumber.	i-2zef4ngqfarepyun****
SourceType	string	Yes	Jenis resource sumber. Nilai yang valid: ecs: instans Elastic Compute Service (ECS) internetIp: Alamat IP publik vsw: vSwitch vpn: gerbang VPN vbr: Virtual Border Router (VBR)	ecs
SourceIpAddress	string	No	Alamat IP sumber.	172.17.XX.XX
SourcePort	integer	No	Port sumber.	443
TargetId	string	No	ID resource tujuan.	i-bp13d0e064gubm****
TargetType	string	No	Jenis resource tujuan. Nilai yang valid: ecs: instans ECS internetIp: Alamat IP publik vsw: vSwitch vpn: gerbang VPN vbr: VBR clb: instans Classic Load Balancer (CLB)	ecs
TargetIpAddress	string	No	Alamat IP tujuan.	192.168.XX.XX
TargetPort	integer	No	Port tujuan.	80
Protocol	string	No	Jenis protokol. Nilai yang valid: tcp: Transmission Control Protocol (TCP) udp: User Datagram Protocol (UDP) icmp: Internet Control Message Protocol (ICMP)	tcp
NetworkPathDescription	string	No	Deskripsi jalur jaringan.	分析ECS到ECS路径
Tag	array<object>	No	Tag yang akan ditambahkan ke resource.
	object	No
Key	string	No	Kunci tag N yang akan ditambahkan ke resource. Panjang kunci tag maksimal 128 karakter dan tidak boleh mengandung `http://` atau `https://`. Kunci tag tidak boleh diawali dengan `acs:` atau `aliyun`. Anda dapat menambahkan hingga 20 tag dalam setiap panggilan.	role
Value	string	No	Nilai tag N yang akan ditambahkan ke resource. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh mengandung `http://` atau `https://`. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:`.	ops
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-acfm27qsxjj****

Elemen respons

Element	Type	Description	Example
	object
NetworkPathId	string	ID jalur jaringan.	np-4cbf598673d14d27****
RequestId	string	ID permintaan.	92DD9FFB-06FB-56F7-83EF-5CEF98F5562A

Contoh

Respons sukses

JSONformat

{
  "NetworkPathId": "np-4cbf598673d14d27****",
  "RequestId": "92DD9FFB-06FB-56F7-83EF-5CEF98F5562A"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	IllegalParam.InternetIP	The specified IP address (%s) is not an internet IP address.
400	IllegalParam.IP	The specified IP address (%s) is invalid.
400	QuotaExceeded.NetworkPath	The quota of %s is exceeded, usage %s/%s.
400	ResourceAlreadyExist.NetworkPath	The specified resource of %s already exists.
400	Mismatch.SourceIdAndTargetId	Reachability Analyzer does not support the scenario in which source and target Internet IP addresses and ECS instance ID (%s and %s) are bound.
400	IllegalParam.SourceAndTargetInternetIp	Both source ID and target ID are IP addresses, but are not Internet IP addresses. Reachability Analyzer does not support the scenario.
400	IllegalParam.SourcePort	The specified SourcePort(%s) value is invalid. The value must be within the range of (0,65536].
400	IllegalParam.TargetPort	The specified TargetPort(%s) value is invalid. The value must be within the range of (0,65536].
400	IllegalParam.SourceId	The specified SourceId(%s) may be not exist.
400	IllegalParam.TargetId	The specified TargetId(%s) may be not exist.
400	MissingParameter.TagValue	You must specify Tag.N.Value.
400	NumberExceed.Tags	The maximum number of Tags is exceeded.
400	Duplicate.TagKey	The Tag.N.Key contains duplicate keys.
400	MissingParameter.TagKey	You must specify Tag.N.Key.
400	InvalidParameter.TagKey	The Tag.N.Key parameter is invalid.
400	InvalidParameter.TagValue	The Tag.N.Value parameter is invalid.
400	IllegalParam.SourceIp	Please enter a valid source IP.
400	IllegalParam.Protocol	The specified Protocol(%s) is invalid.
400	IllegalParam.TargetType	The specified target type (%s) is invalid.
400	IllegalParam.SourceType	The specified source type (%s) is invalid.
400	IllegalParam.TargetIp	The specified target ip (%s) is invalid.
400	IllegalParam.NotSupportHaVpn	The specified VPN(%s), which is not currently supported for such instances.
400	IllegalParam.SourceNotBound	Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being.
400	IllegalParam.TargetNotBound	Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being.
400	IllegalParam.NotPublicIp	The specified (%s) is invalid.
400	IllegalParam.SourceEqualTarget	The specified source and destination are identical, which is not supported for analysis.
400	IllegalParam.TypeAndIdMismatch	The specified instanceId (%s) and type do not match.
403	Forbidden.NetworkPath	The current user has not activated NIS and is not authorized to use the path analysis interface.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.