You can call this operation to associate a Smart Access Gateway (SAG) device with an SAG instance.

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 BindSerialNumber

The operation that you want to perform.

Set the value to BindSerialNumber.

RegionId String Yes cn-hangzhou

The ID of the region where the SAG instance is deployed.

SerialNumber String Yes sage62x021922****

The serial number (SN) of the SAG device.

SmartAGId String Yes sag-r79m060r6oy55******

The ID of the SAG instance.

Response parameters

Parameter Type Example Description
RequestId String 61C33444-D8C5-4018-A06C-BA8C8812BEF6

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=BindSerialNumber
&RegionId=cn-hangzhou
&SerialNumber=sage62x021922****
&SmartAGId=sag-r79m060r6oy55******
&<Common request parameters>

Sample success responses

XML format

<BindSerialNumberResponse>
  <RequestId>61C33444-D8C5-4018-A06C-BA8C8812BEF6</RequestId>
</BindSerialNumberResponse>

JSON format

{
	"RequestId":"61C33444-D8C5-4018-A06C-BA8C8812BEF6"
}

Error codes

HttpCode Error code Error message Description
400 SAG.InstanceIdEmpty You must specify the SAG instance ID. The error message returned because the ID of the SAG instance is not specified.
400 SAG.InstanceNoFound The specified SAG instance does not exist. The error message returned because the specified SAG instance does not exist.
500 SmartAccessGatewayInArrears The specified Smart Access Gateway has expired. The error message returned because the specified SAG instance has expired. Renew the SAG instance first.
400 SAG.SnOverLimit The maximum number of serial numbers bound to the SAG instance is exceeded. The error message returned because the number of SAG devices that can be associated with the SAG instance has reached the upper limit.
400 SAG.SnConflict The specified SerialNumber has been bound to another SAG instance. The error message returned because the specified SAG device has already been associated with another SAG instance.
400 ResourceInOperating The specified resource is being used. Please try later. The error message returned because the specified resource is being managed. Try again later.

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