本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用情况配置文件
使用情况配置文件 API 介绍与在 AWS Glue 中创建、更新或查看使用情况配置文件相关的数据类型和 API。
数据类型
ProfileConfiguration 结构
指定管理员在 AWS Glue 使用情况配置文件中配置的任务和会话值。
字段
-
SessionConfiguration– 键值对的映射数组。每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。
每个值都是一个 ConfigurationObject 对象。
配置 AWS Glue 会话参数的键值映射。
-
JobConfiguration– 键值对的映射数组。每个键是一个 UTF-8 字符串，不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。
每个值都是一个 ConfigurationObject 对象。
配置 AWS Glue 任务参数的键值映射。
ConfigurationObject 结构
指定管理员为 AWS Glue 使用情况配置文件中配置的每个任务或会话参数设置的值。
字段
-
DefaultValue– UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 Custom string pattern #31 匹配。参数的默认值。
-
AllowedValues– UTF-8 字符串数组。参数允许的值的列表。
-
MinValue– UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 Custom string pattern #31 匹配。参数允许的最小值。
-
MaxValue– UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节，与 Custom string pattern #31 匹配。参数允许的最大值。
UsageProfileDefinition 结构
描述 AWS Glue 使用情况配置文件。
字段
-
Name– UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。使用情况配置文件的名称。
-
Description– 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。使用情况配置文件的描述。
-
CreatedOn– 时间戳。使用情况配置文件创建的日期和时间。
-
LastModifiedOn– 时间戳。使用情况配置文件上次修改的日期和时间。
操作
CreateUsageProfile 操作（Python：create_usage_profile）
创建 AWS Glue 使用情况配置文件。
请求
-
Name– 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。使用情况配置文件的名称。
-
Description– 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。使用情况配置文件的描述。
-
Configuration– 必填：一个 ProfileConfiguration 对象。ProfileConfiguration对象，用于指定配置文件的任务和会话值。 -
Tags– 键值对的映射数组，不超过 50 对。每个键都是一个 UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。
每个值是一个 UTF-8 字符串，不超过 256 个字节。
应用于用使用情况配置文件的标签列表。
响应
-
Name– UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。创建的使用情况配置文件的名称。
错误
InvalidInputExceptionInternalServiceExceptionAlreadyExistsExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionOperationNotSupportedException
GetUsageProfile 操作（Python：get_usage_profile）
检索有关指定 AWS Glue 使用情况配置文件的信息。
请求
-
Name– 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。要检索的使用情况配置文件的名称。
响应
-
Name– UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。使用情况配置文件的名称。
-
Description– 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。使用情况配置文件的描述。
-
Configuration– 一个 ProfileConfiguration 对象。ProfileConfiguration对象，用于指定配置文件的任务和会话值。 -
CreatedOn– 时间戳。使用情况配置文件创建的日期和时间。
-
LastModifiedOn– 时间戳。使用情况配置文件上次修改的日期和时间。
错误
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionOperationNotSupportedException
UpdateUsageProfile 操作（Python：update_usage_profile）
更新 AWS Glue 使用情况配置文件。
请求
-
Name– 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。使用情况配置文件的名称。
-
Description– 描述字符串，长度不超过 2048 个字节，与 URI address multi-line string pattern 匹配。使用情况配置文件的描述。
-
Configuration– 必填：一个 ProfileConfiguration 对象。ProfileConfiguration对象，用于指定配置文件的任务和会话值。
响应
-
Name– UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。已更新的使用情况配置文件的名称。
错误
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionOperationNotSupportedExceptionConcurrentModificationException
DeleteUsageProfile 操作（Python：delete_usage_profile）
删除 AWS Glue 指定使用情况配置文件。
请求
-
Name– 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。要删除的使用情况配置文件的名称。
响应
无响应参数。
错误
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionOperationNotSupportedException
ListUsageProfiles 操作（Python：list_usage_profile）
列出所有 AWS Glue 使用情况配置文件。
请求
-
NextToken– UTF-8 字符串，长度不超过 400000 个字节。延续标记 (如果这是延续调用，则包括)。
-
MaxResults– 数字（整数），不小于 1 或大于 200。要在单个响应中返回的使用情况配置文件的最大数量。
响应
-
Profiles– UsageProfileDefinition 对象的数组。使用情况配置文件 (
UsageProfileDefinition) 对象的列表。 -
NextToken– UTF-8 字符串，长度不超过 400000 个字节。延续令牌 (如果当前列表片段不是最后一个，则呈现)。
错误
InternalServiceExceptionOperationTimeoutExceptionInvalidInputExceptionOperationNotSupportedException
