调用UpdateTransitRouter修改转发路由器实例信息_云企业网(CEN)-阿里云帮助中心

调用UpdateTransitRouter接口修改转发路由器实例的名称和描述信息。

接口说明

UpdateTransitRouter 接口属于异步接口，即系统会先返回一个 RequestId，但转发路由器实例的修改并未完成，系统后台的修改任务仍在进行。您可以调用 ListTransitRouters 接口查询转发路由器实例的状态。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作	访问级别	资源类型	条件关键字	关联操作

操作	访问级别	资源类型	条件关键字	关联操作
cen:UpdateTransitRouter	update	TransitRouter `acs:cen::{#accountId}:centransitrouter/{#centransitrouterId}`	无	无

名称	类型	必填	描述	示例值

名称	类型	必填	描述	示例值
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	02fb3da4-130e-11e9-8e44-001****
DryRun	boolean	否	是否对此次修改请求执行预检，包括权限、实例状态校验等。取值： false（默认）：发送正常请求，通过检查后直接修改转发路由器实例的信息。 true：发送检查请求，只进行校验，不会修改转发路由器实例的信息。检查项包括是否填写了必需参数、请求格式等。如果检查不通过，则返回对应错误。如果检查通过，则返回对应请求 ID。	false
RegionId	string	是	转发路由器实例所属地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-shanghai
TransitRouterId	string	是	转发路由器实例 ID。	tr-uf654ttymmljlvh2x****
TransitRouterName	string	否	转发路由器实例的新名称。名称可以为空或长度为 1～128 个字符，不能以 http://或 https://开头。	testname
TransitRouterDescription	string	否	转发路由器实例新的描述信息。描述可以为空或长度为 1～256 个字符，不能以 http://或 https://开头。	testdesc

名称	类型	描述	示例值

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	E9963DD7-998B-4F92-892D-8293CB49EE81

正常返回示例

JSON格式

        
{
  "RequestId": "E9963DD7-998B-4F92-892D-8293CB49EE81"
}

HTTP status code	错误码	错误信息	描述

HTTP status code	错误码	错误信息	描述
400	OperationUnsupported.RegionId	The specified region ID is not supported.	操作不支持此地域
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	转发路由器状态不正确。
400	InvalidParameter	Invalid parameter.	参数不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	账号无权限操作。

访问错误中心查看更多错误码。

变更时间	变更内容概要	操作

变更时间	变更内容概要	操作

暂无变更历史