Remote Rendering - Get Session
Obtiene las propiedades de una sesión de representación determinada.
GET {endpoint}/accounts/{account_id}/sessions/{session_id}?api-version=2021-01-01
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account_id
|
path | True |
string uuid |
Identificador de la cuenta de Azure Remote Rendering. |
endpoint
|
path | True |
string |
Punto de conexión que se va a usar, por ejemplo, https://remoterendering.eastus.mixedreality.azure.com. Puede encontrar una lista en https://docs.microsoft.com/azure/remote-rendering/reference/regions. |
session_id
|
path | True |
string |
Identificador que identifica de forma única la sesión de representación de la cuenta especificada. El identificador distingue mayúsculas de minúsculas, puede contener cualquier combinación de caracteres alfanuméricos, incluidos guiones y caracteres de subrayado, y no puede contener más de 256 caracteres. |
api-version
|
query | True |
string |
Versión de la API que se va a usar con la solicitud HTTP. |
Nombre | Requerido | Tipo | Description |
---|---|---|---|
Authorization | True |
string |
Token de portador devuelto por el servicio de token seguro de Mixed Reality. Para obtener información detallada, vea https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens. |
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar. |
|
401 Unauthorized |
No autorizado. Falta o no es válida la autorización. Encabezados
|
|
403 Forbidden |
Prohibido. Autorización insuficiente para un recurso determinado. Encabezados MS-CV: string |
|
404 Not Found |
Not found. No existe ninguna sesión con el identificador de sesión proporcionado. Encabezados MS-CV: string |
|
429 Too Many Requests |
Demasiadas solicitudes Se ha superado el límite de frecuencia. Vuelva a intentar la solicitud después de la duración especificada en el encabezado Retry-After. Encabezados
|
|
500 Internal Server Error |
Error interno. El servidor ha encontrado un error interno. Volver a intentar la solicitud puede generar resultados correctos. Encabezados MS-CV: string |
Token de portador devuelto por el servicio de token seguro de Mixed Reality. Para obtener información detallada, vea https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens.
Tipo:
apiKey
En:
header
Solicitud de ejemplo
GET 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
Respuesta de muestra
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": 60,
"size": "Standard",
"status": "Ready",
"error": null,
"teraflops": 10.6
}
WWW-Authenticate: Bearer error="invalid_token"
MS-CV: dKEFmka2kkSlDmp/af+sOw
MS-CV: dKEFmka2kkSlDmp/af+sOw
MS-CV: dKEFmka2kkSlDmp/af+sOw
Retry-After: 15
MS-CV: dKEFmka2kkSlDmp/af+sOw
MS-CV: dKEFmka2kkSlDmp/af+sOw
{
"error": {
"code": "InternalServerError",
"message": "An internal server error occurred."
}
}
Nombre | Description |
---|---|
error |
Objeto de error que contiene detalles de por qué se produjo un error en la solicitud. |
error_response |
Respuesta de error que contiene detalles de por qué se produjo un error en la solicitud. |
session_properties |
Propiedades de una sesión de representación. |
session_size |
Tamaño del servidor utilizado para la sesión de representación. El tamaño afecta al número de polígonos que el servidor puede representar. Vea https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes para obtener más información. |
session_status |
Estado de la sesión de representación. Los estados terminales son "Error", "Expirado" y "Detenido". |
Objeto de error que contiene detalles de por qué se produjo un error en la solicitud.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error. |
details |
error[] |
Matriz de detalles sobre errores específicos que llevaron a este error notificado. |
innerError |
Objeto que contiene información más específica que el objeto actual sobre el error. |
|
message |
string |
Representación legible del error. |
target |
string |
Destino del error concreto (por ejemplo, el nombre de la propiedad en error). |
Respuesta de error que contiene detalles de por qué se produjo un error en la solicitud.
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error que contiene detalles de por qué se produjo un error en la solicitud. |
Propiedades de una sesión de representación.
Nombre | Tipo | Description |
---|---|---|
arrInspectorPort |
integer |
Puerto TCP en el que se hospeda la herramienta Azure Remote Rendering Inspector. |
creationTime |
string |
Hora a la que se creó la sesión de representación. Fecha y hora en formato ISO 8601. |
elapsedTimeMinutes |
integer |
Cantidad de tiempo en minutos en que la sesión está o estaba en estado "Listo". El tiempo se redondea a un minuto completo. |
error |
Objeto de error que contiene detalles sobre el error de inicio de la sesión de representación. |
|
handshakePort |
integer |
Puerto TCP utilizado para el protocolo de enlace al establecer una conexión. |
hostname |
string |
Nombre de host en el que se puede acceder a la sesión de representación. |
id |
string |
Identificador de la sesión proporcionada cuando se creó la sesión. |
maxLeaseTimeMinutes |
integer |
El tiempo en minutos que se ejecutará la sesión después de alcanzar el estado "Listo". |
size |
Tamaño del servidor utilizado para la sesión de representación. El tamaño afecta al número de polígonos que el servidor puede representar. Vea https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes para obtener más información. |
|
status |
Estado de la sesión de representación. Los estados terminales son "Error", "Expirado" y "Detenido". |
|
teraflops |
number |
Potencia computacional de la GPU de la sesión de representación medida en teraflops. |
Tamaño del servidor utilizado para la sesión de representación. El tamaño afecta al número de polígonos que el servidor puede representar. Vea https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes para obtener más información.
Nombre | Tipo | Description |
---|---|---|
Premium |
string |
Tamaño de sesión de representación Premium. |
Standard |
string |
Tamaño de sesión de representación estándar. |
Estado de la sesión de representación. Los estados terminales son "Error", "Expirado" y "Detenido".
Nombre | Tipo | Description |
---|---|---|
Error |
string |
La sesión de representación ha encontrado un error y no se puede usar. Se trata de un estado terminal. |
Expired |
string |
La sesión de representación entra en el estado "Expirado" cuando ha estado en el estado "Listo" durante más tiempo que su tiempo de concesión. Se trata de un estado terminal. |
Ready |
string |
La sesión de representación está lista para las conexiones entrantes. |
Starting |
string |
La sesión de representación se está iniciando, pero aún no acepta conexiones entrantes. |
Stopped |
string |
La sesión de representación se ha detenido con la operación "Detener sesión". Se trata de un estado terminal. |