create-aws-cluster

subtitle

Creates an AWS workload cluster.

version

0.9.66

Description

Creates an AWS workload cluster.

Synopsis

  create-aws-cluster
[--cluster-name <value>]
[--cluster-definition <value>]
[--environment <value>]
[--cluster-template <value>]
[--custom-configurations-name <value>]
[--instance-groups <value>]
[--subnet-id <value>]
[--image <value>]
[--tags <value>]
[--request-template <value>]
[--datahub-database <value>]
[--subnet-ids <value>]
[--multi-az | --no-multi-az]
[--enable-load-balancer | --no-enable-load-balancer]
[--cli-input-json <value>]
[--generate-cli-skeleton]

Options

--cluster-name (string)

The name of the cluster. This name must be unique, must have between 5 and 40 characters, and must contain only lowercase letters, numbers and hyphens. Names are case-sensitive.

--cluster-definition (string)

The name or CRN of the cluster definition to use for cluster creation.

--environment (string)

Name or CRN of the environment to use when creating the cluster. The environment must be an AWS environment.

--cluster-template (string)

Name or CRN of the cluster template to use for cluster creation.

--custom-configurations-name (string)

The name of the custom configurations to use for cluster creation.

--instance-groups (array)

Instance group details.

Shorthand Syntax:

nodeCount=integer,instanceGroupName=string,instanceGroupType=string,instanceType=string,attachedVolumeConfiguration=[{volumeSize=integer,volumeCount=integer,volumeType=string},{volumeSize=integer,volumeCount=integer,volumeType=string}],rootVolumeSize=integer,recipeNames=string,string,recoveryMode=string,volumeEncryption={enableEncryption=boolean,encryptionKey=string} ... (separate items with spaces)

JSON Syntax:

[
  {
    "nodeCount": integer,
    "instanceGroupName": "string",
    "instanceGroupType": "string",
    "instanceType": "string",
    "attachedVolumeConfiguration": [
      {
        "volumeSize": integer,
        "volumeCount": integer,
        "volumeType": "string"
      }
      ...
    ],
    "rootVolumeSize": integer,
    "recipeNames": ["string", ...],
    "recoveryMode": "string",
    "volumeEncryption": {
      "enableEncryption": true|false,
      "encryptionKey": "string"
    }
  }
  ...
]

--subnet-id (string)

The subnet ID.

--image (object)

The details of the image used for cluster instances.

id -> (string)

The ID of the image used for cluster instances. This is generated by the cloud provider to uniquely identify the image.

catalogName -> (string)

The image catalog name.

Shorthand Syntax:

id=string,catalogName=string

JSON Syntax:

{
  "id": "string",
  "catalogName": "string"
}

--tags (array)

Tags to be added to Datahub related resources.

Shorthand Syntax:

key=string,value=string ... (separate items with spaces)

JSON Syntax:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--request-template (string)

JSON template to use for cluster creation. This is different from cluster template and would be removed in the future.

--datahub-database (string)

Database type for datahub. Currently supported values: NONE, NON_HA, HA

Possible values:

  • HA

  • NON_HA

  • NONE

--subnet-ids (array)

List of subnet IDs in case of multi availability zone setup.

Syntax:

"string" "string" ...

--multi-az | --no-multi-az (boolean)

Flag that toggles the multi availability zone for the given datahub cluster when you are not sure what subnet IDs can be used. This way the subnet IDs will be used what the environment suggests.

--enable-load-balancer | --no-enable-load-balancer (boolean)

Flag that decides whether to provision a load-balancer to front various service endpoints for the given datahub. This will typically be used for HA cluster shapes.

--cli-input-json (string)

Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (boolean)

Prints a sample input JSON to standard output. Note the specified operation is not run if this argument is specified. The sample input can be used as an argument for --cli-input-json.

Output

cluster -> (object)

Information about a cluster.

clusterName -> (string)

The name of the cluster.

crn -> (string)

The CRN of the cluster.

creationDate -> (datetime)

The date when the cluster was created.

status -> (string)

The status of the stack.

clusterStatus -> (string)

The status of the cluster.

nodeCount -> (integer)

The cluster node count.

instanceGroups -> (array)

The instance details.

item -> (object)

The type of the instance group which also contains the actual instance(s)

name -> (string)

The name of the instance group where the given instance is located.

instances -> (array)

Some information about the given instance.

item -> (object)

Object which holds some details of an instance for the given cluster.

id -> (string)

The ID of the given instance.

state -> (string)

The health state of the instance. UNHEALTHY represents instances with unhealthy services, lost instances, or failed operations.

privateIp -> (string)

The private ip of the given instance.

publicIp -> (string)

The public ip of the given instance.

fqdn -> (string)

The FQDN for the instance

status -> (string)

The status of the instance. This includes information like whether the instance is being provisioned, stopped, decommissioning failures etc.

workloadType -> (string)

The workload type for the cluster.

cloudPlatform -> (string)

The cloud platform.

imageDetails -> (object)

The details of the image used for cluster instances.

name -> (string)

The name of the image used for cluster instances.

id -> (string)

The ID of the image used for cluster instances. This is internally generated by the cloud provider to uniquely identify the image.

catalogUrl -> (string)

The image catalog URL.

catalogName -> (string)

The image catalog name.

environmentCrn -> (string)

The CRN of the environment.

credentialCrn -> (string)

The CRN of the credential.

datalakeCrn -> (string)

The CRN of the attached datalake.

clusterTemplateCrn -> (string)

The CRN of the cluster template used for the cluster creation.

statusReason -> (string)

The status reason.

clouderaManager -> (object)

Cloudera Manager details.

version -> (string)

Cloudera Manager version.

platformVersion -> (string)

CDP Platform version.

endpoints -> (object)

Object which holds the exposed endpoints for the given cluster.

endpoints -> (array)

The endpoints.

item -> (object)

Object which holds the exposed endpoint.

serviceName -> (string)

The name of the exposed service

serviceUrl -> (string)

The server url for the given exposed service’s API.

displayName -> (string)

The more consumable name of the exposed service.

knoxService -> (string)

The related knox entry.

mode -> (string)

The SSO mode of the given service.

open -> (boolean)

The access status of the given endpoint. Whether its open or not.

Form Factors

public