Querying PLAS Connectors¶

Function¶

This API is used to query PLAS connectors.

Example

/v1.0/plasconnector/connectors?name=plasconnector-1&pageSize=10&pageNum=1

Parameter description

Parameter	Mandatory	Type	Description
name	No	String	Indicates the PLAS connector name, which can be used for fuzzy match. The value is a string of 1 to 128 characters.
ID	No	String	Indicates the PLAS connector id, which can be used for fuzzy match. The value is a string of 1 to 36 characters.
pageSize	Yes	int32	Indicates the number of records on each page. pageSize and pageNum determine a specific page. Value range: 10-100
pageNum	Yes	int32	Indicates the number of the current page. pageSize and pageNum determine a specific page.

Sample request

GET /v1.0/plasconnector/connectors HTTP/1.1

Content-Type:application/json

Accept:application/json;

X-Auth-Token:MIIDwAYJKoZIhvcNAQcCoIIDsTCCA60CAQExDTALBglghkgB

Parameter description

Parameter	Mandatory	Type	Description
totalNum	Yes	int32	Indicates the total number of records.
pageSize	Yes	int32	Indicates the number of records on each page. Value range: 10-100
currentPage	Yes	int32	Indicates the number of the current page.
data	Yes	List<PlasConnectorDetailModel>	Indicates the list of PLAS connector.

The PlasConnectorDetailModel object has the following attributes.

Parameter	Mandatory	Type	Description
id	Yes	String	Indicates the PLAS connector ID. The value is a string of 1 to 36 characters.
tenantId	Yes	String	Indicates the tenant ID. The value is a string of 1 to 36 characters.
name	Yes	String	Indicates the PLAS connector name. The name can consist of letters, digits, underscores (_), and hyphens (-). The value is a string of 1 to 128 characters.
description	No	String	Indicates the PLAS connector description. The value is a string of 0 to 255 characters.
bandwidth	Yes	int32	Indicates the bandwidth in Mbit/s. Value range: 10 50 100 150 200 300 400 500 600 1000
cloudInfo	Yes	CloudInfo object	Indicates the cloud interconnected with the PLAS connector.
networkInfo	Yes	NetworkInfo object	Indicates the network interconnected with the PLAS connector.
status	No	String	Indicates the PLAS Connector status. Value range: Pending Available Failed Deleting
createTime	No	String	Indicates the creation time. The time must be a UNIX timestamp accurate to milliseconds. The value is a string of 1 to 36 characters.

The CloudInfo object has the following attributes.

Parameter	Mandatory	Type	Description
provider	Yes	String	Indicates the cloud provider. Only OTC is currently supported. The value is a string of 1 to 64 characters.
masterLocation	Yes	String	Indicates the primary area that the PCCE connects to. Only Biere and Magdeburg are currently supported. The value is a string of 1 to 128 characters.
masterDirectConnectId	Yes	String	Indicates the ID of the Direct Connect link connected to the primary area. The value is a string of 1 to 36 characters.
slaveLocation	Yes	String	Indicates the secondary area that the PCCE connects to. Only Biere and Magdeburg are currently supported. The value is a string of 1 to 128 characters.
slaveDirectConnectId	Yes	String	Indicates the ID of the Direct Connect link connected to the secondary area. The value is a string of 1 to 36 characters.

The NetworkInfo object has the following attributes.

Parameter	Mandatory	Type	Description
provider	Yes	String	Indicates the network provider. Only Telekom is currently supported. The value is a string of 1 to 64 characters.
networkDomain	Yes	String	Indicates the network domain. Only IPLS is currently supported. The value is a string of 1 to 128 characters.
masterLocation	Yes	String	Indicates the primary area that the PCCE connects to. Only Biere and Magdeburg are currently supported. The value is a string of 1 to 128 characters.
slaveLocation	Yes	String	Indicates the secondary area that the PCCE connects to. Only Biere and Magdeburg are currently supported. The value is a string of 1 to 128 characters.
lineId	No	String	Indicates the line ID, which is assigned by the CCR. The value is a string of 1 to 36 characters.

Sample response

HTTP/1.1 200 OK

Content-Type:application/json

Cache-Control:no-cache

"totalNum": 1,

"pageSize": 10,

"currentPage": 1,

"data": [{

"id": "uuid",

"tenantId": "uuid",

"name": "plasconnector-1",

"description":"connector description",

"bandwidth": 50,

"cloudInfo": {

"provider": "OTC",

"masterLocation": "Biere",

"masterDirectConnectId": "uuid1",

"slaveLocation": "Magdeburg",

"slaveDirectConnectId": "uuid2"

},

"networkInfo": {

"provider": "Telekom",

"networkDomain": "IPLS",

"masterLocation": "Biere",

"slaveLocation":"Magdeburg",

"lineId":"UUID"

},

"status": "Available",

"createTime":"1223445454"

Normal
Returned Value
Description
200 OK
PLAS connectors are returned in a list.
Abnormal
Returned Value
Description
400 Bad Request
The server failed to process the request.
500 Internal Server Error
The server encountered an unexpected condition which prevented it from fulfilling the request.

Returned Value	Description
200 OK	PLAS connectors are returned in a list.

Returned Value	Description
400 Bad Request	The server failed to process the request.
500 Internal Server Error	The server encountered an unexpected condition which prevented it from fulfilling the request.

last updated: 2024-12-11 10:00 UTC - commit: 05fa1628b04de6e6ecfaf86722725857aa64e3df