Calls the UpdateTransitRouterEcrAttachmentAttribute operation to modify the name and description of an Express Connect Router (ECR) connection under an Enterprise Edition transit router.
Operation description
UpdateTransitRouterEcrAttachmentAttribute is an asynchronous operation. The system returns a RequestId immediately, but the ECR connection has not been modified yet because the modification task is still running in the background. You can call the ListTransitRouterEcrAttachments operation to query the status of the ECR connection.
If the ECR connection is in the Modifying state, the ECR connection is being modified. In this state, you can only query the ECR connection but cannot perform other operations on it. If the ECR connection is in the Attached state, the ECR connection has been modified.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
cen:UpdateTransitRouterEcrAttachmentAttribute |
update |
*TransitRouterEcrAttachment
|
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. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The client token can contain only ASCII characters. Note
If you do not specify this parameter, the system automatically uses the RequestId of the API request as the ClientToken. The RequestId of each API request may be different. |
123e4567-e89b-12d3-a456-42665544**** |
| TransitRouterAttachmentId |
string |
Yes |
The ID of the ECR connection. |
tr-attach-r6g0m3epjehw57**** |
| TransitRouterAttachmentName |
string |
No |
The new name of the ECR connection. The name can be empty or 1 to 128 characters in length and cannot start with http:// or https://. |
nametest |
| TransitRouterAttachmentDescription |
string |
No |
The new description of the ECR connection. The description can be empty or 1 to 256 characters in length and cannot start with http:// or https://. |
desctest |
| DryRun |
boolean |
No |
Specifies whether to perform a dry run for this modification request, including permission and instance status checks. Valid values:
|
false |
| OrderType |
string |
No |
The payer of the network instance. The payer of the ECR connection cannot be modified. Valid values:
|
PayByCenOwner |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
54B48E3D-DF70-471B-AA93-08E683A1B457 |
Examples
Success response
JSON format
{
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B457"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidTransitRouterAttachmentId.NotFound | TransitRouterAttachmentId is not found. | The error message returned because the ID of the network instance does not exist. |
| 400 | IncorrectStatus.TransitRouterAttachment | The status of TransitRouterAttachment is incorrect. | The error message returned because the status of the transit router attachment does not support this operation. Try again later. |
| 400 | InvalidParameter | Invalid parameter. | The error message returned because the parameter is set to an invalid value. |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | The error message returned because you do not have the permissions to perform this operation. |
| 400 | InvalidParameter.CenBandwidthPackageId | The specified parameter CenBandwidthPackageId is invalid. | The parameter CenBandwidthPackageId entered is illegal. |
| 400 | InvalidParameter.TransitRouterAttachmentId | The specified parameter TransitRouterAttachmentId is invalid. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.