• Private Link Access Service

plas
  1. Help Center
  2. Private Link Access Service
  3. API Reference
  4. PLAS
  5. Querying PLAS Connectors

Querying PLAS Connectors

Function

Query PLAS connectors.

URI

  • URI format

    GET /v1.0/plasconnector/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.

Request

  • Parameter description

    None

  • Sample request
    GET /v1.0/plasconnector/connectors HTTP/1.1 
    Content-Type:application/json 
    Accept:application/json; 
    X-Auth-Token:MIIDwAYJKoZIhvcNAQcCoIIDsTCCA60CAQExDTALBglghkgB

Response

  • 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 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.

popLocation

Yes

String

Indicates the PoP that the PCNE in the PLAS Connector connects to. This PoP corresponds to the area of the PCNE in the network.

Only Berlin and Frankfurt are currently supported.

The value is a string of 1 to 128 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", 
                    "popLocation":"popLocation" 
                }, 
                "status": "Available", 
                "createTime":"1223445454" 
            } 
        ] 
    }     

Returned Value

  • 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.