CreateLocationAzureBlob - AWS DataSync
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateLocationAzureBlob

Erstellt einen Übertragungsort für einen Microsoft Azure Blob Storage-Container. AWS DataSync kann diesen Speicherort als Übertragungsquelle oder -ziel verwenden. Sie können Übertragungen mit oder ohne einen DataSync Agenten durchführen, der eine Verbindung zu Ihrem Container herstellt.

Bevor Sie beginnen, stellen Sie sicher, dass Sie wissen, wie auf Azure Blob Storage DataSync zugegriffen wird und wie mit Zugriffsebenen und Blobtypen gearbeitet wird.

Anforderungssyntax

{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "ContainerUrl": "string",
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SasConfiguration": { 
      "Token": "string"
   },
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AccessTier

Gibt die Zugriffsebene an, in die Ihre Objekte oder Dateien übertragen werden sollen. Dies gilt nur, wenn der Standort als Übertragungsziel verwendet wird. Weitere Informationen finden Sie unter Zugriffsebenen.

Typ: Zeichenfolge

Zulässige Werte: HOT | COOL | ARCHIVE

Erforderlich: Nein

AgentArns

(Optional) Gibt den Amazon-Ressourcennamen (ARN) des DataSync Agenten an, der eine Verbindung mit Ihrem Azure Blob Storage-Container herstellen kann. Wenn Sie eine cloudübergreifende Übertragung ohne Agenten einrichten, müssen Sie für diesen Parameter keinen Wert angeben.

Sie können mehr als einen Agenten angeben. Weitere Informationen finden Sie unter Mehrere Agenten für Ihre Übertragung verwenden.

Anmerkung

Stellen Sie sicher, dass Sie diesen Parameter korrekt konfigurieren, wenn Sie Ihren Speicherort zum ersten Mal erstellen. Nachdem Sie einen Speicherort erstellt haben, können Sie keine Agenten mehr hinzufügen oder daraus entfernen.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 4 Artikeln.

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$

Erforderlich: Nein

AuthenticationType

Gibt die Authentifizierungsmethode an, die für den Zugriff auf Ihren Azure Blob Storage DataSync verwendet wird. DataSync kann mithilfe einer Shared Access Signature (SAS) auf Blob-Speicher zugreifen.

Typ: Zeichenfolge

Zulässige Werte: SAS | NONE

Erforderlich: Ja

BlobType

Gibt den Blobtyp an, den Ihre Objekte oder Dateien haben sollen, wenn sie in Azure Blob Storage übertragen werden. Unterstützt derzeit DataSync nur das Verschieben von Daten in Azure Blob Storage als Blockblobs. Weitere Informationen zu Blobtypen finden Sie in der Azure Blob Storage-Dokumentation.

Typ: Zeichenfolge

Zulässige Werte: BLOCK

Erforderlich: Nein

CmkSecretConfig

Gibt Konfigurationsinformationen für ein vom Kunden DataSync verwaltetes Geheimnis an, zu dem auch das Authentifizierungstoken gehört, das für den Zugriff auf einen bestimmten AzureBlob Speicherort DataSync verwendet wird. AWS KMS key

Wenn Sie diesen Parameter als Teil einer CreateLocationAzureBlob Anfrage angeben, geben Sie nur den KMS-Schlüssel ARN an. DataSync verwendet diesen KMS-Schlüssel zusammen mit dem Authentifizierungstoken, für das Sie angebenSasConfiguration, um ein DataSync verwaltetes Geheimnis zum Speichern der Anmeldeinformationen für den Standortzugriff zu erstellen.

Stellen Sie sicher, dass DataSync er berechtigt ist, auf den von Ihnen angegebenen KMS-Schlüssel zuzugreifen.

Anmerkung

Sie können entweder CmkSecretConfig (mitSasConfiguration) oder CustomSecretConfig (ohneSasConfiguration) verwenden, um Anmeldeinformationen für eine CreateLocationAzureBlob Anfrage bereitzustellen. Geben Sie nicht beide Parameter für dieselbe Anfrage an.

Typ: CmkSecretConfig Objekt

Erforderlich: Nein

ContainerUrl

Gibt die URL des Azure Blob Storage-Containers an, der an Ihrer Übertragung beteiligt ist.

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 325.

Pattern: ^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$

Erforderlich: Ja

CustomSecretConfig

Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Secrets Manager Manager-Geheimnis an, in dem das Authentifizierungstoken für einen AzureBlob Speicherort im Klartext gespeichert wird. Diese Konfiguration umfasst den geheimen ARN und den ARN für eine IAM-Rolle, die Zugriff auf den geheimen Schlüssel ermöglicht.

Anmerkung

Sie können entweder CmkSecretConfig (mitSasConfiguration) oder CustomSecretConfig (ohneSasConfiguration) Anmeldeinformationen für eine CreateLocationAzureBlob Anfrage angeben. Geben Sie nicht beide Parameter für dieselbe Anfrage an.

Typ: CustomSecretConfig Objekt

Erforderlich: Nein

SasConfiguration

Gibt die SAS-Konfiguration an, die DataSync den Zugriff auf Ihren Azure Blob Storage ermöglicht.

Anmerkung

Wenn Sie mithilfe von CmkSecretConfig oder ein Authentifizierungstoken bereitstellenSasConfiguration, aber keine geheimen Konfigurationsdetails angebenCustomSecretConfig, DataSync speichert das Token dann unter Verwendung des Secrets Managers Secret Ihres AWS Kontos.

Typ: AzureBlobSasConfiguration Objekt

Erforderlich: Nein

Subdirectory

Gibt Pfadsegmente an, wenn Sie Ihre Übertragung auf ein virtuelles Verzeichnis in Ihrem Container beschränken möchten (z. B./my/images).

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 1 024.

Pattern: ^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$

Erforderlich: Nein

Tags

Gibt Bezeichnungen an, mit denen Sie Ihre AWS -Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, mindestens ein Namensschild für Ihren Übertragungsort zu erstellen.

Typ: Array von TagListEntry-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente.

Erforderlich: Nein

Antwortsyntax

{
   "LocationArn": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

LocationArn

Der ARN des Azure Blob Storage-Übertragungsorts, den Sie erstellt haben.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InternalException

Diese Ausnahme wird ausgelöst, wenn im AWS DataSync Dienst ein Fehler auftritt.

HTTP Status Code: 500

InvalidRequestException

Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: