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. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateSagExpressConnectInterface

The operation that you want to perform. Set the value to CreateSagExpressConnectInterface.

RegionId String Yes cn-shanghai

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

SmartAGId String Yes sag-whfn****

The ID of the SAG instance.

SmartAGSn String Yes sag32a30****

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

PortName String Yes 5

The name of the Express Connect port.

Vlan String Yes 10

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.
IP String Yes 192.XX.XX.1

The IP address.

Mask String Yes 255.255.255.252

The subnet mask of the IP address.

Response parameters

Parameter Type Example Description
RequestId String AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545

The ID of the request.

Examples

Sample requests

http(s)://smartag.cn-shanghai.aliyuncs.com/?Action=CreateSagExpressConnectInterface
&IP=192.XX.XX.1
&Mask=255.255.255.252
&PortName=5
&RegionId=cn-shanghai
&SmartAGId=sag-whfn****
&SmartAGSn=sag32a30****
&Vlan=10
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateSagExpressConnectInterfaceResponse>
    <RequestId>AFF7E5A6-6897-4FDC-A5A8-1978B5B3E545</RequestId>
</CreateSagExpressConnectInterfaceResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

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

Error codes

HttpCode Error code Error message Description
400 Sag.EccVlanOverLimit The maximum number of VLANs that can be created for the device is exceeded. The error message returned because the number of VLAN subinterfaces of the Express Connect circuit exceeds the upper limit.
400 Sag.EccVlanExist The specified VLAN already exists. The error message returned because the specified VLAN subinterface already exists.

For a list of error codes, visit the API Error Center.