ListJournalKinesisStreamsForLedger - Amazon Quantum Ledger Database (Amazon QLDB)

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

ListJournalKinesisStreamsForLedger

傳回指定分類帳的所有 Amazon QLDB 日誌資料流。

此動作不會傳回任何過期的日誌串流。如需詳細資訊,請參閱 Amazon QLDB 開發人員指南中的終端機串流到期日

此操作返回最大的MaxResults項目。它被分頁,以便您可以通過ListJournalKinesisStreamsForLedger多次調用來檢索所有項目。

請求語法

GET /ledgers/name/journal-kinesis-streams?max_results=MaxResults&next_token=NextToken HTTP/1.1

URI 請求參數

請求會使用下列 URI 參數。

name

分類帳的名稱。

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

模式:(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$

必要:是

MaxResults

在單一ListJournalKinesisStreamsForLedger要求中傳回的結果數目上限。(傳回的實際結果數量可能會較少。)

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

NextToken

一個分頁令牌,表示您要檢索結果的下一頁。如果您在先前ListJournalKinesisStreamsForLedger呼叫的回應NextToken中收到的值,您應該在此處使用該值作為輸入。

長度約束:最小長度為 4。長度上限為 1024。

模式:^[A-Za-z-0-9+/=]+$

請求主體

請求沒有請求主體。

回應語法

HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Streams": [ { "Arn": "string", "CreationTime": number, "ErrorCause": "string", "ExclusiveEndTime": number, "InclusiveStartTime": number, "KinesisConfiguration": { "AggregationEnabled": boolean, "StreamArn": "string" }, "LedgerName": "string", "RoleArn": "string", "Status": "string", "StreamId": "string", "StreamName": "string" } ] }

回應元素

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

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

NextToken
  • 如果NextToken為空,則表示結果的最後一頁已處理,並且沒有更多的結果要擷取。

  • 如果NextToken是空的,則可以使用更多結果。若要擷取結果的下一頁,請在後續ListJournalKinesisStreamsForLedger呼叫NextToken中使用的值。

類型:字串

長度約束:最小長度為 4。長度上限為 1024。

模式:^[A-Za-z-0-9+/=]+$

Streams

目前與指定分類帳相關聯的 QLDB 分錄資料流。

類型:JournalKinesisStreamDescription 物件陣列

錯誤

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

InvalidParameterException

請求中的一個或多個參數無效。

HTTP 狀態碼:400

ResourceNotFoundException

指定的資源不存在。

HTTP 狀態碼:404

ResourcePreconditionNotMetException

作業失敗,因為未事先滿足條件。

HTTP 狀態碼:412

另請參閱

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