Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
StreamJournalToKinesis
Crea uno stream di journal per un determinato registro Amazon QLDB. Il flusso acquisisce ogni revisione del documento di cui viene eseguito il commit al journal del libro mastro e invia i dati a una specifica risorsa Amazon Kinesis Data Streams.
Sintassi della richiesta
POST /ledgers/name
/journal-kinesis-streams HTTP/1.1
Content-type: application/json
{
"ExclusiveEndTime": number
,
"InclusiveStartTime": number
,
"KinesisConfiguration": {
"AggregationEnabled": boolean
,
"StreamArn": "string
"
},
"RoleArn": "string
",
"StreamName": "string
",
"Tags": {
"string
" : "string
"
}
}
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- name
-
Il nome del libro mastro.
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.
Modello:
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$
Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ExclusiveEndTime
-
Data e ora esclusive che specificano quando termina il flusso. Se non si definisce questo parametro, il flusso viene eseguito a tempo indeterminato fino a quando non lo si annulla.
ExclusiveEndTime
deve essere in formato data e oraISO 8601
e in Universal Coordinated Time (UTC). Ad esempio:2019-06-13T21:36:34Z
.Tipo: Timestamp
Campo obbligatorio: no
- InclusiveStartTime
-
Data e ora di inizio inclusive da cui iniziare lo streaming dei dati del journal. Questo parametro deve essere in formato data e ora
ISO 8601
e in Universal Coordinated Time (UTC). Ad esempio:2019-06-13T21:36:34Z
.InclusiveStartTime
non può essere in futuro e deve essere precedente aExclusiveEndTime
.Se si fornisce un
InclusiveStartTime
che è precedente aCreationDateTime
del libro mastro, QLDB viene effettivamente impostato in modo predefinito suCreationDateTime
del libro mastro.Tipo: Timestamp
Campo obbligatorio: sì
- KinesisConfiguration
-
Le impostazioni di configurazione della destinazione Kinesis Data Streams per la richiesta di flusso.
Tipo: oggetto KinesisConfiguration
Campo obbligatorio: sì
- RoleArn
-
L'Amazon Resource Name (ARN) del ruolo IAM che concede autorizzazioni QLDB per un flusso di journal per scrivere record di dati in una risorsa Kinesis Data Streams.
Per passare un ruolo a QLDB quando si richiede un flusso journal, è necessario disporre delle autorizzazioni per eseguire l'operazione
iam:PassRole
sulla risorsa del ruolo IAM. Questa operazione è necessaria per tutte le richieste di flusso journal.▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.
Campo obbligatorio: sì
- StreamName
-
Il nome che si desidera assegnare al flusso del journal QLDB. I nomi definiti dall'utente possono aiutare a identificare e indicare lo scopo di un flusso.
Il nome del flusso deve essere univoco tra gli altri flussi attivi per un determinato libro mastro. I nomi dei flussi hanno gli stessi vincoli per la denominazione dei nomi dei libri mastri, come definito nell'argomento relativo alle quote in Amazon QLDB in Amazon QLDB Developer Guide.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri.
Modello:
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$
Campo obbligatorio: sì
- Tags
-
Le coppie chiave-valore da aggiungere come tag allo stream che desideri creare. Le chiavi dei tag prevedono una distinzione tra lettere maiuscole e minuscole. I valori dei tag fanno distinzione tra maiuscole e minuscole e possono essere nulli.
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.
Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"StreamId": "string"
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- StreamId
-
L'UUID (rappresentato nel testo con codifica Base62) che QLDB assegna a ogni flusso di journal QLDB.
▬Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 22.
Modello:
^[A-Za-z-0-9]+$
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InvalidParameterException
-
Uno o più parametri nella richiesta non sono validi.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
La risorsa specificata non esiste.
Codice di stato HTTP: 404
- ResourcePreconditionNotMetException
-
L'operazione non è riuscita perché una condizione non era soddisfatta in anticipo.
Codice di stato HTTP: 412
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: