Data Types

Last updated: 2021-03-26 15:02:39

    ActionTimer

    Scheduled tasks.

    Used by actions: RunInstances.

    Name Type Required Description
    Externals Externals Yes Additional data
    TimerAction String No Timer name. Currently TerminateInstances is the only supported value.
    ActionTime String No Execution time, which must be at least 5 minutes later than the current time. For example, 2018-5-29 11:26:40.

    ChargePrepaid

    Parameters related to the prepaid billing method, including the subscription period, the auto renewal logic, etc.

    Used by actions: AllocateHosts.

    Name Type Required Description
    Period Integer Yes Purchased usage period, in month. Valid values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36
    RenewFlag String No Auto renewal flag. Valid values:
  • NOTIFY_AND_AUTO_RENEW: notify upon expiration and renew automatically
  • NOTIFY_AND_MANUAL_RENEW: notify upon expiration but do not renew automatically
  • DISABLE_NOTIFY_AND_MANUAL_RENEW: neither notify upon expiration nor renew automatically

    Default value: NOTIFY_AND_AUTO_RENEW. If this parameter is specified as NOTIFY_AND_AUTO_RENEW, the instance will be automatically renewed on a monthly basis if the account balance is sufficient.
  • DataDisk

    Describes data disk information.

    Used by actions: DescribeInstances, InquiryPriceResizeInstanceDisks, InquiryPriceRunInstances, ResizeInstanceDisks, RunInstances.

    Name Type Required Description
    DiskSize Integer Yes Data disk size (in GB). The minimum adjustment increment is 10 GB. The value range varies by data disk type. For more information on limits, see Storage Overview. The default value is 0, indicating that no data disk is purchased. For more information, see the product documentation.
    DiskType String No Data disk type. For more information about limits on different data disk types, see Storage Overview. Valid values:
  • LOCAL_BASIC: local disk
  • LOCAL_SSD: local SSD disk
  • LOCAL_NVME: local NVME disk, specified in the InstanceType
  • LOCAL_PRO: local HDD disk, specified in the InstanceType
  • CLOUD_BASIC: HDD cloud disk
  • CLOUD_PREMIUM: Premium Cloud Storage
  • CLOUD_SSD: SSD
  • CLOUD_HSSD: Enhanced SSD
  • CLOUD_TSSD: Tremendous SSD

    Default value: LOCAL_BASIC.

    This parameter is invalid for the ResizeInstanceDisk API.
  • DiskId String No Data disk ID. Data disks of the type LOCAL_BASIC or LOCAL_SSD do not have IDs and do not support this parameter.
    DeleteWithInstance Boolean No Whether to terminate the data disk when its CVM is terminated. Valid values:
  • TRUE: terminate the data disk when its CVM is terminated. This value only supports pay-as-you-go cloud disks billed on an hourly basis.
  • FALSE: retain the data disk when its CVM is terminated.

    Default value: TRUE

    Currently this parameter is only used in the RunInstances API.
    Note: This field may return null, indicating that no valid value is found.
  • SnapshotId String No Data disk snapshot ID. The size of the selected data disk snapshot must be smaller than that of the data disk.
    Note: This field may return null, indicating that no valid value is found.
    Encrypt Boolean No Specifies whether the data disk is encrypted. Valid values:
  • TRUE: encrypted
  • FALSE: not encrypted

    Default value: FALSE

    This parameter is only used with RunInstances.
    Note: this field may return null, indicating that no valid value is obtained.
  • KmsKeyId String No ID of the custom CMK in the format of UUID or “kms-abcd1234”. This parameter is used to encrypt cloud disks.

    Currently, this parameter is only used in the RunInstances API.
    Note: this field may return null, indicating that no valid values can be obtained.
    ThroughputPerformance Integer No Cloud disk performance, in MB/s
    Note: this field may return null, indicating that no valid values can be obtained.
    CdcId String No ID of the dedicated cluster to which the instance belongs.
    Note: this field may return null, indicating that no valid values can be obtained.

    DisasterRecoverGroup

    Information on disaster recovery groups

    Used by actions: DescribeDisasterRecoverGroups.

    Name Type Description
    DisasterRecoverGroupId String ID of a spread placement group.
    Name String Name of a spread placement group, which must be 1-60 characters long.
    Type String Type of a spread placement group. Valid values:
  • HOST: physical machine
  • SW: switch
  • RACK: rack.
  • CvmQuotaTotal Integer The maximum number of CVMs that can be hosted in a spread placement group.
    CurrentNum Integer The current number of CVMs in a spread placement group.
    InstanceIds Array of String The list of CVM IDs in a spread placement group.
    Note: This field may return null, indicating that no valid value was found.
    CreateTime Timestamp Creation time of a spread placement group.
    Note: This field may return null, indicating that no valid value is found.

    EnhancedService

    Describes the configuration of enhanced services, such as Cloud Security and Cloud Monitor.

    Used by actions: InquiryPriceResetInstance, InquiryPriceRunInstances, ResetInstance, RunInstances.

    Name Type Required Description
    SecurityService RunSecurityServiceEnabled No Enables cloud security service. If this parameter is not specified, the cloud security service will be enabled by default.
    MonitorService RunMonitorServiceEnabled No Enables cloud monitor service. If this parameter is not specified, the cloud monitor service will be enabled by default.

    Externals

    Additional data

    Used by actions: DescribeReservedInstancesConfigInfos, DescribeZoneInstanceConfigInfos, RunInstances.

    Name Type Required Description
    ReleaseAddress Boolean No Release address
    Note: This field may return null, indicating that no valid value is found.
    UnsupportNetworks Array of String No Not supported network. Value:
  • BASIC: classic network
  • VPC1.0: VPC1.0
    Note: This field may return null, indicating that no valid value was found.
  • StorageBlockAttr StorageBlock No Attributes of local HDD storage
    Note: This field may return null, indicating that no valid value is found.

    Filter

    Note:


    Key-value pair filters used for conditional queries, such as filtering results by ID, name, and state.

    • If there are multiple Filter parameters, they are evaluated using the logical AND operator.
    • If a Filter contains multiple Values, they are evaluated using the logical OR operator.

    Take DescribeInstances as an example. You can use the following filters to query the instances in availability zone (zone) Guangzhou Zone 1 and whose billing plan (instance-charge-type) is pay-as-you-go:

    Filters.0.Name=zone
    &Filters.0.Values.0=ap-guangzhou-1
    &Filters.1.Name=instance-charge-type
    &Filters.1.Values.0=POSTPAID_BY_HOUR
    

    Used by actions: DescribeHosts, DescribeImages, DescribeInstanceTypeConfigs, DescribeInstances, DescribeKeyPairs, DescribeReservedInstances, DescribeReservedInstancesConfigInfos, DescribeReservedInstancesOfferings, DescribeZoneInstanceConfigInfos.

    Name Type Required Description
    Name String Yes Filters.
    Values Array of String Yes Filter values.

    HostItem

    Details about a CDH instance

    Used by actions: DescribeHosts.

    Name Type Description
    Placement Placement Location of the CDH instance. You can use this parameter to specify the attributes of the instance, such as its availability zone and project.
    HostId String CDH instance ID
    HostType String CDH instance type
    HostName String CDH instance name
    HostChargeType String Billing method of the CDH instance
    RenewFlag String Auto renewal flag of the CDH instance
    CreatedTime Timestamp ISO8601 Creation time of the CDH instance
    ExpiredTime Timestamp ISO8601 Expiration time of the CDH instance
    InstanceIds Array of String List of IDs of CVM instances created on the CDH
    HostState String CDH instance state
    HostIp String CDH instance IP
    HostResource HostResource Resource information of the CDH instance
    CageId String Cage ID of the CDH instance. This parameter is only valid for CDH instances in the cages of finance availability zones.
    Note: This field may return null, indicating that no valid value is found.

    HostResource

    Resource information of a CDH instance

    Used by actions: DescribeHosts.

    Name Type Description
    CpuTotal Integer Total number of CPU cores in the CDH instance
    CpuAvailable Integer Number of available CPU cores in the CDH instance
    MemTotal Float Total memory of the CDH instance; unit: GiB
    MemAvailable Float Available memory of the CDH instance; unit: GiB
    DiskTotal Integer Total disk size of the CDH instance; unit: GiB
    D