Help & DocumentationAPIsElasticsearch ServiceData Types

Data Types

Last updated: 2020-03-06 11:10:57

CosBackup

Auto-backup to COS for ES

Used by actions: DescribeInstances、UpdateInstance.

Name Type Required Description
IsAutoBackup Boolean Yes Whether to enable auto-backup to COS
BackupTime String Yes Auto-backup time (accurate down to the hour), such as "22:00"

DictInfo

Information of the IK plugin dictionary

Used by actions: DescribeInstances.

Name Type Description
Key String Dictionary key value
Name String Dictionary name
Size Integer Dictionary size in B

EsAcl

ES cluster configuration item

Used by actions: DescribeInstances、UpdateInstance.

Name Type Required Description
BlackIpList Array of String No Kibana access blacklist
WhiteIpList Array of String No Kibana access whitelist

EsDictionaryInfo

ES IK dictionary information

Used by actions: DescribeInstances.

Name Type Description
MainDict Array of DictInfo List of non-stop words
Stopwords Array of DictInfo List of stop words

EsPublicAcl

Public network ACL information of ES

Used by actions: UpdateInstance.

Name Type Required Description
BlackIpList Array of String No Access blacklist
WhiteIpList Array of String No Access whitelist

InstanceInfo

Instance details

Used by actions: DescribeInstances.

Name Type Description
InstanceId String Instance ID
InstanceName String Instance name
Region String Region
Zone String Availability Zone
AppId Integer User ID
Uin String User UIN
VpcUid String UID of the VPC where the instance resides
SubnetUid String UID of the subnet where the instance resides
Status Integer Instance status. 0: processing; 1: normal; -1: stopped; -2: terminating; -3: terminated
ChargeType String Instance billing method. Valid values: POSTPAID_BY_HOUR (pay-as-you-go hourly); CDHPAID (billed based on CDH, i.e., only CDH is billed but not the instances on CDH)
ChargePeriod Integer This parameter is not used on the global website
RenewFlag String This parameter is not used on the global website
NodeType String Node specification
  • ES.S1.SMALL2: 1-core 2 GB
  • ES.S1.MEDIUM4: 2-core 4 GB
  • ES.S1.MEDIUM8: 2-core 8 GB
  • ES.S1.LARGE16: 4-core 16 GB
  • ES.S1.2XLARGE32: 8-core 32 GB
  • ES.S1.4XLARGE32: 16-core 32 GB
  • ES.S1.4XLARGE64: 16-core 64 GB
    • NodeNum Integer Number of nodes
    CpuNum Integer Number of CPU cores of the node
    MemSize Integer Node memory size in GB
    DiskType String Node disk type
    DiskSize Integer Node disk size in GB
    EsDomain String ES domain name
    EsVip String ES VIP
    EsPort Integer ES port
    KibanaUrl String Kibana access URL
    EsVersion String ES version number
    EsConfig String ES configuration item
    EsAcl EsAcl Kibana access control configuration
    CreateTime String Instance creation time
    UpdateTime String Last modified time of the instance
    Deadline String This parameter is not used on the global website
    InstanceType Integer Instance type (instance type identifier, which can be only 1 or 2 currently)
    IkConfig EsDictionaryInfo IK analyzer configuration
    MasterNodeInfo MasterNodeInfo Dedicated master node configuration
    CosBackup CosBackup Auto-backup to COS configuration
    AllowCosBackup Boolean Whether to allow auto-backup to COS
    TagList Array of TagInfo List of tags owned by the instance
    LicenseType String License type
  • oss: Open Source Edition
  • basic: Basic Edition
  • platinum: Platinum Edition
    • Default value: Platinum
    EnableHotWarmMode Boolean Whether it is a hot/warm cluster
  • true: yes
  • false: no

    • Note: this field may return null, indicating that no valid values can be obtained.
    WarmNodeType String Warm node specification
  • ES.S1.SMALL2: 1-core 2 GB
  • ES.S1.MEDIUM4: 2-core 4 GB
  • ES.S1.MEDIUM8: 2-core 8 GB
  • ES.S1.LARGE16: 4-core 16 GB
  • ES.S1.2XLARGE32: 8-core 32 GB
  • ES.S1.4XLARGE32: 16-core 32 GB
  • ES.S1.4XLARGE64: 16-core 64 GB

    • Note: This field may return null, indicating that no valid values can be obtained.
    WarmNodeNum Integer Number of warm nodes
    Note: This field may return null, indicating that no valid values can be obtained.
    WarmCpuNum Integer Number of warm node CPU cores
    Note: This field may return null, indicating that no valid values can be obtained.
    WarmMemSize Integer Warm node memory size in GB
    Note: This field may return null, indicating that no valid values can be obtained.
    WarmDiskType String Warm node disk type
    Note: This field may return null, indicating that no valid values can be obtained.
    WarmDiskSize Integer Warm node disk size in GB
    Note: This field may return null, indicating that no valid values can be obtained.
    NodeInfoList Array of NodeInfo Cluster node information list
    Note: This field may return null, indicating that no valid values can be obtained.
    EsPublicUrl String ES public IP address
    Note: This field may return null, indicating that no valid values can be obtained.
    MultiZoneInfo Array of ZoneDetail Multi-AZ network information
    Note: This field may return null, indicating that no valid values can be obtained.
    DeployMode Integer Deployment mode
  • 0: single-AZ
  • 1: multi-AZ

    • Note: This field may return null, indicating that no valid values can be obtained.
    PublicAccess String ES public access status
  • OPEN: enabled
  • CLOSE: disabled
    Note: This field may return null, indicating that no valid values can be obtained.
    		•
    EsPublicAcl EsAcl ES public access control configuration
    KibanaPrivateUrl String Kibana private IP address
    Note: This field may return null, indicating that no valid values can be obtained.
    KibanaPublicAccess String Kibana public access status
  • OPEN: enabled
  • CLOSE: disabled
    Note: This field may return null, indicating that no valid values can be obtained.
    		•
    KibanaPrivateAccess String Kibana private access status
  • OPEN: enabled
  • CLOSE: disabled
    Note: This field may return null, indicating that no valid values can be obtained.
    		•
    SecurityType Integer Whether to enable X-Pack security authentication in Basic Edition 6.8 (and above)
  • 1: disabled
  • 2: enabled

    • Note: This field may return null, indicating that no valid values can be obtained.

    MasterNodeInfo

    Information of the dedicated master node in an instance

    Used by actions: DescribeInstances.

    Name Type Description
    EnableDedicatedMaster Boolean Whether to enable the dedicated master node
    MasterNodeType String Dedicated master node specification
  • ES.S1.SMALL2: 1-core 2 GB
  • ES.S1.MEDIUM4: 2-core 4 GB
  • ES.S1.MEDIUM8: 2-core 8 GB
  • ES.S1.LARGE16: 4-core 16 GB
  • ES.S1.2XLARGE32: 8-core 32 GB
  • ES.S1.4XLARGE32: 16-core 32 GB
  • ES.S1.4XLARGE64: 16-core 64 GB
    		•
    MasterNodeNum Integer Number of dedicated master nodes
    MasterNodeCpuNum Integer Number of CPU cores of the dedicated master node
    MasterNodeMemSize Integer Memory size of the dedicated master node in GB
    MasterNodeDiskSize Integer Disk size of the dedicated master node in GB
    MasterNodeDiskType String Disk type of the dedicated master node

    NodeInfo

    Specification information of a node type in the cluster (such as hot data node, warm data node, or dedicated master node), including node type, number of nodes, node specification, disk type, and disk size. If Type is not specified, it will be a hot data node by default; if the node is a master node, then the DiskType and DiskSize parameters will be ignored (as a master node has no data disks)

    Used by actions: CreateInstance、DescribeInstances、UpdateInstance.

    Name Type Required Description
    NodeNum Integer Yes Number of nodes
    NodeType String Yes Node specification
  • ES.S1.SMALL2: 1-core 2 GB
  • ES.S1.MEDIUM4: 2-core 4 GB
  • ES.S1.MEDIUM8: 2-core 8 GB
  • ES.S1.LARGE16: 4-core 16 GB
  • ES.S1.2XLARGE32: 8-core 32 GB
  • ES.S1.4XLARGE32: 16-core 32 GB
  • ES.S1.4XLARGE64: 16-core 64 GB
    • Type String No Node type
  • hotData: hot data node
  • warmData: warm data node
  • dedicatedMaster: dedicated master node

    • Default value: hotData
    DiskType String No Node disk type
  • CLOUD_SSD: SSD cloud storage
  • CLOUD_PREMIUM: Premium cloud disk
    • Default value: CLOUD_SSD
    DiskSize Integer No Node disk size in GB

    TagInfo

    Instance tag information

    Used by actions: CreateInstance、DescribeInstances.

    Name Type Description
    TagKey String Tag key
    TagValue String Tag value

    ZoneDetail

    Details of AZs in multi-AZ deployment mode

    Used by actions: CreateInstance、DescribeInstances.

    Name Type Required Description
    Zone String Yes AZ
    SubnetId String Yes Subnet ID