1. Interface Description
Interface request domain name: vpc.api3.convergecloud.com.
This API is used to query the cross-tenant elastic network interface (ENI) list.
Default interface request rate limit: 20 times per second.
Interface update time: 2024-12-29 00:20:38.
The interface only verifies the signature but does not authenticate.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: DescribeNetworkInterfacesEx |
| Version | Yes | No | String | Public parameter, The value of this interface: 2017-03-12 |
| Region | No | No | String | Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface |
| NetworkInterfaceIds | No | No | Array of String | ENI instance ID query, e.g., eni-pxir56ns. The upper limit of instances per request is 100. Parameters NetworkInterfaceIds and Filters must not be specified simultaneously. Example: ["eni-nswq8wkq"] |
| Filters | No | No | Array of Filter | Filters Example:View |
| Offset | No | No | Uint64 | Offset. 0 by default. Example: 0 |
| Limit | No | No | Uint64 | Number of returns, 20 by default, up to 100. Example: 10 |
| VpcAppId | No | No | Int64 | The APPID of the VPC user. Example: 1300224712 |
| VpcUin | No | No | String | The UIN of the VPC user. Example: 700000483554 |
| VpcSubAccountUin | No | No | String | The SubAccountUin of the VPC user. Example: 700000483554 |
| Business | No | No | String | The cross-tenant business name, such as TKE or SCF. Example: TKE |
| BusinessOwner | No | No | String | A business identifier that can uniquely identify a specific business resource. Example: dockerMaster |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| NetworkInterfaceSet | Array of NetworkInterface | Instance detail list. Example:View |
| TotalCount | Uint64 | Number of eligible instances. Example: |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| ResourceNotFound | The resource does not exist |
| InvalidParameter.Coexist | The parameters must not be specified simultaneously. |
| InvalidParameterValue.LimitExceeded | The parameter value exceeds the limit. |
| InvalidParameterValue.Range | The parameter value is not within the specified range. |
| UnsupportedOperation.UinNotFound | The account ID does not exist. |
| InvalidParameter.FilterInvalidKey | |
| InternalError.ModuleError | |
| LimitExceeded.ActionLimited |