Update Express Connect Circuit Specs & IDs via API - Express Connect - Alibaba Cloud - Express Connect

Modifies the configurations of an Express Connect circuit.

Operation description

When you call this operation, note the following items:

You can modify the specifications and redundant circuit ID only for Express Connect circuits in the Initial, Enabled, or Rejected state.
You cannot modify Express Connect circuits in the Canceled, Allocating, AllocationFailed, or Terminated state.
After an Express Connect circuit in the Rejected state is modified, it enters the Initial 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:ModifyPhysicalConnectionAttribute

update

*PhysicalConnection

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

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID of the Express Connect circuit. You can call the DescribeRegions operation to query the region ID.	cn-shanghai
PhysicalConnectionId	string	Yes	The ID of the Express Connect circuit.	pc-119mfjzm******
LineOperator	string	No	The carrier that provides the access to the physical line. Valid values: CT: China Telecom CU: China Unicom CM: China Mobile CO: Other carriers in the Chinese mainland Equinix: Equinix Other: Other carriers outside the Chinese mainland	CT
bandwidth	integer	No	The bandwidth of the Express Connect circuit access interface. Unit: Mbit/s. Valid values: 2 to 10240.	5
PeerLocation	string	No	The geographic location of the on-premises data center.	No. XX, XX Road, XX District, Hangzhou City, Zhejiang Province
PortType	string	No	The port type of the Express Connect circuit access point. Valid values: 100Base-T: 100M Ethernet port. 1000Base-T (default): 1 GE electrical port. 1000Base-LX: GE single-mode optical port (10 km). 10GBase-T: 10 GE electrical port. 10GBase-LR: 10 GE single-mode optical port (10 km). 40GBase-LR: 40 GE single-mode optical port. 100GBase-LR: 100 GE single-mode optical port. Note 40GBase-LR and 100GBase-LR are subject to the availability of backend port resources. Contact your account manager for more information.	1000Base-LX
RedundantPhysicalConnectionId	string	No	The ID of the redundant Express Connect circuit. The redundant circuit must be in the Allocated, Confirmed, or Enabled state.	pc-119mfjzm7
Description	string	No	The description of the Express Connect circuit. The description must be 2 to 256 characters in length and must start with a letter or a Chinese character. It cannot start with `http://` or `https://`.	Description of the Express Connect circuit
Name	string	No	The name of the Express Connect circuit. The name must be 2 to 128 characters in length and must start with a letter or a Chinese character. It can contain digits, periods (.), underscores (_), and hyphens (-). It cannot start with `http://` or `https://`.	Name of the Express Connect circuit
ClientToken	string	No	The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The ClientToken value can contain only ASCII characters. Note If you do not specify this parameter, the system uses the RequestId as the ClientToken. The RequestId may be different for each API request.	efefe566754h
CircuitCode	string	No	The circuit code provided by the carrier for the Express Connect circuit.	longtel001
DownDelayTime	integer	No	The port down delay time of the Express Connect circuit, in milliseconds. When a physical link Down event is detected, the access device waits for this duration before setting the port to the down state. This prevents transient disconnections from affecting your services. Valid values: 0 to 10000. The step size is 100. A value of 0 indicates that the port goes down immediately after the link goes down (default).	100

Response elements

Element	Type	Description	Example
	object	The response parameters.
RequestId	string	The request ID.	013EE132-A109-4247-91B0-099A8FF49AD7

Examples

Success response

JSON format

{
  "RequestId": "013EE132-A109-4247-91B0-099A8FF49AD7"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidLineOperator.Malformd	The LineOperator provided was invalid.
400	InvalidPeerLocation.Malformd	The PeerLocation provided was invalid.
400	InvalidPortType.Malformd	The PortType provided was invalid.
400	InvalidName.Malformed	The specified ?Name? is not valid.
400	InvalidStatus	invalid physical connection status.
400	InvalidBandwidth	invalid physical connection banwidth.
400	InvalidRedundantPhysicalConnection	redundant physical connection doesn't belong to current user.
400	InvalidRedundantPhysicalConnectionStatus	invalid redundant physical connection status.
400	InvalidCircuitCode.Malformed	circuitCode is illegal.
400	InvalidPhysicalConnectionOperator.Malformed	Specified PhysicalConnection Operator is not valid.	The operation on the Express Connect circuit is invalid.
400	InvalidPhysicalConnectionBandwidth.Malformed	Specified PhysicalConnection Bandwidth is not valid.	The bandwidth of the Express Connect circuit is set to an invalid value.
400	InvalidDescription.Malformed	The specified Description is not valid.	Parameter Description value is illegal
400	OperationDenied.VPconn	The operation is not allowed because of VPconn.	The operation failed because the hosted connection does not support the operation.
400	UnsupportedFeature.DownDelayTime	DownDelayTime is not supported for VirtualPhysicalConnection.	The shared line does not support the configuration state switch delay command.
400	InvalidParam.DownDelayTime	The DownDelayTime value is invalid.	State switch delay parameter value illegal
400	UnsupportedFeature.LinkDelay.Device	The access device does not support LinkDelay configuration.	Access device does not support LinkDelay feature
400	UnsupportedFeature.LinkDelay.Region	LinkDelay feature is not enabled in region.	The current region is not open state switching delay command characteristic switch
400	IncorrectBusinessStatus.PhysicalConnection	Invalid physical connection business status.	The current business status of the physical connection does not support operations.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.
404	InvalidPhysicalConnectionId.NotFound	The PhysicalConnectionId provided does not exist in our records.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.