Remote Rendering - Update Session

Service:

Mixed Reality

Version d'API:

2021-01-01

Mises à jour la durée maximale du bail d’une session de rendu particulière.

PATCH {endpoint}/accounts/{account_id}/sessions/{session_id}?api-version=2021-01-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
account_id	path	True	string uuid	ID de compte Azure Remote Rendering.
endpoint	path	True	string	Point de terminaison à utiliser, par exemple https://remoterendering.eastus.mixedreality.azure.com. Vous trouverez une liste à l’adresse https://docs.microsoft.com/azure/remote-rendering/reference/regions.
session_id	path	True	string	ID identifiant de manière unique la session de rendu pour le compte donné. L’ID respecte la casse, peut contenir n’importe quelle combinaison de caractères alphanumériques, y compris des traits d’union et des traits de soulignement, et ne peut pas contenir plus de 256 caractères.
api-version	query	True	string	Version de l’API à utiliser avec la requête HTTP.

En-tête de la demande

Nom	Obligatoire	Type	Description
Authorization	True	string	Jeton du porteur retourné par le service de jeton sécurisé Mixed Reality. Pour plus d'informations, consultez https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens.

Corps de la demande

Nom	Obligatoire	Type	Description
maxLeaseTimeMinutes	True	integer	Mettez à jour l’heure à laquelle la session s’exécute une fois qu’elle a atteint l’état « Prêt ». Elle doit être supérieure à la valeur actuelle de maxLeaseTimeMinutes et inférieure à 1440.

Réponses

Nom	Type	Description
200 OK	session_properties	OK. La session a été mise à jour.
401 Unauthorized		Non autorisé. Autorisation manquante ou non valide. En-têtes MS-CV: string WWW-Authenticate: string
403 Forbidden		Interdit. Autorisation insuffisante pour une ressource donnée. En-têtes MS-CV: string
404 Not Found		Introuvable. Il n’existe aucune session avec l’ID de session fourni. En-têtes MS-CV: string
422 Unprocessable Entity	error_response	Entité non traité. La valeur maxLeaseTimeMinutes n’était pas valide. Elle doit être supérieure à la valeur actuelle de maxLeaseTimeMinutes. En-têtes MS-CV: string
429 Too Many Requests		Trop de demandes. La limite de débit a été dépassée. Réessayez la demande après la durée indiquée dans l’en-tête Retry-After. En-têtes MS-CV: string Retry-After: integer
500 Internal Server Error	error_response	Erreur interne. Le serveur a rencontré une erreur interne. La nouvelle tentative de la demande peut produire des résultats réussis. En-têtes MS-CV: string

Sécurité

Authorization

Jeton du porteur retourné par le service de jeton sécurisé Mixed Reality. Pour plus d'informations, consultez https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens.

Type: apiKey
Dans: header

Exemples

Update a session

Exemple de requête

HTTP

PATCH https://remoterendering.eastus.mixedreality.azure.com/accounts/30ea64bd-100f-4bf0-adc9-29fa45d4880c/sessions/contoso-session-c2b8ac1d-9494-4852-a59c-8c28813adc28?api-version=2021-01-01

{
  "maxLeaseTimeMinutes": 72
}

Exemple de réponse

Code d’état:

200

MS-CV: dKEFmka2kkSlDmp/af+sOw

{
  "id": "contoso-session-c2b8ac1d-9494-4852-a59c-8c28813adc28",
  "creationTime": "2020-11-11T11:11:11.111Z",
  "arrInspectorPort": 50052,
  "handshakePort": 50051,
  "elapsedTimeMinutes": 10,
  "hostname": "d4cefb7b-10b9-4631-934d-67445ffa9126.remoterenderingvm.westus2.mixedreality.azure.com",
  "maxLeaseTimeMinutes": 72,
  "size": "Standard",
  "status": "Ready",
  "error": null,
  "teraflops": 10.6
}

Code d’état:

401

WWW-Authenticate: Bearer error="invalid_token"
MS-CV: dKEFmka2kkSlDmp/af+sOw

Code d’état:

403

MS-CV: dKEFmka2kkSlDmp/af+sOw

Code d’état:

404

MS-CV: dKEFmka2kkSlDmp/af+sOw

Code d’état:

422

MS-CV: dKEFmka2kkSlDmp/af+sOw

{
  "error": {
    "code": "UnprocessableEntity",
    "message": "The request was malformed."
  }
}

Code d’état:

429

Retry-After: 15
MS-CV: dKEFmka2kkSlDmp/af+sOw

Code d’état:

500

MS-CV: dKEFmka2kkSlDmp/af+sOw

{
  "error": {
    "code": "InternalServerError",
    "message": "An internal server error occurred."
  }
}

Définitions

Nom	Description
error	Objet d’erreur contenant les détails de la raison de l’échec de la demande.
error_response	Réponse d’erreur contenant les détails de l’échec de la demande.
session_properties	Propriétés d’une session de rendu.
session_size	Taille du serveur utilisé pour la session de rendu. La taille a un impact sur le nombre de polygones que le serveur peut afficher. Consultez https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes pour plus d'informations.
session_status	Status de la session de rendu. Les états de terminal sont « Erreur », « Expiré » et « Arrêté ».
update_session_settings	Paramètres utilisés pour mettre à jour la session.

error

Objet d’erreur contenant les détails de la raison de l’échec de la demande.

Nom	Type	Description
code	string	Code d’erreur.
details	error[]	Tableau de détails sur les erreurs spécifiques qui ont conduit à cette erreur signalée.
innerError	error	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Représentation lisible par l’homme de l’erreur.
target	string	Cible de l’erreur particulière (par exemple, le nom de la propriété dans l’erreur).

error_response

Réponse d’erreur contenant les détails de l’échec de la demande.

Nom	Type	Description
error	error	Objet d’erreur contenant les détails de la raison de l’échec de la demande.

session_properties

Propriétés d’une session de rendu.

Nom	Type	Description
arrInspectorPort	integer	Port TCP sur lequel l’outil Azure Remote Rendering Inspector est hébergé.
creationTime	string	Heure à laquelle la session de rendu a été créée. Date et heure au format ISO 8601.
elapsedTimeMinutes	integer	Durée en minutes pendant laquelle la session est ou était à l’état « Prêt ». Le temps est arrondi à une minute entière.
error	error	Objet d’erreur contenant des détails sur l’échec de démarrage de la session de rendu.
handshakePort	integer	Port TCP utilisé pour l’établissement d’une connexion.
hostname	string	Nom d’hôte sous lequel la session de rendu est accessible.
id	string	ID de la session fournie lors de la création de la session.
maxLeaseTimeMinutes	integer	Durée en minutes de l’exécution de la session après avoir atteint l’état « Prêt ».
size	session_size	Taille du serveur utilisé pour la session de rendu. La taille a un impact sur le nombre de polygones que le serveur peut afficher. Consultez https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes pour plus d'informations.
status	session_status	Status de la session de rendu. Les états de terminal sont « Erreur », « Expiré » et « Arrêté ».
teraflops	number	Puissance de calcul du GPU de session de rendu mesurée en téraflops.

session_size

Taille du serveur utilisé pour la session de rendu. La taille a un impact sur le nombre de polygones que le serveur peut afficher. Consultez https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes pour plus d'informations.

Nom	Type	Description
Premium	string	Taille de session de rendu Premium.
Standard	string	Taille de session de rendu standard.

session_status

Status de la session de rendu. Les états de terminal sont « Erreur », « Expiré » et « Arrêté ».

Nom	Type	Description
Error	string	La session de rendu a rencontré une erreur et est inutilisable. Il s’agit d’un état terminal.
Expired	string	La session de rendu entre dans l’état « Expiré » lorsqu’elle a été à l’état « Prêt » plus longtemps que son bail. Il s’agit d’un état terminal.
Ready	string	La session de rendu est prête pour les connexions entrantes.
Starting	string	La session de rendu démarre, mais n’accepte pas encore les connexions entrantes.
Stopped	string	La session de rendu a été arrêtée avec l’opération « Arrêter la session ». Il s’agit d’un état terminal.

update_session_settings

Paramètres utilisés pour mettre à jour la session.

Nom	Type	Description
maxLeaseTimeMinutes	integer	Mettez à jour l’heure à laquelle la session s’exécute une fois qu’elle a atteint l’état « Prêt ». Elle doit être supérieure à la valeur actuelle de maxLeaseTimeMinutes et inférieure à 1440.