CreateTransitRouterGrantRule--中转路由器-火山引擎

文档中心

立即注册

导航

CreateTransitRouterGrantRule

最近更新时间：2024.07.09 08:42:33首次发布时间：2023.08.01 10:18:10

调用CreateTransitRouterGrantRule接口创建实例共享，将指定的TR实例授权共享给其他账号。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	CreateTransitRouterGrantRule	要执行的操作，取值为CreateTransitRouterGrantRule。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
TransitRouterId	String	是	tr-7qthudw0ll6jmc****	中转路由器实例的ID。您可以调用DescribeTransitRouters接口获取中转路由器实例ID。
GrantAccountId	String	是	210001****	中转路由器实例待授权的账号ID。您可以调用DescribeVpcs接口获取待授权的账号ID。
Description	String	否	rule01	实例共享的描述信息。必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。长度限制为0 ~ 255个字符。不传入该参数或该参数不传入数值时，默认为空字符串。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=CreateTransitRouterGrantRule&Version=2020-04-01&TransitRouterId=tr-7qthudw0ll6jmc****&GrantAccountId=210001**** HTTP/1.1
Host: open.volcengineapi.com
Service: transitrouter
Region: cn-guangzhou

返回示例

{
    "ResponseMetadata": {
        "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****",
        "Action": "CreateTransitRouterGrantRule",
        "Version": "2020-04-01",
        "Service": "transitrouter",
        "Region": "cn-guangzhou"
    },
    "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode	错误码	错误信息	描述
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法。描述长度不能超过255个字符。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法。请修复描述格式后重试。
400	InvalidTransitRouter.InvalidBusinessStatus	The request is denied because the specified Transit Router is shut down due to arrears.	指定的中转路由器欠费关停，不支持当前操作。
400	InvalidTransitRouter.InvalidStatus	The specified Transit Router is not in the correct status for the request.	指定的中转路由器所处状态无法响应该请求。
400	InvalidTransitRouterGrantRule.InvalidAccount	The specified granted account is equal to the login account, please change the account to grant.	指定的授权账号与当前账号相同，请更换账号授权。
400	QuotaExceeded.GrantRule	You've reached the maximum number of grant rules that one transit router can have.	已达到单个中转路由器可创建的授权规则的上限。
403	Forbidden.NoPermissionToOperate	You are not authorized to operate the specified resource.	无权限操作指定的资源。
404	InvalidTransitRouter.NotFound	The specified Transit Router does not exist.	指定的中转路由器不存在。
409	InvalidTransitRouterGrantRule.Conflict	The specified grant rule has already been existed in the Transit Router.	该授权规则已存在于指定的中转路由器，不支持重复操作。