ListCertificates - AWS Transfer Family

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

ListCertificates

傳回已匯入 的目前憑證清單 AWS Transfer Family。如果您想要將結果限制為特定數字,請提供 MaxResults 參數的值。如果您先前執行 命令並收到 NextToken 參數的值,您可以提供該值,以繼續從上次停止的位置列出憑證。

請求語法

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

請求參數

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

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

MaxResults

要傳回的憑證數目上限。

類型:整數

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

必要:否

NextToken

當您可以從ListCertificates呼叫取得其他結果時,輸出中會傳回 NextToken 參數。然後,您可以在後續命令中傳遞至 NextToken 參數,以繼續列出其他憑證。

類型:字串

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

必要:否

回應語法

{ "Certificates": [ { "ActiveDate": number, "Arn": "string", "CertificateId": "string", "Description": "string", "InactiveDate": number, "Status": "string", "Type": "string", "Usage": "string" } ], "NextToken": "string" }

回應元素

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

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

Certificates

傳回ListCertificates呼叫中指定的憑證陣列。

類型:ListedCertificate 物件陣列

NextToken

傳回下一個權杖,您可以使用它來列出下一個憑證。

類型:字串

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

錯誤

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

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,請參閱下列內容: