UpdateLocationObjectStorage - AWS DataSync

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.

UpdateLocationObjectStorage

Aktualisiert einige Parameter eines vorhandenen Objektspeicherorts, AWS DataSync auf den für eine Übertragung zugegriffen wird. Informationen zum Erstellen eines selbstverwalteten Objektspeicherorts finden Sie unter Einen Speicherort für Objektspeicher erstellen.

Anforderungssyntax

{ "AccessKey": "string", "AgentArns": [ "string" ], "LocationArn": "string", "SecretKey": "string", "ServerCertificate": blob, "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string" }

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AccessKey

Gibt den Zugriffsschlüssel (z. B. einen Benutzernamen) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

Pattern: ^.+$

Erforderlich: Nein

AgentArns

Gibt die Amazon-Ressourcennamen (ARNs) der DataSync Agenten an, die eine sichere Verbindung mit Ihrem Standort herstellen können.

Typ: Zeichenfolge-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 4 Elemente.

Längenbeschränkungen: Maximale Länge von 128.

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

LocationArn

Gibt den ARN des Speicherorts des Objektspeichersystems an, das Sie aktualisieren.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 128.

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}$

Erforderlich: Ja

SecretKey

Gibt den geheimen Schlüssel (z. B. ein Passwort) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

Pattern: ^.+$

Erforderlich: Nein

ServerCertificate

Gibt ein Zertifikat für die Authentifizierung bei einem Objektspeichersystem an, das eine private oder selbstsignierte Zertifizierungsstelle (CA) verwendet. Sie müssen eine Base64-codierte .pem Datei angeben (z. B.). file:///home/user/.ssh/storage_sys_certificate.pem Das Zertifikat kann bis zu 32768 Byte lang sein (vor der Base64-Codierung).

Um diesen Parameter zu verwenden, konfigurieren Sie ServerProtocol ihn aufHTTPS.

Die Aktualisierung des Zertifikats beeinträchtigt Ihre laufenden Aufgaben nicht.

Typ: Base64-kodiertes Binärdatenobjekt

Die maximale Länge von 32768.

Required: No

ServerPort

Gibt den Port an, an dem Ihr Objektspeicher-Server eingehenden Netzwerkverkehr annimmt (z. B. Port 443).

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximaler Anzahl beträgt 65536.

Required: No

ServerProtocol

Gibt das Protokoll an, das Ihr Objektspeicher-Server für die Kommunikation verwendet.

Typ: Zeichenfolge

Zulässige Werte: HTTPS | HTTP

Required: No

Subdirectory

Gibt das Objekt-Präfix für Ihren Objektspeicher-Server an. Wenn dies ein Quell-Speicherort ist, DataSync werden nur Objekte mit diesem Präfix. Wenn dies ein Zielspeicherort ist, DataSync schreibt alle Objekte mit diesem Präfix.

Typ: Zeichenfolge

Längenbeschränkungen beschränkungen beschränkungen beschränkungen beschränkungen beschränkt Maximale Länge von 4096.

Pattern: ^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$

Erforderlich: Nein

Antwortelemente

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

InternalException

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

HTTP Status Code: 500

InvalidRequestException

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

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: