Skip navigation links
com.tencentcloudapi.cvm.v20170312.models

Class DescribeReservedInstancesRequest

Returns:
Filters
  • zone
  • Filter by [availability zones] in which reserved instances can be purchased. For example, ap-guangzhou-1.

    Type: String.

    Required: No.

    Valid values: See the availability zone list.

  • duration
  • Filter by [validity periods] of reserved instances, which is the instance purchase duration. For example, 31536000.

    Type: Integer.

    Unit: Second.

    Required: No.

    Valid values: 31536000 (1 year) | 94608000 (3 years).

  • instance-type
  • Filter by [specifications of reserved instances]. For example, S3.MEDIUM4.

    Type: String.

    Required: No.

    Valid values: See the reserved instance specification list.

  • instance-family
  • Filter by [types of reserved instances]. For example, S3.

    Type: String.

    Required: No.

    Valid values: See the reserved instance type list.

  • offering-type
  • Filter by payment types]. For example, All Upfront (fully prepaid).

    Type: String.

    Required: No.

    Valid values: All Upfront (fully prepaid) | Partial Upfront (partially prepaid) | No Upfront (non-prepaid).

  • product-description
  • Filter by [platform descriptions] (operating system) of reserved instances. For example, linux.

    Type: String.

    Required: No.

    Valid value: linux.

  • reserved-instances-id
  • Filter by [IDs of purchased reserved instances]. For example, 650c138f-ae7e-4750-952a-96841d6e9fc1.

    Type: String.

    Required: No.

  • state
  • Filter by [statuses of purchased reserved instances]. For example, active.

    Type: String.

    Required: No.

    Valid values: active (created) | pending (waiting to be created) | retired (expired).

    Each request can have up to 10 filters, and each filter can have up to 5 values.
    Parameters:
    Filters -
  • zone
  • Filter by [availability zones] in which reserved instances can be purchased. For example, ap-guangzhou-1.

    Type: String.

    Required: No.

    Valid values: See the availability zone list.

  • duration
  • Filter by [validity periods] of reserved instances, which is the instance purchase duration. For example, 31536000.

    Type: Integer.

    Unit: Second.

    Required: No.

    Valid values: 31536000 (1 year) | 94608000 (3 years).

  • instance-type
  • Filter by [specifications of reserved instances]. For example, S3.MEDIUM4.

    Type: String.

    Required: No.

    Valid values: See the reserved instance specification list.

  • instance-family
  • Filter by [types of reserved instances]. For example, S3.

    Type: String.

    Required: No.

    Valid values: See the reserved instance type list.

  • offering-type
  • Filter by payment types]. For example, All Upfront (fully prepaid).

    Type: String.

    Required: No.

    Valid values: All Upfront (fully prepaid) | Partial Upfront (partially prepaid) | No Upfront (non-prepaid).

  • product-description
  • Filter by [platform descriptions] (operating system) of reserved instances. For example, linux.

    Type: String.

    Required: No.

    Valid value: linux.

  • reserved-instances-id
  • Filter by [IDs of purchased reserved instances]. For example, 650c138f-ae7e-4750-952a-96841d6e9fc1.

    Type: String.

    Required: No.

  • state
  • Filter by [statuses of purchased reserved instances]. For example, active.

    Type: String.

    Required: No.

    Valid values: active (created) | pending (waiting to be created) | retired (expired).

    Each request can have up to 10 filters, and each filter can have up to 5 values.
    Skip navigation links

    Copyright © 2025. All rights reserved.