CreateSessions

지정된 세부 정보로 새 Amazon DCV 세션을 생성합니다.

API 작업

요청 파라미터
응답 파라미터
예시

요청 파라미터

Name

세션의 이름입니다.

유형: 문자열

필수 항목 여부: 예

Owner

세션 소유자의 이름입니다. 이는 대상 Amazon DCV 서버의 기존 사용자 이름이어야 합니다.

유형: 문자열

필수 항목 여부: 예

Type

세션 유형입니다. 세션 유형에 대한 자세한 내용은 Amazon DCV 관리자 안내서의 Amazon DCV 세션 소개를 참조하세요.

유효한 값: CONSOLE | VIRTUAL

유형: 문자열

필수 항목 여부: 예

InitFile

Linux Amazon DCV 서버의 가상 세션에서 지원됩니다. Windows 및 Linux Amazon DCV 서버의 콘솔 세션에서는 지원되지 않습니다. 세션을 만들 때 세션을 초기화하기 위해 실행할 Amazon DCV 서버의 사용자 지정 스크립트 경로입니다. 파일 경로는 agent.init_folder 에이전트 구성 파라미터에 지정된 init 디렉터리를 기준으로 합니다. 지정된 init 디렉터리에 파일이 있는 경우 파일 이름만 지정하세요. 지정된 init 디렉터리에 파일이 없는 경우 상대 경로를 지정하세요. 자세한 내용은 Amazon DCV 세션 관리자 관리 안내서의 에이전트 구성 파일을 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

MaxConcurrents

동시에 접속할 수 있는 Amazon DCV 클라이언트의 최대 수입니다.

유형: 정수

필수 항목 여부: 아니요

DcvGlEnabled

가상 세션이 하드웨어 기반 OpenGL을 사용하도록 구성되었는지 여부를 나타냅니다. 가상 세션에서만 지원됩니다. 이 파라미터는 Windows Amazon DCV 서버에서는 지원되지 않습니다.

유효값: true/false

유형: 부울

필수 항목 여부: 아니요

PermissionsFile

권한 파일의 Base64로 인코딩된 내용입니다. 생략할 경우 서버 기본값이 기본 설정됩니다. 자세한 내용은 Amazon DCV 관리자 안내서의 Amazon DCV 권한 부여 구성을 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

EnqueueRequest

요청을 즉시 이행할 수 없는 경우 요청을 대기열에 넣을지 여부를 나타냅니다.

유형: 부울

기본값: false

필수 여부: 아니요

AutorunFile

Windows Amazon DCV 서버의 콘솔 세션과 Linux Amazon DCV 서버의 가상 세션에서 지원됩니다. Linux Amazon DCV 서버의 콘솔 세션에서는 지원되지 않습니다.

세션 내에서 실행될 호스트 서버의 파일 경로입니다. 파일 경로는 agent.autorun_folder 에이전트 구성 파라미터에 지정된 autorun 디렉터리를 기준으로 합니다. 지정된 autorun 디렉터리에 파일이 있는 경우 파일 이름만 지정하세요. 지정된 autorun 디렉터리에 파일이 없는 경우 상대 경로를 지정하세요. 자세한 내용은 Amazon DCV 세션 관리자 관리 안내서의 에이전트 구성 파일을 참조하세요.

파일은 지정된 소유자를 대신하여 실행됩니다. 지정된 소유자에게는 서버에서 파일을 실행할 수 있는 권한이 있어야 합니다. Windows Amazon DCV 서버에서는 소유자가 세션에 로그인할 때 파일이 실행됩니다. Linux Amazon DCV 서버에서는 세션이 생성될 때 파일이 실행됩니다.

유형: 문자열

필수 항목 여부: 아니요

AutorunFileArguments

Linux Amazon DCV 서버의 가상 세션에서 지원됩니다. Windows 및 Linux Amazon DCV 서버의 콘솔 세션에서는 지원되지 않습니다. 세션 내에서 실행될 때 AutoRunFile에 전달되는 명령줄 인수입니다. 인수는 지정된 배열에 나타나는 순서대로 전달됩니다. 허용되는 최대 인수 개수와 각 인수의 최대 허용 길이를 구성할 수 있습니다. 자세한 내용은 Amazon DCV 세션 관리자 관리 안내서의 브로커 구성 파일을 참조하세요.

유형: 문자열 배열

필수 여부: 아니요

DisableRetryOnFailure

어떤 이유로든 Amazon DCV 호스트에서 세션 생성 요청이 실패한 후 다시 시도하지 않을 것인지 여부를 나타냅니다. 세션 재시도 생성 메커니즘에 대한 자세한 내용은 Amazon DCV 세션 관리자 관리 안내서의 브로커 구성 파일을 참조하세요.

유형: 부울

기본값: false

필수 여부: 아니요

Requirements

세션을 배치하기 위해 서버가 충족해야 하는 요구 사항입니다. 요구 사항에는 서버 태그 및 서버 속성이 포함될 수 있으며, 서버 태그와 서버 속성은 모두 DescribeServers API를 직접적으로 호출하여 검색됩니다.

요구 사항 조건 표현식:

a != b - a와 b가 같지 않은 경우 true
a = b - a와 b가 같은 경우 true
a > b - a가 b보다 큰 경우 true
a >= b - a가 b보다 크거나 같은 경우 true
a < b - a가 b보다 작은 경우 true
a <= b - a가 b보다 작거나 같은 경우 true
a = b - a에 b가 포함된 경우 true

요구 사항 부울 연산자:

a and b - a와 b가 참인 경우 true
a or b - a 또는 b 가 참인 경우 true
not a - a가 거짓인 경우 true

태그 키에는 tag: 접두사를 붙이고 서버 속성에는 server: 접두사를 붙여야 합니다. 요구 사항 표현식에는 괄호(())가 지원됩니다.

요구 사항 예제:

tag:color = 'pink' and (server:Host.Os.Family = 'windows' or tag:color := 'red')
"server:Host.Aws.Ec2InstanceType := 't2' and server:Host.CpuInfo.NumberOfCpus >= 2"

지수 표기법을 사용하여 숫자 값을 지정할 수 있습니다(예: "server:Host.Memory.TotalBytes > 1024E6").

지원되는 서버 속성은 다음과 같습니다.

Id
Hostname
Version
SessionManagerAgentVersion
Host.Os.BuildNumber
Host.Os.Family
Host.Os.KernelVersion
Host.Os.Name
Host.Os.Version
Host.Memory.TotalBytes
Host.Memory.UsedBytes
Host.Swap.TotalBytes
Host.Swap.UsedBytes
Host.CpuLoadAverage.OneMinute
Host.CpuLoadAverage.FiveMinutes
Host.CpuLoadAverage.FifteenMinutes
Host.Aws.Ec2InstanceId
Host.Aws.Ec2InstanceType
Host.Aws.Region
Host.Aws.Ec2ImageId
Host.CpuInfo.Architecture
Host.CpuInfo.ModelName
Host.CpuInfo.NumberOfCpus
Host.CpuInfo.PhysicalCoresPerCpu
Host.CpuInfo.Vendor

유형: 문자열

필수 항목 여부: 아니요

StorageRoot

세션 스토리지에 사용되는 폴더 경로를 지정합니다. Amazon DCV 세션 스토리지에 대한 자세한 내용은 Amazon DCV 관리자 안내서의 세션 스토리지 활성화를 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

응답 파라미터

Id: 세션의 고유 ID입니다.
Name: 세션 이름
Owner: 세션 소유자입니다.
Type: 세션 유형입니다.
State: 세션의 상태입니다. 요청이 성공적으로 완료되면 세션이 CREATING 상태로 전환됩니다.
Substate: 세션의 하위 상태입니다. 요청이 성공적으로 완료되면 세션이 SESSION_PLACING 하위 상태로 전환됩니다.

예시

Python

요청

다음 예제에서는 세 개의 세션을 만듭니다.



from swagger_client.models.create_session_request_data import CreateSessionRequestData

def get_sessions_api():
    api_instance = swagger_client.SessionsApi(swagger_client.ApiClient(get_client_configuration()))
    set_request_headers(api_instance.api_client)
    return api_instance

def create_sessions(sessions_to_create):
    create_sessions_request = list()
    for name, owner, session_type, init_file_path, autorun_file, autorun_file_arguments, max_concurrent_clients,\
            dcv_gl_enabled, permissions_file, requirements, storage_root in sessions_to_create:
        a_request = CreateSessionRequestData(
            name=name, owner=owner, type=session_type,
            init_file_path=init_file_path, autorun_file=autorun_file, autorun_file_arguments=autorun_file_arguments, max_concurrent_clients=max_concurrent_clients,
            dcv_gl_enabled=dcv_gl_enabled, permissions_file=permissions_file, requirements=requirements, storage_root=storage_root)
        create_sessions_request.append(a_request)

    api_instance = get_sessions_api()
    print('Create Sessions Request:', create_sessions_request)
    api_response = api_instance.create_sessions(body=create_sessions_request)
    print('Create Sessions Response:', api_response)

def main():
    create_sessions([
    ('session1', 'user1', 'CONSOLE', None, None, None, 1, None, '/dcv/permissions.file', "tag:os = 'windows' and server:Host.Memory.TotalBytes > 1024", "/storage/root"),
    ('session2', 'user1', 'VIRTUAL', None, 'myapp.sh', None, 1, False, None, "tag:os = 'linux'", None),
    ('session3', 'user1', 'VIRTUAL', '/dcv/script.sh', 'myapp.sh', ['argument1', 'argument2'], 1, False, None, "tag:os = 'linux'", None),
])

응답

다음은 출력 샘플입니다.


{
              "RequestId": "e32d0b83-25f7-41e7-8c8b-e89326ecc87f",
    "SuccessfulList": [
    {
            "Id": "78b45deb-1163-46b1-879b-7d8fcbe9d9d6",
            "Name": "session1",
            "Owner": "user1",
            "Type": "CONSOLE",
            "State": "CREATING"
    },
    {
            "Id": " a0c743c4-9ff7-43ce-b13f-0c4d55a268dd",
            "Name": "session2",
            "Owner": "user1",
            "Type": "VIRTUAL",
            "State": "CREATING"
    },
    {
            "Id": " 10311636-df90-4cd1-bcf7-474e9675b7cd",
            "Name": "session3",
            "Owner": "user1",
            "Type": "VIRTUAL",
            "State": "CREATING"
    }
    ],
    "UnsuccessfulList": [
    ]
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

CloseServers

DescribeServers