기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# WorkSpaces 애플리케이션에 대한 앱 권한 관리를 위한 API 작업
<a name="manage-app-entitlement-api-actions"></a>

다음 API 작업을 사용하여 WorkSpaces 애플리케이션에 대한 애플리케이션 권한을 관리할 수 있습니다.

## `AddApplicationsRequest` 작업
<a name="manage-app-entitlement-api-addapplications-request"></a>

WorkSpaces 애플리케이션 사용자의 애플리케이션 카탈로그에 애플리케이션을 추가합니다. WorkSpaces 애플리케이션에서 표시하는 애플리케이션 카탈로그에는이 API 작업을 사용하여 추가하는 애플리케이션과 이미지에 추가하는 애플리케이션이 포함됩니다. 이 두 가지 방법 중 하나 또는 둘 다를 사용해 애플리케이션을 추가하였으면 이제 사용자가 애플리케이션을 시작할 수 있습니다.

**요청 구문**

*string userSid;*

`list<Application> applications;`

**요청 파라미터**

***userSid***  
요청이 적용되는 사용자의 SID입니다.  
**유형**: 문자열  
**필수 항목 여부:** 예  
**길이 제한:** 최소 길이 1자, 최대 길이 208자

***애플리케이션***  
요청이 적용되는 애플리케이션 목록입니다.  
**유형**: 문자열  
**필수 항목 여부:** 예

## `Application` 객체
<a name="manage-app-entitlement-api-application-object"></a>

애플리케이션을 표시하고 시작하는 데 필요한 애플리케이션 메타데이터에 대해서 설명합니다. 애플리케이션 식별자는 고유해야 하며, API 작업이나 이미지를 통해 지정하는 다른 애플리케이션과 충돌을 일으켜서도 안 됩니다.

***id***  
지정되는 애플리케이션의 식별자입니다. WorkSpaces 애플리케이션 보고서의 `application_name` 값에 해당하는이 값은 사용자가 애플리케이션을 시작할 때 제공됩니다. [사용 보고서를](enable-usage-reports.md) 활성화하면 사용자가 스트리밍 세션 중에 애플리케이션을 하나 이상 시작하는 날마다 WorkSpaces 애플리케이션은 애플리케이션 보고서를 Amazon S3 버킷으로 내보냅니다. 애플리케이션 보고서에 대한 자세한 내용은 [애플리케이션 보고서 필드](usage-reports-fields-applications-reports.md) 단원을 참조하십시오.  
**유형**: 문자열  
**필수 항목 여부:** 예  
**길이 제한:** 최소 길이 1자, 최대 길이 512자

***displayName***  
지정되는 애플리케이션의 표시 이름입니다. 이 이름은 애플리케이션 카탈로그의 사용자에게 표시됩니다.  
**유형**: 문자열  
**필수 항목 여부:** 예  
**길이 제한:** 최소 길이 1자, 최대 길이 512자

***launchPath***  
시작할 애플리케이션의 실행 파일에 대한 Windows 파일 시스템 경로입니다.  
**유형**: 문자열  
**필수 항목 여부:** 예  
**길이 제한:** 최소 길이 1자, 최대 길이 32,767자

***iconData***  
애플리케이션 카탈로그에 표시할 base-64 인코딩 이미지입니다. 이 이미지의 형식은 .png, .jpeg 또는 .jpg 중 하나가 되어야 합니다.  
**유형**: 문자열  
**필수 항목 여부:** 예  
**길이 제한:** 최소 길이 1자, 최대 길이 1,000,000자

***launchParams***  
애플리케이션을 시작할 때 사용되는 파라미터입니다.  
**유형**: 문자열  
**필수 항목 여부**: 아니요  
**길이 제한:** 최대 32,000자

***workingDirectory***  
애플리케이션이 시작되어야 하는 작업 디렉터리에 대한 Windows 파일 시스템 경로입니다.  
**유형**: 문자열  
**필수 항목 여부**: 아니요  
**길이 제한:** 최대 32,767자

## `RemoveApplicationsRequest` 작업
<a name="manage-app-entitlement-api-removeapplications-request"></a>

`AddApplicationsRequest` 작업을 사용해 추가되었던 애플리케이션을 제거합니다. 애플리케이션이 사용자의 애플리케이션 카탈로그에서 제거됩니다. 제거된 애플리케이션은 시작할 수 없습니다. 애플리케이션이 여전히 실행 중인 경우 WorkSpaces 애플리케이션은 애플리케이션을 닫지 않습니다. WorkSpaces 애플리케이션 이미지에 직접 지정된 애플리케이션은 제거할 수 없습니다.

**요청 구문**

*string userSid;*

`list<Application> applications;`

**요청 파라미터**

***userSid***  
요청이 적용되는 사용자의 SID입니다.  
**유형**: 문자열  
**필수 항목 여부:** 예  
**길이 제한:** 최소 길이 1자, 최대 길이 208자

***애플리케이션***  
요청이 적용되는 애플리케이션 목록입니다.  
**유형**: 문자열  
**필수 항목 여부:** 예

## `ClearApplicationsRequest` 작업
<a name="manage-app-entitlement-api-clearapplications-request"></a>

`AddApplicationsRequest` 작업을 사용해 애플리케이션 카탈로그에 추가되었던 애플리케이션을 모두 제거합니다. 제거된 애플리케이션은 시작할 수 없습니다. `ClearApplicationsRequest` 작업을 사용할 때 애플리케이션이 실행 중인 경우 WorkSpaces 애플리케이션은 애플리케이션을 닫지 않습니다. WorkSpaces 애플리케이션 이미지에 직접 지정된 애플리케이션은 제거할 수 없습니다.

**요청 구문**

*string userSid;*

**요청 파라미터**

***userSid***  
요청이 적용되는 사용자의 SID입니다.  
**유형**: 문자열  
**필수 항목 여부:** 예  
**길이 제한:** 최소 길이 1자, 최대 길이 208자