AppStream 2.0에 대한 앱 권한을 관리할 수 있는 API 작업 - Amazon AppStream 2.0

AppStream 2.0에 대한 앱 권한을 관리할 수 있는 API 작업

AppStream 2.0에 대한 애플리케이션 권한을 관리할 수 있는 API 작업은 다음과 같습니다.

AddApplicationsRequest 작업

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

요청 구문

string userSid;

list<Application> applications;

요청 파라미터

userSid

요청이 적용되는 사용자의 SID입니다.

유형: 문자열

필수 항목 여부: 예

길이 제한: 최소 길이 1자, 최대 길이 208자

애플리케이션

요청이 적용되는 애플리케이션 목록입니다.

유형: 문자열

필수 항목 여부: 예

Application 객체

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

id

지정되는 애플리케이션의 식별자입니다. 이 값은 AppStream 2.0 애플리케이션 보고서의 application_name 값에 해당하며, 사용자가 애플리케이션을 시작할 때 제공됩니다. 사용 보고서를 활성화하면 사용자가 스트리밍 세션 도중 애플리케이션을 하나 이상 시작하는 날마다 AppStream 2.0이 Amazon S3 버킷으로 애플리케이션 보고서를 내보냅니다. 애플리케이션 보고서에 대한 자세한 내용은 애플리케이션 보고서 필드 단원을 참조하십시오.

유형: 문자열

필수 항목 여부: 예

길이 제한: 최소 길이 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 작업

AddApplicationsRequest 작업을 사용해 추가되었던 애플리케이션을 제거합니다. 애플리케이션이 사용자의 애플리케이션 카탈로그에서 제거됩니다. 제거된 애플리케이션은 시작할 수 없습니다. 애플리케이션이 계속 실행되면 AppStream 2.0이 애플리케이션을 종료하지 않았기 때문입니다. AppStream 2.0 이미지에서 직접 지정한 애플리케이션은 제거할 수 없습니다.

요청 구문

string userSid;

list<Application> applications;

요청 파라미터

userSid

요청이 적용되는 사용자의 SID입니다.

유형: 문자열

필수 항목 여부: 예

길이 제한: 최소 길이 1자, 최대 길이 208자

애플리케이션

요청이 적용되는 애플리케이션 목록입니다.

유형: 문자열

필수 항목 여부: 예

ClearApplicationsRequest 작업

AddApplicationsRequest 작업을 사용해 애플리케이션 카탈로그에 추가되었던 애플리케이션을 모두 제거합니다. 제거된 애플리케이션은 시작할 수 없습니다. ClearApplicationsRequest 작업을 사용해도 애플리케이션이 계속 실행되면 AppStream 2.0이 애플리케이션을 종료하지 않았기 때문입니다. AppStream 2.0 이미지에서 직접 지정한 애플리케이션은 제거할 수 없습니다.

요청 구문

string userSid;

요청 파라미터

userSid

요청이 적용되는 사용자의 SID입니다.

유형: 문자열

필수 항목 여부: 예

길이 제한: 최소 길이 1자, 최대 길이 208자