Solicitudes de cubos de almacenamiento

Agregar un archivo a un depósito de almacenamiento

La carga de archivos a un depósito de almacenamiento existente mediante las API de Orchestrator es un proceso que consta de dos partes:

• Primero debes llamar al punto final GET /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri , que devuelve un URI y el método HTTP como respuesta.
• Luego debes usar el método HTTP de la respuesta GET para llamar al punto final {URI} , adjuntar el archivo que quieres cargar en formato binario y enviarlo al URI obtenido de la solicitud GET.

OBTENER Punto final

OBTENER https://{yourDomain}/odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri

Para averiguar el URI y el verbo HTTP, debe cargar el archivo a un depósito de almacenamiento existente y, luego, realizar una solicitud GET a /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri.

Proporcione los siguientes parámetros y encabezados:

Parámetros de ruta

Parámetros de ruta	Tipo de datos	Descripción
key (obligatorio)	Cadena	El ID del depósito de almacenamiento donde desea cargar su archivo.

Parámetros de consulta

Parámetros	Tipo de datos	Descripción
path (obligatorio)	Cadena	El nombre del archivo que quieres cargar, junto con su extensión. Por ejemplo, "my_file.txt".
contentType (obligatorio)	Cadena	El tipo de contenido para la extensión del archivo. Por ejemplo, el tipo de contenido de .txt extensiones es text/plain.

Solicitar encabezados.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json' \
--header 'X-UIPATH-OrganizationUnitId: {the_ID_of_the_folder_that_contains_the_storage_bucket}' \

El X-UIPATH-OrganizationUnitId es el ID de la carpeta que contiene el depósito de almacenamiento.

Solicitud de ejemplo

curl --location --request GET 'https://{yourDomain}/odata/Buckets(28053)/UiPath.Server.Configuration.OData.GetWriteUri?path=my_file.txt&contentType=text/plain' \
--header 'x-uipath-organizationunitid: 3991326' \
--header 'Authorization: Bearer 1234'

El token de acceso en el ejemplo es 1234 por razones de longitud.

Cuerpo de respuesta

El cuerpo de la respuesta contiene el URI y el verbo HTTP necesarios para cargar el archivo en el depósito de almacenamiento en formato binario.

{
    "@odata.context": "https://{yourDomain}/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"
        ]
    }
}

Punto final PUT

PUT {URI}

El URI es el valor de la clave "Uri" del cuerpo de la respuesta.

Solicitar encabezados.

--header 'x-ms-blob-type: BlockBlob' \
--header 'Content-Type: text/plain'

Nota:

• Asegúrate de incluir los encabezados que recibes en el cuerpo de la respuesta GET y asígnales valores. Por ejemplo, para Azure Blob Storage, el encabezado devuelto es x-ms-blob-type-header, que usa el valor BlockBlob .
• No utilice un encabezado de autorización con esta solicitud.

Solicitar cuerpo

Carga el archivo en formato binario. Debes usar el mismo archivo que usaste como parámetro de consulta en la solicitud GET. En este caso, "my_file.txt".

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

Solicitud de ejemplo

Supongamos que has recopilado toda la información necesaria para crear la llamada a la 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'

En la interfaz de usuario de Orchestrator, el archivo está visible en tu depósito de almacenamiento.