GlueDataBrew / Client / batch_delete_recipe_version

batch_delete_recipe_version#

GlueDataBrew.Client.batch_delete_recipe_version(**kwargs)#

Deletes one or more versions of a recipe at a time.

The entire request will be rejected if:

  • The recipe does not exist.

  • There is an invalid version identifier in the list of versions.

  • The version list is empty.

  • The version list size exceeds 50.

  • The version list contains duplicate entries.

The request will complete successfully, but with partial failures, if:

  • A version does not exist.

  • A version is being used by a job.

  • You specify LATEST_WORKING, but it’s being used by a project.

  • The version fails to be deleted.

The LATEST_WORKING version will only be deleted if the recipe has no other versions. If you try to delete LATEST_WORKING while other versions exist (or if they can’t be deleted), then LATEST_WORKING will be listed as partial failure in the response.

See also: AWS API Documentation

Request Syntax

response = client.batch_delete_recipe_version(
    Name='string',
    RecipeVersions=[
        'string',
    ]
)
Parameters:

  • Name (string) –

    [REQUIRED]

    The name of the recipe whose versions are to be deleted.

  • RecipeVersions (list) –

    [REQUIRED]

    An array of version identifiers, for the recipe versions to be deleted. You can specify numeric versions ( X.Y) or LATEST_WORKING. LATEST_PUBLISHED is not supported.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Name': 'string',
    'Errors': [
        {
            'ErrorCode': 'string',
            'ErrorMessage': 'string',
            'RecipeVersion': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    • Name (string) –

      The name of the recipe that was modified.

    • Errors (list) –

      Errors, if any, that occurred while attempting to delete the recipe versions.

      • (dict) –

        Represents any errors encountered when attempting to delete multiple recipe versions.

        • ErrorCode (string) –

          The HTTP status code for the error.

        • ErrorMessage (string) –

          The text of the error message.

        • RecipeVersion (string) –

          The identifier for the recipe version associated with this error.

Exceptions

  • GlueDataBrew.Client.exceptions.ConflictException

  • GlueDataBrew.Client.exceptions.ResourceNotFoundException

  • GlueDataBrew.Client.exceptions.ValidationException