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.
**Topics**
+ [Parametri della richiesta](#request)
+ [Parametri di risposta](#response)
+ [Esempio](#example)
## 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](https://docs.aws.amazon.com/dcv/latest/adminguide/manage-storage.html) 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"
}
]
}
```
------