다음을 통해 공유


Remote Rendering - List Sessions

모든 렌더링 세션의 목록을 가져옵니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
account_id
path True

string

uuid

Azure Remote Rendering 계정 ID입니다.

endpoint
path True

string

사용할 엔드포인트(예: )입니다. https://remoterendering.eastus.mixedreality.azure.com 목록은 에서 https://docs.microsoft.com/azure/remote-rendering/reference/regions찾을 수 있습니다.

api-version
query True

string

HTTP 요청과 함께 사용할 API 버전입니다.

요청 헤더

Name 필수 형식 Description
Authorization True

string

Mixed Reality 보안 토큰 서비스에서 반환된 전달자 토큰입니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens를 참조하세요.

응답

Name 형식 Description
200 OK

sessions_list

OK. '시작' 또는 '준비' 상태인 세션 목록을 반환합니다.

401 Unauthorized

권한이 없습니다. 권한 부여가 없거나 잘못되었습니다.

Headers

  • MS-CV: string
  • WWW-Authenticate: string
403 Forbidden

사용할 수 없습니다. 지정된 리소스에 대한 권한 부여가 부족합니다.

Headers

MS-CV: string

500 Internal Server Error

error_response

내부 오류입니다. 서버에 내부 오류가 발생했습니다. 요청을 다시 시도하면 성공적인 결과가 발생할 수 있습니다.

Headers

MS-CV: string

Other Status Codes

요청이 너무 많음. 속도 제한을 초과했습니다. Retry-After 헤더에 지정된 기간 이후에 요청을 다시 시도합니다.

Headers

  • MS-CV: string
  • Retry-After: integer

보안

Authorization

Mixed Reality 보안 토큰 서비스에서 반환된 전달자 토큰입니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens를 참조하세요.

Type: apiKey
In: header

예제

List sessions

Sample Request

GET https://remoterendering.eastus.mixedreality.azure.com/accounts/30ea64bd-100f-4bf0-adc9-29fa45d4880c/sessions?api-version=2021-01-01

Sample Response

MS-CV: dKEFmka2kkSlDmp/af+sOw
{
  "sessions": [
    {
      "id": "contoso-session-c2b8ac1d-9494-4852-a59c-8c28813adc28",
      "creationTime": "2020-11-11T11:11:11.111Z",
      "arrInspectorPort": 50052,
      "handshakePort": 50051,
      "elapsedTimeMinutes": 59,
      "hostname": "d4cefb7b-10b9-4631-934d-67445ffa9126.remoterenderingvm.westus2.mixedreality.azure.com",
      "maxLeaseTimeMinutes": 60,
      "size": "Standard",
      "status": "Stopped",
      "error": null,
      "teraflops": 10.6
    },
    {
      "id": "contoso-session-03c200ce-faf8-4238-8db9-872ac9dd501d",
      "creationTime": "2021-01-01T11:11:11.111Z",
      "arrInspectorPort": 50053,
      "handshakePort": 50052,
      "elapsedTimeMinutes": 12,
      "hostname": "615854b8-1748-4f2e-9522-bf8523d7299c.remoterenderingvm.westus2.mixedreality.azure.com",
      "maxLeaseTimeMinutes": 72,
      "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
Retry-After: 15
MS-CV: dKEFmka2kkSlDmp/af+sOw
MS-CV: dKEFmka2kkSlDmp/af+sOw
{
  "error": {
    "code": "InternalServerError",
    "message": "An internal server error occurred."
  }
}

정의

Name Description
error

요청이 실패한 이유에 대한 세부 정보를 포함하는 오류 개체입니다.

error_response

요청이 실패한 이유에 대한 세부 정보가 포함된 오류 응답입니다.

session_properties

렌더링 세션의 속성입니다.

session_size

렌더링 세션에 사용되는 서버의 크기입니다. 크기는 서버에서 렌더링할 수 있는 다각형 수에 영향을 줍니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes을 참조하세요.

session_status

렌더링 세션의 상태. 터미널 상태는 '오류', '만료됨' 및 '중지됨'입니다.

sessions_list

목록 세션 요청의 결과입니다.

error

요청이 실패한 이유에 대한 세부 정보를 포함하는 오류 개체입니다.

Name 형식 Description
code

string

오류 코드

details

error[]

이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.

innerError

error

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

message

string

사람이 읽을 수 있는 오류 표현입니다.

target

string

특정 오류의 대상(예: 오류에 있는 속성의 이름)입니다.

error_response

요청이 실패한 이유에 대한 세부 정보가 포함된 오류 응답입니다.

Name 형식 Description
error

error

요청이 실패한 이유에 대한 세부 정보를 포함하는 오류 개체입니다.

session_properties

렌더링 세션의 속성입니다.

Name 형식 Description
arrInspectorPort

integer

Azure Remote Rendering Inspector 도구가 호스트되는 TCP 포트입니다.

creationTime

string

렌더링 세션을 만든 시간입니다. ISO 8601 형식의 날짜 및 시간입니다.

elapsedTimeMinutes

integer

세션이 '준비' 상태이거나 인 시간(분)입니다. 시간은 전체 분으로 반올림됩니다.

error

error

렌더링 세션 시작 실패에 대한 세부 정보를 포함하는 오류 개체입니다.

handshakePort

integer

연결을 설정할 때 핸드셰이크에 사용되는 TCP 포트입니다.

hostname

string

렌더링 세션에 연결할 수 있는 호스트 이름입니다.

id

string

세션을 만들 때 제공된 세션의 ID입니다.

maxLeaseTimeMinutes

integer

'준비' 상태에 도달한 후 세션이 실행되는 시간(분)입니다.

size

session_size

렌더링 세션에 사용되는 서버의 크기입니다. 크기는 서버에서 렌더링할 수 있는 다각형 수에 영향을 줍니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes을 참조하세요.

status

session_status

렌더링 세션의 상태. 터미널 상태는 '오류', '만료됨' 및 '중지됨'입니다.

teraflops

number

teraflops로 측정된 렌더링 세션 GPU의 계산 능력입니다.

session_size

렌더링 세션에 사용되는 서버의 크기입니다. 크기는 서버에서 렌더링할 수 있는 다각형 수에 영향을 줍니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes을 참조하세요.

Name 형식 Description
Premium

string

프리미엄 렌더링 세션 크기입니다.

Standard

string

표준 렌더링 세션 크기입니다.

session_status

렌더링 세션의 상태. 터미널 상태는 '오류', '만료됨' 및 '중지됨'입니다.

Name 형식 Description
Error

string

렌더링 세션에 오류가 발생하여 사용할 수 없습니다. 터미널 상태입니다.

Expired

string

렌더링 세션은 임대 시간보다 더 긴 '준비' 상태일 때 '만료됨' 상태로 들어갑니다. 터미널 상태입니다.

Ready

string

렌더링 세션은 들어오는 연결에 대해 준비됩니다.

Starting

string

렌더링 세션이 시작되었지만 아직 들어오는 연결을 허용하지 않습니다.

Stopped

string

'세션 중지' 작업으로 렌더링 세션이 중지되었습니다. 터미널 상태입니다.

sessions_list

목록 세션 요청의 결과입니다.

Name 형식 Description
@nextLink

string

더 많은 렌더링 세션을 사용할 수 있는 경우 이 필드에는 다음 세션 일괄 처리를 요청할 수 있는 URL이 포함됩니다. 이 URL은 Azure Remote Rendering API에 대한 모든 호출과 동일한 인증이 필요합니다.

sessions

session_properties[]

렌더링 세션 목록입니다. '중지됨' 상태의 세션은 포함되지 않습니다.