All Products
Search
Document Center

Alibaba Cloud Service Mesh:DescribeEipResources

Last Updated:Mar 05, 2024

Queries elastic IP addresses (EIPs).

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ServiceMeshIdstringNo

The ID of the ASM instance.

cb8963379255149cb98c8686f274x****
PageNumintegerNo

The number of the page to return. Default value: 1.

1
PageSizeintegerNo

The number of entries to return on each page.

50

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

BD65C0AD-D3C6-48D3-8D93-38D2015C****
EipListobject []

The EIPs.

IpAddressstring

The IP address of the EIP.

120.xx.xx.112
Statusstring

The status of the EIP. Valid values:

  • Associating: The EIP is being associated with a resource.
  • Unassociating: The EIP is being disassociated from a resource.
  • InUse: The EIP is associated with a resource.
  • Available: The EIP is available.
InUse
AllocationIdstring

The ID of the EIP.

eip-2zeerraiwb7ujxscd****
InstanceTypestring

The type of the resource that is associated with the EIP. Valid values:

  • EcsInstance: an ECS instance in a VPC
  • SlbInstance: a Server Load Balancer (SLB) instance in a VPC
  • Nat: a NAT gateway
  • HaVip: a high-availability virtual IP address (HAVIP)
  • NetworkInterface: a secondary elastic network interface (ENI)

Default value: EcsInstance.

SlbInstance
PageResultobject

The pagination information.

TotalCountinteger

The number of entries returned.

10
PageNumberinteger

The page number of the returned page.

1
PageSizeinteger

The number of entries returned per page.

10

Examples

Sample success responses

JSONformat

{
  "RequestId": "BD65C0AD-D3C6-48D3-8D93-38D2015C****",
  "EipList": [
    {
      "IpAddress": "120.xx.xx.112",
      "Status": "InUse",
      "AllocationId": "eip-2zeerraiwb7ujxscd****",
      "InstanceType": "SlbInstance"
    }
  ],
  "PageResult": {
    "TotalCount": 10,
    "PageNumber": 1,
    "PageSize": 10
  }
}

Error codes

HTTP status codeError codeError message
500ERR500An internal server error occurred.

For a list of error codes, visit the Service error codes.