Remote Rendering - Create Conversion

참조

서비스:: Mixed Reality

API 버전:: 2021-01-01

Azure Blob Storage 계정에 저장된 자산을 사용하여 변환을 만듭니다.

PUT {endpoint}/accounts/{account_id}/conversions/{conversion_id}?api-version=2021-01-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
account_id	path	True	string uuid	Azure Remote Rendering 계정 ID입니다.
conversion_id	path	True	string	지정된 계정의 변환을 고유하게 식별하는 ID입니다. ID는 대/소문자를 구분하고 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 256자를 초과할 수 없습니다.
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
settings	True	conversion_settings	변환 설정은 입력 파일의 원본과 출력 파일의 대상을 설명합니다.

응답

Name	형식	Description
200 OK	conversion	OK. 동일한 설정이 있는 변환이 이미 있음을 나타냅니다. 변환 만들기를 다시 시도하면 이 값이 필요합니다. 헤더 MS-CV: string
201 Created	conversion	만들어졌습니다. 새 변환이 만들어졌습니다. 헤더 MS-CV: string
400 Bad Request	error_response	잘못된 요청. 반환된 오류 개체는 발생한 문제를 설명합니다. 헤더 MS-CV: string
401 Unauthorized		권한이 없습니다. 권한 부여가 없거나 잘못되었습니다. 헤더 MS-CV: string WWW-Authenticate: string
403 Forbidden		사용할 수 없습니다. 지정된 리소스에 대한 권한 부여가 부족합니다. 헤더 MS-CV: string
429 Too Many Requests		요청이 너무 많음. 속도 제한을 초과했습니다. Retry-After 헤더에 지정된 기간 이후에 요청을 다시 시도합니다. 헤더 MS-CV: string Retry-After: integer
500 Internal Server Error	error_response	내부 오류입니다. 서버에 내부 오류가 발생했습니다. 요청을 다시 시도하면 성공적인 결과가 발생할 수 있습니다.
Other Status Codes	error_response	충돌. 변환이 이미 있습니다. 오류 개체는 발생한 문제를 설명합니다. 헤더 MS-CV: string

보안

Authorization

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

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

예제

Create a conversion

샘플 요청

HTTP

PUT https://remoterendering.eastus.mixedreality.azure.com/accounts/30ea64bd-100f-4bf0-adc9-29fa45d4880c/conversions/contoso-conversion-fbc3646c-0b97-4553-81ca-6fae2bfb754e?api-version=2021-01-01

{
  "settings": {
    "inputLocation": {
      "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arrinput",
      "blobPrefix": "models/",
      "relativeInputAssetPath": "house.fbx"
    },
    "outputLocation": {
      "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arroutput",
      "blobPrefix": "conversionOutput/fbc3646c-0b97-4553-81ca-6fae2bfb754e",
      "outputAssetFilename": "convertedHouse.arrAsset"
    }
  }
}

샘플 응답

상태 코드:: 201

MS-CV: dKEFmka2kkSlDmp/af+sOw

{
  "id": "contoso-conversion-fbc3646c-0b97-4553-81ca-6fae2bfb754e",
  "creationTime": "2021-01-01T11:11:11.111Z",
  "settings": {
    "inputLocation": {
      "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arrinput",
      "blobPrefix": "models/",
      "relativeInputAssetPath": "house.fbx"
    },
    "outputLocation": {
      "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arroutput",
      "blobPrefix": "conversionOutput/fbc3646c-0b97-4553-81ca-6fae2bfb754e",
      "outputAssetFilename": "convertedHouse.arrAsset"
    }
  },
  "status": "NotStarted",
  "error": null
}

상태 코드:: 200

MS-CV: dKEFmka2kkSlDmp/af+sOw

{
  "id": "contoso-conversion-fbc3646c-0b97-4553-81ca-6fae2bfb754e",
  "creationTime": "2021-01-01T11:11:11.111Z",
  "settings": {
    "inputLocation": {
      "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arrinput",
      "blobPrefix": "models/",
      "relativeInputAssetPath": "house.fbx"
    },
    "outputLocation": {
      "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arroutput",
      "blobPrefix": "conversionOutput/fbc3646c-0b97-4553-81ca-6fae2bfb754e",
      "outputAssetFilename": "convertedHouse.arrAsset"
    }
  },
  "status": "NotStarted",
  "error": null
}

상태 코드:: 400

MS-CV: dKEFmka2kkSlDmp/af+sOw

{
  "error": {
    "code": "BadRequest",
    "message": "The request was malformed."
  }
}

상태 코드:: 409

MS-CV: dKEFmka2kkSlDmp/af+sOw

{
  "error": {
    "code": "Conflict",
    "message": "A resource already exists under the given ID."
  }
}

상태 코드:: 401

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

상태 코드:: 403

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
conversion	변환의 속성입니다.
conversion_input_settings	변환 입력 설정은 변환 입력의 원본을 설명합니다.
conversion_output_settings	변환 출력 설정은 변환 출력의 대상을 설명합니다.
conversion_settings	변환 설정은 입력 파일의 원본과 출력 파일의 대상을 설명합니다.
conversion_status	변환의 상태. 터미널 상태는 'Canceled', 'Failed' 및 'Succeeded'입니다.
create_conversion_settings	변환 시작 요청
error	요청이 실패한 이유에 대한 세부 정보를 포함하는 오류 개체입니다.
error_response	요청이 실패한 이유에 대한 세부 정보가 포함된 오류 응답입니다.
Output	성공적인 변환의 출력에 대한 정보입니다. 변환의 상태 '성공'인 경우에만 존재합니다.

conversion

변환의 속성입니다.

Name	형식	Description
creationTime	string	변환을 만든 시간입니다. ISO 8601 형식의 날짜 및 시간입니다.
error	error	변환 실패에 대한 세부 정보를 포함하는 오류 개체입니다.
id	string	변환을 만들 때 제공된 변환의 ID입니다.
output	Output	성공적인 변환의 출력에 대한 정보입니다. 변환의 상태 '성공'인 경우에만 존재합니다.
settings	conversion_settings	변환 설정은 입력 파일의 원본과 출력 파일의 대상을 설명합니다.
status	conversion_status	변환의 상태. 터미널 상태는 'Canceled', 'Failed' 및 'Succeeded'입니다.

conversion_input_settings

변환 입력 설정은 변환 입력의 원본을 설명합니다.

Name	형식	Description
blobPrefix	string	이 접두사로 시작하는 Blob만 다운로드하여 변환을 수행합니다. 선택 사항입니다. 제공되지 않으면 컨테이너의 모든 Blob이 다운로드됩니다.
relativeInputAssetPath	string	입력 모델에 대한 blobPrefix(또는 blobPrefix가 제공되지 않은 경우 컨테이너 루트)에서 시작하는 상대 경로입니다. 지원되는 파일 형식이 끝나는 파일을 가리킵니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/how-tos/conversion/model-conversion를 참조하세요.
storageContainerReadListSas	string	스토리지 컨테이너에 대한 읽기 및 목록 액세스를 제공하는 Azure Blob Storage 컨테이너 공유 액세스 서명입니다. 선택 사항입니다. 제공되지 않으면 Azure Remote Rendering 계정을 Blob 컨테이너가 포함된 스토리지 계정과 연결해야 합니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/how-tos/create-an-account#link-storage-accounts를 참조하세요. 보안을 위해 이 필드는 응답 본문에 채워지지 않습니다.
storageContainerUri	string	입력 모델을 포함하는 Azure Blob Storage 컨테이너의 URI입니다.

conversion_output_settings

변환 출력 설정은 변환 출력의 대상을 설명합니다.

Name	형식	Description
blobPrefix	string	변환 프로세스에서 생성된 모든 파일 앞에 앞에 접두사를 추가합니다. 가상 폴더로 처리됩니다. 선택 사항입니다. 제공되지 않으면 출력 파일이 컨테이너 루트에 저장됩니다.
outputAssetFilename	string	출력 자산의 파일 이름입니다. '.arrAsset'로 끝나야 합니다. 선택 사항입니다. 제공되지 않으면 파일 이름은 입력 자산과 이름이 같고 확장명은 '.arrAsset'입니다.
storageContainerUri	string	변환 결과를 기록해야 하는 Azure Blob Storage 컨테이너의 URI입니다.
storageContainerWriteSas	string	스토리지 컨테이너에 대한 쓰기 권한을 제공하는 Azure Blob Storage 컨테이너 공유 액세스 서명입니다. 선택 사항입니다. 제공되지 않으면 Azure Remote Rendering 계정을 Blob 컨테이너가 포함된 스토리지 계정과 연결해야 합니다. 자세한 내용은 https://docs.microsoft.com/azure/remote-rendering/how-tos/create-an-account#link-storage-accounts를 참조하세요. 보안을 위해 이 필드는 응답 본문에 채워지지 않습니다.

conversion_settings

변환 설정은 입력 파일의 원본과 출력 파일의 대상을 설명합니다.

Name	형식	Description
inputLocation	conversion_input_settings	변환 입력 설정은 변환 입력의 원본을 설명합니다.
outputLocation	conversion_output_settings	변환 출력 설정은 변환 출력의 대상을 설명합니다.

conversion_status

변환의 상태. 터미널 상태는 'Canceled', 'Failed' 및 'Succeeded'입니다.

Name	형식	Description
Cancelled	string	변환이 취소되었습니다. 터미널 상태입니다.
Failed	string	변환에 실패했습니다. 자세한 내용은 '오류' 필드를 확인하세요. 터미널 상태입니다.
NotStarted	string	변환이 만들어졌지만 시작되지 않았습니다.
Running	string	변환이 실행 중입니다.
Succeeded	string	변환에 성공했습니다. 출력 자산 위치에 대한 '출력' 필드를 확인합니다. 터미널 상태입니다.

create_conversion_settings

변환 시작 요청

Name	형식	Description
settings	conversion_settings	변환 설정은 입력 파일의 원본과 출력 파일의 대상을 설명합니다.

error

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

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

error_response

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

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

Output

성공적인 변환의 출력에 대한 정보입니다. 변환의 상태 '성공'인 경우에만 존재합니다.

Name	형식	Description
outputAssetUri	string	변환 프로세스에서 생성된 자산의 URI입니다.

다음을 통해 공유