Overview¶
Object Introduction¶
This topic describes the APIs for managing connections, including the API used to query a connection and the API used to query the connection list.
Object Model¶
Parameter | Type | CRUD | Default Value | Constraint | Description |
|---|---|---|---|---|---|
id | String | R | Automatically generated | UUID | Specifies the connection ID. |
tenant_id | String | R | N/A | The value can contain 0 to 255 characters. | Specifies the tenant ID. |
name | String | R | None | The value can contain 0 to 64 characters. Only letters, digits, underscores (_), hyphens (-), and periods (.) are allowed. | Specifies the connection name. |
description | String | R | None | The value can contain 0 to 128 characters. Angle brackets (<>) are not allowed. | Provides supplementary information about the connection. |
port_type | String | R | None | The value can contain 0 to 255 characters. | Specifies the type of the port used by the connection. The value can be 1G or 10G. |
bandwidth | Integer | R | N/A | Bandwidth range: 2 Mbit/s to 20,000 Mbit/s | Specifies the bandwidth of the connection in Mbit/s. |
location | String | R | None | The value can contain 0 to 255 characters. | Specifies the connection access location. |
peer_location | String | R | None | The value can contain 0 to 255 characters. | Specifies the physical location of the peer device accessed by the connection, specific to the street or data center name. |
device_id | String | R | None | The value can contain 0 to 255 characters. | Specifies the gateway device ID of the connection. |
interface_name | String | R | None | The value can contain 0 to 255 characters. | Specifies the name of the interface accessed by the connection. |
redundant_id | String | R | None | UUID | Specifies the ID of the redundant connection using the same gateway. |
provider | String | R | None | The value can contain 0 to 255 characters. | Specifies the carrier who provides the leased line. |
provider_status | String | R | DOWN | N/A | Specifies the status of the carrier's leased line. The value can be ACTIVE or DOWN. |
type | String | R | standard | The value can contain 0 to 255 characters. | Specifies the connection type. The value can be standard. |
charge_mode | String | R | prepayment | The value can contain 0 to 255 characters. | Specifies the billing mode. The value can be prepayment, bandwidth, or traffic. |
apply_time | String | R | N/A | The value can contain 0 to 255 characters. | Specifies the time when the connection was requested. |
order_id | String | R | None | The value can contain 0 to 64 characters. | Specifies the connection order ID, which is used to support duration-based billing and identify user orders. |
product_id | String | R | None | The value can contain 0 to 64 characters. | Specifies the product ID corresponding to the connection's order, which is used to custom billing policies such as duration-based packages. |
status | String | R | DOWN | N/A | Specifies the operating status of the connection. The value can be ACTIVE, DOWN, BUILD, or ERROR.
|
admin_state_up | Boolean | R | true | The value can only be true. | Specifies the administrative status of the connection. The value can be true or false. |
spec_code | String | R | None | N/A | This is a reserved field, which is not used currently. |
applicant | String | R | None | N/A | This is a reserved field, which is not used currently. |
mobile | String | R | None | N/A | This is a reserved field, which is not used currently. |
String | R | None | The value consists of 1 to 255 characters. | This is a reserved field, which is not used currently. | |
region_id | String | R | None | N/A | This is a reserved field, which is not used currently. |
service_key | String | R | None | N/A | This is a reserved field, which is not used currently. |
cable_label | String | R | None | N/A | This is a reserved field, which is not used currently. |
peer_port_type | String | R | None | N/A | This is a reserved field, which is not used currently. |
peer_provider | String | R | None | N/A | This is a reserved field, which is not used currently. |
onestop_product_id | String | R | None | N/A | This is a reserved field, which is not used currently. |
building_line_product_id | String | R | None | N/A | This is a reserved field, which is not used currently. |
last_onestop_product_id | String | R | None | N/A | This is a reserved field, which is not used currently. |
period_type | Integer | R | None | N/A | This is a reserved field, which is not used currently. |
period_num | Integer | R | None | N/A | This is a reserved field, which is not used currently. |
reason | String | R | None | N/A | This is a reserved field, which is not used currently. |
vgw_type | String | R | default | default | Specifies the type of the gateway. Currently, only the default type is supported. |
lag_id | String | R | None | UUID | This is a reserved field, which is not used currently. |