调用CreateIpv6EgressOnlyRule接口为IPv6地址添加仅主动出规则。

使用说明

  • CreateIpv6EgressOnlyRule接口属于异步接口,即系统返回一个实例ID,但该IPv6地址的仅主动出规则尚未创建成功,系统后台的创建任务仍在进行。您可以调用DescribeIpv6EgressOnlyRules查询IPv6地址的仅主动出规则的创建状态:
    • 当IPv6地址的仅主动出规则处于Creating状态时,表示IPv6地址仅主动出规则正在创建中。
    • 当IPv6地址的仅主动出规则处于Created状态时,表示IPv6地址仅主动出规则创建完成。
  • CreateIpv6EgressOnlyRule接口不支持为同一个IPv6地址并发添加仅主动出规则。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String cn-huhehaote

IPv6网关的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

Ipv6GatewayId String ipv6gw-hp3c2paq0ywauasza****

IPv6网关实例ID。

InstanceId String ipv6-hp3nxjkfxn5pnhgl5****

需要设置仅主动出规则的IPv6地址ID。

InstanceType String Ipv6Address

需要设置仅主动出规则的实例类型。

仅取值:Ipv6Address(默认值),表示为IPv6地址类型。

Name String rulename

仅主动出规则的名称。

长度为2~128个字符,必须以字母或中文开头,可包含数字、下划线(_)和短划线(-),开头不能为http://https://

Description String ruledescription

仅主动出规则的描述。

长度为2~256个字符,开头不能为http://https://

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe637760

客户端Token,用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符。

说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
Action String CreateIpv6EgressOnlyRule

系统规定参数。取值:CreateIpv6EgressOnlyRule

返回数据

名称 类型 示例值 描述
Ipv6EgressRuleId String ipv6py-hp3w98rmlbqp01245****

仅主动出规则的ID。

RequestId String 9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateIpv6EgressOnlyRule
&InstanceId=ipv6-hp3nxjkfxn5pnhgl5****
&Ipv6GatewayId=ipv6gw-hp3c2paq0ywauasza****
&RegionId=cn-huhehaote
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateIpv6EgressOnlyRuleResponse>
	<RequestId>9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75</RequestId>
	<Ipv6EgressRuleId>ipv6py-hp3w98rmlbqp01245****</Ipv6EgressRuleId>
</CreateIpv6EgressOnlyRuleResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Ipv6EgressRuleId" : "ipv6py-hp3w98rmlbqp01245****",
  "RequestId" : "9DFEDBEE-E5AB-49E8-A2DC-CC114C67AF75"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定的RegionId不存在。

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