create-deployment¶

Description¶

Creates a deployment.

Synopsis¶

  create-deployment
--environment-crn <value>
--configuration-version <value>
--name <value>
--deployment-request-crn <value>
[--parameter-groups <value>]
[--auto-scaling-enabled | --no-auto-scaling-enabled]
[--flow-metrics-scaling-enabled | --no-flow-metrics-scaling-enabled]
[--auto-scale-min-nodes <value>]
[--auto-scale-max-nodes <value>]
[--static-node-count <value>]
[--kpis <value>]
[--cfm-nifi-version <value>]
[--auto-start-flow | --no-auto-start-flow]
[--inbound-hostname <value>]
[--listen-components <value>]
[--node-storage-profile-name <value>]
[--custom-nar-configuration-crn <value>]
[--project-crn <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton]

Options¶

--environment-crn (string)

The CRN of an environment to execute the command.

--configuration-version (integer)

The version of this configuration

--name (string)

The name of the deployment

--deployment-request-crn (string)

The CRN of the deployment request.

--parameter-groups (array)

The list of flow parameter groups

JSON Syntax:

[
  {
    "name": "string",
    "parameters": [
      {
        "name": "string",
        "description": "string",
        "value": "string",
        "sensitive": true|false,
        "type": "TEXT"|"FILE"|"FILES",
        "assetReferences": [
          { ... recursive ... }
          ...
        ],
        "valueSet": true|false
      }
      ...
    ]
  }
  ...
]

--auto-scaling-enabled | --no-auto-scaling-enabled (boolean)

Specifies that auto-scaling should be enabled.

--flow-metrics-scaling-enabled | --no-flow-metrics-scaling-enabled (boolean)

Specifies that Flow metrics should be enabled for scaling.

--auto-scale-min-nodes (integer)

The minimum number of nodes that the cluster should allocate. May only be specified when auto-scaling-enabled is true.

--auto-scale-max-nodes (integer)

The maximum number of nodes that the cluster should scale to. May only be specified when auto-scaling-enabled is true.

--static-node-count (integer)

The static number of nodes that the cluster should allocate. May only be specified when auto-scaling-enabled is false.

--kpis (array)

The list of configured KPIs

JSON Syntax:

[
  {
    "metricId": "string",
    "id": "string",
    "metricComponentType": "SYSTEM"|"NIFI_FLOW"|"NIFI_PROCESSOR"|"NIFI_PROCESS_GROUP"|"NIFI_CONNECTION",
    "alert": {
      "thresholdMoreThan": {
        "unitId": "string",
        "value": double
      },
      "thresholdLessThan": {
        "unitId": "string",
        "value": double
      },
      "frequencyTolerance": {
        "unit": {
          "id": "SECONDS"|"MINUTES"|"HOURS"|"DAYS",
          "label": "string",
          "abbreviation": "string"
        },
        "value": double
      }
    },
    "componentId": "string"
  }
  ...
]

--cfm-nifi-version (string)

The CFM NiFi version associated with the deployment

--auto-start-flow | --no-auto-start-flow (boolean)

Indicates whether or not the flow should be started during deployment creation

--inbound-hostname (string)

The FQDN of inbound hostname or just the prefix part

--listen-components (array)

Listen components port and protocol data

Shorthand Syntax:

protocol=string,listenComponentType=string,port=string ... (separate items with spaces)

JSON Syntax:

[
  {
    "protocol": "TCP"|"UDP",
    "listenComponentType": "ListenHTTP"|"ListenFTP"|"ListenSyslog"|"ListenRELP"|"ListenTCP"|"ListenUDP"|"ListenTCPRecord"|"ListenUDPRecord"|"ListenGRPC"|"ListenSMTP"|"ListenBeats"|"ListenLumberjack"|"ListenWebSocket"|"HandleHttpRequest",
    "port": "string"
  }
  ...
]

--node-storage-profile-name (string)

Node storage profile name

Possible values:

• STANDARD_AWS

• STANDARD_AZURE

• PERFORMANCE_AWS

• PERFORMANCE_AZURE

• LOCAL_K8S

--custom-nar-configuration-crn (string)

The CRN of the custom NAR configuration.

--project-crn (string)

The CRN of the project.

--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¶

deployment -> (object)

Provides details about a deployment.

name -> (string)

The name of the deployment

status -> (object)

The state and state message associated with a deployment

detailedState -> (string)

The detailed state that the deployment is currently in

state -> (string)

The state that the deployment is currently in

message -> (string)

Detail message relating to the current status of the deployment

service -> (object)

The meta information about a DataFlow service.

crn -> (string)

The CRN of the DataFlow service

name -> (string)

The name of the DataFlow service

cloudPlatform -> (string)

The cloudPlatform flag of the DataFlow service

region -> (object)

A cloud region

name -> (string)

Name of the cloud region

displayName -> (string)

Display-friendly name of the cloud region

environmentCrn -> (string)

Crn of associated CDP environment

crn -> (string)

The CRN of the deployment

activeInfoAlertCount -> (integer)

Current count of active alerts classified as an info

activeWarningAlertCount -> (integer)

Current count of active alerts classified as a warning

activeErrorAlertCount -> (integer)

Current count of active alerts classified as an error

created -> (integer)

Timestamp of the creation of the deployment

updated -> (integer)

Timestamp of the last time the deployment was modified

validActions -> (array)

Valid actions that can be applied to the deployment in its current state

item -> (string)

project -> (object)

The meta information about a project.

id -> (string)

The id of the project

crn -> (string)

The CRN of the project

name -> (string)

The name of the group

nifiUrl -> (string)

The url to open the deployed flow in NiFi

autoscalingEnabled -> (boolean)

Whether or not autoscaling is enabled for this deployment

flowMetricsScalingEnabled -> (boolean)

Whether or not flow metrics scaling is enabled for this deployment

autoscaleMinNodes -> (integer)

The minimum number of nodes that the deployment will allocate; can only be used when autoscalingEnabled is true

autoscaleMaxNodes -> (integer)

The maximum number of nodes that the deployment can scale up to; can only be used when autoscalingEnabled is true

staticNodeCount -> (integer)

The static number of nodes of the deployment; can only be used when autoscalingEnabled is false

flowName -> (string)

The name of the flow

flowVersion -> (integer)

The version of the flow

flowVersionCrn -> (string)

The deployment’s current flow version CRN

flowCrn -> (string)

The deployment’s current flow CRN

creatorCrn -> (string)

The CRN of the user who deployed the flow

artifactTypeName -> (string)

The type of artifact of the flow

currentNodeCount -> (integer)

The current node count

deployedByUsername -> (string)

The username of the person who deployed the flow

deployedByName -> (string)

The name of the person who deployed the flow

dfxLocalUrl -> (string)

Base URL to the CDF Local instance running this deployment

configurationVersion -> (integer)

The current version of the deployment’s configuration

lastUpdatedByUsername -> (string)

The username of the last person to update the deployment

cfmNifiVersion -> (string)

The CFM NiFi version associated with the deployment

inboundConnectionEndpointId -> (string)

The ID of Inbound Connection Endpoint assigned to the deployment

testSession -> (boolean)

Indicates this deployment was created as a test session for designing a flow

flowDesignerId -> (string)

The ID of the flow design for a test session deployment.

customNarConfigurationId -> (string)

The identifier of the custom NAR configuration, if used.

nodeStorageProfile -> (string)

The node storage profile

projectCrn -> (string)

The crn of the project this deployment belongs to, or null if does not belong to a project

Form Factors¶

public