All Products
Search

This Product

    Express Connect:CompletePhysicalConnectionLOA

    Document Center

    Express Connect:CompletePhysicalConnectionLOA

    Last Updated:Aug 24, 2026

    Calls CompletePhysicalConnectionLOA to complete the construction and backfill the completion information after the LOA is approved and the line construction is finished.

    Operation description

    Calls the CompletePhysicalConnectionLOA operation to complete the construction. Before calling this operation, call DescribePhysicalConnectionLOA to query the LOA status. You can call this operation only when the status is Available or Complete. After an LOA application is submitted, the status changes to Applying. After the application is approved, the status changes to Available. If the application is rejected, the status changes to Rejected. For a rejected application, call SecondApplyPhysicalConnectionLOA to reapply. After the construction is completed, the LOA status changes to Complete.

    Complete call chain: CreatePhysicalConnection → ApplyPhysicalConnectionLOA (LOA enters the Applying state) → Wait for approval (Available after approval; Rejected if denied, in which case call SecondApplyPhysicalConnectionLOA or ApplyPhysicalConnectionLOA again to reapply) → CompletePhysicalConnectionLOA (backfill completion information, LOA enters the Completing state) → ConfirmPhysicalConnection (confirm the Express Connect circuit, LOA enters the Complete state).

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    vpc:CompletePhysicalConnectionLOA

    update

    *PhysicalConnection

    acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ClientToken

    string

    No

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

    The client generates the value. Ensure that the value is unique among different requests.

    Note

    If you do not specify this parameter, the system uses the RequestId of the API request as the ClientToken. The RequestId of each API request may be different.

    02fb3da4-230e-11e9-8e44-0016e04115b
    RegionId

    string

    Yes

    The region ID of the Express Connect circuit.

    You can call the DescribeRegions operation to query the region ID.

    cn-shanghai
    InstanceId

    string

    Yes

    The instance ID of the Express Connect circuit.

    pc-bp10tvlhnwkw****
    LineCode

    string

    No

    The line code of the carrier.

    aaa111****
    LineLabel

    string

    No

    The cable label in the data center building.

    bbb222****
    LineServiceProvider

    string

    No

    The carrier. Valid values:

    • 中国电信.

    • 中国联通.

    • 中国移动.

    • 中国其他.

    中国其他
    LineSPContactInfo

    string

    No

    The O&M contact information of the line carrier.

    1388888****
    FinishWork

    boolean

    No

    Specifies whether the construction is completed. Valid values:

    • true: Construction is completed.

    • false: Line O&M.

    true

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    F8983C74-E068-4509-B442-89BD82C8F43B

    Examples

    Success response

    JSON format

    {
  "RequestId": "F8983C74-E068-4509-B442-89BD82C8F43B"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 MissingParam.AliUid %s
    400 MissingParam.InstanceId %s
    400 MissingParam.RegionNo %s
    400 InvalidInstanceId.NotFound %s
    400 IncorrectStatus.PhysicalConnectionLOA %s
    400 IllegalParam.LineCode %s
    400 IllegalParam.LineLabel %s
    400 OperationDenied.LOAStatusNotAllowComplete The operation is not allowed because of LOAStatusNotAllowComplete. The LOA status of the port does not allow completion reporting or line O&M.
    400 IllegalParam.LineSPContactInfo LineSPContactInfo is illegal. The contact information of the operator's line operation and maintenance is illegal.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.