create_gui_session_access_details

Lightsail.Client.create_gui_session_access_details(**kwargs)

Creates two URLs that are used to access a virtual computer’s graphical user interface (GUI) session. The primary URL initiates a web-based NICE DCV session to the virtual computer's application. The secondary URL initiates a web-based NICE DCV session to the virtual computer's operating session.

Use StartGUISession to open the session.

See also: AWS API Documentation

Request Syntax

response = client.create_gui_session_access_details(
    resourceName='string'
)

Parameters

resourceName (string) --

[REQUIRED]

The resource name.

Return type

dict

Returns

Response Syntax

{
    'resourceName': 'string',
    'status': 'startExpired'|'notStarted'|'started'|'starting'|'stopped'|'stopping'|'settingUpInstance'|'failedInstanceCreation'|'failedStartingGUISession'|'failedStoppingGUISession',
    'percentageComplete': 123,
    'failureReason': 'string',
    'sessions': [
        {
            'name': 'string',
            'url': 'string',
            'isPrimary': True|False
        },
    ]
}

Response Structure

• (dict) --
  • resourceName (string) --

    The resource name.

  • status (string) --

    The status of the operation.

  • percentageComplete (integer) --

    The percentage of completion for the operation.

  • failureReason (string) --

    The reason the operation failed.

  • sessions (list) --

    Returns information about the specified NICE DCV GUI session.

    • (dict) --

      Describes a web-based, remote graphical user interface (GUI), NICE DCV session. The session is used to access a virtual computer’s operating system or application.

      • name (string) --

        The session name.

      • url (string) --

        The session URL.

      • isPrimary (boolean) --

        When true, this Boolean value indicates the primary session for the specified resource.

Exceptions

• Lightsail.Client.exceptions.AccessDeniedException
• Lightsail.Client.exceptions.InvalidInputException
• Lightsail.Client.exceptions.NotFoundException
• Lightsail.Client.exceptions.ServiceException
• Lightsail.Client.exceptions.UnauthenticatedException