ListHostKeys - AWS Transfer Family

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

ListHostKeys

傳回 ServerId 參數指定之伺服器的主機金鑰清單。

請求語法

{ "MaxResults": number, "NextToken": "string", "ServerId": "string" }

請求參數

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

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

MaxResults

要傳回的主機金鑰數目上限。

類型:整數

有效範圍:最小值為 1。最大值為 1000。

必要:否

NextToken

有未傳回的其他結果時,會傳回NextToken參數。您可以使用該值進行後續呼叫,ListHostKeys以繼續列出結果。

類型:字串

長度限制:長度下限為 1。長度上限為 6144。

必要:否

ServerId

包含您要檢視之主機金鑰的伺服器識別碼。

類型:字串

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

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

必要:是

回應語法

{ "HostKeys": [ { "Arn": "string", "DateImported": number, "Description": "string", "Fingerprint": "string", "HostKeyId": "string", "Type": "string" } ], "NextToken": "string", "ServerId": "string" }

回應元素

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

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

HostKeys

傳回陣列,其中每個項目都包含主機金鑰的詳細資訊。

類型:ListedHostKey 物件陣列

NextToken

傳回權杖,如果有的話,您可以使用該權杖ListHostKeys再次呼叫並接收其他結果。

類型:字串

長度限制:長度下限為 1。長度上限為 6144。

ServerId

傳回包含所列主機金鑰的伺服器識別碼。

類型:字串

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

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

錯誤

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

InternalServiceError

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

HTTP 狀態碼:500

InvalidNextTokenException

傳遞的 NextToken 參數無效。

HTTP 狀態碼:400

InvalidRequestException

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

HTTP 狀態碼:400

ResourceNotFoundException

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

HTTP 狀態碼:400

ServiceUnavailableException

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

HTTP 狀態碼:500

另請參閱

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