本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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,請參閱下列內容: