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