change-flow-version-in-deployment¶

Description¶

Change flow version of a running deployed flow.

Synopsis¶

  change-flow-version-in-deployment
--environment-crn <value>
--deployment-crn <value>
--deployed-flow-crn <value>
[--parameter-groups <value>]
[--kpis <value>]
[--strategy <value>]
[--wait-for-flow-to-stop-in-minutes <value>]
[--ignore-custom-nar-configuration-check | --no-ignore-custom-nar-configuration-check]
[--ignore-custom-python-configuration-check | --no-ignore-custom-python-configuration-check]
[--ignore-deployment-inbound-configuration-checks | --no-ignore-deployment-inbound-configuration-checks]
[--deployment-request-crn <value>]
[--asset-update-request-crn <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton]

Options¶

--environment-crn (string)

The CRN of an environment to execute the command.

--deployment-crn (string)

The crn of the deployment being updated.

--deployed-flow-crn (string)

The crn of the flow deployment being updated.

--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,
        "sourceParameterGroupId": "string"
      }
      ...
    ],
    "inheritedParameterGroups": [
      {
        "groupId": "string",
        "version": integer
      }
      ...
    ],
    "otherName": "string"
  }
  ...
]

--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"
  }
  ...
]

--strategy (string)

The strategy to use during change flow version.

Possible values:

• STOP_AND_PROCESS_DATA

• STOP_AND_EMPTY_QUEUES

• ONLY_RESTART_AFFECTED_COMPONENTS

--wait-for-flow-to-stop-in-minutes (integer)

The max time in minutes to wait for the flow to process data.

--ignore-custom-nar-configuration-check | --no-ignore-custom-nar-configuration-check (boolean)

When specified, ignore the check to validate if deployment has custom NARs configured when the flow definition contains custom components.

--ignore-custom-python-configuration-check | --no-ignore-custom-python-configuration-check (boolean)

When specified, ignore the check to validate if deployment has custom Python configured when the flow definition contains custom Python processors.

--ignore-deployment-inbound-configuration-checks | --no-ignore-deployment-inbound-configuration-checks (boolean)

When specified, ignore the check to validate if deployment has inbound connection configured for all listen components.

--deployment-request-crn (string)

The CRN of the deployment request. Required for a new deployment.

--asset-update-request-crn (string)

The CRN of the asset update request. Required when updating assets of an existing deployment.

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

deployedFlowConfiguration -> (object)

Provides all of the configuration that dictates how a flow is deployed.

configurationVersion -> (integer)

The version of this configuration.

deployedFlowId -> (string)

The id of the deployed flow.

deployedFlowName -> (string)

The name of the deployed flow.

deployedFlowCrn -> (string)

The CRN of the deployed flow.

parametersDirty -> (boolean)

Indicates whether or not all current parameter values have successfully been applied to NiFi.

kpisDirty -> (boolean)

Indicates whether or not the current KPIs have successfully been deployed as alert rules.

lastUpdatedByUsername -> (string)

The username of the last person to update the deployed flow configuration.

parameterGroups -> (array)

The list of flow parameter groups.

item -> (object)

A flow parameter group

name -> (string)

The name of the parameter group

parameters -> (array)

The parameters in the group

item -> (object)

A flow parameter

name -> (string)

The name of the parameter

description -> (string)

The description of the param

value -> (string)

The value of the parameter

sensitive -> (boolean)

Whether or not the parameter value is sensitive

type -> (string)

The type of parameter. Possibly TEXT, FILE, FILES

assetReferences -> (array)

The list of referenced assets.

( … recursive … )

valueSet -> (boolean)

Indicates if the value of this parameter is set (i.e. not null)

sourceParameterGroupId -> (string)

The ID of the shared parameter group where the value should come from.

inheritedParameterGroups -> (array)

The names and versions of the inherited parameter groups

item -> (object)

A reference to a specific version of a shared parameter group

groupId -> (string)

The ID of the parameter group

version -> (integer)

The version of the parameter group. Empty or null means the latest version.

otherName -> (string)

The other name that can be used to reference this group in a flow. This is used when multiple flows with same parameter group are deployed in to same NiFi cluster.

kpis -> (array)

The list of configured KPIs.

item -> (object)

An instantiated KPI specifying a metric on which to alert

metricId -> (string)

The id of the associated metric

id -> (string)

The id of the KPI; used only when viewing and editing existing KPIs

metricComponentType -> (string)

The component type of the associated metric

alert -> (object)

An alert configuration that specifies a configured frequency with lower and/or upper thresholds

thresholdMoreThan -> (object)

A configured alert threshold to pair together a statistical unit and value

unitId -> (string)

The identifier of the alert threshold unit to associate with the given threshold value

value -> (double)

The threshold value whose triggering causes an alert

thresholdLessThan -> (object)

A configured alert threshold to pair together a statistical unit and value

unitId -> (string)

The identifier of the alert threshold unit to associate with the given threshold value

value -> (double)

The threshold value whose triggering causes an alert

frequencyTolerance -> (object)

An alert configuration frequency tolerance for measuring an amount of time and unit for alert triggering

unit -> (object)

The alert frequency unit to use in KPI tolerances and metrics

id -> (string)

The id of the frequency unit

label -> (string)

The user-friendly label of the frequency unit

abbreviation -> (string)

The abbreviation for frequency unit

value -> (double)

The amount of time, associated with the given unit, a metric value can persist outside its boundaries before an alert is generated

componentId -> (string)

The optional process group ID, processor ID, or connection ID. This is a composite ID containing a chain of process group IDs representing the component’s full ancestry

Form Factors¶

public