赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 云服务器 ECS
  4. 开发参考
  5. API参考(ECS)
  6. API目录
  7. 专有宿主机
  8. DescribeDedicatedHostAutoRenew - 查询专有宿主机自动续费状态

DescribeDedicatedHostAutoRenew - 查询专有宿主机自动续费状态

  • 专有宿主机
  • 发布于 2025-04-01
  • 0 次阅读
文档编辑
文档编辑

调用DescribeDedicatedHostAutoRenew查询一台或多台包年包月专有宿主机自动续费状态。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
DedicatedHostIdsstring是

专有宿主机 ID。最多可以输入 100 个包年包月专有宿主机 ID,ID 之间用半角逗号(,)隔开。

dh-bp165p6xk2tlw61e****,dh-bp1f9vxmno****
RegionIdstring是

专有宿主机所属的地域 ID。

cn-hangzhou

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

04F0F334-1335-436C-A1D7-6C044FE73368
DedicatedHostRenewAttributesarray<object>

专有宿主机自动续费属性组成的数组。

DedicatedHostRenewAttributeobject
PeriodUnitstring

续费单位。可能值:

  • Week
  • Month
Month
Durationinteger

自动续费时长。

0
DedicatedHostIdstring

专有宿主机 ID。

dh-bp165p6xk2tlw61e****
RenewalStatusstring

是否自动续费包年包月专有宿主机。取值范围:

  • AutoRenewal:自动续费。
  • Normal:待续费。
  • NotRenewal:不续费,也不发送到期提醒。到期前第三天阿里云会发送不续费提醒。不续费的专有宿主机可以设置成待续费(Normal),再自行续费 RenewDedicatedHosts 或设置为自动续费(AutoRenewal)。
Normal
AutoRenewEnabledboolean

是否自动续费。可能值:

  • true:自动续费
  • false:不自动续费
false
AutoRenewWithEcsstring

包年包月专有宿主机内的包年包月 ECS 实例自动续费时,如果 ECS 实例续费后的到期时间比专有宿主机的到期时间晚,则该专有宿主机是否随 ECS 实例自动续费。可能值:

  • AutoRenewWithEcs:跟随 ECS 实例自动续费。
  • StopRenewWithEcs:不跟随 ECS 实例自动续费。
StopRenewWithEcs

示例

正常返回示例

JSON格式

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "DedicatedHostRenewAttributes": {
    "DedicatedHostRenewAttribute": [
      {
        "PeriodUnit": "Month",
        "Duration": 0,
        "DedicatedHostId": "dh-bp165p6xk2tlw61e****",
        "RenewalStatus": "Normal",
        "AutoRenewEnabled": false,
        "AutoRenewWithEcs": "StopRenewWithEcs"
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
403ChargeTypeViolationPay-As-You-Go dedicated host does not support this operation.按量付费的宿主机不支持当前操作。
403MissingParameter.DedicatedHostIdDedicatedHostId should not be null.参数 DedicatedHostId 不能为空。
403InvalidParameter.ToManyDedicatedHostIdsDedicatedHostId should be less than 100.参数 DedicatedHostIds 包含的专有宿主机 ID 应该少于 100 个。
403InvalidParameter.InvalidDedicatedHostId%s指定的参数 DedicatedHostId 无效。
403IncorrectDedicatedHostStatusThe current status of the resource does not support this operation.当前资源的状态不支持此操作。
403MissingParamter.InstanceIdInstanceId should not be null.实例id不能为空

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

变更历史

变更时间变更内容概要操作
2023-06-13OpenAPI 错误码发生变更查看变更详情
相关文章

AllocateDedicatedHosts - 创建一台或多台按量付费或者包年包月专有宿主机 2025-04-01 11:57

调用AllocateDedicatedHosts创建一台或多台按量付费或者包年包月专有宿主机。专有宿主机是单租户独享的物理机资源,您可以在专有宿主机上自行创建ECS实例和获取物理服务器属性等信息。

CreateDedicatedHostCluster - 创建专有宿主机组 2025-04-01 11:57

创建一个专有宿主机组。

DeleteDedicatedHostCluster - 删除专有宿主机组 2025-04-01 11:57

删除一个专有宿主机组,操作前请先将该专有宿主机组下的专有宿主机迁移至其他专有宿主机组。

DescribeDedicatedHostAutoRenew - 查询专有宿主机自动续费状态 2025-04-01 11:57

调用DescribeDedicatedHostAutoRenew查询一台或多台包年包月专有宿主机自动续费状态。

DescribeDedicatedHostClusters - 查询专有宿主机组的详情 2025-04-01 11:57

查询一个或多个专有宿主机组的详细信息。

DescribeDedicatedHosts - 查询专有宿主机详细信息 2025-04-01 11:57

本接口用于查询一台或多台专有宿主机的详细信息。通过该接口,您可以获取包括专有宿主机的物理性能指标、机器码、使用状态以及已创建的ECS实例列表等信息。您能够根据具体需求,通过指定相关参数,如专有宿主机ID列表、专有宿主机集群ID、宿主机名称、状态等,精准地查询所需的专有宿

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号