Remote Rendering - Stop Session

참조

서비스:: Mixed Reality

API 버전:: 2021-01-01

특정 렌더링 세션을 중지합니다.

POST {endpoint}/accounts/{account_id}/sessions/{session_id}/:stop?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찾을 수 있습니다.
session_id	path	True	string	지정된 계정에 대한 렌더링 세션을 고유하게 식별하는 ID입니다. ID는 대/소문자를 구분하고 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 256자를 초과할 수 없습니다.
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
204 No Content		NoContent. 중지 요청이 성공했습니다. 렌더링 세션이 중지되었습니다. 헤더 MS-CV: string
401 Unauthorized		권한이 없습니다. 누락되었거나 잘못된 권한 부여입니다. 헤더 MS-CV: string WWW-Authenticate: string
403 Forbidden		사용할 수 없습니다. 지정된 리소스에 대한 권한 부여가 부족합니다. 헤더 MS-CV: string
404 Not Found		찾을 수 없음 제공된 세션 ID가 있는 세션이 없습니다. 헤더 MS-CV: string
429 Too Many Requests		요청이 너무 많음. 속도 제한을 초과했습니다. Retry-After 헤더에 지정된 기간 후에 요청을 다시 시도합니다. 헤더 MS-CV: string Retry-After: integer
500 Internal Server Error	error_response	내부 오류입니다. 서버에 내부 오류가 발생했습니다. 요청을 다시 시도하면 성공적인 결과가 생성됩니다. 헤더 MS-CV: string

보안

Authorization

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

형식: apiKey
In(다음 안에): header

예제

Stop a session

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 204

MS-CV: dKEFmka2kkSlDmp/af+sOw

상태 코드:: 401

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

상태 코드:: 403

MS-CV: dKEFmka2kkSlDmp/af+sOw

상태 코드:: 404

MS-CV: dKEFmka2kkSlDmp/af+sOw

상태 코드:: 429

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

상태 코드:: 500

MS-CV: dKEFmka2kkSlDmp/af+sOw

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

정의

Name	Description
error	요청이 실패한 이유에 대한 세부 정보를 포함하는 오류 개체입니다.
error_response	요청이 실패한 이유에 대한 세부 정보가 포함된 오류 응답입니다.

error

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

Name	형식	Description
code	string	오류 코드
details	error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innerError	error	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	특정 오류의 대상(예: 오류에 있는 속성의 이름)입니다.

error_response

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

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

다음을 통해 공유