Requêtes de compartiments de stockage

Requêtes d'API pour le téléchargement et la gestion de fichiers dans les compartiments de stockage Orchestrator

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://{yourDomain}/{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 charger ainsi que son extension. Par exemple, « my_file.txt ».
contentType (requis)	Chaîne de caractères (string)	Le type de contenu de 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}' \

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://{yourDomain}/{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://{yourDomain}/{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'

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'

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'

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