You can call the ListFlowClusterHost operation to query the list of clients from which a cluster can submit jobs.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. You can use OpenAPI Explorer to search for API operations, call API operations, and dynamically generate SDK sample code.

Request parameters

Parameter Type Required Example Description
Action String Yes ListFlowClusterHost

The operation that you want to perform. This parameter is required for API requests that you create by piecing together HTTP or HTTPS URLs. Set the value to ListFlowClusterHost.

ClusterId String Yes C-F32FB31D8295****

The ID of the cluster. You can call ListClusters You can call this operation to view the ID of a cluster.

ProjectId String Yes FP-3535FE0BE522****

The ID of the project. You can call ListFlowProject View the ID of the project.

RegionId String Yes cn-hangzhou

The region ID of the instance. You can call DescribeRegions To view the latest list of Alibaba Cloud regions.

ResourceGroupId String No rg-bp67acfmxazb4p****

The ID of the resource group to which the snapshot belongs. You can call ListResourceGroups View the resource group ID.

Response parameters

Parameter Type Example Description
HostList Array of Host

The list of hosts that can be added to the whitelist in the specified cluster.

Host
Cpu Integer 4

The number of vCPUs of the host.

HostId String 119***

The ID of the host to which the instances belong.

HostInstanceId String i-bp1agi4417dx08si****

The ID of the host.

HostName String emr-header-1.cluster-500159692

The name of the node.

InstanceType String ecs.n4.xlarge

The architecture type of the instance.

Memory Integer 16

Memory, in GB.

PrivateIp String 127.0.**.**

The internal IP address of the host.

PublicIp String 192.0.**.**

The public IP address of the host.

Role String MASTER

Role:

  • MASTER
  • CORE
  • TASK
SerialNumber String 738d0af9-6ca3-46dd-a973-bab70da4****

The serial number of the host.

Status String STARTING

The status of the host.

Type String VM

The type of the host.

RequestId String 2E429517-6A50-4082-9A30-47755CE9F9A5

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListFlowClusterHost
&ClusterId=C-F32FB31D8295****
&ProjectId=FP-3535FE0BE522****
&RegionId=cn-hangzhou
&<common request parameters>

Sample success responses

XML format

<RequestId>2E429517-6A50-4082-9A30-47755CE9F9A5</RequestId>
<HostList>
    <Host>
        <Status>STARTING</Status>
        <Role>MASTER</Role>
        <SerialNumber>738d0af9-6ca3-46dd-a973-bab70da4****</SerialNumber>
        <PublicIp>47.99.**.**</PublicIp>
        <PrivateIp>192.168.**.**</PrivateIp>
        <Memory>8</Memory>
        <Cpu>4</Cpu>
        <HostInstanceId>i-bp1agi4417dx08si****</HostInstanceId>
        <HostId>119***</HostId>
        <HostName>emr-header-1.cluster-500159692</HostName>
    </Host>
</HostList>

JSON Syntax

{
    "RequestId": "2E429517-6A50-4082-9A30-47755CE9F9A5",
    "HostList": {
        "Host": [
            {
                "Status": "STARTING",
                "Role": "MASTER",
                "SerialNumber": "738d0af9-6ca3-46dd-a973-bab70da4****",
                "PublicIp": "47.99.**.**",
                "PrivateIp": "192.168.**.**",
                "Memory": 8,
                "Cpu": 4,
                "HostInstanceId": "i-bp1agi4417dx08si****",
                "HostId": "119***",
                "HostName": "emr-header-1.cluster-500159692"
            }
        ]
    }
}