Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
GetSessionConnectionData
Obtient les informations de connexion d'un utilisateur spécifique à une DCV session Amazon spécifique.
Paramètres de demande
SessionId
-
ID de la session pour laquelle les informations de connexion doivent être affichées.
Type : String
Obligatoire : oui
User
-
Nom de l'utilisateur pour lequel les informations de connexion doivent être affichées.
Type : String
Obligatoire : oui
Paramètres de réponse
Id
-
L'identifiant unique de la session.
Name
-
Le nom de la session.
Owner
-
Le propriétaire de la session.
Server
-
Informations sur le serveur sur lequel la session s'exécute. Cette structure de données inclut les paramètres de réponse imbriqués suivants :
Ip
-
Adresse IP de l'hôte DCV du serveur Amazon.
Hostname
-
Le nom d'hôte de l'hôte DCV du serveur Amazon.
Port
-
Port par lequel le DCV serveur Amazon communique avec les DCV clients Amazon.
Endpoints
-
Informations sur les points de terminaison DCV du serveur Amazon. Cette structure de données inclut les paramètres de réponse imbriqués suivants :
IpAddress
-
Adresse IP du point de terminaison du serveur.
Port
-
Port du point de terminaison du serveur.
Protocol
-
Protocole utilisé par le point de terminaison du serveur. Les valeurs possibles incluent :
-
HTTP
— Le point de terminaison utilise le protocole WebSocket (TCP). -
QUIC
— Le point de terminaison utilise le protocole QUIC (UDP).
-
WebUrlPath
-
Le URL chemin Web du point de terminaison du serveur. Disponible uniquement pour le HTTP protocole.
WebUrlPath
-
Le chemin d'accès au fichier de configuration du DCV serveur Amazon.
Tags
-
Les balises attribuées au serveur. Cette structure de données inclut les paramètres de réponse imbriqués suivants :
Key
-
Identification de balise.
Value
-
Valeur de balise.
Type
-
Type de session.
State
-
État actuel de la session. Les valeurs possibles sont :
-
CREATING
- le Broker est en train de créer la session. -
READY
- la session est prête à accepter les connexions des clients. -
DELETING
- la session est en cours de suppression. -
DELETED
- la session a été supprimée. -
UNKNOWN
- impossible de déterminer l'état de la session. Le courtier et l'agent peuvent ne pas être en mesure de communiquer.
-
CreationTime
-
Date et heure de création de la session.
LastDisconnectionTime
-
Date et heure de la dernière déconnexion du client.
NumOfConnections
-
Le nombre de connexions simultanées de l'utilisateur à la session.
ConnectionToken
-
Le jeton d'authentification utilisé pour se connecter à la session.
Informations supplémentaires
Les informations ainsi obtenues API peuvent être transmises à un DCV client Amazon afin de se connecter à la DCV session Amazon.
Dans le cas du client DCV Web Amazon, vous pouvez en créer un URL qui peut être ouvert dans le navigateur. Le format URL est le suivant :
https://
{Ip}
:{Port}{WebUrlPath}
?authToken={ConnectionToken}
#{SessionId}
.
Dans le cas du client DCV natif Amazon, vous pouvez créer un URL avec le dcv://
schéma. Lorsque le client DCV natif Amazon est installé, il s'enregistre auprès du système en tant que gestionnaire pour dcv://
URLs. Le format URL est le suivant :
dcv://
{Ip}
:{Port}{WebUrlPath}
?authToken={ConnectionToken}
#{SessionId}
.
Note
Si vous utilisez AmazonEC2, l'adresse IP doit être publique. Si votre configuration comporte des DCV hôtes Amazon derrière une passerelle, spécifiez l'adresse de la passerelle plutôt que celle renvoyée par le SessionConnectionData API.