Usage profiles - Amazon Glue
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Usage profiles

The Usage profiles API describes the data types and API related to creating, updating, or viewing usage profiles in Amazon Glue.

Data types

ProfileConfiguration structure

Specifies the job and session values that an admin configures in an Amazon Glue usage profile.

Fields
  • SessionConfiguration – A map array of key-value pairs.

    Each key is a UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    Each value is a A ConfigurationObject object.

    A key-value map of configuration parameters for Amazon Glue sessions.

  • JobConfiguration – A map array of key-value pairs.

    Each key is a UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    Each value is a A ConfigurationObject object.

    A key-value map of configuration parameters for Amazon Glue jobs.

ConfigurationObject structure

Specifies the values that an admin sets for each job or session parameter configured in a Amazon Glue usage profile.

Fields
  • DefaultValue – UTF-8 string, not less than 1 or more than 128 bytes long, matching the Custom string pattern #31.

    A default value for the parameter.

  • AllowedValues – An array of UTF-8 strings.

    A list of allowed values for the parameter.

  • MinValue – UTF-8 string, not less than 1 or more than 128 bytes long, matching the Custom string pattern #31.

    A minimum allowed value for the parameter.

  • MaxValue – UTF-8 string, not less than 1 or more than 128 bytes long, matching the Custom string pattern #31.

    A maximum allowed value for the parameter.

UsageProfileDefinition structure

Describes an Amazon Glue usage profile.

Fields
  • Name – UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile.

  • Description – Description string, not more than 2048 bytes long, matching the URI address multi-line string pattern.

    A description of the usage profile.

  • CreatedOn – Timestamp.

    The date and time when the usage profile was created.

  • LastModifiedOn – Timestamp.

    The date and time when the usage profile was last modified.

Operations

CreateUsageProfile action (Python: create_usage_profile)

Creates an Amazon Glue usage profile.

Request
  • NameRequired: UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile.

  • Description – Description string, not more than 2048 bytes long, matching the URI address multi-line string pattern.

    A description of the usage profile.

  • ConfigurationRequired: A ProfileConfiguration object.

    A ProfileConfiguration object specifying the job and session values for the profile.

  • Tags – A map array of key-value pairs, not more than 50 pairs.

    Each key is a UTF-8 string, not less than 1 or more than 128 bytes long.

    Each value is a UTF-8 string, not more than 256 bytes long.

    A list of tags applied to the usage profile.

Response
  • Name – UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile that was created.

Errors
  • InvalidInputException

  • InternalServiceException

  • AlreadyExistsException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • OperationNotSupportedException

GetUsageProfile action (Python: get_usage_profile)

Retrieves information about the specified Amazon Glue usage profile.

Request
  • NameRequired: UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile to retrieve.

Response
  • Name – UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile.

  • Description – Description string, not more than 2048 bytes long, matching the URI address multi-line string pattern.

    A description of the usage profile.

  • Configuration – A ProfileConfiguration object.

    A ProfileConfiguration object specifying the job and session values for the profile.

  • CreatedOn – Timestamp.

    The date and time when the usage profile was created.

  • LastModifiedOn – Timestamp.

    The date and time when the usage profile was last modified.

Errors
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • OperationNotSupportedException

UpdateUsageProfile action (Python: update_usage_profile)

Update an Amazon Glue usage profile.

Request
  • NameRequired: UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile.

  • Description – Description string, not more than 2048 bytes long, matching the URI address multi-line string pattern.

    A description of the usage profile.

  • ConfigurationRequired: A ProfileConfiguration object.

    A ProfileConfiguration object specifying the job and session values for the profile.

Response
  • Name – UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile that was updated.

Errors
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • OperationNotSupportedException

  • ConcurrentModificationException

DeleteUsageProfile action (Python: delete_usage_profile)

Deletes the Amazon Glue specified usage profile.

Request
  • NameRequired: UTF-8 string, not less than 1 or more than 255 bytes long, matching the Single-line string pattern.

    The name of the usage profile to delete.

Response
  • No Response parameters.

Errors
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • OperationNotSupportedException

ListUsageProfiles action (Python: list_usage_profiles)

List all the Amazon Glue usage profiles.

Request
  • NextToken – UTF-8 string, not more than 400000 bytes long.

    A continuation token, included if this is a continuation call.

  • MaxResults – Number (integer), not less than 1 or more than 200.

    The maximum number of usage profiles to return in a single response.

Response
  • Profiles – An array of UsageProfileDefinition objects.

    A list of usage profile (UsageProfileDefinition) objects.

  • NextToken – UTF-8 string, not more than 400000 bytes long.

    A continuation token, present if the current list segment is not the last.

Errors
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

  • OperationNotSupportedException