ImportHostKey - AWS Transfer Family

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ImportHostKey

將主機金鑰新增至 ServerId 參數指定的伺服器。

請求語法

{ "Description": "string", "HostKeyBody": "string", "ServerId": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

請求參數

如需所有動作的一般參數資訊,請參閱《Common Parameters》。

請求接受下列JSON格式的資料。

Description

識別此主機金鑰的文字描述。

類型:字串

長度限制:長度下限為 0。長度上限為 200。

模式:[\p{Print}]*

必要:否

HostKeyBody

金鑰對的私有SSH金鑰部分。

AWS Transfer Family 接受 RSA、 ECDSA和 ED25519金鑰。

類型:字串

長度限制:長度下限為 0。長度上限為 4096。

必要:是

ServerId

包含您匯入之主機金鑰的伺服器識別碼。

類型:字串

長度限制條件:固定長度為 19。

模式:s-([0-9a-f]{17})

必要:是

Tags

可用於分組和搜尋主機金鑰的鍵值對。

類型:Tag 物件陣列

陣列成員:項目數下限為 1。項目數上限為 50。

必要:否

回應語法

{ "HostKeyId": "string", "ServerId": "string" }

回應元素

如果動作成功,服務會傳回 HTTP 200 個回應。

服務會以 JSON 格式傳回下列資料。

HostKeyId

傳回匯入金鑰的主機金鑰識別符。

類型:字串

長度限制條件:固定長度為 25。

模式:hostkey-[0-9a-f]{17}

ServerId

傳回包含匯入金鑰的伺服器識別碼。

類型:字串

長度限制條件:固定長度為 19。

模式:s-([0-9a-f]{17})

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

InternalServiceError

當 AWS Transfer Family 服務發生錯誤時,就會擲回此例外狀況。

HTTP 狀態碼:500

InvalidRequestException

當用戶端提交格式不正確的請求時,就會擲回此例外狀況。

HTTP 狀態碼:400

ResourceExistsException

請求的資源不存在,或存在於命令指定的區域以外的區域。

HTTP 狀態碼:400

ResourceNotFoundException

當 AWS Transfer Family 服務找不到資源時,就會擲回此例外狀況。

HTTP 狀態碼:400

ServiceUnavailableException

請求失敗,因為 AWS Transfer Family 服務無法使用。

HTTP 狀態碼:500

ThrottlingException

由於請求調節,因此請求遭到拒絕。

HTTP 狀態碼:400

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: