Anforderungen für Speicher-Buckets

Hinzufügen einer Datei zu einem Speicher-Bucket

Das Hochladen von Dateien in einen vorhandenen Speicher-Bucket mithilfe von Orchestrator-APIs ist ein zweiteiliger Prozess:

• Zuerst müssen Sie den GET-Endpunkt /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri aufrufen, der einen URI und die HTTP-Methode als Antwort zurückgibt.
• Dann müssen Sie die HTTP-Methode aus der GET-Antwort verwenden, um den {URI}-Endpunkt aufzurufen, die Datei, die Sie hochladen möchten, im Binärformat anhängen und an den URI senden, den Sie aus der GET-Anforderung erhalten haben.

GET-Endpunkt

GET https://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri

Um den URI und das HTTP-Verb herauszufinden, müssen Sie die Datei in einen vorhandenen Speicher-Bucket hochladen und dann eine GET-Anforderung an /odata/Buckets({key})/UiPath.Server.Configuration.OData.GetWriteUri stellen.

Geben Sie die folgenden Parameter und Header an:

Pfadparameter

Pfadparameter	Datentyp	Beschreibung
key (erforderlich)	String	Die ID des Speicher-Buckets, in den Sie Ihre Datei hochladen möchten.

Abfrageparameter

Parameter	Datentyp	Beschreibung
path (erforderlich)	String	Der Name der Datei, die Sie hochladen möchten, zusammen mit ihrer Erweiterung. Beispiel: „my_file.txt“.
contentType (erforderlich)	String	Der Inhaltstyp für die Dateierweiterung. Der Inhaltstyp von .txt-Erweiterungen ist beispielsweise text/plain.

Anforderungsheader

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

X-UIPATH-OrganizationUnitId ist die ID des Ordners, der den Speicher-Bucket enthält.

Beispielanforderung

curl --location --request GET 'https://govcloud.uipath.us/{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'

Das Zugriffstoken im Beispiel ist aus Längengründen 1234.

Antworttext

Der Antworttext enthält den URI und das HTTP-Verb, die zum Hochladen der Datei in den Speicher-Bucket im Binärformat erforderlich sind.

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

PUT-Endpunkt

PUT {URI}

Der URI ist der Wert des Schlüssels „Uri“ aus dem Antworttext.

Anforderungsheader

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

Hinweis:

• Stellen Sie sicher, dass Sie die empfangenen Header in den GET-Antworttext einschließen, und weisen Sie ihnen Werte zu. Für Azure Blob Storage ist der zurückgegebene Header beispielsweise x-ms-blob-type-header, der den Wert BlockBlob verwendet.
• Verwenden Sie bei dieser Anforderung keinen Autorisierungsheader.

Anforderungstext

Laden Sie die Datei im Binärformat hoch. Sie müssen dieselbe Datei verwenden, die Sie als Abfrageparameter in der GET-Anforderung verwendet haben. In diesem Fall „my_file.txt“.

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

Beispielanforderung

Angenommen, Sie haben alle Informationen gesammelt, die zum Erstellen des API-Aufrufs erforderlich sind.

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'

In der Orchestrator-UI ist die Datei in Ihrem Speicher-Bucket sichtbar.