本文介绍了云服务器ECS的OpenAPI变更信息。 :::tip 更多历史变更信息，请查看[历史变更记录](https://www.volcengine.com/docs/6396/1170916)。 ::: ## 2025年03月 |API |变更记录 |关联功能 |发布地域 | |---|---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |* 新增请求参数AffinityGroupSize，可选、邀测。|实例 |中国香港 |\ | |* 更新请求参数DeploymentSetGroupNumber的取值范围。| | |\ | |* 新增错误码：InvalidInstanceTypeForAffinityGroupSize.Unsupported、InvalidInstanceTypeForNonAffinityGroup.Unsupported、InvalidSecurityGroupStatus、QuotaExceeded.MaximumEipAddresses、InvalidAffinityGroupSize.CountMismatch、InvalidAffinityGroupSize.DeploymentSetIdMismatch、InvalidAffinityGroupSize.MinCountMismatch、InvalidInstanceChargeType.AffinityGroupSizeMismatch。| | |\ | |* 更新错误码描述OperationDenied.TrafficModeNotAuthorized。 | | | |[CreateScheduledInstances](https://www.volcengine.com/docs/6396/1187924) |新增错误码：InvalidSecurityGroupStatus。 |^^|^^| |[DeleteInstance](https://www.volcengine.com/docs/6396/70465)|新增错误码：OperationDenied.AffinityGroupInstance。|^^|^^|\ |[RenewInstance](https://www.volcengine.com/docs/6396/76276)| | | |\ |[DeleteInstances](https://www.volcengine.com/docs/6396/101070) | | | | |[StopInstance](https://www.volcengine.com/docs/6396/70468) |新增错误码：InvalidStoppedModeForAffinityGroupInstance.Unsupported。 |^^|^^| |[StopInstances](https://www.volcengine.com/docs/6396/101067) |更新返回参数：Error返回结构新增取值InvalidStoppedModeForAffinityGroupInstance.Unsupported。 |^^|^^| |[DescribeInstances](https://www.volcengine.com/docs/6396/70466) |* 新增请求参数AffinityGroupIds.N（可选）；更新请求参数DeploymentSetGroupNumbers。|^^|^^|\ | |* 新增返回参数AffinityGroupId。| | |\ | |* 新增错误码：LimitExceeded.MaximumAffinityGroupIds。 | | | |[DescribeInstanceTypes](https://www.volcengine.com/docs/6396/92769) |新增返回参数：AffinityGroupSizes、IsSupportAffinityGroup、RDMA结构下新增RdmaProductName。 |^^|^^| |[ModifyInstanceChargeType](https://www.volcengine.com/docs/6396/76278) |新增错误码：InvalidAffinityGroupInstanceForModifyInstanceChargeType.Unsupported、OperationDenied.AffinityGroupInstance。 |^^|^^| |[ModifyInstanceSpec](https://www.volcengine.com/docs/6396/76277) |新增错误码：InvalidAffinityGroupInstanceForModifyInstanceSpec.Unsupported。 |^^|^^| |[ModifyInstancesSpec](https://www.volcengine.com/docs/6396/1473910) |新增接口。 |^^|^^| |[ImportImage](https://www.volcengine.com/docs/6396/120263) |新增请求参数：|镜像 |^^|\ | |ImportDataVolumes.N.DataVolumeUrl，可选。| | |\ | |新增错误码：| | |\ | |400，LimitExceeded.MaximumImportDataVolumes | | | |[CreateDeploymentSet](https://www.volcengine.com/docs/6396/165528) |更新GroupCount、Granularity取值。 |部署集 |^^| |[DescribeDeploymentSets](https://www.volcengine.com/docs/6396/165534) |更新Granularity描述。 |^^|^^| |[ModifyInstanceDeployment](https://www.volcengine.com/docs/6396/165550) |更新DeploymentSetGroupNumber取值。 |^^|^^| |[DescribeHpcClusters](https://www.volcengine.com/docs/6396/1453770) |删除请求参数AccountId。 |高性能计算集群 |^^| |[CreateLaunchTemplate](https://www.volcengine.com/docs/6396/1324369) |新增请求参数：LaunchTemplateTags.N.Key、LaunchTemplateTags.N.Value，可选。 |启动模版 |全部 | |[DescribeLaunchTemplates](https://www.volcengine.com/docs/6396/1324371) |新增响应参数：LaunchTemplateTags。 |^^|^^| ## 2025年02月 |API |变更记录 |关联功能 |发布地域 | |---|---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |* 新增请求参数：CpuMaxFrequency，可选，邀测。|实例 |全部 |\ | |* 新增错误码：InvalidNetworkInterfaceType、InvalidSubnetStatus、LimitExceeded.MaximumHighPerformanceNetworkInterfaces、OperationDenied.TrafficModeNotAuthorized。 | | | |[DescribeInstances](https://www.volcengine.com/docs/6396/70466) |新增返回参数：SecurityGroupIds。 |^^|^^| |[ModifyInstanceSpec](https://www.volcengine.com/docs/6396/76277) |新增错误码：LimitExceeded.MaximumHighPerformanceNetworkInterfaces。 |^^|^^| |[CreateScheduledInstances](https://www.volcengine.com/docs/6396/1187924) |* 新增请求参数：MinCount，可选；CpuMaxFrequency，可选，邀测。|^^|^^|\ | |* 新增错误码：InvalidMinCount.Malformed。 | | | |[PurchaseReservedInstances](https://www.volcengine.com/docs/6396/1171074) |* 新增请求参数：EffectiveAt、RscAutoRenew、RscAutoRenewPeriod、ReservedStorageCapacityName、ReservedCapacity、VolumeType。|^^|^^|\ | |* 新增返回参数：ReservedStorageCapacityId。| | |\ | |* 新增错误码：InvalidReservedStorageCapacityName.Malformed、InvalidVolumeType.Malformed、LimitExceeded.ReservedCapacitySize、OperationDenied.ReservedStorageCapacityNotAvailable。 | | | |[CreateTags](https://www.volcengine.com/docs/6396/130886)|* 变更请求参数：ResourceIds.N改为非必填。|标签 |^^|\ |[ListTagsForResources](https://www.volcengine.com/docs/6396/1394794) |* 新增错误码：MissingParameter.ResourceType。 | | | |[CreateLaunchTemplate](https://www.volcengine.com/docs/6396/1324369)|新增请求参数：Eip.ReleaseWithInstance，可选。 |实例启动模版 |^^|\ |[CreateLaunchTemplateVersion](https://www.volcengine.com/docs/6396/1324370) | | | | |[DescribeLaunchTemplateVersions](https://www.volcengine.com/docs/6396/1324372) |新增响应参数：Eip.ReleaseWithInstance。 |^^|^^| |[CreateSubscription](https://www.volcengine.com/docs/6396/166016)|* 请求参数EventTypes.N 新增枚举值：InstanceFileSystemFailure.StopAndRepair:Succeeded、InstanceFileSystemFailure.StopAndRepair:Failed、ElasticScheduledInstance.Create、MemoryRiskDetected:Succeeded、DiskError.ReplaceDisk:Succeeded、SystemFailure.Redeploy:Failed、SystemMaintenance.Redeploy:Failed|事件监控 |^^|\ |[ModifySubscriptionEventTypes](https://www.volcengine.com/docs/6396/166017) |* 请求参数EventTypes.N 枚举值文案优化：DiskError.Redeploy、SystemFailure.Redeploy、SystemMaintenance.Redeploy、InstanceFailure | | | |[DescribeSystemEvents](https://www.volcengine.com/docs/6396/129399)|* 请求参数Types.N 新增枚举值：InstanceFileSystemFailure_StopAndRepair、ElasticScheduledInstance、MemoryRiskDetected、SystemFailure_Repair、SystemMaintenance_StopAndRepair|^^|^^|\ |[DescribeEventTypes](https://www.volcengine.com/docs/6396/196424) |* 请求参数Types.N 优化枚举值文案：SystemFailure、DiskError_Redeploy、SystemMaintenance、InstanceFailure | | | |[CreateHpcCluster](https://www.volcengine.com/docs/6396/1453768)|新增接口。 |高性能计算集群 |^^|\ |[DeleteHpcCluster](https://www.volcengine.com/docs/6396/1453769)| | | |\ |[DescribeHpcClusters](https://www.volcengine.com/docs/6396/1453770) | | | | |^^|^^|^^|^^| |^^|^^|^^|^^| ## 2024年12月 |API |变更记录 |关联功能 | |---|---|---| |[CreateLaunchTemplate](https://www.volcengine.com/docs/6396/1324369) |新增请求参数：LaunchTemplateProjectName，可选。 |启动模版 | |[DescribeLaunchTemplates](https://www.volcengine.com/docs/6396/1324371) |* 新增请求参数：LaunchTemplateProjectName，可选。|^^|\ | |* 新增响应参数：LaunchTemplateProjectName。 | | |[TagResources](https://www.volcengine.com/docs/6396/1394798)|新增接口。 |标签 |\ |[UntagResources](https://www.volcengine.com/docs/6396/1394799)| | |\ |[ListTagsForResources](https://www.volcengine.com/docs/6396/1394794) | | | ## 2024年11月 |API |变更记录 |关联功能 | |---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |新增请求参数：|实例 |\ | |`ImageReleaseVersion`，可选，表示选用的公共镜像具体版本。 | | |[DescribeInstanceTypes](https://www.volcengine.com/docs/6396/92769) |修改请求参数`InstanceTypeIds.N`，N的长度由10限制为100。 |^^| |[DescribeScheduledInstanceStock](https://www.volcengine.com/docs/6396/1187927) |新增返回数据`ReleaseStatus`，表示弹性预约实例\-时段型的释放预约状态。 |^^| |[CreateTags](https://www.volcengine.com/docs/6396/130886)|修改请求参数：`ResourceType`新增取值`keypair`。 |标签 |\ |[DeleteTags](https://www.volcengine.com/docs/6396/130887)| | |\ |[DescribeTags](https://www.volcengine.com/docs/6396/130888) | | | |[ImportKeyPair](https://www.volcengine.com/docs/6396/120444)|* 新增请求参数（可选）：`Tags.N.Key`、`Tags.N.Value` ，表示密钥对绑定的标签键、标签值。|密钥对 |\ |[CreateKeyPair](https://www.volcengine.com/docs/6396/120445) |* 新增错误码：InvalidTagKey.Malformed、InvalidTagValue.Malformed、LimitExceeded.MaximumTags、InvalidTagKey.Conflict。 | | |[DescribeKeyPairs](https://www.volcengine.com/docs/6396/120446) |* 新增请求参数（可选）：`TagFilters.N.Key`、`TagFilters.N.Value`，表示根据标签键、标签值查找资源。|^^|\ | |* 新增返回参数：Tags返回结构新增`Key`、`Value`。| |\ | |* 新增错误码：InvalidTagFilterKey.Malformed、InvalidTagFilterValue.Malformed、LimitExceeded.MaximumTagFilterKeys、LimitExceeded.MaximumTagFilterResults、LimitExceeded.MaximumTagFilterValues、InvalidTagFilterKey.Conflict。 | | |[ReplaceSystemVolume](https://www.volcengine.com/docs/6396/101073) |* 新增请求参数：|镜像 |\ | | `ImageReleaseVersion`，可选，表示选用的公共镜像具体版本。| |\ | |* 新增错误码：LimitExceeded.MaximumVolumes。 | | |[DescribeInvocations](https://www.volcengine.com/docs/6396/170906) |新增请求参数（可选）：TagFilters.N.Values.N。 |批量作业 | |[DescribeCommands](https://www.volcengine.com/docs/6396/170749) |^^|^^| |[除“UpgradeCloudAssistants”和“UninstallCloudAssistants”外的所有接口](https://www.volcengine.com/docs/6396/170743) |新增全量错误码。 |^^| ## 2024年10月 |API |变更记录 |关联功能 | |---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |* 新增请求参数：`NetworkInterfaces.N.Ipv6AddressCount`（邀测、可选），表示为主网卡分配的IPv6地址数量。|实例 |\ | |* 新增错误码：InvalidIpv6AddressCount.Malformed、InvalidSubnet.DisableIPv6。 | | |[DescribeInstances](https://www.volcengine.com/docs/6396/70466) |新增返回参数：`NetworkInterfaces`结构新增`Ipv6Addresses`，表示网卡分配的IPv6地址。 |^^| ## 2024年09月 |API |变更记录 |关联功能 | |---|---|---| |[StopInstance](https://www.volcengine.com/docs/6396/70468)|修改`StoppedMode`参数描述。 |实例 |\ |[StopInstances](https://www.volcengine.com/docs/6396/101067) | | | |[ModifyInstanceAttribute](https://www.volcengine.com/docs/6396/92110) |修改`Password`参数描述。 |^^| |[DescribeInstances](https://www.volcengine.com/docs/6396/70466) |* 新增请求参数`Ipv6Addresses.N`（可选），表示实例的IPv6地址。|^^|\ | |* 新增错误码：LimitExceeded.MaximumIpv6Addresses、InvalidActionOrVersion。 | | |[RunInstances](https://www.volcengine.com/docs/6396/76275) |* 新增请求参数（可选）：`Volumes.N.ExtraPerformanceIOPS`、`Volumes.N.ExtraPerformanceThroughputMB`、`Volumes.N.ExtraPerformanceTypeId`，表示云盘的额外性能。|^^|\ | |* 新增错误码：| |\ | | * IPv6相关：InvalidIPv6OnlySubnet.Unsupported、InvalidSubnetImage.Mismatch、InvalidIpv6OnlyNetworkInterfaceAndIpv4NetworkInterface.Mismatch。| |\ | | * 配额和认证相关：QuotaExceeded.MaximumGeneralCpus、QuotaExceeded.MaximumGpuBasicNums、QuotaExceeded.MaximumHighPerformanceGpus、QuotaExceeded.MaximumLocalVolumeCpus、QuotaExceeded.MaximumReservedInstanceGeneralCpus、QuotaExceeded.MaximumReservedInstanceGpuBasicNums、QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus、QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus、NotPaymentQualified。| |\ | | * 额外性能相关：InvalidExtraPerformanceTypeId.Malformed、InvalidSystemVolumeForExtraPerformance.Unsupported、InvalidVolumeSizeForExtraPerformance.Unsupported、InvalidVolumeTypeForExtraPerformance.Unsupported、LimitExceeded.ExtraPerformanceThroughput、LimitExceeded.MaximumExtraPerformanceIOPS、LimitExceeded.MaximumExtraPerformanceThroughputMB、LimitExceeded.MinimumExtraPerformanceIOPS、LimitExceeded.MinimumExtraPerformanceThroughputMB。 | | |[StartInstance](https://www.volcengine.com/docs/6396/70467) |新增错码：OperationDenied.InstanceIsSnapshotRollback、InvalidActionOrVersion。 |^^| |[DescribeInstanceTypes](https://www.volcengine.com/docs/6396/92769)|新增错误码：InvalidActionOrVersion。 |^^|\ |[DescribeScheduledInstances](https://www.volcengine.com/docs/6396/1187925)| | |\ |[GetScheduledInstanceLatestReleaseAt](https://www.volcengine.com/docs/6396/1223825) | | | |[ModifyInstanceChargeType](https://www.volcengine.com/docs/6396/76278) |新增错误码：QuotaExceeded.MaximumGeneralCpus、QuotaExceeded.MaximumGpuBasicNums、QuotaExceeded.MaximumHighPerformanceGpus、QuotaExceeded.MaximumLocalVolumeCpus、QuotaExceeded.MaximumReservedInstanceGeneralCpus、QuotaExceeded.MaximumReservedInstanceGpuBasicNums、QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus、QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus、DryRunOperation。 |^^| |[ModifyInstanceSpec](https://www.volcengine.com/docs/6396/76277) |新增错误码：QuotaExceeded.MaximumGeneralCpus、QuotaExceeded.MaximumGpuBasicNums、QuotaExceeded.MaximumHighPerformanceGpus、QuotaExceeded.MaximumLocalVolumeCpus、QuotaExceeded.MaximumReservedInstanceGeneralCpus、QuotaExceeded.MaximumReservedInstanceGpuBasicNums、QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus、QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus。 |^^| |[CreateScheduledInstances](https://www.volcengine.com/docs/6396/1187924) |* 新增请求参数（可选）：`Volumes.N.ExtraPerformanceIOPS`、`Volumes.N.ExtraPerformanceThroughputMB`、`Volumes.N.ExtraPerformanceTypeId`，表示云盘的额外性能。|^^|\ | |* 新增错误码：| |\ | | * 配额相关：QuotaExceeded.MaximumGeneralCpus、QuotaExceeded.MaximumGpuBasicNums、QuotaExceeded.MaximumHighPerformanceGpus、QuotaExceeded.MaximumLocalVolumeCpus、QuotaExceeded.MaximumReservedInstanceGeneralCpus、QuotaExceeded.MaximumReservedInstanceGpuBasicNums、QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus、QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus。| |\ | | * 额外性能相关：InvalidExtraPerformanceTypeId.Malformed、InvalidSystemVolumeForExtraPerformance.Unsupported、InvalidVolumeSizeForExtraPerformance.Unsupported、InvalidVolumeTypeForExtraPerformance.Unsupported、LimitExceeded.ExtraPerformanceThroughput、LimitExceeded.MaximumExtraPerformanceIOPS、LimitExceeded.MaximumExtraPerformanceThroughputMB、LimitExceeded.MinimumExtraPerformanceIOPS、LimitExceeded.MinimumExtraPerformanceThroughputMB。 | | |[ModifyReservedInstances](https://www.volcengine.com/docs/6396/1171076)|* 新增请求参数（可选）：`Description`，表示预留实例券的描述信息。|^^|\ |[PurchaseReservedInstances](https://www.volcengine.com/docs/6396/1171074) |* 新增错误码：QuotaExceeded.MaximumGeneralCpus、QuotaExceeded.MaximumGpuBasicNums、QuotaExceeded.MaximumHighPerformanceGpus、QuotaExceeded.MaximumLocalVolumeCpus、QuotaExceeded.MaximumReservedInstanceGeneralCpus、QuotaExceeded.MaximumReservedInstanceGpuBasicNums、QuotaExceeded.MaximumReservedInstanceHighPerformanceGpus、QuotaExceeded.MaximumReservedInstanceLocalVolumeCpus、InvalidInstanceDescription.Malformed。 | | |[DescribeReservedInstances](https://www.volcengine.com/docs/6396/1171075) |新增返回参数：`Description`，表示预留实例券的描述信息。 |^^| |[CopyImage](https://www.volcengine.com/docs/6396/124454) |新增错误码： 412，OperationDenied.SnapshotServiceUnavailable |镜像 | |[CreateImage](https://www.volcengine.com/docs/6396/132240) |新增错误码： 400，LimitExceeded.MaximumSnapshotCount |^^| |[ImportImage](https://www.volcengine.com/docs/6396/120263) |新增错误码： 412，OperationDenied.SnapshotServiceUnavailable |^^| |[DescribeImages](https://www.volcengine.com/docs/6396/70808) |新增返回参数： DescribeImageNextTokenResponse.Images结构，新增：|^^|\ | || |\ | |* `IsInstallRunCommandAgent`，表示公共镜像中是否安装了批量作业Agent。| |\ | |* `Kernel`，表示镜像的内核版本。 | | ## 2024年08月 |API |发布时间 |变更记录 |关联功能 | |---|---|---|---| |[CreateLaunchTemplate](https://www.volcengine.com/docs/6396/1324369) |2024年08月 |新增接口。 |实例启动模版 | |[CreateLaunchTemplateVersion](https://www.volcengine.com/docs/6396/1324370) |^^|^^|^^| |[DescribeLaunchTemplates](https://www.volcengine.com/docs/6396/1324371) |^^|^^|^^| |[DescribeLaunchTemplateVersions](https://www.volcengine.com/docs/6396/1324372) |^^|^^|^^| |[ModifyTemplateDefaultVersion](https://www.volcengine.com/docs/6396/1324373) |^^|^^|^^| |[DeleteLaunchTemplate](https://www.volcengine.com/docs/6396/1324374) |^^|^^|^^| |[DeleteLaunchTemplateVersion](https://www.volcengine.com/docs/6396/1324375) |^^|^^|^^| ## 2024年07月 |API |发布时间 |变更记录 |关联功能 | |---|---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |2024\-07\-30 |新增错误码：LimitExceeded.MaximumSecurityProtectionTypes、OperationDenied.PurchaseLimited、InvalidTenancy.InstanceTypeIdMismatch。 |实例 | |[ModifyInstanceSpec](https://www.volcengine.com/docs/6396/76277) |^^|新增错误码：LimitExceeded.MaximumVolumes、OperationDenied.InstanceHasUnfinishedOrder、OperationDenied.InstanceIsSnapshotRollback。 |^^| |[DeleteInstance](https://www.volcengine.com/docs/6396/70465) |^^|新增错误码：OperationDenied.InstanceIsSnapshotRollback。 |^^| |[ModifyInstanceVpcAttribute](https://www.volcengine.com/docs/6396/1113921) |^^|新增错误码：Insufficient.Balance、OperationDenied.SpecifiedSecurityGroupNotAuthorized。 |^^| |[ModifyReservedInstances](https://www.volcengine.com/docs/6396/1171076) |^^|新增错误码：InvalidReservedInstance.ProjectMismatch。 |^^| |[CreateScheduledInstances](https://www.volcengine.com/docs/6396/1187924) |^^|* 新增错误码：InvalidImageForCreateScheduledInstance.UnSupported、LimitExceeded.MaximumSecurityProtectionTypes、OperationDenied.ImageNotSnapshot、Insufficient.ScheduledInstanceDeliveryCapacity、Insufficient.VolumePoolCapacity。|^^|\ | | |* 修改错误码Insufficient.ScheduledInstanceCapacity描述。 | | |[DescribeInstanceTypes](https://www.volcengine.com/docs/6396/92769) |^^|* 新增请求参数：|^^|\ | | | * `ImageId`参数，表示查询该镜像可创建的实例规格。| |\ | | |* 新增错误码：| |\ | | | * InvalidImage.NotFound | | |[DescribeImages](https://www.volcengine.com/docs/6396/70808) |^^|新增返回参数：|镜像 |\ | | |`Images`结构新增`LicenseType`参数，表示镜像许可证类型。 | | |[CreateImage](https://www.volcengine.com/docs/6396/132240) |^^|* 新增请求参数：|^^|\ | | | 新增`CreateWholeImage`参数，表示否是创建整机镜像。| |\ | | |* 新增错误码：| |\ | | | 400，InvalidVolumeTypeForCreateImage.Unsupported | | |[ImportImage](https://www.volcengine.com/docs/6396/120263) |^^|* 新增请求参数：|^^|\ | | | 新增`LicenseType`参数，表示镜像许可证类型。| |\ | | |* 新增错误码：| |\ | | | 400，InvalidImageFormat.Malformed | | |[CreateSubscription](https://www.volcengine.com/docs/6396/166016) |^^|请求参数新增取值：|事件监控 |\ | | |请求参数`EventTypes.N`中增加取值：SystemFailure.Stop.Succeeded，表示系统故障，导致实例停止：执行成功。 | | |[ModifySubscriptionEventTypes](https://www.volcengine.com/docs/6396/166017) |^^|请求参数新增取值：|^^|\ | | |请求参数`EventTypes.N`中增加取值：SystemFailure.Stop.Succeeded，表示系统故障，导致实例停止：执行成功。 | | ## 2024年05月 |API |发布时间 |变更记录 |关联功能 | |---|---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |2024\-05\-21 |* 新增错误码：|实例 |\ | | | * InvalidBandwidthPackageStatus| |\ | | | * QuotaExceeded.BandwidthPackage| |\ | | | * RequestForbidden| |\ | | | * InvalidISP.BandwidthPackageMismatch| |\ | | | * InvalidInstanceTenancy.DeploymentSetIdMismatch| |\ | | |* 修改错误码：InvalidSnapshotStatus描述修改为指定的快照状态不支持此操作。 | | |[StartInstance](https://www.volcengine.com/docs/6396/70467)|^^|新增错误码InvalidInstance.RequestForbidden。 |^^|\ |[StartInstances](https://www.volcengine.com/docs/6396/101068)| | | |\ |[RebootInstance](https://www.volcengine.com/docs/6396/70464)| | | |\ |[RebootInstances](https://www.volcengine.com/docs/6396/101069)| | | |\ |[ModifyInstanceChargeType](https://www.volcengine.com/docs/6396/76278)| | | |\ |[ModifyInstanceAttribute](https://www.volcengine.com/docs/6396/92110)| | | |\ |[ModifyInstanceSpec](https://www.volcengine.com/docs/6396/76277)| | | |\ |[RenewInstance](https://www.volcengine.com/docs/6396/76276) | | | | |[CreateScheduledInstances](https://www.volcengine.com/docs/6396/1187924) |^^|* 新增错误码：|弹性预约实例 |\ | | | * InvalidBandwidthPackageStatus| |\ | | | * QuotaExceeded.BandwidthPackage| |\ | | | * RequestForbidden| |\ | | | * InvalidISP.BandwidthPackageMismatch| |\ | | |* 修改错误码：InvalidSnapshotStatus描述修改为指定的快照状态不支持此操作。 | | |[DescribeScheduledInstanceStock](https://www.volcengine.com/docs/6396/1187927) |^^|新增错误码InvalidInstanceType.NotFound。 |^^| |[CreateImage](https://www.volcengine.com/docs/6396/132240) |^^|* 新增错误码：|镜像 |\ | | | * InvalidSnapshotStatus | | |[ImportImage](https://www.volcengine.com/docs/6396/120263) |^^|* 新增错误码：|^^|\ | | | * InvalidPlatformVersion.Malformed | | |[DescribeImages](https://www.volcengine.com/docs/6396/70808) |^^|* 新增请求参数：|^^|\ | | | * `Platform`，镜像操作系统的发行版本。 | | |[ReplaceSystemVolume](https://www.volcengine.com/docs/6396/101073) |^^|* 新增错误码：|^^|\ | | | * InvalidInstance.RequestForbidden| |\ | | | * InvalidDedicatedHostStatus.Unsupported| |\ | | | * InvalidInstanceForReplaceSystemVolume.Unsupported| |\ | | | * InvalidSnapshotStatus| |\ | | | * InvalidDedicatedHost.Expired| |\ | | |* 更新错误码：| |\ | | | * 调整InvalidSnapshotStatus描述为The status of the specified snapshot does not support this request. | | |[ModifyInstanceDeployment](https://www.volcengine.com/docs/6396/165550) |^^|新增错误码InvalidDedicatedHostInstanceForModifyInstanceDeploymentSet.Unsupported。 |部署集 | |[CreateCommand](https://www.volcengine.com/docs/6396/170743) |2024年05月23日 |* 新增请求参数：|批量作业 |\ | | | * `ContentEncoding`，命令内容是否经过Base64编码处理。 | | |[ModifyCommand](https://www.volcengine.com/docs/6396/170746) |^^|* 新增请求参数：|^^|\ | | | * `ContentEncoding`，命令内容是否经过Base64编码处理。 | | |[DescribeCommands](https://www.volcengine.com/docs/6396/170749) |^^|* 新增请求参数：|^^|\ | | | * `ContentEncoding`，指定返回的命令内容是否经过Base64编码处理。 | | |[RunCommand](https://www.volcengine.com/docs/6396/170753) |^^|* 新增请求参数：|^^|\ | | | * `ContentEncoding`，指定返回的命令内容是否经过Base64编码处理。 | | |[DescribeInvocations](https://www.volcengine.com/docs/6396/170906) |^^|* 新增请求参数：|^^|\ | | | * `ContentEncoding`，指定返回的命令内容是否经过Base64编码处理。 | | ## 2024年03月 |API |发布时间 |变更记录 |关联功能 | |---|---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |2024\-03\-22 |* 新增请求参数（可选）：|实例 |\ | | | * `EipAddress.ReleaseWithInstance`，表示创建实例时是否选择公网IP随实例释放。| |\ | | | * `Volumes.N.SnapshotId`，表示使用快照创建云盘，仅支持创建数据盘。| |\ | | | * `EipAddress.SecurityProtectionInstanceId`、`EipAddress.SecurityProtectionTypes.N`，表示公网IP的安全防护属性。| |\ | | |* 新增错误码：| |\ | | | * InvalidSnapshotStatus| |\ | | | * InvalidVolumeTypeForSnapshot.UnSupported| |\ | | | * InvalidSnapshot.NotFound| |\ | | | * InvalidSnapshotZoneId.Mismatch| |\ | | | * InvalidReleaseWithInstance.ChargeTypeMismatch| |\ | | | * LimitExceeded.MaximumEipBandwidth| |\ | | | * InvalidSecurityProtectionTypes.Malformed| |\ | | | * InvalidSecurityProtectionTypes.BandwidthPackageIdMismatch| |\ | | | * OperationDenied.SpecifiedSecurityGroupNotAuthorized | | |[DescribeInstances](https://www.volcengine.com/docs/6396/70466) |^^|* 新增请求参数（可选）：`EipAddresses.N`，表示支持按公网IP地址查询实例。|^^|\ | | |* 新增返回数据：`IpAddress`，表示实例绑定的公网IP地址。| |\ | | |* 新增错误码：LimitExceeded.PrimaryIpAddresses、LimitExceeded.MaximumEipAddresses。 | | |[CreateScheduledInstances](https://www.volcengine.com/docs/6396/1187924) |^^|* 新增请求参数（可选）：|弹性预约实例 |\ | | | * `EipAddress.ReleaseWithInstance`，表示创建实例时是否选择公网IP随实例释放。| |\ | | | * `Volumes.N.SnapshotId`，表示使用快照创建云盘，仅支持创建数据盘。| |\ | | | * `EipAddress.SecurityProtectionInstanceId`、`EipAddress.SecurityProtectionTypes.N`，表示公网IP的安全防护属性。| |\ | | |* 新增错误码：| |\ | | | * InvalidSnapshotStatus| |\ | | | * InvalidVolumeTypeForSnapshot.UnSupported| |\ | | | * InvalidSnapshot.NotFound| |\ | | | * InvalidSnapshotZoneId.Mismatch| |\ | | | * InvalidReleaseWithInstance.ChargeTypeMismatch| |\ | | | * LimitExceeded.MaximumEipBandwidth| |\ | | | * InvalidSecurityProtectionTypes.Malformed| |\ | | | * InvalidSecurityProtectionTypes.BandwidthPackageIdMismatch| |\ | | | * OperationDenied.SpecifiedSecurityGroupNotAuthorized | | |[DescribeScheduledInstances](https://www.volcengine.com/docs/6396/1187925) |^^|* 新增请求参数（可选）：`ImageId`、`KeyPairName`，表示支持按镜像ID或密钥对名称查询弹性预约实例。|^^|\ | | |* 新增返回数据`ReleaseWithInstance`、`SecurityProtectionInstanceId`，表示公网IP是否随实例释放以及安全防护包的ID。 | | |[GetScheduledInstanceLatestReleaseAt](https://www.volcengine.com/docs/6396/1223825) |^^|新增接口，用于查询弹性预约实例\-时段型（预约交付）的最晚释放时间。 |^^| |[DetectImage](https://www.volcengine.com/docs/6396/1217622) |^^|新增接口，用于发起镜像检测流程。 |镜像 | |[CreateImage](https://www.volcengine.com/docs/6396/132240) |^^|* 新增请求参数：|^^|\ | | | * `NeedDetection`，表示是否进行镜像检测。| |\ | | | * `SnapshotGroupId`，表示使用快照一致性组创建自定义镜像。| |\ | | | * `SnapshotId`，表示使用系统盘快照创建自定义镜像。| |\ | | |* 更新请求参数：| |\ | | | * `InstanceId`，调整为非必填参数。| |\ | | | * `Tags.N.Key`，增加使用限制，不支持任何大小写形式`sys:`开头。| |\ | | |* 新增错误码：| |\ | | | * 400，InvalidPlatformForDetect.UnSupported，指定的镜像平台不支持检测。| |\ | | | * 400，InvalidSnapshotIdOrSnapshotGroupIdForCreateImage.UnSupported，指定的快照或一致性组不支持创建自定义镜像。| |\ | | | * 400，LimitExceeded.MaximumSnapshotGroupTotalSize，指定的快照一致性组容量超过限制。| |\ | | | * 404，InvalidSnapshotGroupId.NotFound，指定的快照一致性组Id不存在。| |\ | | | * 404，InvalidSnapshotId.NotFound，指定的快照Id不存在。| |\ | | | * 412，OperationDenied.SnapshotServiceUnavailable，指定的操作被拒绝，因为快照服务未开通。 | | |[ImportImage](https://www.volcengine.com/docs/6396/120263) |^^|* 新增请求参数：|^^|\ | | | * `NeedDetection`参数，表示是否进行镜像检测。| |\ | | |* 更新请求参数：| |\ | | | * `Tags.N.Key`参数增加使用限制，不支持任何大小写形式`sys:`开头。| |\ | | |* 新增错误码：| |\ | | | * 400，InvalidPlatformForDetect.UnSupported，指定的镜像平台不支持检测。 | | |[DescribeImages](https://www.volcengine.com/docs/6396/70808) |^^|* 新增返回参数：|^^|\ | | | * `Images`结构新增：| |\ | | | * `DetectionResults`结构，表示镜像的检测结果。| |\ | | | * `Snapshots`结构，表示镜像关联的快照信息。 | | |[DeleteImages](https://www.volcengine.com/docs/6396/120265) |^^|* 新增请求参数：|^^|\ | | | * `DeleteBindedSnapshots`，表示删除镜像是否同时删除快照或快照一致性组。 | | ## 2024年01月 |API |发布时间 |变更记录 |关联功能 | |---|---|---|---| |[RunInstances](https://www.volcengine.com/docs/6396/76275) |2024\-01\-12 |新增请求参数（可选）：`EipAddress.ChargeType`、`EipAddress.ISP`、`EipAddress.BandwidthMbps`、`EipAddress.BandwidthPackageId`，表示创建实例时支持绑定公网IP。 |实例 | |[StopInstance](https://www.volcengine.com/docs/6396/70468) |^^|新增错误码：InvalidStoppedModeForScheduledInstance.Unsupported。 |^^| |[StopInstances](https://www.volcengine.com/docs/6396/101067) |^^|^^|^^| |[ModifyInstanceSpec](https://www.volcengine.com/docs/6396/76277) |^^|新增错误码：InvalidScheduledInstanceForModifyInstanceSpec.Unsupported。 |^^| |[ModifyInstanceChargeType](https://www.volcengine.com/docs/6396/76278) |^^|新增错误码：InvalidScheduledInstanceForModifyInstanceChargeType.Unsupported。 |^^| |[DescribeInstances](https://www.volcengine.com/docs/6396/70466) |^^|* 新增请求参数：`ScheduledInstanceId`（可选），表示弹性预约单ID。|^^|\ | | |* 变更返回数据：`ElasticScheduledInstanceType`新增取值Segmented，表示弹性预约实例\-时段型。| |\ | | |* 新增返回数据：`ScheduledInstanceId`，表示弹性预约单ID。 | | |[DescribeAvailableResource](https://www.volcengine.com/docs/6396/76279) |^^|* 新增请求参数：`ElasticScheduledInstanceType`（可选），表示弹性预约实例类型。|^^|\ | | |* 新增错误码：InvalidElasticScheduledInstanceType.Malformed。 | | |[CreateScheduledInstances](https://www.volcengine.com/docs/6396/1187924) |^^|新增接口，用于创建弹性预约实例。 |弹性预约实例 | |[DescribeScheduledInstances](https://www.volcengine.com/docs/6396/1187925) |^^|新增接口，用于查询弹性预约单信息。 |^^| |[DeleteScheduledInstance](https://www.volcengine.com/docs/6396/1187926) |^^|新增接口，用于取消预约。 |^^| |[DescribeScheduledInstanceStock](https://www.volcengine.com/docs/6396/1187927) |^^|新增接口，获取弹性预约实例预约情况。 |^^| |[CreateTags](https://www.volcengine.com/docs/6396/130886) |^^|变更请求参数：`ResourceType`新增取值scheduledinstance，表示弹性预约实例支持标签管理。 |标签 | |[DeleteTags](https://www.volcengine.com/docs/6396/130887) |^^|^^|^^| |[DescribeTags](https://www.volcengine.com/docs/6396/130888) |^^|^^|^^| |[ModifyInstanceDeployment](https://www.volcengine.com/docs/6396/165550) |^^|新增错误码：InvalidScheduledInstanceForModifyInstanceDeploymentSet.Unsupported。 |部署集 | |[PurchaseReservedInstances](https://www.volcengine.com/docs/6396/1171074) |^^|新增错误码：Insufficient.VolumePoolCapacity。 |预留实例券 | |[UpgradeCloudAssistants](https://www.volcengine.com/docs/6396/1185521) |2024\-01\-11 |新增接口，为云服务器实例升级已安装的批量作业客户端至最新版本。 |批量作业 | |[UninstallCloudAssistants](https://www.volcengine.com/docs/6396/1185523) |^^|新增接口，为云服务器实例卸载已安装的批量作业客户端。 |^^| |[DescribeCloudAssistantStatus](https://www.volcengine.com/docs/6396/170931) |^^|变更请求参数：|^^|\ | | |`Status`参数新增枚举值：| |\ | | || |\ | | |* `Lost`表示心跳超时| |\ | | |* `ReadyReboot`表示待重启| |\ | | |* `InstallFailed`安装失败| |\ | | |* `Uninstalling`卸载中| |\ | | |* `Initializing`初始化 | |