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.
UpdateHostKey
Aktualisiert die Beschreibung für den Host-Schlüssel, der durch die HostKeyId
Parameter ServerId
und angegeben ist.
Anforderungssyntax
{
"Description": "string
",
"HostKeyId": "string
",
"ServerId": "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.
- Description
-
Eine aktualisierte Beschreibung für den Hostschlüssel.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen.
Pattern:
[\p{Print}]*
Erforderlich: Ja
- HostKeyId
-
Die ID des Hostschlüssels, den Sie aktualisieren.
Typ: Zeichenfolge
Längenbeschränkungen: Feste Länge von 25.
Pattern:
hostkey-[0-9a-f]{17}
Erforderlich: Ja
- ServerId
-
Die ID des Servers, der den Hostschlüssel enthält, den Sie aktualisieren.
Typ: Zeichenfolge
Längenbeschränkungen: Feste Länge von 19.
Pattern:
s-([0-9a-f]{17})
Erforderlich: Ja
Antwortsyntax
{
"HostKeyId": "string",
"ServerId": "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.
- HostKeyId
-
Gibt die Hostschlüssel-ID für den aktualisierten Hostschlüssel zurück.
Typ: Zeichenfolge
Längenbeschränkungen: Feste Länge von 25.
Pattern:
hostkey-[0-9a-f]{17}
- ServerId
-
Gibt die Server-ID für den Server zurück, der den aktualisierten Hostschlüssel enthält.
Typ: Zeichenfolge
Längenbeschränkungen: Feste Länge von 19.
Pattern:
s-([0-9a-f]{17})
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- InternalServiceError
-
Diese Ausnahme wird ausgelöst, wenn im AWS Transfer Family 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
- ResourceNotFoundException
-
Diese Ausnahme wird ausgelöst, wenn eine Ressource vom AWS Transfer Family Family-Dienst nicht gefunden wird.
HTTP Status Code: 400
- ServiceUnavailableException
-
Die Anfrage ist fehlgeschlagen, da der AWS Transfer Family Family-Dienst nicht verfügbar ist.
HTTP Status Code: 500
- ThrottlingException
-
Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.
HTTP Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: