Applies for a Letter of Authorization (LOA) 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
ClientToken String No 123e4567-e89b-12d3-a456-426655440000

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among all requests. ClientToken can contain only ASCII characters.

Note If you do not set this parameter, ClientToken is set to the value of RequestId. The value of RequestId may be different for each API request.
Action String Yes ApplyPhysicalConnectionLOA

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

RegionId String Yes cn-hangzhou

The region ID of the Express Connect circuit.

You can call the DescribeRegions operation to query the most recent region list.

Bandwidth Integer No 3

The bandwidth of the Express Connect circuit. Unit: Mbit/s.

Valid values: 2 to 10240.

PeerLocation String No Hangzhou

The geographical location where the Express Connect circuit is deployed.

InstanceId String Yes pc-bp1qrb3044eqi****

The ID of the Express Connect circuit.

CompanyName String Yes company

The name of the customer company that requires the Express Connect circuit.

LineType String Yes FIBRE

The type of Express Connect circuit. Valid values:

  • MSTP: MSTP line
  • MPLSVPN: MPLSVPN line
  • FIBRE: fiber line
  • Other: other types
Si String Yes Alibaba Cloud

The construction company.

ConstructionTime String Yes 2022-02-28T16:00:00Z

The time when construction started. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mm:ssZ format. The time must be in UTC.

PMInfo.N.PMCertificateNo String Yes 5****************9

The ID number of the construction engineer. You can specify the ID number of an ID card or an international passport.

You can configure information for up to 16 construction engineers.

PMInfo.N.PMName String Yes Tom

The name of the construction engineer.

PMInfo.N.PMCertificateType String Yes IDCard

The type of the identity document of the construction engineer. Valid values:

  • IDCard: identity card
  • Passport: international passport
PMInfo.N.PMGender String Yes Male

The gender of the construction engineer.

PMInfo.N.PMContactInfo String Yes 1390000****

The contact information about the construction engineer.

Response parameters

Parameter Type Example Description
RequestId String A47BD386-7FDE-42C4-8D22-C6223D18AA1C

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?ClientToken=123e4567-e89b-12d3-a456-426655440000
&Action=ApplyPhysicalConnectionLOA
&RegionId=cn-hangzhou
&Bandwidth=3
&PeerLocation=Hangzhou
&InstanceId=pc-bp1qrb3044eqi****
&CompanyName=company
&LineType=FIBRE
&Si=Alibaba
&ConstructionTime=2022-02-28T16:00:00Z
&PMInfo=[{"PMCertificateNo":"5****************9","PMName":"Tom","PMCertificateType":"IDCard","PMGender":"Male","PMContactInfo":"1390000****"}]
&Common request parameters

Sample success responses

XML format

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

<ApplyPhysicalConnectionLOAResponse>
    <RequestId>A47BD386-7FDE-42C4-8D22-C6223D18AA1C</RequestId>
</ApplyPhysicalConnectionLOAResponse>

JSON format

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

{
  "RequestId" : "A47BD386-7FDE-42C4-8D22-C6223D18AA1C"
}

Error codes

HttpCode Error code Error message Description
400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. The error message returned because billing for outbound data transfer is disabled.
400 IllegalParam.Bandwidth The param of bandwidth is illegal. The error message returned because the Bandwidth parameter is set to an invalid value.

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