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