ListIpamDiscoveredIpAddresses - Virtual Private Cloud - Alibaba Cloud Documentation Center

Menampilkan daftar alamat IP yang digunakan oleh Sumber daya yang ditemukan di VPC atau vSwitch.

Deskripsi operasi

Supported query combinations:

VpcId only
VSwitchId only
VpcId + VSwitchId
VpcId + CidrBlock
VSwitchId + CidrBlock
VpcId + VSwitchId + CidrBlock

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah tempat instans penemuan Sumber daya berada.	cn-hangzhou
IpamResourceDiscoveryId	string	Yes	ID instans penemuan Sumber daya.	ipam-res-disco-jt5f2af2u6nk2z321****
VpcId	string	No	ID VPC yang ditemukan. Catatan Anda harus menentukan setidaknya satu dari VpcId dan VSwitchId.	vpc-bp1fjfnrg3av6zb9e****
VSwitchId	string	No	ID vSwitch yang ditemukan. Catatan Anda harus menentukan setidaknya satu dari VpcId dan VSwitchId.	vsw-bp1bmwg5u07e1l3q0is4w
Cidr	string	No	Blok CIDR untuk mencari alamat IP yang digunakan di VPC atau vSwitch. Untuk mengkueri alamat IP tertentu, gunakan panjang awalan /32. Catatan Hanya blok CIDR IPv4 yang didukung.	192.168.1.0/24
IpVersion	string	No	Versi protokol IP. Nilai valid: IPv4. Valid values: IPv4 :	IPv4
NextToken	string	No	Token yang digunakan untuk mengambil halaman hasil berikutnya. Nilai valid: Jangan tentukan parameter ini untuk permintaan pertama Anda. Jika halaman berikutnya ada, tetapkan parameter ini ke nilai NextToken yang dikembalikan dalam tanggapan sebelumnya.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	No	Jumlah maksimum entri yang dikembalikan per halaman. Nilai valid: 1 hingga 200. Nilai default: 100.	100

Elemen respons

Element	Type	Description	Example
	object	The response object.
IpamDiscoveredIpAddresses	array<object>	Details of the used IP addresses.
	object
VpcId	string	The VPC ID.	vpc-bp1fjfnrg3av6zb9e****
VSwitchId	string	The vSwitch ID.	vsw-bp1bmwg5u07e1l3q0is4w
IpVersion	string	The IP version. Valid value: IPv4: Indicates the IPv4 protocol.	IPv4
IpAddress	string	The IP address in use.	192.168.10.40/32
ResourceId	string	The resource ID.	eni-bp1001jpjhzmgc5m****
ResourceRegionId	string	The ID of the region in which the resource resides.	cn-shenzhen
ResourceServiceType	string	The cloud service to which the resource belongs.	ENI
NextToken	string	The pagination token. Use this token in a subsequent request to retrieve the next page of results. Valid values: Empty: All results have been returned. If NextToken has a value, it is the token for the next page of results.	FFmyTO70tTpLG6I3FmYAXGKPd****
TotalCount	integer	The total number of entries that match the query.	1000
MaxResults	integer	The maximum number of entries to return per page. Valid values: 1 to 200. Default value: 100.	100
Count	integer	The number of entries returned on the current page.	10
RequestId	string	The request ID.	9F8315CB-560E-5F1E-B069-6E44B440CAF8

Contoh

Respons sukses

JSONformat

{
  "IpamDiscoveredIpAddresses": [
    {
      "VpcId": "vpc-bp1fjfnrg3av6zb9e****",
      "VSwitchId": "vsw-bp1bmwg5u07e1l3q0is4w",
      "IpVersion": "IPv4",
      "IpAddress": "192.168.10.40/32",
      "ResourceId": "eni-bp1001jpjhzmgc5m****",
      "ResourceRegionId": "cn-shenzhen",
      "ResourceServiceType": "ENI"
    }
  ],
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount": 1000,
  "MaxResults": 100,
  "Count": 10,
  "RequestId": "9F8315CB-560E-5F1E-B069-6E44B440CAF8"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	ResourceNotFound.IpamResourceDiscovery	The dependent instance of IPAM resource discovery is not found.
400	MissingParam.IpamResourceDiscoveryId	The IpamResourceDiscoveryId must be input.
400	Forbidden.IpResourceAccess	The IPAM resource discovery instance in the parameters is not allowed to access the IP address of resource %s.
400	IllegalParamFormat.%s	The param of %s is illegal.
400	ResourceNotFound.IpamDiscoveredResource	The queried %s is not found among IPAM discovered resources.
400	Mismatch.VpcIdAndVSwitchId	VpcId and VSwitchId do not match.
400	MissingParam.VpcIdAndVSwitchId	VpcId and VSwitchId cannot both be empty please provide at least one.
400	Mismatch.IpamResourceDiscoveryAndResource	The IPAM resource discovery %s and the queried %s do not match.
400	ResourceNotFound.IpamDiscoveredResource.Vpc	The queried VPC %s is not found among IPAM discovered resources.
400	ResourceNotFound.IpamDiscoveredResource.VSwitch	The queried VSwitch %s is not found among IPAM discovered resources.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.