View a markdown version of this page

DescribeSessions - Gestore di sessioni Amazon DCV
Parametri della richiestaParametri di rispostaEsempio

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

DescribeSessions

Descrive una o più sessioni Amazon DCV.

Parametri della richiesta

SessionIds

Le IDs sessioni da descrivere.

▬Tipo: stringa

Obbligatorio: no

NextToken

Il token da utilizzare per recuperare la pagina successiva dei risultati.

▬Tipo: stringa

Obbligatorio: no

Filters

Filtri aggiuntivi da applicare alla richiesta. I filtri supportati includono:

  • tag:key: i tag assegnati alla sessione.

  • Proprietario: il proprietario della sessione.

▬Tipo: stringa

Obbligatorio: no

Parametri di risposta

Id

L'ID univoco della sessione.

Name

Il nome della sessione.

Owner

Il proprietario della sessione.

Server

Informazioni sul server su cui è in esecuzione la sessione. Questa struttura di dati include i seguenti parametri di risposta annidati:

Ip

L'indirizzo IP dell'host del server Amazon DCV.

Hostname

Il nome host dell'host del server Amazon DCV.

Port

La porta tramite la quale il server Amazon DCV comunica con i client Amazon DCV.

Endpoints

Informazioni sugli endpoint del server Amazon DCV. Questa struttura di dati include i seguenti parametri di risposta annidati:

IpAddress

L'indirizzo IP dell'endpoint del server.

Port

La porta dell'endpoint del server.

Protocol

Il protocollo utilizzato dall'endpoint del server. I valori possibili includono:

  • HTTP— L'endpoint utilizza il protocollo WebSocket (TCP).

  • QUIC— L'endpoint utilizza il protocollo QUIC (UDP).

WebUrlPath

Il percorso dell'URL Web dell'endpoint del server. Disponibile solo per il protocollo HTTP.

Tags

I tag assegnati al server. Questa struttura di dati include i seguenti parametri di risposta annidati:

Key

La chiave di tag:

Value

Il valore del tag.

Type

Il tipo di sessione.

State

Lo stato corrente della sessione. I valori possibili sono:

  • CREATING- il Broker sta creando la sessione.

  • READY- la sessione è pronta per accettare le connessioni client.

  • DELETING- la sessione viene eliminata.

  • DELETED- la sessione è stata eliminata.

  • UNKNOWN- impossibile determinare lo stato della sessione. Il Broker e l'Agente potrebbero non essere in grado di comunicare.

Substate

Il sottostato corrente della sessione. I valori possibili sono:

  • SESSION_PLACING- la sessione è in attesa di essere inserita su un server DCV disponibile.

  • PENDING_PREPARATION- la sessione è stata creata ma non è utilizzabile; è collegata a un server DCV.

CreationTime

La data e l'ora di creazione della sessione.

LastDisconnectionTime

La data e l'ora dell'ultima disconnessione del client.

NumOfConnections

Il numero di connessioni client attive.

StorageRoot

Specifica il percorso della cartella usato per lo storage della sessione. Per ulteriori informazioni sullo storage delle sessioni di Amazon DCV, consulta Enabling Session Storage nella Amazon DCV Administrator Guide.

▬Tipo: stringa

Obbligatorio: no

Esempio

Python
Richiesta

L'esempio seguente descrive le sessioni di proprietà di user1 e con un tag di. os=windows

from swagger_client.models.describe_sessions_request_data import DescribeSessionsRequestData
from swagger_client.models.key_value_pair import KeyValuePair

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 describe_sessions(session_ids=None, next_token=None, tags=None, owner=None):
    filters = list()
    if tags:
        for tag in tags:
            filter_key_value_pair = KeyValuePair(key='tag:' + tag['Key'], value=tag['Value'])
            filters.append(filter_key_value_pair)
    if owner:
        filter_key_value_pair = KeyValuePair(key='owner', value=owner)
        filters.append(filter_key_value_pair)

    request = DescribeSessionsRequestData(session_ids=session_ids, filters=filters, next_token=next_token)
    print('Describe Sessions Request:', request)
    api_instance = get_sessions_api()
    api_response = api_instance.describe_sessions(body=request)
    print('Describe Sessions Response', api_response)

def main():
    describe_sessions(
        owner='user1',
        tags=[{'Key': 'os', 'Value': 'windows'}])
Risposta

Di seguito è riportato l'output di esempio.

{
    "Sessions": [
        {
            "Id": "SessionId1897",
            "Name": "a session name",
            "Owner": "an owner 1890",
            "Server": {
                "Ip": "1.1.1.123",
                "Hostname": "server hostname",
                "Port": "1222",
                "Endpoints": [
                    {
                        "IpAddress": "x.x.x.x",
                        "Port": 8443,
                        "WebUrlPath": "/",
                        "Protocol": "HTTP"
                    },
                    {
                        "IpAddress": "x.x.x.x",
                        "Port": 9443,
                        "WebUrlPath": "/",
                        "Protocol": "HTTP"
                    },
                    {
                        "IpAddress": "x.x.x.x",
                        "Port": 8443,
                        "WebUrlPath": "",
                        "Protocol": "QUIC"
                    }
                ],
                "Tags": [
                    {
                        "Key": "os",
                        "Value": "windows"
                    },
                    {
                        "Key": "ram",
                        "Value": "4gb"
                    }
                ]
            },
            "Type": "VIRTUAL",
            "State": "READY",
            "CreationTime": "2020-10-06T10:15:31.633Z",
            "LastDisconnectionTime": "2020-10-06T10:15:31.633Z",
            "NumOfConnections": 2,
            "StorageRoot" : "/storage/root"
        },
        {
            "Id": "SessionId1895",
            "Name": "a session name",
            "Owner": "an owner 1890",
            "Server": {
                "Ip": "1.1.1.123",
                "Hostname": "server hostname",
                "Port": "1222",
                "Endpoints": [
                    {
                        "IpAddress": "x.x.x.x",
                        "Port": 8443,
                        "WebUrlPath": "/",
                        "Protocol": "HTTP"
                    },
                    {
                        "IpAddress": "x.x.x.x",
                        "Port": 9443,
                        "WebUrlPath": "/",
                        "Protocol": "HTTP"
                    },
                    {
                        "IpAddress": "x.x.x.x",
                        "Port": 8443,
                        "WebUrlPath": "",
                        "Protocol": "QUIC"
                    }
                ],
                "Tags": [
                    {
                        "Key": "os",
                        "Value": "windows"
                    },
                    {
                        "Key": "ram",
                        "Value": "4gb"
                    }
                ]
            },
            "Type": "VIRTUAL",
            "State": "DELETING",
            "CreationTime": "2020-10-06T10:15:31.633Z",
            "LastDisconnectionTime": "2020-10-06T10:15:31.633Z",
            "NumOfConnections": 2,
            "StorageRoot" : "/storage/root"
        }
    ]
}