Solicitações de bucket de armazenamento

Como os uploads de arquivos do bucket de armazenamento funcionam por meio da API do Orchestrator, incluindo as etapas de recuperação e upload de URIs

Adicionar um arquivo a um bucket de armazenamento

O upload de arquivos para um bucket de armazenamento existente usando APIs do Orchestrator é um processo de duas partes:

• Primeiro você precisa chamar o terminal GET /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri , que retorna um URI e o método HTTP como resposta.
• Em seguida, você precisa usar o método HTTP da resposta GET para chamar o endpoint {URI} , anexar o arquivo que deseja carregar em formato binário e enviá-lo para o URI obtido da solicitação GET.

Ponto de extremidade GET

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

Para descobrir o URI e o verbo HTTP, você precisa fazer upload do arquivo para um depósito de armazenamento existente e, em seguida, fazer uma solicitação GET para /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri.

Forneça os seguintes parâmetros e cabeçalhos:

Parâmetros do caminho

Parâmetro do caminho	Tipo de dados	Description
key (obrigatório)	String	O ID do depósito de armazenamento no qual você deseja fazer upload do arquivo.

Parâmetros de Consulta

Parâm	Tipo de dados	Description
path (obrigatório)	String	O nome do arquivo que você deseja carregar, junto com sua extensão. Por exemplo, "meu_arquivo.txt".
contentType (obrigatório)	String	O tipo de conteúdo para a extensão de arquivo. Por exemplo, o tipo de conteúdo das extensões .txt é text/plain.

Cabeçalhos de solicitação.

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

O X-UIPATH-OrganizationUnitId é o ID da pasta que contém o depósito de armazenamento.

Exemplo de solicitação

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'

O token de acesso no exemplo é 1234 para considerações de comprimento.

Corpo da Resposta

O corpo da resposta contém o URI e o verbo HTTP necessários para fazer upload do arquivo para o depósito de armazenamento em formato binário.

{
    "@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"
        ]
    }
}

Ponto de extremidade PUT

PUT {URI}

O URI é o valor da chave "Uri" do corpo da resposta.

Cabeçalhos de solicitação.

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

Observação:

• Certifique-se de incluir os cabeçalhos recebidos no corpo da resposta GET e atribuir valores a eles. Por exemplo, para Azure Blob Storage, o cabeçalho retornado é x-ms-blob-type-header, que usa o valor BlockBlob .
• Não use um cabeçalho de autorização com esta solicitação.

Corpo da Solicitação

Carregue o arquivo em formato binário. Você deve usar o mesmo arquivo usado como parâmetro de consulta na solicitação GET. Neste caso, "meu_arquivo.txt".

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

Exemplo de solicitação

Digamos que você reuniu todas as informações necessárias para criar a chamada de 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'

Na IU do orquestrador, o arquivo fica visível em seu depósito de armazenamento.