Compartir a través de


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

Parámetros de identificador URI

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.

Encabezado de la solicitud

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.

Respuestas

Nombre Tipo Description
200 OK

session_properties

Aceptar.

401 Unauthorized

No autorizado. Falta o no es válida la autorización.

Encabezados

  • MS-CV: string
  • WWW-Authenticate: string
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

  • MS-CV: string
  • Retry-After: integer
500 Internal Server Error

error_response

Error interno. El servidor ha encontrado un error interno. Volver a intentar la solicitud puede generar resultados correctos.

Encabezados

MS-CV: string

Seguridad

Authorization

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

Ejemplos

Get a previously created session by ID

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."
  }
}

Definiciones

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".

error

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

error

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).

error_response

Respuesta de error que contiene detalles de por qué se produjo un error en la solicitud.

Nombre Tipo Description
error

error

Objeto 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.

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

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

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.

status

session_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.

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.

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.

session_status

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.