All Products
Search
Document Center

Smart Access Gateway:CreateSagExpressConnectInterface

Last Updated:Mar 03, 2024

Creates a subinterface for an Express Connect circuit.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The ID of the region where the Smart Access Gateway (SAG) instance is deployed.

cn-shanghai
SmartAGIdstringYes

The ID of the SAG instance.

sag-whfn****
SmartAGSnstringYes

The serial number of the SAG device associated with the SAG instance.

sag32a30****
PortNamestringYes

The name of the Express Connect port.

5
VlanstringYes

The VLAN ID of the subinterface.

Value: 0 to 4094.

Note
  • If the VLAN ID is 0, this port is a physical port and does not support VLAN subinterfaces.
  • If the VLAN ID is 1 to 4094, this port supports VLAN subinterfaces based on the Layer 3 protocols.
  • You can create a maximum of 5 VLAN subinterfaces.
10
IPstringYes

The IP address.

192.XX.XX.1
MaskstringYes

The subnet mask of the IP address.

255.255.255.252

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545

Examples

Sample success responses

JSONformat

{
  "RequestId": "AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545"
}

Error codes

HTTP status codeError codeError messageDescription
400Sag.EccVlanOverLimitThe maximum number of VLANs that can be created for the device is exceeded.-
400Sag.EccVlanExistThe specified VLAN already exists.The specified VLAN already exists.
400Sag.EccVlanDefaultWhen VLAN 0 exists, other VLANs cannot be created.If a physical port of the device is used to connect to an Express Connect circuit, you cannot create a VLAN.

For a list of error codes, visit the Service error codes.