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: