DeleteInstances_云服务器 ECS_API文档

2014-05-26

获取元数据获取 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.

接口说明

警告释放实例后，实例所使用的物理资源会被回收，相关数据全部丢失且不可恢复。

云盘的手动快照会被保留并继续计费，您可以通过 DeleteSnapshot 删除。
实例上挂载的云盘和自动快照是否被释放取决于创建时的参数设置。释放实例之前，您可以通过 DescribeDisks 、 ModifyDiskAttribute 查询和修改相关参数设置：
- DeleteWithInstance=false，云盘会被转换成按量付费云盘而保留下来，否则会随实例被释放。
- DeleteAutoSnapshot=false，自动快照被保留，否则会随实例被释放。
弹性公网 IP（EIP）不会随实例被释放，您可以通过 ReleaseEipAddress 释放。
注意被安全锁定的实例，即使云盘的DeleteWithInstance参数设置为false，释放实例时也会忽略这个属性而释放云盘。

流控信息

请求速率为100/60(s)。更多流控信息，请前往配额中心查看

授权信息

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

具体说明如下：展开详情

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

ecs:DeleteInstances	Delete	Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}	无	无

请求参数

字段名称	字段详情
DryRunboolean	是否只预检此次请求。展开详情示例值:false
Forceboolean	是否强制释放运行中（`Running`）的 ECS 实例。展开详情示例值:false
TerminateSubscriptionboolean	是否释放已到期的包年包月实例。展开详情示例值:false
ClientTokenstring	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。示例值:123e4567-e89b-12d3-a456-426655440000
RegionIdstring	实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。示例值:cn-hangzhou参考取值来源: DescribeRegions
InstanceIdarray<string>	实例 ID 数组。数组长度：1~100。示例值:i-bp1g6zv0ce8oghu7****子级条数 <= 100

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:7B7813C6-57BF-41XX-B12B-F172F65A6046

返回示例

错误码

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

全局错误码

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

400	InvalidParameter.CrossRegionNotSupport	Instances of multiple regions not support.	诊断
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	诊断
400	DependencyViolation.SLBConfiguring	Specified operation is denied as your instance is using by another product.	诊断
400	DependencyViolation.RouteEntry	Specified instance is used by route entry.	诊断
403	InvalidParameter.TooManyInstanceIds	Instance ids cannot be more than 100.	诊断
403	InvalidInstanceIds.ValueNotSupported	The specified instanceIds is not valid.	诊断
403	InvalidOperation.DeletionProtection	The operation is not allowed due to deletion protection.	诊断
403	ChargeTypeViolation	%s	诊断
403	IncorrectInstanceStatus.Initializing	%s	诊断
403	InvalidOperation.EniLinked	%s	诊断
403	IncorrectInstanceStatus	%s	诊断
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	诊断
403	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.	诊断
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	诊断
404	InvalidInstanceId.NotFound	%s	诊断
500	InvalidParameter	Invalid parameters.	诊断
500	InternalError	The request processing has failed due to some unknown error.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-03-20	变更错误码403

相关示例

批量删除 ECS 实例

批量删除 ECS 实例，可强制解除保护状态释放实例

2021-02-28

释放ECS实例

本文介绍如何通过阿里云ECS SDK调用StopInstance、DeleteInstance、ModifyInstanceAutoReleaseTime停止、释放ECS实例，并设置实例的自动释放时间。

2024-08-22