Resource /webmapi/clusterExpand | Collapse

APIs for cluster-level operations

Show cluster information
Description

Show cluster information

HTTP Example

GET /webmapi/cluster

Output

Reports successful result in ResponseContentType<ClusterShowOutputType>

Errors

Reports errors in ResponseContentType<ErrorType>

Error KeyError CodeError Description
CLUSTER_SHOW_CLUSTER_UNINITIALIZED7001Cluster is uninitialized.
CLUSTER_SHOW_INTERNAL_ERROR7023Internal error occurred.
CLUSTER_SHOW_EXISTS7024Cluster already exists.
CLUSTER_SHOW_SHELL_FAILURE7025Cluster operation failed.
CLUSTER_SHOW_CLUSTER_SHUTDOWN7026Cluster shutdown in progress.
Produces

application/json

Since

1.0

Create a cluster
Description

Create a cluster

HTTP Example

POST /webmapi/cluster

Input

Pass input arguments in ClusterCreateInputType

Output

Reports successful result in ResponseContentType<UuidType>

Errors

Reports errors in ResponseContentType<ErrorType>

Error KeyError CodeError Description
CLUSTER_CREATE_EXISTS7000Cluster already exists.
CLUSTER_CREATE_INTERNAL_ERROR7009Internal error occurred.
CLUSTER_CREATE_REQUEST_IN_PROGRESS7010Another request is in progress.
CLUSTER_CREATE_SHELL_FAILURE7011Cluster operation failed.
Produces

application/json

Consumes

application/json

Since

1.0

Deprecated since 1.0.1. See nodes instead.Discover nodes that are eligible for forming or joining a cluster.
Description

Discover nodes that are eligible for forming or joining a cluster. Nodes are identified by system serial number

HTTP Example

POST /webmapi/cluster/action/discover-nodes

Output

Reports successful result in ResponseContentType<ContainerType<ClusterNodeType>>

Errors

Reports errors in ResponseContentType<ErrorType>

Error KeyError CodeError Description
CLUSTER_DISCOVER_NODES_INTERNAL_ERROR7027Internal error occurred.
Produces

application/json

Consumes

application/json

Since

1.0

Deprecated since 1.0.1. See net/services/dns instead.Show the network DNS server
Description

Show the network DNS server

HTTP Example

GET /webmapi/cluster/dns-server

Output

Reports successful result in ResponseContentType<ClusterDnsServerOutputType>

Errors

Reports errors in ResponseContentType<ErrorType>

Error KeyError CodeError Description
NETWORK_DNS_SERVER_SHOW_INTERNAL_ERROR35008Internal error occurred.
NETWORK_DNS_SERVER_SHOW_REQUEST_IN_PROGRESS35009Another request is in progress.
NETWORK_DNS_SERVER_SHOW_DNS_UNINITIALIZED35010Network DNS server not initialized.
NETWORK_DNS_SERVER_SHOW_SHELL_FAILURE35011Network operation failed.
NETWORK_DNS_SERVER_SHOW_NETWORK_SHUTDOWN35012Network shutdown in progress.
Produces

application/json

Since

1.0

Deprecated since 1.0.1. See net/services/dns instead.Set the network DNS server
Description

Set the network DNS server

To clear DNS settings, pass all empty fields to input except for protocol.

HTTP Example

PUT /webmapi/cluster/dns-server

Input

Pass input arguments in ClusterDnsServerModifyInputType

Output

Reports successful result in ResponseContentType

Errors

Reports errors in ResponseContentType<ErrorType>

Error KeyError CodeError Description
NETWORK_DNS_SERVER_MODIFY_INTERNAL_ERROR35013Internal error occurred.
NETWORK_DNS_SERVER_MODIFY_REQUEST_IN_PROGRESS35014Another request is in progress.
NETWORK_DNS_SERVER_MODIFY_SHELL_FAILURE35015Network operation failed.
NETWORK_DNS_SERVER_MODIFY_NETWORK_SHUTDOWN35016Network shutdown in progress.
NETWORK_DNS_SERVER_MODIFY_NETWORK_IPV6_NOT_SUPPORTED35017IPV6 not supported.
NETWORK_DNS_SERVER_MODIFY_NUM_NETWORK_DNS_SERVERS35018Incorrect number of DNS servers.
NETWORK_DNS_SERVER_MODIFY_DUPLICATE_DNS_SERVERS35019Duplicate DNS servers.
NETWORK_DNS_SERVER_MODIFY_INVALID_DNS_SERVER_IP35020INVALID DNS server IP.
Produces

application/json

Consumes

application/json

Since

1.0

Show the cluster management IP address, netmask, and gateway
Description

Show the cluster management IP address, netmask, and gateway

HTTP Example

GET /webmapi/cluster/management-interface

Output

Reports successful result in ResponseContentType<ClusterMgmtInterfaceOutputType>

Errors

Reports errors in ResponseContentType<ErrorType>

Error KeyError CodeError Description
CLUSTER_MANAGEMENT_INTERFACE_SHOW_INTERNAL_ERROR7017Internal error occurred.
CLUSTER_MANAGEMENT_INTERFACE_SHOW_REQUEST_IN_PROGRESS7018Another request is in progress.
CLUSTER_MANAGEMENT_INTERFACE_SHOW_MANAGEMENT_IP_NOT_INITIALIZED7019Cluster management IP address not initialized.
CLUSTER_MANAGEMENT_INTERFACE_SHOW_IPV4_UNINITIALIZED7020IPv4 cluster management address not initialized.
CLUSTER_MANAGEMENT_INTERFACE_SHOW_IPV6_UNINITIALIZED7021IPv6 cluster management address not initialized.
CLUSTER_MANAGEMENT_INTERFACE_SHOW_CLUSTER_SHUTDOWN7022Cluster shutdown in progress.
Produces

application/json

Since

1.0

Change cluster management interface
Description

Change cluster management interface

HTTP Example

PUT /webmapi/cluster/management-interface

Input

Pass input arguments in ClusterMgmtInterfaceModifyInputType

Output

Reports successful result in ResponseContentType

Errors

Reports errors in ResponseContentType<ErrorType>

Error KeyError CodeError Description
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_INTERNAL_ERROR7037Internal error occurred.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_REQUEST_IN_PROGRESS7038Another request is in progress.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_SHELL_FAILURE7039Cluster operation failed.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_CLUSTER_SHUTDOWN7040Cluster shutdown in progress.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_CLUSTER_IPV6_NOT_SUPPORTED7041IPv6 not supported.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_INVALID_CLUSTER_MGMT_IP7043Invalid cluster management IP.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_INVALID_CLUSTER_NETMASK7044Invalid cluster netmask.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_INVALID_CLUSTER_GATEWAY7045Invalid cluster gateway.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_INVALID_MGMT_IP_GATEWAY7046Cluster management IP and gateway in different subnets.
CLUSTER_MANAGEMENT_INTERFACE_MODIFY_DUPLICATE_CLUSTER_IP_GATEWAY7047Duplicate cluster IP and Gateway.
HTTP Responses
Status CodeReason
202The request has been accepted successfully
Produces

application/json

Consumes

application/json

Since

1.0