orchestrator
2023.10
true
Guia da API do Orchestrator
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 22 de jun de 2024

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.

GET Endpoint

OBTER https://{yourDomain}/{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}' \--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}/{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://{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'
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}/{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://{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"
        ]
    }
}

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'--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'--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'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.

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.