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.
ImportHostKey
Fügt dem Server, der durch den ServerId
Parameter angegeben ist, einen Hostschlüssel hinzu.
Anforderungssyntax
{
"Description": "string
",
"HostKeyBody": "string
",
"ServerId": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.
Die Anfrage akzeptiert die folgenden Daten im JSON Format.
- Description
-
Die Textbeschreibung, die diesen Hostschlüssel identifiziert.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen.
Pattern:
[\p{Print}]*
Erforderlich: Nein
- HostKeyBody
-
Der private Schlüsselteil eines SSH key pair.
AWS Transfer Family akzeptiert RSAECDSA, und ED25519 Schlüssel.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge von 4096.
Erforderlich: Ja
- ServerId
-
Die ID des Servers, der den Hostschlüssel enthält, den Sie importieren.
Typ: Zeichenfolge
Längenbeschränkungen: Feste Länge von 19.
Pattern:
s-([0-9a-f]{17})
Erforderlich: Ja
- Tags
-
Schlüssel-Wert-Paare, die zur Gruppierung und Suche nach Hostschlüsseln verwendet werden können.
Typ: Array von Tag-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.
Erforderlich: Nein
Antwortsyntax
{
"HostKeyId": "string",
"ServerId": "string"
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.
- HostKeyId
-
Gibt den Host-Schlüsselbezeichner für den importierten Schlüssel zurück.
Typ: Zeichenfolge
Längenbeschränkungen: Feste Länge von 25.
Pattern:
hostkey-[0-9a-f]{17}
- ServerId
-
Gibt die Server-ID zurück, die den importierten Schlü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.
HTTPStatuscode: 500
- InvalidRequestException
-
Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet.
HTTPStatuscode: 400
- ResourceExistsException
-
Die angeforderte Ressource ist nicht vorhanden oder befindet sich in einer anderen Region als der für den Befehl angegebenen.
HTTPStatuscode: 400
- ResourceNotFoundException
-
Diese Ausnahme wird ausgelöst, wenn eine Ressource vom AWS Transfer Family Family-Dienst nicht gefunden wird.
HTTPStatuscode: 400
- ServiceUnavailableException
-
Die Anfrage ist fehlgeschlagen, da der AWS Transfer Family Family-Dienst nicht verfügbar ist.
HTTPStatuscode: 500
- ThrottlingException
-
Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.
HTTPStatuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: