Solicitações de bucket de armazenamento

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.

Note: External applications must include the OR.Administration scope in order to upload files to an existing storage bucket. This scope provides the storage permissions needed for upload operations.

Ponto de extremidade GET

OBTER https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/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 enviar, junto com sua extensão. Por exemplo, "meu_arquivo.txt".
contentType (obrigatório)	String	O tipo de conteúdo para a extensão do arquivo. Por exemplo, o tipo de conteúdo de .txt extensões é 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://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'

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://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"
        ]
    }
}

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.