DataPipeline / Client / validate_pipeline_definition

validate_pipeline_definition

DataPipeline.Client.validate_pipeline_definition(**kwargs)

Validates the specified pipeline definition to ensure that it is well formed and can be run without error.

See also: AWS API Documentation

Request Syntax

response = client.validate_pipeline_definition(
    pipelineId='string',
    pipelineObjects=[
        {
            'id': 'string',
            'name': 'string',
            'fields': [
                {
                    'key': 'string',
                    'stringValue': 'string',
                    'refValue': 'string'
                },
            ]
        },
    ],
    parameterObjects=[
        {
            'id': 'string',
            'attributes': [
                {
                    'key': 'string',
                    'stringValue': 'string'
                },
            ]
        },
    ],
    parameterValues=[
        {
            'id': 'string',
            'stringValue': 'string'
        },
    ]
)

Parameters:

• pipelineId (string) –

  [REQUIRED]

  The ID of the pipeline.

• pipelineObjects (list) –

  [REQUIRED]

  The objects that define the pipeline changes to validate against the pipeline.

  • (dict) –

    Contains information about a pipeline object. This can be a logical, physical, or physical attempt pipeline object. The complete set of components of a pipeline defines the pipeline.

    • id (string) – [REQUIRED]

      The ID of the object.

    • name (string) – [REQUIRED]

      The name of the object.

    • fields (list) – [REQUIRED]

      Key-value pairs that define the properties of the object.

      • (dict) –

        A key-value pair that describes a property of a pipeline object. The value is specified as either a string value ( StringValue) or a reference to another object ( RefValue) but not as both.

        • key (string) – [REQUIRED]

          The field identifier.

        • stringValue (string) –

          The field value, expressed as a String.

        • refValue (string) –

          The field value, expressed as the identifier of another object.

• parameterObjects (list) –

  The parameter objects used with the pipeline.

  • (dict) –

    Contains information about a parameter object.

    • id (string) – [REQUIRED]

      The ID of the parameter object.

    • attributes (list) – [REQUIRED]

      The attributes of the parameter object.

      • (dict) –

        The attributes allowed or specified with a parameter object.

        • key (string) – [REQUIRED]

          The field identifier.

        • stringValue (string) – [REQUIRED]

          The field value, expressed as a String.

• parameterValues (list) –

  The parameter values used with the pipeline.

  • (dict) –

    A value or list of parameter values.

    • id (string) – [REQUIRED]

      The ID of the parameter value.

    • stringValue (string) – [REQUIRED]

      The field value, expressed as a String.

Return type:

dict

Returns:

Response Syntax

{
    'validationErrors': [
        {
            'id': 'string',
            'errors': [
                'string',
            ]
        },
    ],
    'validationWarnings': [
        {
            'id': 'string',
            'warnings': [
                'string',
            ]
        },
    ],
    'errored': True|False
}

Response Structure

• (dict) –

  Contains the output of ValidatePipelineDefinition.

  • validationErrors (list) –

    Any validation errors that were found.

    • (dict) –

      Defines a validation error. Validation errors prevent pipeline activation. The set of validation errors that can be returned are defined by AWS Data Pipeline.

      • id (string) –

        The identifier of the object that contains the validation error.

      • errors (list) –

        A description of the validation error.

        • (string) –

  • validationWarnings (list) –

    Any validation warnings that were found.

    • (dict) –

      Defines a validation warning. Validation warnings do not prevent pipeline activation. The set of validation warnings that can be returned are defined by AWS Data Pipeline.

      • id (string) –

        The identifier of the object that contains the validation warning.

      • warnings (list) –

        A description of the validation warning.

        • (string) –

  • errored (boolean) –

    Indicates whether there were validation errors.

Exceptions

• DataPipeline.Client.exceptions.InternalServiceError

• DataPipeline.Client.exceptions.InvalidRequestException

• DataPipeline.Client.exceptions.PipelineNotFoundException

• DataPipeline.Client.exceptions.PipelineDeletedException