Console Core Open APIs (1.0.0)

Download OpenAPI specification:Download

Introduction

Console Core is a reselling platform used to resell various partner network services using a unified set of APIs (currently supported services are ports, layer 2 connections, and Internet exchange).

Product structures

  • Ethernet ports
  • Ethernet connections
  • Internet exchange

Authentication

  • Step 1. Get credentials and API key We have a production and demo/sandbox environments available. All testing should be done on the demo/sandbox environments. To get access to either of these environments contact your Account Executive.

  • Step 2. Obtain an authentication token Use HTTP POST /partners/login endpoint with the credentials mentioned in the previous step, and it will return an authentication token.

  • Step 3. Use the token and API key When using the API from a client code, set the token in the header authentication and x-api-key.


API scenarios

  1. Here you can find API scenarios that explain how to use the APIs step by step.


Ports API scenarios

SCENARIO 1: Order a port

Order a port diagram

  1. Query possible providers using the GET providers endpoint.
  2. Query supported locations by provider key using the GET locations endpoint.
  3. Query all port SKUs and select one using the GET ports by their SKUS endpoint.
  4. Query prices by SKU ID and location key using the GET port prices endpoint.
  5. Order a port using the POST ports endpoint with payload.

SCENARIO 2: Lookup a port

Lookup a port diagram

  1. Query order status by order ID using the GET orders by order ID endpoint.
  2. Get a port when order status is Pending or Completed using the GET ports endpoint.

    SCENARIO 3: Delete a port

Delete a port diagram

  1. Delete a port by ID using the DELETE a port endpoint.

  2. Verify that the port is deleted using the GET port details endpoint.


Layer 2 connections API scenarios

SCENARIO 1: Order a layer 2 connection

Order a connection diagram

  1. Query source/destination ports by location and get VLAN IDs that are in use using the GET ports endpoint.

  2. Query all layer 2 connection SKUs, using the GET layer 2 connections by their SKUS endpoint.

  3. Query layer 2 connection prices by SKU ID, source location, and destination location using the GET layer 2 connection prices endpoint.

  4. Order a layer 2 connection using the POST layer 2 connection endpoint.

SCENARIO 2: Lookup a layer 2 connection

Lookup a connection diagram

  1. Query layer 2 connection status by order ID using the GET orders by order ID endpoint.

  2. Get a layer 2 connection when order status is Completed using the GET connections endpoint.

SCENARIO 3: Update a layer 2 connection

Update a connection diagram

  1. Check the valid bandwidth for the update using the Get available max bandwidth endpoint.

  2. Request to update bandwidth using the POST update bandwidth endpoint.

  3. Query layer 2 connection update using the GET orders by order ID endpoint.

SCENARIO 4: Delete a layer 2 connection

Delete a connection diagram

  1. Delete a layer 2 connection by ID using the [DELETE connections by connection ID]#operation/deleteL2Connection) endpoint.

  2. Verify that the layer 2 connection is deleted using the GET connection details endpoint.

Authentication

bearerAuth

Security Scheme Type HTTP
HTTP Authorization Scheme bearer
Bearer format "JWT"

Digital-Marketing

Digital-Marketing

Sync data to hubspot Test

Authorizations:
Request Body schema: application/json
string

Responses

Request samples

Content type
application/json
"string"

Response samples

Content type
application/json
{
  • "app": "string",
  • "code": 0,
  • "payload": { },
  • "destination": "string",
  • "type": "string",
  • "message": { },
  • "properties": {
    },
  • "transactionId": "string"
}

Partner-Network

Partner-Network

Update a connection with a valid bandwidth

Authorizations:
query Parameters
connectionId
required
string

ID of the layer 2 connection

bandWidth
required
integer <int32>

New bandwidth value this layer 2 connection is to be updated to

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": { },
  • "message": "string"
}

Retrieve ports by their SKU

Authorizations:
query Parameters
provider
string

Provider of the port

speed
string

Bandwidth value of the port

unit
string

Bandwidth value unit, in Mbps or Gbps

Connector
string

Physical attribute of the port, e.g., RJ45

Interface
string

Physical attribute of the port, e.g., 1000Base-T

noPrices
boolean
Default: true

Whether prices are displayed

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of ports displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve port logs

Authorizations:
query Parameters
portId
required
string

ID of the port

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of port logs displayed on a page

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": {
    },
  • "message": "string"
}

Retrieve all NNI ports

Authorizations:
query Parameters
locationId
string

ID of this NNI port location

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of NNI ports displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve port details

Authorizations:
path Parameters
id
required
string

ID of the port

Responses

Response samples

Content type
application/json
{
  • "activedAt": "2019-08-24T14:15:22Z",
  • "code": "string",
  • "orderId": "string",
  • "description": "string",
  • "used": "string",
  • "isBandwidthSoldInTiers": true,
  • "interface": "1000BASE-T",
  • "speed": 0,
  • "deletedBy": "string",
  • "productCategory": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "maxBandwidth": 0,
  • "provider": "string",
  • "locationId": "string",
  • "acceptableVlanRanges": [
    ],
  • "links": {
    },
  • "id": "string",
  • "state": "PENDING",
  • "connections": [
    ],
  • "bandwidthTiers": [
    ],
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "allocatedAt": "2019-08-24T14:15:22Z",
  • "utilisation": "string",
  • "isNNI": true,
  • "portMode": "TRUNK",
  • "updatedBy": "string",
  • "productId": "string",
  • "contract": {
    },
  • "keyName": "string",
  • "externalId": "string",
  • "freeVlanRanges": [
    ],
  • "portType": "SMF",
  • "unit": "string",
  • "companyId": "string",
  • "deletedAt": "2019-08-24T14:15:22Z",
  • "deleted": true,
  • "productCode": "string",
  • "connector": "LC",
  • "createdBy": "string",
  • "name": "string",
  • "siteId": "string",
  • "minBandwidth": 0
}

Delete a port

Authorizations:
path Parameters
id
required
string

ID of the port that is to be deleted

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": "string",
  • "message": "string"
}

Retrieve details of an order

Authorizations:
path Parameters
id
required
string

ID of the order

Responses

Response samples

Content type
application/json
{
  • "resourceId": "string",
  • "companyName": "string",
  • "customerInfo": "string",
  • "productKey": "string",
  • "orderItems": [
    ],
  • "deletedBy": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "failedAt": "2019-08-24T14:15:22Z",
  • "provider": "string",
  • "rejectedAt": "2019-08-24T14:15:22Z",
  • "action": "NEW",
  • "links": {
    },
  • "id": "string",
  • "state": "PENDING",
  • "productType": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "completedAt": "2019-08-24T14:15:22Z",
  • "updatedBy": "string",
  • "productId": "string",
  • "keyName": "string",
  • "externalId": "string",
  • "message": "string",
  • "stateChanges": [
    ],
  • "external": { },
  • "companyId": "string",
  • "deletedAt": "2019-08-24T14:15:22Z",
  • "deleted": true,
  • "createdBy": "string",
  • "status": "ACKNOWLEDGED",
  • "resourceType": "PORT"
}

Allocate a port

Authorizations:
Request Body schema: application/json
portMode
string

Mode of the requested port

Enum: "TRUNK" "ACCESS" "HYBIRD"
name
required
string

Name of the requested port

autoRenew
boolean

Whether the contract renews itself automatically when contract duration finishes for this port

customerInfo
string

Information on customer for whom this port is ordered

priceId
required
string

ID of the price for the requested port

vlan
string

when provider is eunetworks or other support mef mode,vlan is mandatory.format:start-end ,for example:10-15

shieldId
string

ID of the console connect order for the requested port

Responses

Request samples

Content type
application/json
{
  • "portMode": "TRUNK",
  • "name": "string",
  • "autoRenew": true,
  • "customerInfo": "string",
  • "priceId": "string",
  • "vlan": "string",
  • "shieldId": "string"
}

Response samples

Content type
application/json
{
  • "resourceId": "string",
  • "companyName": "string",
  • "customerInfo": "string",
  • "productKey": "string",
  • "orderItems": [
    ],
  • "deletedBy": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "failedAt": "2019-08-24T14:15:22Z",
  • "provider": "string",
  • "rejectedAt": "2019-08-24T14:15:22Z",
  • "action": "NEW",
  • "links": {
    },
  • "id": "string",
  • "state": "PENDING",
  • "productType": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "completedAt": "2019-08-24T14:15:22Z",
  • "updatedBy": "string",
  • "productId": "string",
  • "keyName": "string",
  • "externalId": "string",
  • "message": "string",
  • "stateChanges": [
    ],
  • "external": { },
  • "companyId": "string",
  • "deletedAt": "2019-08-24T14:15:22Z",
  • "deleted": true,
  • "createdBy": "string",
  • "status": "ACKNOWLEDGED",
  • "resourceType": "PORT"
}

Retrieve connection logs

Authorizations:
query Parameters
connectionId
required
string

ID of the layer 2 connection

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of layer 2 connection logs displayed on a page

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": {
    },
  • "message": "string"
}

Retrieve all allocated ports Test

Authorizations:
query Parameters
orderId
string

ID of the port

isNNI
boolean

Whether the port is a NNI port

provider
string

Name of the port provider

locationId
string

ID of the port location

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of allocated ports displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve prices of ports

Authorizations:
query Parameters
skuId
string

ID of the port SKU

location
string

Port location

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of port prices displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve prices of connections

Authorizations:
query Parameters
skuId
string

ID of the connection SKU

srcLocationId
string

ID of the connection source location

destLocationId
string

ID of the connection destination location

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of layer 2 connection prices displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve all layer 2 connections

Authorizations:
query Parameters
orderId
string

ID of the layer 2 connection order

portId
string

ID of the port

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of layer 2 connections displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve connection details

Authorizations:
path Parameters
id
required
string

ID of the layer 2 connection

Responses

Response samples

Content type
application/json
{
  • "activedAt": "2019-08-24T14:15:22Z",
  • "destPortId": "string",
  • "code": "string",
  • "description": "string",
  • "deletedBy": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "provider": "string",
  • "links": {
    },
  • "id": "string",
  • "state": "PENDING",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "allocatedAt": "2019-08-24T14:15:22Z",
  • "srcPortId": "string",
  • "updatedBy": "string",
  • "bandwidth": 0,
  • "contract": {
    },
  • "keyName": "string",
  • "externalId": "string",
  • "unit": "string",
  • "deletedAt": "2019-08-24T14:15:22Z",
  • "destCompanyId": "string",
  • "deleted": true,
  • "srcCompanyId": "string",
  • "createdBy": "string",
  • "destVlan": 0,
  • "srcVlan": 0,
  • "name": "string"
}

Delete a connection

Authorizations:
path Parameters
id
required
string

ID of the layer 2 connection that is to be deleted

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": "string",
  • "message": "string"
}

Retrieve a valid bandwidth for a layer 2 connection

Authorizations:
query Parameters
connectionId
string

ID of the layer 2 connection

Responses

Response samples

Content type
application/json
{
  • "isUnlimited": true,
  • "allowOver": 0,
  • "updateBandwidth": [
    ],
  • "externalId": "string",
  • "connectionId": "string",
  • "currentBandwidth": 0,
  • "maxFreeBandwidth": 0,
  • "isPermitOverLimit": true,
  • "status": "ALLOCATED",
  • "totalMaxBandwidth": 0
}

Allocate a connection

Authorizations:
Request Body schema: application/json
destPortId
required
string

ID of the destination port for this layer 2 connection

srcPortId
required
string

ID of the source port for this layer 2 connection

bandwidth
required
integer <int32>

Bandwidth value for this layer 2 connection

destVlan
integer <int32>

Destination VLAN for this layer 2 connection

srcVlan
integer <int32>

Source VLAN for this layer 2 connection

name
required
string

Name of the layer 2 connection that is to be created

autoRenew
boolean

Whether the contract renews itself automatically when contract duration finishes

customerInfo
string

Information on the customer for whom this layer 2 connection was requested

object (1.0.0_Contract)

Represents contract details

priceId
required
string

ID of the price for this layer 2 connection

Responses

Request samples

Content type
application/json
{
  • "destPortId": "string",
  • "srcPortId": "string",
  • "bandwidth": 0,
  • "destVlan": 0,
  • "srcVlan": 0,
  • "name": "string",
  • "autoRenew": true,
  • "customerInfo": "string",
  • "term": {
    },
  • "priceId": "string"
}

Response samples

Content type
application/json
{
  • "resourceId": "string",
  • "companyName": "string",
  • "customerInfo": "string",
  • "productKey": "string",
  • "orderItems": [
    ],
  • "deletedBy": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "failedAt": "2019-08-24T14:15:22Z",
  • "provider": "string",
  • "rejectedAt": "2019-08-24T14:15:22Z",
  • "action": "NEW",
  • "links": {
    },
  • "id": "string",
  • "state": "PENDING",
  • "productType": "string",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "completedAt": "2019-08-24T14:15:22Z",
  • "updatedBy": "string",
  • "productId": "string",
  • "keyName": "string",
  • "externalId": "string",
  • "message": "string",
  • "stateChanges": [
    ],
  • "external": { },
  • "companyId": "string",
  • "deletedAt": "2019-08-24T14:15:22Z",
  • "deleted": true,
  • "createdBy": "string",
  • "status": "ACKNOWLEDGED",
  • "resourceType": "PORT"
}

Retrieve all providers for test

Authorizations:
query Parameters
page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of providers displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve all layer 2 connections by their SKU

Authorizations:
query Parameters
provider
string

Name of the service provider

bandwidth
string

Bandwidth value of the layer 2 connection

unit
string

Bandwidth value unit, in Mbps or Gbps

noPrices
boolean
Default: true

Whether prices are displayed

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of layer 2 connections displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve Data Centers

Authorizations:
query Parameters
country
string

Country in which the Data Center is located

city
string

City in which the Data Center is located

metro
string

The Metropolitan Area Network of the Data Center

provider
string

Name of the service provider who provides service in this Data Center

isOnNet
boolean
Default: true

Whether this Data Center can be automatically processesed

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of Data Centers displayed on a page

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "data": [
    ],
  • "size": 0,
  • "links": {
    },
  • "page": 0
}

Retrieve a layer 2 connection order status

Authorizations:
path Parameters
orderId
required
string

ID of the order

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": "string",
  • "message": "string"
}

Retrieve available bandwidth for a port

Authorizations:
query Parameters
srcPortId
string

ID os the source port

destPortId
string

ID of the destination port

Responses

Response samples

Content type
application/json
{
  • "isUnlimited": true,
  • "validBandwidth": [
    ],
  • "allowOver": 0,
  • "maxFreeBandwidth": 0,
  • "isPermitOverLimit": true,
  • "totalMaxBandwidth": 0
}

Retrieve order logs

Authorizations:
query Parameters
orderId
required
string

ID of the order

page
integer <int32>
Default: 1

The nth page of the results

size
integer <int32>
Default: 20

The number of order logs displayed on a page

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": {
    },
  • "message": "string"
}

Retrieve Loa Status by console connect order id

Authorizations:
query Parameters
orderId
required
string

ID of the console connect order

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": "string",
  • "message": "string"
}

Retrieve Loa pdf by console connect order id

Authorizations:
query Parameters
orderId
required
string

ID of the console connect order

Responses

customer ali cloud

ali-cloud api for customer

describeSchedulerRules

Authorizations:
path Parameters
uid
required
string

The Ali account uid.

query Parameters
ruleName
string

The name of the rule.

Responses

Response samples

Content type
*/*
{
  "code": 200,
  "data": {
    "requestId": "116C12ED-98B1-3829-8567-E2285F22168F",
    "schedulerRules": [
      {
        "cname": "1st6cdo1ah42e671.pccwglobalddos001.com",
        "param": {
          "paramData": {}
        },
        "ruleName": "testRule2",
        "ruleType": "3",
        "rules": [
          {
            "priority": 100,
            "regionId": "",
            "restoreDelay": 0,
            "status": 1,
            "type": "A",
            "value": "63.222.160.95",
            "valueType": 1
          },
          {
            "priority": 100,
            "regionId": "",
            "restoreDelay": 0,
            "status": 1,
            "type": "A",
            "value": "63.222.160.95",
            "valueType": 1
          },
          {
            "priority": 50,
            "regionId": "",
            "restoreDelay": 0,
            "status": 0,
            "type": "A",
            "value": "170.33.2.244",
            "valueType": 3
          }
        ]
      }
    ],
    "totalCount": "8"
  }
}

createSchedulerRule

Authorizations:
path Parameters
uid
required
string

The Ali account uid.

Request Body schema: application/json
resourceGroupId
string

The ID of the resource group to which the instance belongs in Resource Management.

required
Array of objects (3.2.7_Rule)

The details of the scheduling rule. This parameter is a JSON string.

ruleName
required
string

The name of the rule.

ruleType
required
integer <int32>

The type of the rule. Fixed Value:3

object (3.2.7_Param)

Responses

Request samples

Content type
application/json
{
  • "ruleName": "your rule name",
  • "ruleType": 3,
  • "rules": [
    ]
}

switchSchedulerRule

Authorizations:
path Parameters
uid
required
string

The Ali account uid.

Request Body schema: application/json
ruleName
required
string

The name of the scheduling rule to manage.

ruleType
required
integer <int32>

The type of the scheduling rule.

required
Array of objects (3.2.7_SwitchData)

The configuration that is used to switch service traffic. This parameter is a string that consists of JSON arrays.

Responses

Request samples

Content type
application/json
{
  • "ruleName": "string",
  • "ruleType": 0,
  • "switchData": [
    ]
}

modifySchedulerRule

Authorizations:
path Parameters
uid
required
string

The Ali account uid.

Request Body schema: application/json
resourceGroupId
string

The ID of the resource group to which the instance belongs in Resource Management.

required
Array of objects (3.2.7_Rule)
ruleName
required
string

The name of the rule.

ruleType
required
integer <int32>

The type of the rule. Fixed Value:3

object (3.2.7_Param)

Responses

Request samples

Content type
application/json
{
  • "resourceGroupId": "string",
  • "rules": [
    ],
  • "ruleName": "string",
  • "ruleType": 0,
  • "param": {
    }
}

deleteSchedulerRule

Authorizations:
path Parameters
uid
required
string

The Ali account uid.

query Parameters
resourceGroupId
string

The ID of the resource group to which the instance belongs in Resource Management.

ruleName
string

The name of the scheduling rule that you want to delete.

Responses

Search attribute configs

Authorizations:

Responses

Response samples

Content type
*/*
{
  "code": 200,
  "data": [
    {
      "id": "c8e5ced0-3812-43e2-8b5e-7e37748c7e55",
      "type": "INSURANCE",
      "cleanBandWidth": [
        {
          "label": "100 Mbps",
          "value": "100",
          "enable": true
        }
      ],
      "percentile": [
        {
          "label": "Disable",
          "value": "false",
          "enable": true
        }
      ],
      "functionPlan": [
        {
          "label": "Standard",
          "value": "standard",
          "enable": true
        }
      ],
      "cleanQPS": {
        "min": 500,
        "max": 150000,
        "step": 100
      },
      "domains": {
        "min": 10,
        "max": 2000,
        "step": 10
      },
      "ports": {
        "min": 5,
        "max": 1000,
        "step": 50
      }
    }
  ]
}

get instance list

Authorizations:
query Parameters
id
string
name
string
provider
string
customerId
string
ip
string
uid
string
status
string
Default: "ENABLED"
Enum: "ALLOCATED" "ENABLING" "ENABLED" "DISABLING" "DISABLED" "DELETING" "DELETED" "UPDATING" "FAILED"
deleted
boolean
Default: false
page
integer <int32>
Default: 1
size
integer <int32>
Default: 20

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

create ddos order

Authorizations:
Request Body schema: application/json
name
string
plan
required
integer <int32>
cleanBandwidth
required
integer <int32>
percentile95th
boolean
cleanQps
integer <int32>
customerId
string
companyId
string
functionVersion
integer <int32>
portCount
integer <int32>
domainCount
integer <int32>
subscription
integer <int32>
autoRenewal
boolean
renewPeriod
integer <int32>
productType
string
provider
string
uid
required
string
totalPrice
required
number <double>
createdBy
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "plan": 0,
  • "cleanBandwidth": 0,
  • "percentile95th": true,
  • "cleanQps": 0,
  • "customerId": "string",
  • "companyId": "string",
  • "functionVersion": 0,
  • "portCount": 0,
  • "domainCount": 0,
  • "subscription": 0,
  • "autoRenewal": true,
  • "renewPeriod": 0,
  • "productType": "string",
  • "provider": "string",
  • "uid": "string",
  • "totalPrice": 0,
  • "createdBy": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

send slack when data error exists

Authorizations:
Request Body schema: application/json
content
required
string
webhook
required
string

Responses

Request samples

Content type
application/json
{
  • "content": "string",
  • "webhook": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": "string"
}

describe SlaEvent List

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
domains
Array of strings
startTime
string
endTime
string
interval
integer <int64>
region
string
queryType
string
uid
string
pageSize
integer <int32>
pageNumber
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "domains": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "region": "string",
  • "queryType": "string",
  • "uid": "string",
  • "pageSize": 0,
  • "pageNumber": 0
}

describe PortMax Conns

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
instanceIds
Array of strings
startTime
string
endTime
string
interval
integer <int32>
uid
string

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "instanceIds": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "uid": "string"
}

describe PortFlow List

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
instanceIds
Array of strings
startTime
string
endTime
string
interval
integer <int32>
uid
string

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "instanceIds": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "uid": "string"
}

describe PortConns List

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
instanceIds
Array of strings
startTime
string
endTime
string
interval
integer <int32>
uid
string

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "instanceIds": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "uid": "string"
}

describe PortConns Count

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
instanceIds
Array of strings
startTime
string
endTime
string
interval
integer <int32>
uid
string

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "instanceIds": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "uid": "string"
}

describe PortAttack MaxFlow

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
instanceIds
Array of strings
startTime
string
endTime
string
interval
integer <int32>
uid
string

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "instanceIds": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "uid": "string"
}

describe DomainStatusCode List

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
domains
Array of strings
startTime
string
endTime
string
interval
integer <int64>
region
string
queryType
string
uid
string
pageSize
integer <int32>
pageNumber
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "domains": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "region": "string",
  • "queryType": "string",
  • "uid": "string",
  • "pageSize": 0,
  • "pageNumber": 0
}

describe DomainQPS List

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
domains
Array of strings
startTime
string
endTime
string
interval
integer <int64>
region
string
queryType
string
uid
string

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "domains": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "region": "string",
  • "queryType": "string",
  • "uid": "string"
}

describe DomainOver view

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
domains
Array of strings
startTime
string
endTime
string
interval
integer <int64>
region
string
queryType
string
uid
string
pageSize
integer <int32>
pageNumber
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "domains": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "region": "string",
  • "queryType": "string",
  • "uid": "string",
  • "pageSize": 0,
  • "pageNumber": 0
}

describe DomainAttack Events

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
domains
Array of strings
startTime
string
endTime
string
interval
integer <int64>
region
string
queryType
string
uid
string
pageSize
integer <int32>
pageNumber
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "domains": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "region": "string",
  • "queryType": "string",
  • "uid": "string",
  • "pageSize": 0,
  • "pageNumber": 0
}

describe DDoS Events

Authorizations:
Request Body schema: application/json
companyIds
Array of strings
instanceIds
Array of strings
startTime
string
endTime
string
interval
integer <int32>
uid
string
pageSize
integer <int32>
pageNumber
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "companyIds": [
    ],
  • "instanceIds": [
    ],
  • "startTime": "string",
  • "endTime": "string",
  • "interval": 0,
  • "uid": "string",
  • "pageSize": 0,
  • "pageNumber": 0
}

getSubscriptionPrice

Authorizations:
Request Body schema: application/json
productType
string
plan
required
integer <int32>
cleanBandwidth
integer <int32>
percentile95th
boolean
cleanQps
integer <int32>
functionVersion
integer <int32>
portCount
integer <int32>
domainCount
integer <int32>
subscription
required
integer <int32>
autoRenewal
boolean
uid
required
string

Responses

Request samples

Content type
application/json
{
  • "productType": "string",
  • "plan": 0,
  • "cleanBandwidth": 0,
  • "percentile95th": true,
  • "cleanQps": 0,
  • "functionVersion": 0,
  • "portCount": 0,
  • "domainCount": 0,
  • "subscription": 0,
  • "autoRenewal": true,
  • "uid": "string"
}

modifyHealthCheckConfig

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
forwardProtocol
string
frontendPort
integer <int32>
healthCheck
string
instanceId
string

Responses

Request samples

Content type
application/json
{
  • "forwardProtocol": "string",
  • "frontendPort": 0,
  • "healthCheck": "string",
  • "instanceId": "string"
}

describeNetworkRules

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
forwardProtocol
string
frontendPort
integer <int32>
instanceId
string
pageNumber
integer <int32>
pageSize
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "forwardProtocol": "string",
  • "frontendPort": 0,
  • "instanceId": "string",
  • "pageNumber": 0,
  • "pageSize": 0
}

describeHealthCheckStatus

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
networkRules
string

Responses

Request samples

Content type
application/json
{
  • "networkRules": "string"
}

deleteNetworkRule

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
networkRule
string

Responses

Request samples

Content type
application/json
{
  • "networkRule": "string"
}

createNetworkRules

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
networkRules
string

Responses

Request samples

Content type
application/json
{
  • "networkRules": "string"
}

configNetworkRules

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
networkRules
string

Responses

Request samples

Content type
application/json
{
  • "networkRules": "string"
}

modifyNetworkRuleAttribute

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
config
string
forwardProtocol
string
frontendPort
integer <int32>
instanceId
string

Responses

Request samples

Content type
application/json
{
  • "config": "string",
  • "forwardProtocol": "string",
  • "frontendPort": 0,
  • "instanceId": "string"
}

describeNetworkRuleAttributes

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
networkRules
string

Responses

Request samples

Content type
application/json
{
  • "networkRules": "string"
}

describeLayer4RulePolicy

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
listeners
string

Responses

Request samples

Content type
application/json
{
  • "listeners": "string"
}

describeHealthCheckList

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
networkRules
string

Responses

Request samples

Content type
application/json
{
  • "networkRules": "string"
}

configLayer4RulePolicy

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
listeners
string

Responses

Request samples

Content type
application/json
{
  • "listeners": "string"
}

configLayer4RuleBakMode

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
bakMode
string
listeners
string

Responses

Request samples

Content type
application/json
{
  • "bakMode": "string",
  • "listeners": "string"
}

setRenewal

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
instanceIDs
string
ownerId
integer <int64>
productCode
string
productType
string
renewalPeriod
integer <int32>
renewalPeriodUnit
string
renewalStatus
string
subscriptionType
string

Responses

Request samples

Content type
application/json
{
  • "instanceIDs": "string",
  • "ownerId": 0,
  • "productCode": "string",
  • "productType": "string",
  • "renewalPeriod": 0,
  • "renewalPeriodUnit": "string",
  • "renewalStatus": "string",
  • "subscriptionType": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

setRenewal with camunda

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
instanceIDs
string
ownerId
integer <int64>
productCode
string
productType
string
renewalPeriod
integer <int32>
renewalPeriodUnit
string
renewalStatus
string
subscriptionType
string
totalPrice
number <double>

Responses

Request samples

Content type
application/json
{
  • "instanceIDs": "string",
  • "ownerId": 0,
  • "productCode": "string",
  • "productType": "string",
  • "renewalPeriod": 0,
  • "renewalPeriodUnit": "string",
  • "renewalStatus": "string",
  • "subscriptionType": "string",
  • "totalPrice": 0
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

renew instance

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
clientToken
string
instanceId
string
ownerId
integer <int64>
productCode
string
productType
string
renewPeriod
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "clientToken": "string",
  • "instanceId": "string",
  • "ownerId": 0,
  • "productCode": "string",
  • "productType": "string",
  • "renewPeriod": 0
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

renew instance v2

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
clientToken
string
instanceId
string
ownerId
integer <int64>
productCode
string
productType
string
renewPeriod
integer <int32>
totalPrice
number <double>

Responses

Request samples

Content type
application/json
{
  • "clientToken": "string",
  • "instanceId": "string",
  • "ownerId": 0,
  • "productCode": "string",
  • "productType": "string",
  • "renewPeriod": 0,
  • "totalPrice": 0
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

create order by camunda

Authorizations:
Request Body schema: application/json
name
string
plan
required
integer <int32>
cleanBandwidth
required
integer <int32>
percentile95th
boolean
cleanQps
integer <int32>
customerId
string
companyId
string
functionVersion
integer <int32>
portCount
integer <int32>
domainCount
integer <int32>
subscription
integer <int32>
autoRenewal
boolean
renewPeriod
integer <int32>
productType
string
provider
string
uid
required
string
totalPrice
required
number <double>
createdBy
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "plan": 0,
  • "cleanBandwidth": 0,
  • "percentile95th": true,
  • "cleanQps": 0,
  • "customerId": "string",
  • "companyId": "string",
  • "functionVersion": 0,
  • "portCount": 0,
  • "domainCount": 0,
  • "subscription": 0,
  • "autoRenewal": true,
  • "renewPeriod": 0,
  • "productType": "string",
  • "provider": "string",
  • "uid": "string",
  • "totalPrice": 0,
  • "createdBy": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

modifyWebRule

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
domain
string
httpsExt
string
instanceIds
Array of strings
proxyTypes
string
realServers
Array of strings
resourceGroupId
string
rsType
integer <int32>
object
ocsp
integer <int32>
cname
string
cnameReused
boolean

Responses

Request samples

Content type
application/json
{
  • "domain": "string",
  • "httpsExt": "string",
  • "instanceIds": [
    ],
  • "proxyTypes": "string",
  • "realServers": [
    ],
  • "resourceGroupId": "string",
  • "rsType": 0,
  • "customHeaders": {
    },
  • "ocsp": 0,
  • "cname": "string",
  • "cnameReused": true
}

modifyTlsConfig

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
config
string
domain
string
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "config": "string",
  • "domain": "string",
  • "resourceGroupId": "string"
}

describeL7RsPolicy

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
domain
string
realServers
Array of strings
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "domain": "string",
  • "realServers": [
    ],
  • "resourceGroupId": "string"
}

describeHeaders

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
domain
string
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "domain": "string",
  • "resourceGroupId": "string"
}

describeCerts

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
domain
string
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "domain": "string",
  • "resourceGroupId": "string"
}

describeBackSourceCidr

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
ipVersion
string
line
string
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "ipVersion": "string",
  • "line": "string",
  • "resourceGroupId": "string"
}

deleteWebRule

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
domain
string
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "domain": "string",
  • "resourceGroupId": "string"
}

createWebRule

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
domain
string
resourceGroupId
string
rsType
integer <int32>
Array of objects (3.2.7_Rule)
object (3.2.7_HttpsExt)
defenseId
string
instanceIds
Array of strings
object
ocsp
integer <int32>
cnameReused
boolean

Responses

Request samples

Content type
application/json
{
  • "domain": "string",
  • "resourceGroupId": "string",
  • "rsType": 0,
  • "rules": [
    ],
  • "httpsExt": {
    },
  • "defenseId": "string",
  • "instanceIds": [
    ],
  • "customHeaders": {
    },
  • "ocsp": 0,
  • "cnameReused": true
}

configL7RsPolicy

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
domain
string
policy
string
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "domain": "string",
  • "policy": "string",
  • "resourceGroupId": "string"
}

associateWebCert

Authorizations:
path Parameters
uid
required
string
Request Body schema: application/json
cert
string
certId
integer <int32>
certName
string
domain
string
key
string
resourceGroupId
string

Responses

Request samples

Content type
application/json
{
  • "cert": "string",
  • "certId": 0,
  • "certName": "string",
  • "domain": "string",
  • "key": "string",
  • "resourceGroupId": "string"
}

instance data compare

Authorizations:
query Parameters
uid
string

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": { }
}

getInstanceStatus

Authorizations:
path Parameters
id
required
string

Responses

search ddos networks

Authorizations:
query Parameters
provider
string
companyId
string
customerId
string
uid
string
instanceId
string
forwardingPort
string
ip
string
page
integer <int32>
Default: 1
size
integer <int32>
Default: 10

Responses

list

Authorizations:
path Parameters
uid
required
string
query Parameters
instanceId
required
string
forwardProtocol
string
frontendPort
integer <int32>
page
integer <int32>
Default: 1
size
integer <int32>
Default: 10

Responses

get instance status from ali

Authorizations:
path Parameters
id
required
string
query Parameters
uid
required
string

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

get a instance detail

Authorizations:
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

getInstanceList_1

Authorizations:
path Parameters
uid
required
string
query Parameters
instanceId
string
companyId
string
page
integer <int32>
Default: 1
size
integer <int32>
Default: 20

Responses

getCadTemplate

Authorizations:
path Parameters
uid
required
string
query Parameters
instanceId
string
domain
string

Responses

describeWebRuleConfig

Authorizations:
path Parameters
uid
required
string
query Parameters
domain
required
string

Responses

domain search

Authorizations:
query Parameters
provider
string
companyId
string
customerId
string
uid
string
instanceId
string
page
integer <int32>
Default: 1
size
integer <int32>
Default: 10

Responses

get credit and account info

Authorizations:
path Parameters
uid
required
string
subUid
required
string

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

release Instance with camunda

Authorizations:
path Parameters
uid
required
string
id
required
string

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}

release Instance

Authorizations:
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "code": 0,
  • "message": "string",
  • "data": {
    }
}