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
Ändert die folgenden Konfigurationsparameter des Objektspeicher-Übertragungsorts, den Sie mit AWS DataSync verwenden.
Weitere Informationen finden Sie unter [Konfiguration von DataSync Übertragungen mit einem Objektspeichersystem](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).
## Anforderungssyntax
```
{
"AccessKey": "string",
"AgentArns": [ "string" ],
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"LocationArn": "string",
"SecretKey": "string",
"ServerCertificate": blob,
"ServerHostname": "string",
"ServerPort": number,
"ServerProtocol": "string",
"Subdirectory": "string"
}
```
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **
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 0. Höchstlänge = 200 Zeichen.
Pattern: `^.*$`
Erforderlich: Nein
** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) **
(Optional) Gibt die Amazon-Ressourcennamen (ARNs) der DataSync Agenten an, die eine Verbindung zu Ihrem Objektspeichersystem herstellen können. Wenn Sie eine cloudübergreifende Übertragung ohne Agenten einrichten, müssen Sie für diesen Parameter keinen Wert angeben.
Sie können keine Agenten zu einem Speicherort hinzufügen oder daraus entfernen, nachdem Sie ihn ursprünglich erstellt haben.
Typ: Zeichenfolgen-Array
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 8 Artikeln.
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$`
Erforderlich: Nein
** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt Konfigurationsinformationen für ein DataSync verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, das für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet wird, und für einen vom AWS KMS key Kunden verwalteten Schlüssel.
Typ: [CmkSecretConfig](API_CmkSecretConfig.md) Objekt
Erforderlich: Nein
** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt Konfigurationsinformationen für ein vom Kunden verwaltetes Geheimnis an, z. B. ein Authentifizierungstoken oder einen Satz von Anmeldeinformationen, die für den Zugriff auf einen bestimmten Übertragungsort DataSync verwendet werden, und eine vom Kunden verwaltete Rolle AWS Identity and Access Management (IAM), die den Zugriff auf das Geheimnis ermöglicht.
Typ: [CustomSecretConfig](API_CustomSecretConfig.md) Objekt
Erforderlich: Nein
** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt den ARN des Objekt-Storage-Systemspeicherorts an, den Sie aktualisieren.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$`
Erforderlich: Ja
** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt den geheimen Schlüssel (z. B. ein Passwort) an, wenn Anmeldeinformationen für die Authentifizierung beim Objektspeicher-Server erforderlich sind.
Wenn Sie mithilfe von `CmkSecretConfig` oder ein Geheimnis angeben`SecretKey`, aber keine geheimen Konfigurationsdetails angeben`CustomSecretConfig`, DataSync speichert das Token unter Verwendung des Secrets Manager Manager-Geheimnisses Ihres AWS Kontos.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen.
Pattern: `^.*$`
Erforderlich: Nein
** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt eine Zertifikatskette für DataSync die Authentifizierung bei Ihrem Objektspeichersystem an, falls das System eine private oder selbstsignierte Zertifizierungsstelle (CA) verwendet. Sie müssen eine einzelne `.pem` Datei mit einer vollständigen Zertifikatskette angeben (z. B.`file:///home/user/.ssh/object_storage_certificates.pem`).
Die Zertifikatskette könnte Folgendes beinhalten:
+ Das Zertifikat des Objektspeichersystems
+ Alle Zwischenzertifikate (falls vorhanden)
+ Das Stammzertifikat der signierenden Zertifizierungsstelle
Sie können Ihre Zertifikate zu einer `.pem` Datei zusammenfügen (die vor der Base64-Kodierung bis zu 32768 Byte groß sein kann). Mit dem folgenden `cat` Beispielbefehl wird eine `object_storage_certificates.pem` Datei erstellt, die drei Zertifikate enthält:
`cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`
Um diesen Parameter zu verwenden, konfigurieren Sie `ServerProtocol` auf`HTTPS`.
Die Aktualisierung dieses Parameters beeinträchtigt nicht die Aufgaben, die Sie gerade ausführen.
Typ: Base64-kodiertes Binärdatenobjekt
Längenbeschränkungen: Die maximale Länge beträgt 32768.
Erforderlich: Nein
** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt den Domänennamen oder die IP-Adresse (IPv4 oder IPv6) des Objektspeicherservers an, mit dem Ihr DataSync Agent eine Verbindung herstellt.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 255.
Pattern: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`
Erforderlich: Nein
** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt den Port an, an dem Ihr Objektspeicher-Server eingehenden Netzwerkverkehr annimmt (z. B. Port 443).
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1. Der Höchstwert ist 65536.
Erforderlich: Nein
** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt das Protokoll an, das Ihr Objektspeicher-Server für die Kommunikation verwendet.
Typ: Zeichenfolge
Zulässige Werte: `HTTPS | HTTP`
Erforderlich: Nein
** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **
Gibt das Objekt-Präfix für Ihren Objektspeicher-Server an. Wenn es sich um einen Quellspeicherort handelt, werden DataSync nur Objekte mit diesem Präfix kopiert. Wenn es sich um einen Zielort handelt, werden alle Objekte mit diesem Präfix DataSync geschrieben.
Typ: Zeichenfolge
Längenbeschränkungen: Die maximale Länge beträgt 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
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** 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-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage)