All Products
Search
Document Center

Cloud Firewall:DescribeNetworkInstanceList

Last Updated:Oct 16, 2025

Queries a list of network instances.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Lang

string

No

The language of the response.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

Lang

string

No

The language of the response.

Valid values:

  • en :

    English

  • zh :

    Chinese

zh

ConnectType

string

No

The type of connection.

Valid values:

  • expressconnect :

    Express Connect

  • cen :

    Cloud Enterprise Network (CEN)

expressconnect

CenId

string

No

The ID of the CEN instance.

cen-x5jayxou71ad73****

Response elements

Element

Type

Description

Example

object

TotalCount

integer

The total number of entries.

21

RequestId

string

The request ID.

D2373503-3921-59F2-93A6-3DA7FB7****

NetworkInstanceList

array<object>

The details of the network instances.

object

The details of the network instances.

NetworkInstanceId

string

The ID of the network instance.

vpc-m5ewlqkuf7or****

NetworkInstanceName

string

The name of the network instance.

vpc-test

RegionNo

string

The region ID.

cn-shanghai

NetworkInstanceType

string

The type of the network instance.

Valid values:

  • vbr :

    VBR

  • vpc :

    VPC

vpc

Examples

Success response

JSON format

{
  "TotalCount": 21,
  "RequestId": "D2373503-3921-59F2-93A6-3DA7FB7****",
  "NetworkInstanceList": [
    {
      "NetworkInstanceId": "vpc-m5ewlqkuf7or****",
      "NetworkInstanceName": "vpc-test",
      "RegionNo": "cn-shanghai",
      "NetworkInstanceType": "vpc"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorAliUid Aliuid invalid. The aliuid is invalid.
400 ErrorDBSelectError A database select error occurred. The error message returned because an internal error has occurred in querying the database.
400 ErrorConnectType Connect type invalid. Incorrect selection of interworking type. Please select again.
400 ErrorMarshalJSON internal error. Internal error.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.