Mengkueri alamat IP virtual ketersediaan tinggi (HaVip) di wilayah tertentu dengan memanggil operasi DescribeHaVips.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID wilayah tempat HaVip diterapkan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru. |
cn-hangzhou |
| PageNumber |
integer |
No |
Nomor halaman. Nilai default: 1. |
1 |
| PageSize |
integer |
No |
Jumlah entri per halaman. Nilai maksimum: 50. Nilai default: 10. |
10 |
| Filter |
array<object> |
No |
Detail kondisi filter. |
|
|
object |
No |
Detail kondisi filter. |
||
| Key |
string |
No |
Kondisi filter. Anda dapat menentukan paling banyak lima kondisi filter. Nilai valid N: 1 hingga 5. Kondisi filter berikut didukung:
Setiap kondisi filter (Kunci Filter) dapat memfilter beberapa nilai. Hubungan logis di antara beberapa nilai adalah OR. Selama salah satu nilai memenuhi kondisi, nilai tersebut dianggap cocok dengan kondisi filter. Hubungan logis di antara beberapa kondisi filter (Kunci Filter) adalah AND. Hanya nilai yang cocok dengan semua kondisi filter yang dapat dikueri. |
HaVipId |
| Value |
array |
No |
Nilai kondisi filter yang ditentukan. Nilai valid N: 1 hingga 5. |
havip-bp19o63nequs01i8d**** |
|
string |
No |
Nilai filter dari kondisi filter. Anda dapat menentukan beberapa nilai filter untuk satu kondisi filter. Hubungan logis di antara beberapa nilai filter adalah OR. Selama salah satu nilai filter memenuhi kondisi, nilai tersebut dianggap cocok dengan kondisi filter. |
Active |
|
| ResourceGroupId |
string |
No |
ID kelompok sumber daya tempat HaVip berada. |
rg-bp67acfmxazb4ph**** |
| Tags |
array<object> |
No |
Daftar tag. |
|
|
object |
No |
Daftar tag. |
||
| Key |
string |
No |
Kunci tag. Anda dapat menentukan paling banyak 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag paling banyak 128 karakter. Kunci tag tidak boleh diawali dengan |
FinanceDept |
| Value |
string |
No |
Nilai tag. Anda dapat menentukan paling banyak 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag paling banyak 128 karakter. Nilai tag tidak boleh diawali dengan |
FinanceJoshua |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Jumlah entri per halaman. |
||
| PageSize |
integer |
Jumlah entri per halaman. |
10 |
| RequestId |
string |
ID permintaan. |
33E480C5-B46F-4CA5-B6FD-D77C746E86AB |
| PageNumber |
integer |
Nomor halaman. |
1 |
| TotalCount |
integer |
Jumlah entri yang dikembalikan. |
1 |
| HaVips |
object |
||
| HaVip |
array<object> |
Detail HaVip. |
|
|
array<object> |
Detail HaVip. |
||
| VpcId |
string |
The ID of the VPC to which the HaVip belongs. |
vpc-bp1kcm36tevkpms97**** |
| Status |
string |
The status of the HaVip. Valid values:
|
Available |
| HaVipId |
string |
The ID of the HaVip. |
havip-bp149uyvut73dpld**** |
| AssociatedInstanceType |
string |
The type of the instance with which the HaVip is associated. Valid values:
|
EcsInstance |
| CreateTime |
string |
The time when the HaVip was created. |
2021-07-03T14:25:26Z |
| ChargeType |
string |
The parameter is invalid. No value is returned. |
none |
| RegionId |
string |
The ID of the region to which the HaVip belongs. |
cn-hangzhou |
| VSwitchId |
string |
The ID of the vSwitch to which the HaVip belongs. |
vsw-bp1pkt1fba8e824ez**** |
| IpAddress |
string |
The private IP address of the HaVip. |
192.168.24.5 |
| Description |
string |
The description of the HaVip. |
My HaVip |
| MasterInstanceId |
string |
The ID of the active instance that is associated with the HaVip. |
i-bp145q7glnuzdvz**** |
| Name |
string |
The name of the HaVip. |
test |
| AssociatedEipAddresses |
object |
||
| associatedEipAddresse |
array |
The list of EIPs associated with the HaVip. |
|
|
string |
The EIP that is associated with the HaVip. |
121.12.XX.XX |
|
| AssociatedInstances |
object |
||
| associatedInstance |
array |
The information about the instance associated with the HaVip. |
|
|
string |
The ID of the instance with which the HaVip is associated. |
i-bp145q7glnuzdvzu21**** |
|
| ResourceGroupId |
string |
The ID of the resource group to which the HaVip belongs. |
rg-bp67acfmxazb4ph**** |
| Tags |
object |
||
| Tag |
array<object> |
The tag list. |
|
|
object |
|||
| Key |
string |
The key of tag N added to the resource. |
FinanceDept |
| Value |
string |
The value of tag N added to the resource. |
FinanceJoshua |
Contoh
Respons sukses
JSONformat
{
"PageSize": 10,
"RequestId": "33E480C5-B46F-4CA5-B6FD-D77C746E86AB",
"PageNumber": 1,
"TotalCount": 1,
"HaVips": {
"HaVip": [
{
"VpcId": "vpc-bp1kcm36tevkpms97****",
"Status": "Available",
"HaVipId": "havip-bp149uyvut73dpld****",
"AssociatedInstanceType": "EcsInstance",
"CreateTime": "2021-07-03T14:25:26Z",
"ChargeType": "none",
"RegionId": "cn-hangzhou",
"VSwitchId": "vsw-bp1pkt1fba8e824ez****",
"IpAddress": "192.168.24.5",
"Description": "My HaVip",
"MasterInstanceId": "i-bp145q7glnuzdvz****",
"Name": "test",
"AssociatedEipAddresses": {
"associatedEipAddresse": [
"121.12.XX.XX"
]
},
"AssociatedInstances": {
"associatedInstance": [
"i-bp145q7glnuzdvzu21****"
]
},
"ResourceGroupId": "rg-bp67acfmxazb4ph****",
"Tags": {
"Tag": [
{
"Key": "FinanceDept",
"Value": "FinanceJoshua"
}
]
}
}
]
}
}Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Forbidden.HaVip | No permissions to perform operations on HAVIPs. Please apply for privilege--vpc_privilege_allow_buy_havip_instance. | |
| 400 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | |
| 400 | InvalidFilterKey.ValueNotSupported | Specified filter key is not supported: Filter.X.key |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.