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
    DiskAvailable Integer Avilable disk size of the CDH instance; unit: GiB
    DiskType String CDH instance disk type.

    Image

    Details about an image, including its state and attributes.

    Used by actions: DescribeImages.

    Name Type Description
    ImageId String Image ID
    OsName String Operating system of the image
    ImageType String Image type
    CreatedTime Timestamp ISO8601 Creation time of the image
    ImageName String Image name
    ImageDescription String Image description
    ImageSize Integer Image size
    Architecture String Image architecture
    ImageState String Image state
    Platform String Source platform of the image
    ImageCreator String Image creator
    ImageSource String Image source
    SyncPercent Integer Synchronization percentage
    Note: This field may return null, indicating that no valid value is found.
    IsSupportCloudinit Boolean Whether the image supports cloud-init
    Note: This field may return null, indicating that no valid value is found.
    SnapshotSet Array of Snapshot Information on the snapshots associated with the image
    Note: This field may return null, indicating that no valid value is found.

    ImageOsList

    Supported operating systems are divided into two categories, Windows and Linux.

    Used by actions: DescribeImportImageOs.

    Name Type Description
    Windows Array of String Supported Windows OS
    Note: This field may return null, indicating that no valid value is found.
    Linux Array of String Supported Linux OS
    Note: This field may return null, indicating that no valid value is found.

    Instance

    Describes information on an instance

    Used by actions: DescribeInstances.

    Name Type Description
    Placement Placement Location of the instance
    InstanceId String Instance ID
    InstanceType String Instance model
    CPU Integer Number of CPU cores of the instance; unit: core
    Memory Integer Memory capacity; unit: GB.
    RestrictState String Instance status. Valid values:
  • NORMAL: instance is normal.
  • EXPIRED: instance expired.
  • PROTECTIVELY_ISOLATED: instance is protectively isolated.
  • InstanceName String Instance name
    InstanceChargeType String Instance billing plan. Valid values:
  • POSTPAID_BY_HOUR: pay after use. You are billed by the hour, by traffic.
  • CDHPAID: CDH billing plan. Applicable to CDH only, not the instances on the host.
  • SystemDisk SystemDisk Information on the system disk of the instance
    DataDisks Array of DataDisk Information on the data disks of the instance, which only covers the data disks purchased together with the instance.
    PrivateIpAddresses Array of String List of private IPs of the instance's primary ENI.
    PublicIpAddresses Array of String List of public IPs of the instance's primary ENI.
    Note: This field may return null, indicating that no valid value is found.
    InternetAccessible InternetAccessible Information on instance bandwidth.
    VirtualPrivateCloud VirtualPrivateCloud Information on the VPC where the instance resides.
    ImageId String ID of the image used to create the instance.
    RenewFlag String Auto renewal flag. Valid values:
  • NOTIFY_AND_MANUAL_RENEW: notify upon expiration, but do not renew automatically
  • NOTIFY_AND_AUTO_RENEW: notify upon expiration and renew automatically
  • DISABLE_NOTIFY_AND_MANUAL_RENEW: do not notify upon expiration and do not renew automatically.

  • Note: this parameter is null for postpaid instances.
  • CreatedTime Timestamp ISO8601 Creation time following the ISO8601 standard and using UTC time in the format of YYYY-MM-DDThh:mm:ssZ.
    ExpiredTime Timestamp ISO8601 Expiration time in UTC format following the ISO8601 standard: YYYY-MM-DDThh:mm:ssZ. Note: this parameter is null for postpaid instances.
    OsName String Operating system name.
    SecurityGroupIds Array of String Security groups to which the instance belongs. To obtain the security group IDs, you can call DescribeSecurityGroups and look for the sgld fields in the response.
    LoginSettings LoginSettings Login settings of the instance. Currently only the key associated with the instance is returned.
    InstanceState String Instance state. Valid values:
  • PENDING: creating
  • LAUNCH_FAILED: creation failed
  • RUNNING: running
  • STOPPED: shut down
  • STARTING: starting
  • STOPPING: shutting down
  • REBOOTING: rebooting
  • SHUTDOWN: shut down and to be terminated
  • TERMINATING: terminating.
  • Tags Array of Tag List of tags associated with the instance.
    StopChargingMode String Instance billing method after shutdown.
    Valid values:
  • KEEP_CHARGING: billing continues after shutdown
  • STOP_CHARGING: billing stops after shutdown
  • NOT_APPLICABLE: the instance is not shut down or stopping billing after shutdown is not applicable to the instance.
  • Uuid String Globally unique ID of the instance.
    LatestOperation String Last operation of the instance, such as StopInstances or ResetInstance.
    LatestOperationState String The latest operation status of the instance. Valid values:
  • SUCCESS: operation succeeded
  • OPERATING: operation in progress
  • FAILED: operation failed
  • LatestOperationRequestId String Unique request ID for the last operation of the instance.
    DisasterRecoverGroupId String ID of a spread placement group.
    Note: this field may return null, indicating that no valid value is obtained.
    IPv6Addresses Array of String IPv6 address of the instance.
    Note: this field may return null, indicating that no valid value is obtained.
    CamRoleName String CAM role name.
    Note: this field may return null, indicating that no valid value is obtained.
    HpcClusterId String HPC cluster ID.
    Note: this field may return null, indicating that no valid value was found.
    RdmaIpAddresses Array of String IP list of HPC cluster.
    Note: this field may return null, indicating that no valid value was found.

    InstanceChargePrepaid

    Describes the billing method of an instance.

    Used by actions: InquiryPriceRunInstances, RunInstances.

    Name Type Required Description
    Period Integer Yes Subscription period; unit: 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_MANUAL_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.
  • InstanceFamilyConfig

    Describes the model family of the instance.
    Examples: {'InstanceFamilyName': 'Standard S1', 'InstanceFamily': 'S1'}, {'InstanceFamilyName': 'Network-optimized N1', 'InstanceFamily': 'N1'}, {'InstanceFamilyName': 'High IO I1', 'InstanceFamily': 'I1'}, etc.

    Used by actions: DescribeInstanceFamilyConfigs.

    Name Type Description
    InstanceFamilyName String Full name of the model family.
    InstanceFamily String Acronym of the model family.

    InstanceMarketOptionsRequest

    Options related to bidding requests

    Used by actions: InquiryPriceRunInstances, RunInstances.

    Name Type Required Description
    SpotOptions SpotMarketOptions Yes Options related to bidding
    MarketType String No Market option type. Currently spot is the only supported value.

    InstanceStatus

    Describes instance states. For state types, see here.

    Used by actions: DescribeInstancesStatus.

    Name Type Description
    InstanceId String