You can call this operation to create a VLAN interface for a leased line.

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 No CreateSagExpressConnectInterface

The operation that you want to perform.

Set the value to CreateSagExpressConnectInterface.

IP String Yes 192.XX.XX.1

The IP address of the leased line port.
Mask String Yes 255.255.255.252

The subnet mask of the IP address of the leased line port.
PortName String Yes 5

The name of the leased line port.
RegionId String Yes cn-shanghai

The ID of the region where the 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.
Vlan String Yes 10

The VLAN ID of the leased line port.

Valid values: 0 to 4094.

Note
  • If the VLAN ID is 0, the leased line port is a physical port and you cannot create a VLAN interface for the leased line port.
  • If the VLAN ID is 1 to 4094, the leased line port supports VLAN interfaces based on the Layer-3 protocols.
  • You can create a maximum of 5 VLAN interfaces.

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 

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

JSON format 

{
"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 number of VLAN interfaces of the leased line port exceeds the upper limit.
400 Sag.EccVlanExist The specified VLAN already exists. The specified VLAN interface already exists.
400 Sag.EccVlanDefault When VLAN 0 exists, other VLANs cannot be created. If the VLAN ID is 0, you cannot create a VLAN interface.

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