Partager via

Remote Rendering - List Conversions

  • Référence
Service:
Mixed Reality
API Version:
2021-01-01

Obtient la liste de toutes les conversions.

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

Paramètres URI

Nom Dans Obligatoire Type Description
account_id
 path True

string

uuid

ID de compte Azure Remote Rendering.
endpoint
 path True

string

Point de terminaison à utiliser, par exemple https://remoterendering.eastus.mixedreality.azure.com. Vous trouverez une liste à l’adresse https://docs.microsoft.com/azure/remote-rendering/reference/regions.
api-version
 query True

string

Version de l’API à utiliser avec la requête HTTP.

En-tête de la demande

Nom Obligatoire Type Description
Authorization True

string

Jeton du porteur retourné par le service de jeton sécurisé Mixed Reality. Pour plus d'informations, consultez https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens.

Réponses

Nom Type Description
200 OK

conversion_list

OK.

Headers

MS-CV: string
401 Unauthorized

Non autorisé. Autorisation manquante ou non valide.

Headers

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

Interdit. Autorisation insuffisante pour une ressource donnée.

Headers

MS-CV: string
500 Internal Server Error

error_response

Erreur interne. Le serveur a rencontré une erreur interne. La nouvelle tentative de la demande peut produire des résultats réussis.

Headers

MS-CV: string
Other Status Codes

Trop de demandes. La limite de débit a été dépassée. Réessayez la demande après la durée indiquée dans l’en-tête Retry-After.

Headers

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

Sécurité

Authorization

Jeton du porteur retourné par le service de jeton sécurisé Mixed Reality. Pour plus d'informations, consultez https://docs.microsoft.com/azure/remote-rendering/how-tos/tokens.

Type: apiKey
In: header

Exemples

List conversions

Sample Request

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

Sample Response

Status code:
200 
MS-CV: dKEFmka2kkSlDmp/af+sOw
Response Body
{
  "conversions": [
    {
      "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": "Succeeded",
      "error": null,
      "output": {
        "outputAssetUri": "https://contosostorage01.blob.core.windows.net/arroutput/conversionOutput/fbc3646c-0b97-4553-81ca-6fae2bfb754e/convertedHouse.arrAsset"
      }
    },
    {
      "id": "contoso-conversion-7da568fb-f3da-4b6d-ba75-d18c8e5a015e",
      "creationTime": "2021-02-02T11:11:11.111Z",
      "settings": {
        "inputLocation": {
          "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arrinput",
          "blobPrefix": "models/",
          "relativeInputAssetPath": "barrel.fbx"
        },
        "outputLocation": {
          "storageContainerUri": "https://contosostorage01.blob.core.windows.net/arroutput",
          "blobPrefix": "conversionOutput/7da568fb-f3da-4b6d-ba75-d18c8e5a015e"
        }
      },
      "status": "Running",
      "error": null
    }
  ]
}
Status code:
401 
WWW-Authenticate: Bearer error="invalid_token"
MS-CV: dKEFmka2kkSlDmp/af+sOw
Status code:
403 
MS-CV: dKEFmka2kkSlDmp/af+sOw
Status code:
429 
Retry-After: 15
MS-CV: dKEFmka2kkSlDmp/af+sOw
Status code:
500 
MS-CV: dKEFmka2kkSlDmp/af+sOw
Response Body
{
  "error": {
    "code": "InternalServerError",
    "message": "An internal server error occurred."
  }
}

Définitions

Nom Description
conversion

Propriétés de la conversion.
conversion_input_settings

Les paramètres d’entrée de conversion décrivent l’origine de l’entrée de conversion.
conversion_list

Liste des conversions.
conversion_output_settings

Les paramètres de sortie de conversion décrivent la destination de la sortie de conversion.
conversion_settings

Les paramètres de conversion décrivent l’origine des fichiers d’entrée et la destination des fichiers de sortie.
conversion_status

Status de la conversion. Les états de terminal sont « Cancelled », « Failed » et « Succeeded ».
error

Objet d’erreur contenant les détails de la raison de l’échec de la demande.
error_response

Réponse d’erreur contenant des détails sur la raison de l’échec de la demande.
Output

Informations sur la sortie d’une conversion réussie. Présent uniquement lorsque le status de la conversion est « Réussi ».

conversion

Propriétés de la conversion.

Nom Type Description
creationTime

string

Heure de création de la conversion. Date et heure au format ISO 8601.
error

error

Objet d’erreur contenant des détails sur l’échec de conversion.
id

string

ID de la conversion fournie lors de la création de la conversion.
output

Output

Informations sur la sortie d’une conversion réussie. Présent uniquement lorsque le status de la conversion est « Réussi ».
settings

conversion_settings

Les paramètres de conversion décrivent l’origine des fichiers d’entrée et la destination des fichiers de sortie.
status

conversion_status

Status de la conversion. Les états de terminal sont « Cancelled », « Failed » et « Succeeded ».

conversion_input_settings

Les paramètres d’entrée de conversion décrivent l’origine de l’entrée de conversion.

Nom Type Description
blobPrefix

string

Seuls les objets blob commençant par ce préfixe sont téléchargés pour effectuer la conversion. facultatif. S’ils ne sont pas fournis, tous les objets blob du conteneur sont téléchargés.
relativeInputAssetPath

string

Chemin d’accès relatif commençant à blobPrefix (ou à la racine du conteneur si blobPrefix n’est pas fourni) au modèle d’entrée. Doit pointer vers un fichier dont le format de fichier pris en charge se termine. Pour plus d'informations, consultez https://docs.microsoft.com/azure/remote-rendering/how-tos/conversion/model-conversion.
storageContainerReadListSas

string

Signature d’accès partagé au conteneur de stockage Blob Azure qui donne un accès en lecture et en liste au conteneur de stockage. facultatif. S’il n’est pas fourni, le compte Azure Remote Rendering doit être lié au compte de stockage contenant le conteneur d’objets blob. Pour plus d'informations, consultez https://docs.microsoft.com/azure/remote-rendering/how-tos/create-an-account#link-storage-accounts. Pour des raisons de sécurité, ce champ ne sera jamais rempli dans les corps des réponses.
storageContainerUri

string

URI du conteneur de stockage d’objets blob Azure contenant le modèle d’entrée.

conversion_list

Liste des conversions.

Nom Type Description
@nextLink

string

Si d’autres conversions sont disponibles, ce champ contient une URL où le lot suivant de conversions peut être demandé. Cette URL nécessite la même authentification que tous les appels à l’API Azure Remote Rendering.
conversions

conversion[]

Liste des conversions.

conversion_output_settings

Les paramètres de sortie de conversion décrivent la destination de la sortie de conversion.

Nom Type Description
blobPrefix

string

Préfixe qui est ajouté devant tous les fichiers générés par le processus de conversion. Sera traité comme un dossier virtuel. facultatif. S’ils ne sont pas fournis, les fichiers de sortie sont stockés à la racine du conteneur.
outputAssetFilename

string

Nom de fichier de la ressource de sortie. Doit se terminer par « .arrAsset ». facultatif. S’il n’est pas fourni, le nom de fichier aura le même nom que la ressource d’entrée, avec l’extension '.arrAsset'
storageContainerUri

string

URI du conteneur de stockage d’objets blob Azure dans lequel le résultat de la conversion doit être écrit.
storageContainerWriteSas

string

Signature d’accès partagé du conteneur de stockage Blob Azure donnant un accès en écriture au conteneur de stockage. facultatif. S’il n’est pas fourni, le compte Azure Remote Rendering doit être lié au compte de stockage contenant le conteneur d’objets blob. Pour plus d'informations, consultez https://docs.microsoft.com/azure/remote-rendering/how-tos/create-an-account#link-storage-accounts. Pour des raisons de sécurité, ce champ ne sera jamais rempli dans les corps des réponses.

conversion_settings

Les paramètres de conversion décrivent l’origine des fichiers d’entrée et la destination des fichiers de sortie.

Nom Type Description
inputLocation

conversion_input_settings

Les paramètres d’entrée de conversion décrivent l’origine de l’entrée de conversion.
outputLocation

conversion_output_settings

Les paramètres de sortie de conversion décrivent la destination de la sortie de conversion.

conversion_status

Status de la conversion. Les états de terminal sont « Cancelled », « Failed » et « Succeeded ».

Nom Type Description
Cancelled

string

La conversion a été annulée. Il s’agit d’un état terminal.
Failed

string

La conversion a échoué. Pour plus d’informations, consultez le champ « erreur ». Il s’agit d’un état terminal.
NotStarted

string

La conversion a été créée, mais n’a pas démarré.
Running

string

La conversion est en cours d’exécution.
Succeeded

string

La conversion a réussi. Vérifiez l’emplacement de la ressource de sortie dans le champ « output ». Il s’agit d’un état terminal.

error

Objet d’erreur contenant les détails de la raison de l’échec de la demande.

Nom Type Description
code

string

Code d’erreur.
details

error[]

Tableau de détails sur les erreurs spécifiques qui ont conduit à cette erreur signalée.
innerError

error

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message

string

Représentation lisible de l’erreur.
target

string

Cible de l’erreur particulière (par exemple, le nom de la propriété dans l’erreur).

error_response

Réponse d’erreur contenant des détails sur la raison de l’échec de la demande.

Nom Type Description
error

error

Objet d’erreur contenant les détails de la raison de l’échec de la demande.

Output

Informations sur la sortie d’une conversion réussie. Présent uniquement lorsque le status de la conversion est « Réussi ».

Nom Type Description
outputAssetUri

string

URI de la ressource générée par le processus de conversion.