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 |
OK. '시작' 또는 '준비' 상태인 세션 목록을 반환합니다. |
|
401 Unauthorized |
권한이 없습니다. 권한 부여가 없거나 잘못되었습니다. Headers
|
|
403 Forbidden |
사용할 수 없습니다. 지정된 리소스에 대한 권한 부여가 부족합니다. Headers MS-CV: string |
|
500 Internal Server Error |
내부 오류입니다. 서버에 내부 오류가 발생했습니다. 요청을 다시 시도하면 성공적인 결과가 발생할 수 있습니다. Headers MS-CV: string |
|
Other Status Codes |
요청이 너무 많음. 속도 제한을 초과했습니다. Retry-After 헤더에 지정된 기간 이후에 요청을 다시 시도합니다. Headers
|
보안
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 |
오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다. |
|
message |
string |
사람이 읽을 수 있는 오류 표현입니다. |
target |
string |
특정 오류의 대상(예: 오류에 있는 속성의 이름)입니다. |
error_response
요청이 실패한 이유에 대한 세부 정보가 포함된 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
요청이 실패한 이유에 대한 세부 정보를 포함하는 오류 개체입니다. |
session_properties
렌더링 세션의 속성입니다.
Name | 형식 | Description |
---|---|---|
arrInspectorPort |
integer |
Azure Remote Rendering Inspector 도구가 호스트되는 TCP 포트입니다. |
creationTime |
string |
렌더링 세션을 만든 시간입니다. ISO 8601 형식의 날짜 및 시간입니다. |
elapsedTimeMinutes |
integer |
세션이 '준비' 상태이거나 인 시간(분)입니다. 시간은 전체 분으로 반올림됩니다. |
error |
렌더링 세션 시작 실패에 대한 세부 정보를 포함하는 오류 개체입니다. |
|
handshakePort |
integer |
연결을 설정할 때 핸드셰이크에 사용되는 TCP 포트입니다. |
hostname |
string |
렌더링 세션에 연결할 수 있는 호스트 이름입니다. |
id |
string |
세션을 만들 때 제공된 세션의 ID입니다. |
maxLeaseTimeMinutes |
integer |
'준비' 상태에 도달한 후 세션이 실행되는 시간(분)입니다. |
size |
렌더링 세션에 사용되는 서버의 크기입니다. 크기는 서버에서 렌더링할 수 있는 다각형 수에 영향을 줍니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes을 참조하세요. |
|
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 |
렌더링 세션 목록입니다. '중지됨' 상태의 세션은 포함되지 않습니다. |