# 사용 프로필
<a name="aws-glue-api-usage-profiles"></a>

사용 프로필 API는 AWS Glue에서의 사용 프로필 생성, 업데이트 또는 확인과 관련된 API 및 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-usage-profiles-objects"></a>
+ [ProfileConfiguration 구조](#aws-glue-api-usage-profiles-ProfileConfiguration)
+ [ConfigurationObject 구조](#aws-glue-api-usage-profiles-ConfigurationObject)
+ [UsageProfileDefinition 구조](#aws-glue-api-usage-profiles-UsageProfileDefinition)

## ProfileConfiguration 구조
<a name="aws-glue-api-usage-profiles-ProfileConfiguration"></a>

관리자가 AWS Glue 사용 프로필에서 구성하는 작업 및 세션 값을 지정합니다.

**필드**
+ `SessionConfiguration` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [ConfigurationObject](#aws-glue-api-usage-profiles-ConfigurationObject) 객체입니다.

  AWS Glue 세션에 대한 구성 파라미터의 키 값 맵.
+ `JobConfiguration` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [ConfigurationObject](#aws-glue-api-usage-profiles-ConfigurationObject) 객체입니다.

  AWS Glue 작업에 대한 구성 파라미터의 키 값 맵.

## ConfigurationObject 구조
<a name="aws-glue-api-usage-profiles-ConfigurationObject"></a>

관리자가 AWS Glue 사용 프로필에 구성된 각 작업 또는 세션 파라미터에 대해 설정하는 값을 지정합니다.

**필드**
+ `DefaultValue` – [Custom string pattern #35](aws-glue-api-common.md#regex_35)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  파라미터의 기본값.
+ `AllowedValues` – UTF-8 문자열의 배열입니다.

  파라미터에 허용되는 값 목록.
+ `MinValue` – [Custom string pattern #35](aws-glue-api-common.md#regex_35)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  파라미터에 허용되는 최솟값.
+ `MaxValue` – [Custom string pattern #35](aws-glue-api-common.md#regex_35)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  파라미터에 허용되는 최댓값.

## UsageProfileDefinition 구조
<a name="aws-glue-api-usage-profiles-UsageProfileDefinition"></a>

AWS Glue 사용 프로필을 설명합니다.

**필드**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용 프로필의 이름.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  사용 프로필에 대한 설명.
+ `CreatedOn` – 타임스탬프입니다.

  사용 프로필을 생성한 날짜와 시간.
+ `LastModifiedOn` – 타임스탬프입니다.

  사용 프로필을 마지막으로 수정한 날짜 및 시간.

## 운영
<a name="aws-glue-api-usage-profiles-actions"></a>
+ [CreateUsageProfile 작업(Python: create\$1usage\$1profile)](#aws-glue-api-usage-profiles-CreateUsageProfile)
+ [GetUsageProfile 작업(Python: get\$1usage\$1profile)](#aws-glue-api-usage-profiles-GetUsageProfile)
+ [UpdateUsageProfile 작업(Python: update\$1usage\$1profile)](#aws-glue-api-usage-profiles-UpdateUsageProfile)
+ [DeleteUsageProfile 작업(Python: delete\$1usage\$1profile)](#aws-glue-api-usage-profiles-DeleteUsageProfile)
+ [ListUsageProfiles 작업(Python: list\$1usage\$1profiles)](#aws-glue-api-usage-profiles-ListUsageProfiles)

## CreateUsageProfile 작업(Python: create\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-CreateUsageProfile"></a>

AWS Glue 사용 프로필을 생성합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용 프로필의 이름.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  사용 프로필에 대한 설명.
+ `Configuration` – **필수(Required): [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration) 객체입니다.

  프로필의 작업 및 세션 값을 지정하는 `ProfileConfiguration` 객체.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

  사용 프로필에 적용된 태그 목록.

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  생성한 사용 프로필의 이름.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `AlreadyExistsException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `OperationNotSupportedException`

## GetUsageProfile 작업(Python: get\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-GetUsageProfile"></a>

지정된 AWS Glue 사용 프로필에 대한 정보를 검색합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  검색할 사용 프로필의 이름.

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용 프로필의 이름.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  사용 프로필에 대한 설명.
+ `Configuration` – [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration) 객체입니다.

  프로필의 작업 및 세션 값을 지정하는 `ProfileConfiguration` 객체.
+ `CreatedOn` – 타임스탬프입니다.

  사용 프로필을 생성한 날짜와 시간.
+ `LastModifiedOn` – 타임스탬프입니다.

  사용 프로필을 마지막으로 수정한 날짜 및 시간.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `OperationNotSupportedException`

## UpdateUsageProfile 작업(Python: update\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-UpdateUsageProfile"></a>

AWS Glue 사용 프로필을 업데이트합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용 프로필의 이름.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  사용 프로필에 대한 설명.
+ `Configuration` – **필수(Required): [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration) 객체입니다.

  프로필의 작업 및 세션 값을 지정하는 `ProfileConfiguration` 객체.

**응답**
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트한 사용 프로필의 이름.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `OperationNotSupportedException`
+ `ConcurrentModificationException`

## DeleteUsageProfile 작업(Python: delete\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-DeleteUsageProfile"></a>

지정된 AWS Glue 사용 프로필을 삭제합니다.

**요청**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제할 사용 프로필의 이름.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `OperationNotSupportedException`

## ListUsageProfiles 작업(Python: list\$1usage\$1profiles)
<a name="aws-glue-api-usage-profiles-ListUsageProfiles"></a>

모든 AWS Glue 사용 프로필을 나열합니다.

**요청**
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `MaxResults` - 1 이상 200 이하의 숫자(정수)입니다.

  한 번의 응답으로 반환할 최대 사용 프로필 수.

**응답**
+ `Profiles` – [UsageProfileDefinition](#aws-glue-api-usage-profiles-UsageProfileDefinition) 객체의 배열입니다.

  사용 프로필(`UsageProfileDefinition`) 객체 목록.
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  현재 목록 부분이 유지가 되지 않으면 연속 토큰이 존재합니다.

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `OperationNotSupportedException`