orchestrator
latest
false
UiPath logo, featuring letters U and I in white
Guide de l'API Orchestrator
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 23 oct. 2024

Requêtes de compartiments de stockage

Ajouter un fichier à un compartiment de stockage

Le téléchargement de fichiers dans un compartiment de stockage existant à l'aide des API Orchestrator est un processus en deux parties :

  • Vous devez d'abord appeler le point de terminaison GET /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri, qui renvoie un URI et la méthode HTTP en tant que réponse.
  • Vous devez ensuite utiliser la méthode HTTP à partir de la réponse GET pour appeler le point de terminaison {URI}, joindre le fichier que vous souhaitez télécharger au format binaire et l'envoyer à l'URI obtenu à partir de la requête GET.

Point de terminaison GET

LIRE https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri
Pour connaître l'URI et le verbe HTTP, vous devez télécharger le fichier dans un compartiment de stockage existant, puis envoyer une requête GET à /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri.

Fournissez les paramètres et en-têtes suivants :

Paramètres de chemin d'accès

Paramètre du chemin d'accès

Type de données

Description

key

(requis)

Chaîne de caractères (string)

L'ID du compartiment de stockage dans lequel vous souhaitez télécharger votre fichier.

Paramètres de requête

Param

Type de données

Description

path

(requis)

Chaîne de caractères (string)

Le nom du fichier que vous souhaitez télécharger, avec son extension.

Par exemple, « mon_fichier.txt » (my_file.txt).

contentType

(requis)

Chaîne de caractères (string)

Le type de contenu pour l'extension de fichier.

Par exemple, le type de contenu des extensions .txt est text/plain.

En-têtes de requête.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json' \
--header 'X-UIPATH-OrganizationUnitId: {the_ID_of_the_folder_that_contains_the_storage_bucket}' \--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json' \
--header 'X-UIPATH-OrganizationUnitId: {the_ID_of_the_folder_that_contains_the_storage_bucket}' \
La valeur X-UIPATH-OrganizationUnitId est l'ID du dossier qui contient le compartiment de stockage.

Exemple de requête

curl --location --request GET 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/Buckets(28053)/UiPath.Server.Configuration.OData.GetWriteUri?path=my_file.txt&contentType=text/plain' \
--header 'x-uipath-organizationunitid: 3991326' \
--header 'Authorization: Bearer 1234'curl --location --request GET 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/Buckets(28053)/UiPath.Server.Configuration.OData.GetWriteUri?path=my_file.txt&contentType=text/plain' \
--header 'x-uipath-organizationunitid: 3991326' \
--header 'Authorization: Bearer 1234'
Le jeton d'accès dans l'exemple est 1234 pour des raisons de longueur.

Corps de la réponse

Le corps de la réponse contient l'URI et le verbe HTTP requis pour télécharger le fichier dans le compartiment de stockage au format binaire.

{
    "@odata.context": "https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/$metadata#UiPath.Server.Configuration.OData.BlobFileAccessDto",
    "Uri": "https://cr.blob.core.windows.net/orchestrator-4871-905f/BlobFilePersistence/2760e0fe-0fa7/my_file.txt?sv=2021-08-06&st=2023-01-13T16%3A32%3A12Z&se=2023-01-13T17%3A32%3A42Z&sr=b&sp=cw&sig=xB3W02xGYHfw%3D",
    "Verb": "PUT",
    "Headers": {
        "Keys": [
            "x-ms-blob-type"
        ],
        "Values": [
            "BlockBlob"
        ]
    }
}{
    "@odata.context": "https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/$metadata#UiPath.Server.Configuration.OData.BlobFileAccessDto",
    "Uri": "https://cr.blob.core.windows.net/orchestrator-4871-905f/BlobFilePersistence/2760e0fe-0fa7/my_file.txt?sv=2021-08-06&st=2023-01-13T16%3A32%3A12Z&se=2023-01-13T17%3A32%3A42Z&sr=b&sp=cw&sig=xB3W02xGYHfw%3D",
    "Verb": "PUT",
    "Headers": {
        "Keys": [
            "x-ms-blob-type"
        ],
        "Values": [
            "BlockBlob"
        ]
    }
}

Point de terminaison PUT

PUT {URI}

L'URI est la valeur de la clé « Uri » du corps de la réponse.

En-têtes de requête.

--header 'x-ms-blob-type: BlockBlob' \
--header 'Content-Type: text/plain'--header 'x-ms-blob-type: BlockBlob' \
--header 'Content-Type: text/plain'
Remarque :
  • Assurez-vous d'inclure les en-têtes que vous recevez dans le corps de la réponse GET et de leur attribuer des valeurs. Par exemple, pour Azure Blob Storage, l'en-tête renvoyé est x-ms-blob-type-header, qui utilise la valeur BlockBlob.
  • N'utilisez pas d'en-tête d'autorisation avec cette demande.

Corps de la requête

Téléchargez le fichier au format binaire. Vous devez utiliser le même fichier que vous avez utilisé comme paramètre de requête dans la requête GET. Dans ce cas, « mon_fichier.txt » (my_file.txt).

--data-binary '@/C:/Users/adam.eve/OneDrive/Documents/my_file.txt'--data-binary '@/C:/Users/adam.eve/OneDrive/Documents/my_file.txt'

Exemple de requête

Supposons que vous ayez rassemblé toutes les informations nécessaires pour créer l'appel d'API.

curl --location --request PUT 'https://cr.blob.core.windows.net/orchestrator-4871-905f/BlobFilePersistence/2760e0fe-0fa7/my_file.txt?sv=2021-08-06&st=2023-01-13T16%3A32%3A12Z&se=2023-01-13T17%3A32%3A42Z&sr=b&sp=cw&sig=xB3W02xGYHfw%3D' \
--header 'x-ms-blob-type: BlockBlob' \
--header 'Content-Type: text/plain' \
--data-binary '@/C:/Users/adam.eve/OneDrive/Documents/my_file.txt'curl --location --request PUT 'https://cr.blob.core.windows.net/orchestrator-4871-905f/BlobFilePersistence/2760e0fe-0fa7/my_file.txt?sv=2021-08-06&st=2023-01-13T16%3A32%3A12Z&se=2023-01-13T17%3A32%3A42Z&sr=b&sp=cw&sig=xB3W02xGYHfw%3D' \
--header 'x-ms-blob-type: BlockBlob' \
--header 'Content-Type: text/plain' \
--data-binary '@/C:/Users/adam.eve/OneDrive/Documents/my_file.txt'

Dans l'interface utilisateur d'Orchestrator, le fichier est visible dans votre compartiment de stockage.

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.