swagger: '2.0' info: description: > Describing the [Azure Remote Rendering](https://docs.microsoft.com/azure/remote-rendering/) REST API for rendering sessions and asset conversions. All requests to these APIs must be authenticated using the Secure Token Service as described in the [Azure Remote rendering documentation chapter about authentication](https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens). title: Microsoft Azure MixedRealityRemoteRendering version: 2021-01-01-preview x-ms-parameterized-host: hostTemplate: '{endpoint}' useSchemePrefix: false parameters: - $ref: '#/parameters/Endpoint' schemes: - https paths: /accounts/{account_id}/conversions/{conversion_id}: put: operationId: microsoftAzureRemoterenderingCreateconversion consumes: - application/json produces: - application/json x-ms-examples: Create a conversion: $ref: ./examples/CreateConversion.json parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' - $ref: '#/parameters/conversion_id' - description: Request body configuring the settings for an asset conversion. in: body name: body required: true schema: $ref: '#/definitions/create_conversion_settings' responses: '200': description: >- OK. Indicates that there was already a conversion with the same settings present. This is expected when a conversion creation is retried. headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/conversion' '201': description: Created. A new conversion was created. headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/conversion' '400': description: Bad Request. Returned error object describes which issues occurred. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '409': description: >- Conflict. A conversion already exists. An error object describes which issues occurred. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true schema: $ref: '#/definitions/error_response' tags: - Conversion summary: >- Microsoft Azure Creates A Conversion Using An Asset Stored In An Azure Blob Storage Account description: Needs a more full description created. get: operationId: microsoftAzureRemoterenderingGetconversion produces: - application/json parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' - $ref: '#/parameters/conversion_id' x-ms-examples: Get a single conversion by ID: $ref: ./examples/GetConversion.json responses: '200': description: OK. headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- Time in seconds when the status of this conversion should be polled again type: integer schema: $ref: '#/definitions/conversion' '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '404': description: Not found. No conversion with the provided conversion ID exists. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' tags: - Conversion summary: 'Microsoft Azure Gets The Status Of A Particular Conversion' description: Needs a more full description created. /accounts/{account_id}/conversions: get: operationId: microsoftAzureRemoterenderingListconversions produces: - application/json parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' x-ms-examples: List conversions: $ref: ./examples/ListConversions.json responses: '200': description: OK. headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/conversion_list' '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting errors to the Azure Remote Rendering team. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting errors to the Azure Remote Rendering team. type: string '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting errors to the Azure Remote Rendering team. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting errors to the Azure Remote Rendering team. type: string schema: $ref: '#/definitions/error_response' x-ms-pageable: itemName: conversions nextLinkName: '@nextLink' tags: - Conversion summary: 'Microsoft Azure Gets A List Of All Conversions' description: Needs a more full description created. /accounts/{account_id}/sessions/{session_id}: put: operationId: microsoftAzureRemoterenderingCreatesession consumes: - application/json produces: - application/json parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' - $ref: '#/parameters/session_id' - description: Settings of the session to be created. in: body name: body required: true schema: $ref: '#/definitions/create_session_settings' x-ms-examples: Create a rendering session: $ref: ./examples/CreateSession.json responses: '200': description: >- OK. Indicates that there was already a session with the same settings present. This is expected when session creation is retried. schema: $ref: '#/definitions/session_properties' '201': description: Created. The session was created successfully. schema: $ref: '#/definitions/session_properties' headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '400': description: Bad Request. Returned error object describes which issues occurred. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '409': description: >- Conflict. A rendering session with the ID already exists for the remote rendering account. x-ms-error-response: true schema: $ref: '#/definitions/error_response' '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' tags: - Rendering Session summary: 'Microsoft Azure Creates A New Rendering Session' description: Needs a more full description created. get: operationId: microsoftAzureRemoterenderingGetsession produces: - application/json parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' - $ref: '#/parameters/session_id' x-ms-examples: Get a previously created session by ID: $ref: ./examples/GetSession.json responses: '200': description: OK. schema: $ref: '#/definitions/session_properties' '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '404': description: Not found. No session with the provided session ID exists. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' tags: - Rendering Session summary: 'Microsoft Azure Gets The Properties Of A Particular Rendering Session' description: Needs a more full description created. patch: operationId: microsoftAzureRemoterenderingUpdatesession consumes: - application/json produces: - application/json parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' - $ref: '#/parameters/session_id' - description: Settings used to update the session. in: body name: body required: true schema: $ref: '#/definitions/update_session_settings' x-ms-examples: Update a session: $ref: ./examples/UpdateSession.json responses: '200': description: OK. Session has been updated. schema: $ref: '#/definitions/session_properties' '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '404': description: Not found. No session with the provided session ID exists. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '422': description: >- Unprocessable Entity. The maxLeaseTimeMinutes value was invalid. It has to be bigger than the current value of maxLeaseTimeMinutes. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' tags: - Rendering Session summary: 'Microsoft Azure Updates The Max Lease Time Of A Particular Rendering Session' description: Needs a more full description created. /accounts/{account_id}/sessions/{session_id}/:stop: post: operationId: microsoftAzureRemoterenderingStopsession produces: - application/json parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' - $ref: '#/parameters/session_id' x-ms-examples: Stop a session: $ref: ./examples/StopSession.json responses: '204': description: >- NoContent. Stop request was successful. The rendering session is stopped. headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '404': description: Not found. No session with the provided session ID exists. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' tags: - Rendering Session summary: 'Microsoft Azure Stops A Particular Rendering Session' description: Needs a more full description created. /accounts/{account_id}/sessions: get: operationId: microsoftAzureRemoterenderingListsessions produces: - application/json x-ms-pageable: itemName: sessions nextLinkName: '@nextLink' parameters: - $ref: '#/parameters/api_version' - $ref: '#/parameters/account_id' x-ms-examples: List sessions: $ref: ./examples/ListSessions.json responses: '200': description: >- OK. Returns the list of sessions which are in a 'Starting' or 'Ready' state. schema: $ref: '#/definitions/sessions_list' '401': description: Unauthorized. Missing or invalid authorization. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string WWW-Authenticate: description: >- Describes the error encountered while trying to authenticate the resource. type: string '403': description: Forbidden. Authorization insufficient for given resource. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string '429': description: >- Too Many Requests. The rate limit has been exceeded. Retry the request after the duration given in the Retry-After header. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string Retry-After: description: >- The minimum number of seconds to wait before not getting this response anymore. type: integer '500': description: >- Internal Error. Server has encountered an internal error. Retrying the request may produce successful results. x-ms-error-response: true headers: MS-CV: description: >- Microsoft Correlation Vector. Include this value when reporting issues. type: string schema: $ref: '#/definitions/error_response' tags: - Rendering Session summary: 'Microsoft Azure Gets A List Of All Rendering Sessions' description: Needs a more full description created. definitions: conversion: description: The properties of the conversion. properties: id: type: string description: The ID of the conversion supplied when the conversion was created. settings: $ref: '#/definitions/conversion_settings' output: type: object description: >- Information about the output of a successful conversion. Only present when the status of the conversion is 'Succeeded'. properties: outputAssetUri: type: string description: URI of the asset generated by the conversion process. format: uri example: >- https://contoso.blob.core.windows.net/arr/architecture-output/house.arrAsset readOnly: true readOnly: true error: x-nullable: true description: The error object containing details about the conversion failure. type: object $ref: '#/definitions/error' example: status: $ref: '#/definitions/conversion_status' creationTime: type: string description: >- The time when the conversion was created. Date and time in ISO 8601 format. format: date-time required: - id - settings - status - error - creationTime type: object conversion_list: description: List of conversions. properties: conversions: items: $ref: '#/definitions/conversion' type: array description: The list of conversions. '@nextLink': description: >- If more conversions are available this field will contain a URL where the next batch of conversions can be requested. This URL will need the same authentication as all calls to the Azure Remote Rendering API. type: string readOnly: true required: - conversions type: object conversion_input_settings: properties: storageContainerUri: type: string description: >- The URI of the Azure blob storage container containing the input model. format: uri example: https://contosostorage01.blob.core.windows.net/arrinput storageContainerReadListSas: type: string description: >- An Azure blob storage container shared access signature giving read and list access to the storage container. Optional. If not provided, the Azure Remote Rendering account needs to be linked with the storage account containing the blob container. See https://docs.microsoft.com/azure/remote-rendering/how-tos/create-an-account#link-storage-accounts for details. For security purposes this field will never be filled out in responses bodies. blobPrefix: type: string description: >- Only Blobs starting with this prefix will be downloaded to perform the conversion. Optional. If not provided, all Blobs from the container will be downloaded. example: models/ relativeInputAssetPath: type: string description: >- The relative path starting at blobPrefix (or at the container root if blobPrefix is not provided) to the input model. Must point to a file with a supported file format ending. See https://docs.microsoft.com/azure/remote-rendering/how-tos/conversion/model-conversion for details. example: house.fbx required: - storageContainerUri - relativeInputAssetPath type: object description: Conversion input settings describe the origin of conversion input. conversion_output_settings: properties: storageContainerUri: type: string description: >- The URI of the Azure blob storage container where the result of the conversion should be written to. format: uri example: https://contosostorage01.blob.core.windows.net/arroutput storageContainerWriteSas: type: string description: >- An Azure blob storage container shared access signature giving write access to the storage container. Optional. If not provided, the Azure Remote Rendering account needs to be linked with the storage account containing the blob container. See https://docs.microsoft.com/azure/remote-rendering/how-tos/create-an-account#link-storage-accounts for details. For security purposes this field will never be filled out in responses bodies. blobPrefix: type: string description: >- A prefix which gets prepended in front of all files produced by the conversion process. Will be treated as a virtual folder. Optional. If not provided, output files will be stored at the container root. example: conversionOutput/fbc3646c-0b97-4553-81ca-6fae2bfb754e outputAssetFilename: type: string description: >- The file name of the output asset. Must end in '.arrAsset'. Optional. If not provided, file name will the same name as the input asset, with '.arrAsset' extension example: house.arrAsset required: - storageContainerUri type: object description: Conversion output settings describe the destination of conversion output. create_conversion_settings: description: Request to start a conversion properties: settings: $ref: '#/definitions/conversion_settings' required: - settings type: object conversion_settings: description: >- Conversion settings describe the origin of input files and destination of output files. properties: inputLocation: $ref: '#/definitions/conversion_input_settings' outputLocation: $ref: '#/definitions/conversion_output_settings' required: - inputLocation - outputLocation type: object conversion_status: description: >- The status of the conversion. Terminal states are 'Cancelled', 'Failed', and 'Succeeded'. enum: - NotStarted - Running - Cancelled - Failed - Succeeded type: string x-ms-enum: name: conversion_status modelAsString: true values: - value: NotStarted description: The conversion was created but hasn't started. - value: Running description: The conversion is running. - value: Cancelled description: The conversion was cancelled. This is a terminal state. - value: Failed description: >- The conversion has failed. Check the 'error' field for more details. This is a terminal state. - value: Succeeded description: >- The conversion has succeeded. Check the 'output' field for output asset location. This is a terminal state. error_response: description: The error response containing details of why the request failed. properties: error: description: The error object containing details of why the request failed. type: object $ref: '#/definitions/error' type: object required: - error error: description: The error object containing details of why the request failed. properties: code: type: string description: Error code. message: type: string description: A human-readable representation of the error. details: type: array items: $ref: '#/definitions/error' description: >- An array of details about specific errors that led to this reported error. readOnly: true target: description: >- The target of the particular error (e.g., the name of the property in error). type: string readOnly: true innerError: type: object $ref: '#/definitions/error' description: >- An object containing more specific information than the current object about the error. readOnly: true type: object required: - code - message session_properties: description: The properties of a rendering session. properties: id: example: contoso-session-c2b8ac1d-9494-4852-a59c-8c28813adc28 type: string description: The ID of the session supplied when the session was created. arrInspectorPort: example: 50052 maximum: 65534 minimum: 49152 type: integer description: >- The TCP port at which the Azure Remote Rendering Inspector tool is hosted. readOnly: true handshakePort: example: 50051 maximum: 65534 minimum: 49152 type: integer description: The TCP port used for the handshake when establishing a connection. readOnly: true elapsedTimeMinutes: description: >- Amount of time in minutes the session is or was in the 'Ready' state. Time is rounded down to a full minute. example: 10 type: integer readOnly: true hostname: example: >- d4cefb7b-10b9-4631-934d-67445ffa9126.remoterenderingvm.westus2.mixedreality.azure.com type: string description: The hostname under which the rendering session is reachable. readOnly: true maxLeaseTimeMinutes: type: integer description: >- The time in minutes the session will run after reaching the 'Ready' state. example: 60 readOnly: true size: $ref: '#/definitions/session_size' example: Standard status: $ref: '#/definitions/session_status' example: Ready teraflops: example: 10.6 format: float type: number description: >- The computational power of the rendering session GPU measured in teraflops. readOnly: true error: x-nullable: true description: >- The error object containing details about the rendering session startup failure. type: object $ref: '#/definitions/error' example: readOnly: true creationTime: type: string format: date-time description: >- The time when the rendering session was created. Date and time in ISO 8601 format. readOnly: true type: object required: - id - size - status create_session_settings: description: Settings of the session to be created. properties: maxLeaseTimeMinutes: example: 60 type: integer description: >- The time in minutes the session will run after reaching the 'Ready' state. It has to be between 0 and 1440. size: $ref: '#/definitions/session_size' type: object required: - maxLeaseTimeMinutes - size update_session_settings: description: Settings used to update the session. type: object properties: maxLeaseTimeMinutes: description: >- Update to the time the session will run after it reached the 'Ready' state. It has to be larger than the current value of maxLeaseTimeMinutes and less than 1440. example: 72 type: integer required: - maxLeaseTimeMinutes session_status: enum: - Error - Expired - Starting - Ready - Stopped x-ms-enum: name: session_status modelAsString: true values: - value: Error description: >- The rendering session has encountered an error, and is unusable. This is a terminal state. - value: Expired description: >- The rendering session enters the 'Expired' state when it has been in the 'Ready' state longer than its lease time. This is a terminal state. - value: Starting description: >- The rendering session is starting, but not accepting incoming connections yet. - value: Ready description: The rendering session is ready for incoming connections. - value: Stopped description: >- The rendering session has been stopped with the 'Stop Session' operation. This is a terminal state. type: string example: Ready description: >- The status of the rendering session. Terminal states are 'Error', 'Expired', and 'Stopped'. session_size: enum: - Standard - Premium x-ms-enum: name: session_size modelAsString: true values: - value: Standard description: Standard rendering session size. - value: Premium description: Premium rendering session size. example: Standard type: string description: >- The size of the server used for the rendering session. The size impacts the number of polygons the server can render. Refer to https://docs.microsoft.com/azure/remote-rendering/reference/vm-sizes for details. sessions_list: description: The result of a list sessions request. type: object properties: sessions: type: array description: >- The list of rendering sessions. Does not include sessions in 'Stopped' state. items: $ref: '#/definitions/session_properties' '@nextLink': description: >- If more rendering sessions are available this field will contain a URL where the next batch of sessions can be requested. This URL will need the same authentication as all calls to the Azure Remote Rendering API. type: string readOnly: true required: - sessions parameters: Endpoint: name: endpoint description: >- The endpoint to use e.g. https://remoterendering.eastus.mixedreality.azure.com. A list can be found at https://docs.microsoft.com/azure/remote-rendering/reference/regions. required: true type: string in: path x-ms-skip-url-encoding: true x-ms-parameter-location: client api_version: name: api-version in: query description: The API version to be used with the HTTP request. required: true type: string x-example: 2021-01-01-preview x-ms-parameter-location: method account_id: name: account_id description: The Azure Remote Rendering account ID. format: uuid in: path required: true type: string x-example: 30ea64bd-100f-4bf0-adc9-29fa45d4880c x-ms-parameter-location: method conversion_id: description: >- An ID uniquely identifying the conversion for the given account. The ID is case sensitive, can contain any combination of alphanumeric characters including hyphens and underscores, and cannot contain more than 256 characters. in: path name: conversion_id required: true type: string x-example: contoso-conversion-fbc3646c-0b97-4553-81ca-6fae2bfb754e x-ms-parameter-location: method session_id: name: session_id description: >- An ID uniquely identifying the rendering session for the given account. The ID is case sensitive, can contain any combination of alphanumeric characters including hyphens and underscores, and cannot contain more than 256 characters. in: path required: true type: string x-example: contoso-session-c2b8ac1d-9494-4852-a59c-8c28813adc28 x-ms-parameter-location: method securityDefinitions: MrcBearerAuth: in: header name: Authorization type: apiKey description: >- A bearer token returned by the Mixed Reality Secure Token Service. See https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens for details. security: - MrcBearerAuth: [] tags: - name: Conversion - name: Rendering Session