DeleteIpv4Gateway_专有网络_API文档

2016-04-28

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

删除 IPv4 网关实例前，请确保已解绑 IPv4 网关实例关联的路由表。
DeleteIpv4Gateway 接口属于异步接口，即系统会先返回一个 RequestId，但该 IPv4 网关实例并未删除完成，系统后台的删除任务仍在进行。您可以调用 GetIpv4GatewayAttribute 查询 IPv4 网关实例的状态。
- 当 IPv4 网关实例处于 Deleting 状态时，表示正在删除中。
- 当 IPv4 网关实例无法被查询到时，表示删除完成。
DeleteIpv4Gateway 接口不支持并发删除同一个 IPv4 网关实例。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

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

vpc:DeleteIpv4Gateway	Delete	Ipv4Gateway acs:vpc:{#regionId}:{#accountId}:ipv4gateway/{#ipv4gatewayId}	无	无

请求参数

字段名称	字段详情
Ipv4GatewayIdstring	要删除的 IPv4 网关的实例 ID。示例值:ipv4gw-5tsnc6s4ogsedtp3k****参考取值来源: ListIpv4Gateways CreateIpv4Gateway
InternetModestring	选择删除 IPv4 网关后 VPC 的公网模式，取值：展开详情示例值:public枚举值:privatepublic
RegionIdstring	要删除的 IPv4 网关所在的地域 ID。展开详情示例值:ap-southeast-6参考取值来源: DescribeRegions
ClientTokenstring	客户端 Token，用于保证请求的幂等性。展开详情示例值:123e4567-e89b-12d3-a456-426655440000
DryRunboolean	是否只预检此次请求。取值：展开详情示例值:false

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:21133AC0-0636-521B-A400-253818691A56

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	ResourceNotFound.Ipv4Gateway	The specified resource ipv4Gateway is not found.	诊断
400	IncorrectStatus.Ipv4Gateway	The status of %s [%s] is incorrect.	诊断
400	OperationDenied.RouteEntryExist	The operation is not allowed because of existing routeEntry point to ipv4Gateway.	诊断
400	OperationDenied.GatewayAlreadyAssociated	The operation is not allowed because of the specified resource %s is already associated.	诊断
400	OperationFailed.Ipv4GatewayUsedByEipBindIpAddress	Failed to delete the IPv4 gateway because the EIP associated with a private IP address requires the IPv4 gateway to implement outbound Internet access.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-06-14	新增请求参数InternetMode
	2023-04-13	变更错误码400
	2021-11-02	新增OpenAPI，删除IPv4网关

相关示例

[创建并使能ipv4网关][创建网关路由表并绑定ipv4网关][创建网关路由表路由条目][解绑网关路由表并删除ipv4网关]

1.创建vpc->创建vswitch->创建ipv4网关->使能ipv4网关->修改ipv4网关名称、描述等属性 2.创建网关路由表->查询ipv4网关->绑定网关路由表到ipv4网关 3.创建ecs->网关路由表指定路由下一跳为ecs->查询网关路由条目 4.查询ipv4网关->解绑ipv4网关->删除ipv4网关

2021-12-17