QLDBexemplos usando AWS CLI - AWS Command Line Interface
Ações

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

QLDBexemplos usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface withQLDB.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar cancel-journal-kinesis-stream.

AWS CLI

Para cancelar uma transmissão do diário

O cancel-journal-kinesis-stream exemplo a seguir cancela o fluxo de diário especificado de um livro contábil.

aws qldb cancel-journal-kinesis-stream \
    --ledger-name myExampleLedger \
    --stream-id 7ISCkqwe4y25YyHLzYUFAf

Saída:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Para obter mais informações, consulte Dados de periódicos de streaming da Amazon QLDB no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar create-ledger.

AWS CLI

Exemplo 1: como criar um livro contábil com propriedades padrão

O exemplo de create-ledger a seguir cria um livro contábil com o nome myExampleLedger e o modo de permissões STANDARD. Os parâmetros opcionais para proteção de exclusão e AWS KMS chave não são especificados, então eles usam como padrão uma chave própria true e uma KMS chave AWS própria, respectivamente.

aws qldb create-ledger \
    --name myExampleLedger \
    --permissions-mode STANDARD

Saída:

{
    "State": "CREATING",
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger",
    "DeletionProtection": true,
    "CreationDateTime": 1568839243.951,
    "Name": "myExampleLedger",
    "PermissionsMode": "STANDARD"
}

Exemplo 2: Para criar um livro contábil com a proteção contra exclusão desativada, uma KMS chave gerenciada pelo cliente e tags especificadas

O exemplo de create-ledger a seguir cria um livro contábil com o nome myExampleLedger2 e o modo de permissões STANDARD. O recurso de proteção contra exclusão está desativado, a KMS chave gerenciada pelo cliente especificada é usada para criptografia em repouso e as tags especificadas são anexadas ao recurso.

aws qldb create-ledger \
    --name myExampleLedger2 \
    --permissions-mode STANDARD \
    --no-deletion-protection \
    --kms-key arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
    --tags IsTest=true,Domain=Test

Saída:

{
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger2",
    "DeletionProtection": false,
    "CreationDateTime": 1568839543.557,
    "State": "CREATING",
    "Name": "myExampleLedger2",
    "PermissionsMode": "STANDARD",
    "KmsKeyArn": "arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Para obter mais informações, consulte Operações básicas do Amazon QLDB Ledgers no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte CreateLedgerna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-ledger.

AWS CLI

Para excluir um livro contábil

O delete-ledger exemplo a seguir exclui o livro contábil especificado.

aws qldb delete-ledger \
    --name myExampleLedger

Este comando não produz saída.

Para obter mais informações, consulte Operações básicas do Amazon QLDB Ledgers no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte DeleteLedgerna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar describe-journal-kinesis-stream.

AWS CLI

Para descrever um fluxo de diário

O describe-journal-kinesis-stream exemplo a seguir exibe os detalhes do fluxo de diário especificado a partir de um livro contábil.

aws qldb describe-journal-kinesis-stream \
    --ledger-name myExampleLedger \
    --stream-id 7ISCkqwe4y25YyHLzYUFAf

Saída:

{
    "Stream": {
        "LedgerName": "myExampleLedger",
        "CreationTime": 1591221984.677,
        "InclusiveStartTime": 1590710400.0,
        "ExclusiveEndTime": 1590796799.0,
        "RoleArn": "arn:aws:iam::123456789012:role/my-kinesis-stream-role",
        "StreamId": "7ISCkqwe4y25YyHLzYUFAf",
        "Arn": "arn:aws:qldb:us-east-1:123456789012:stream/myExampleLedger/7ISCkqwe4y25YyHLzYUFAf",
        "Status": "ACTIVE",
        "KinesisConfiguration": {
            "StreamArn": "arn:aws:kinesis:us-east-1:123456789012:stream/stream-for-qldb",
            "AggregationEnabled": true
        },
        "StreamName": "myExampleLedger-stream"
    }
}

Para obter mais informações, consulte Dados de periódicos de streaming da Amazon QLDB no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar describe-journal-s3-export.

AWS CLI

Para descrever um trabalho de exportação de diário

O describe-journal-s3-export exemplo a seguir exibe os detalhes do trabalho de exportação especificado em um livro contábil.

aws qldb describe-journal-s3-export \
    --name myExampleLedger \
    --export-id ADR2ONPKN5LINYGb4dp7yZ

Saída:

{
    "ExportDescription": {
        "S3ExportConfiguration": {
            "Bucket": "awsExampleBucket",
            "Prefix": "ledgerexport1/",
            "EncryptionConfiguration": {
                "ObjectEncryptionType": "SSE_S3"
            }
        },
        "RoleArn": "arn:aws:iam::123456789012:role/my-s3-export-role",
        "Status": "COMPLETED",
        "ExportCreationTime": 1568847801.418,
        "InclusiveStartTime": 1568764800.0,
        "ExclusiveEndTime": 1568847599.0,
        "LedgerName": "myExampleLedger",
        "ExportId": "ADR2ONPKN5LINYGb4dp7yZ"
    }
}

Para obter mais informações, consulte Exportando seu periódico na Amazon QLDB no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar describe-ledger.

AWS CLI

Para descrever um livro contábil

O describe-ledger exemplo a seguir exibe os detalhes do livro contábil especificado.

aws qldb describe-ledger \
    --name myExampleLedger

Saída:

{
    "CreationDateTime": 1568839243.951,
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger",
    "State": "ACTIVE",
    "Name": "myExampleLedger",
    "DeletionProtection": true,
    "PermissionsMode": "STANDARD",
    "EncryptionDescription": {
        "KmsKeyArn": "arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "EncryptionStatus": "ENABLED"
    }
}

Para obter mais informações, consulte Operações básicas do Amazon QLDB Ledgers no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte DescribeLedgerna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar export-journal-to-s3.

AWS CLI

Para exportar blocos de diário para o S3

O export-journal-to-s3 exemplo a seguir cria uma tarefa de exportação para blocos de diário dentro de um intervalo de data e hora especificado a partir de um livro contábil com o nomemyExampleLedger. O trabalho de exportação grava os blocos em um bucket específico do Amazon S3.

aws qldb export-journal-to-s3 \
    --name myExampleLedger \
    --inclusive-start-time 2019-09-18T00:00:00Z \
    --exclusive-end-time 2019-09-18T22:59:59Z \
    --role-arn arn:aws:iam::123456789012:role/my-s3-export-role \
    --s3-export-configuration file://my-s3-export-config.json

Conteúdo de my-s3-export-config.json:

{
    "Bucket": "awsExampleBucket",
    "Prefix": "ledgerexport1/",
    "EncryptionConfiguration": {
        "ObjectEncryptionType": "SSE_S3"
    }
}

Saída:

{
    "ExportId": "ADR2ONPKN5LINYGb4dp7yZ"
}

Para obter mais informações, consulte Exportando seu periódico na Amazon QLDB no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte ExportJournalToS3 na Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-block.

AWS CLI

Exemplo 1: Para obter um bloco de diário e uma prova para verificação usando arquivos de entrada

O get-block exemplo a seguir solicita um objeto de dados de bloco e uma prova do livro contábil especificado. A solicitação é para um endereço de dica de resumo e endereço de bloco especificados.

aws qldb get-block \
    --name vehicle-registration \
    --block-address file://myblockaddress.json \
    --digest-tip-address file://mydigesttipaddress.json

Conteúdo de myblockaddress.json:

{
    "IonText": "{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100}"
}

Conteúdo de mydigesttipaddress.json:

{
    "IonText": "{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:123}"
}

Saída:

{
    "Block": {
        "IonText": "{blockAddress:{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100},transactionId:\"FnQeJBAicTX0Ah32ZnVtSX\",blockTimestamp:2019-09-16T19:37:05.360Z,blockHash:{{NoChM92yKRuJAb/jeLd1VnYn4DHiWIf071ACfic9uHc=}},entriesHash:{{l05LOsiKV14SDbuaYnH7uwXzUvqzIwUiRLXGbTyj/nY=}},previousBlockHash:{{7kewBXhpdbClcZKxhVmpoMHpUGOJtWQD0iY2LPfZkYA=}},entriesHashList:[{{eRSwnmAM7WWANWDd5iGOyK+T4tDXyzUq6HZ/0fgLHos=}},{{mHVex/yjHAWjFPpwhBuH2GKXmKJjK2FBa9faqoUVNtg=}},{{y5cCBr7pOAIUfsVQ1j0TqtE97b4b4oo1R0vnYyE5wWM=}},{{TvTXygML1bMe6NvEZtGkX+KR+W/EJl4qD1mmV77KZQg=}}],transactionInfo:{statements:[{statement:\"FROM VehicleRegistration AS r \\nWHERE r.VIN = '1N4AL11D75C109151'\\nINSERT INTO r.Owners.SecondaryOwners\\n    VALUE { 'PersonId' : 'CMVdR77XP8zAglmmFDGTvt' }\",startTime:2019-09-16T19:37:05.302Z,statementDigest:{{jcgPX2vsOJ0waum4qmDYtn1pCAT9xKNIzA+2k4R+mxA=}}}],documents:{JUJgkIcNbhS2goq8RqLuZ4:{tableName:\"VehicleRegistration\",tableId:\"BFJKdXgzt9oF4wjMbuxy4G\",statements:[0]}}},revisions:[{blockAddress:{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100},hash:{{mHVex/yjHAWjFPpwhBuH2GKXmKJjK2FBa9faqoUVNtg=}},data:{VIN:\"1N4AL11D75C109151\",LicensePlateNumber:\"LEWISR261LL\",State:\"WA\",PendingPenaltyTicketAmount:90.25,ValidFromDate:2017-08-21,ValidToDate:2020-05-11,Owners:{PrimaryOwner:{PersonId:\"BFJKdXhnLRT27sXBnojNGW\"},SecondaryOwners:[{PersonId:\"CMVdR77XP8zAglmmFDGTvt\"}]},City:\"Everett\"},metadata:{id:\"JUJgkIcNbhS2goq8RqLuZ4\",version:3,txTime:2019-09-16T19:37:05.344Z,txId:\"FnQeJBAicTX0Ah32ZnVtSX\"}}]}"
    },
    "Proof": {
        "IonText": "[{{l3+EXs69K1+rehlqyWLkt+oHDlw4Zi9pCLW/t/mgTPM=}},{{48CXG3ehPqsxCYd34EEa8Fso0ORpWWAO8010RJKf3Do=}},{{9UnwnKSQT0i3ge1JMVa+tMIqCEDaOPTkWxmyHSn8UPQ=}},{{3nW6Vryghk+7pd6wFCtLufgPM6qXHyTNeCb1sCwcDaI=}},{{Irb5fNhBrNEQ1VPhzlnGT/ZQPadSmgfdtMYcwkNOxoI=}},{{+3CWpYG/ytf/vq9GidpzSx6JJiLXt1hMQWNnqOy3jfY=}},{{NPx6cRhwsiy5m9UEWS5JTJrZoUdO2jBOAAOmyZAT+qE=}}]"
    }
}

Para obter mais informações, consulte Verificação de dados na Amazon QLDB no Amazon QLDB Developer Guide.

Exemplo 2: Para obter um bloco de diário e uma prova para verificação usando a sintaxe abreviada

O get-block exemplo a seguir solicita um objeto de dados de bloco e uma prova do livro contábil especificado usando a sintaxe abreviada. A solicitação é para um endereço de dica de resumo e endereço de bloco especificados.

aws qldb get-block \
    --name vehicle-registration \
    --block-address 'IonText="{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100}"' \
    --digest-tip-address 'IonText="{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:123}"'

Saída:

{
    "Block": {
        "IonText": "{blockAddress:{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100},transactionId:\"FnQeJBAicTX0Ah32ZnVtSX\",blockTimestamp:2019-09-16T19:37:05.360Z,blockHash:{{NoChM92yKRuJAb/jeLd1VnYn4DHiWIf071ACfic9uHc=}},entriesHash:{{l05LOsiKV14SDbuaYnH7uwXzUvqzIwUiRLXGbTyj/nY=}},previousBlockHash:{{7kewBXhpdbClcZKxhVmpoMHpUGOJtWQD0iY2LPfZkYA=}},entriesHashList:[{{eRSwnmAM7WWANWDd5iGOyK+T4tDXyzUq6HZ/0fgLHos=}},{{mHVex/yjHAWjFPpwhBuH2GKXmKJjK2FBa9faqoUVNtg=}},{{y5cCBr7pOAIUfsVQ1j0TqtE97b4b4oo1R0vnYyE5wWM=}},{{TvTXygML1bMe6NvEZtGkX+KR+W/EJl4qD1mmV77KZQg=}}],transactionInfo:{statements:[{statement:\"FROM VehicleRegistration AS r \\nWHERE r.VIN = '1N4AL11D75C109151'\\nINSERT INTO r.Owners.SecondaryOwners\\n    VALUE { 'PersonId' : 'CMVdR77XP8zAglmmFDGTvt' }\",startTime:2019-09-16T19:37:05.302Z,statementDigest:{{jcgPX2vsOJ0waum4qmDYtn1pCAT9xKNIzA+2k4R+mxA=}}}],documents:{JUJgkIcNbhS2goq8RqLuZ4:{tableName:\"VehicleRegistration\",tableId:\"BFJKdXgzt9oF4wjMbuxy4G\",statements:[0]}}},revisions:[{blockAddress:{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100},hash:{{mHVex/yjHAWjFPpwhBuH2GKXmKJjK2FBa9faqoUVNtg=}},data:{VIN:\"1N4AL11D75C109151\",LicensePlateNumber:\"LEWISR261LL\",State:\"WA\",PendingPenaltyTicketAmount:90.25,ValidFromDate:2017-08-21,ValidToDate:2020-05-11,Owners:{PrimaryOwner:{PersonId:\"BFJKdXhnLRT27sXBnojNGW\"},SecondaryOwners:[{PersonId:\"CMVdR77XP8zAglmmFDGTvt\"}]},City:\"Everett\"},metadata:{id:\"JUJgkIcNbhS2goq8RqLuZ4\",version:3,txTime:2019-09-16T19:37:05.344Z,txId:\"FnQeJBAicTX0Ah32ZnVtSX\"}}]}"
    },
    "Proof": {
        "IonText": "[{{l3+EXs69K1+rehlqyWLkt+oHDlw4Zi9pCLW/t/mgTPM=}},{{48CXG3ehPqsxCYd34EEa8Fso0ORpWWAO8010RJKf3Do=}},{{9UnwnKSQT0i3ge1JMVa+tMIqCEDaOPTkWxmyHSn8UPQ=}},{{3nW6Vryghk+7pd6wFCtLufgPM6qXHyTNeCb1sCwcDaI=}},{{Irb5fNhBrNEQ1VPhzlnGT/ZQPadSmgfdtMYcwkNOxoI=}},{{+3CWpYG/ytf/vq9GidpzSx6JJiLXt1hMQWNnqOy3jfY=}},{{NPx6cRhwsiy5m9UEWS5JTJrZoUdO2jBOAAOmyZAT+qE=}}]"
    }
}

Para obter mais informações, consulte Verificação de dados na Amazon QLDB no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte GetBlockna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-digest.

AWS CLI

Para obter um resumo de um livro contábil

O get-digest exemplo a seguir solicita um resumo do livro contábil especificado no último bloco confirmado no diário.

aws qldb get-digest \
    --name vehicle-registration

Saída:

{
    "Digest": "6m6BMXobbJKpMhahwVthAEsN6awgnHK62Qq5McGP1Gk=",
    "DigestTipAddress": {
        "IonText": "{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:123}"
    }
}

Para obter mais informações, consulte Verificação de dados na Amazon QLDB no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte GetDigestna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-revision.

AWS CLI

Exemplo 1: Para obter uma revisão do documento e uma prova para verificação usando arquivos de entrada

O get-revision exemplo a seguir solicita um objeto de dados de revisão e uma prova do livro contábil especificado. A solicitação é para um endereço de dica de resumo, ID do documento e endereço de bloco especificados da revisão.

aws qldb get-revision \
    --name vehicle-registration \
    --block-address file://myblockaddress.json \
    --document-id JUJgkIcNbhS2goq8RqLuZ4 \
    --digest-tip-address file://mydigesttipaddress.json

Conteúdo de myblockaddress.json:

{
    "IonText": "{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100}"
}

Conteúdo de mydigesttipaddress.json:

{
    "IonText": "{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:123}"
}

Saída:

{
    "Revision": {
        "IonText": "{blockAddress:{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100},hash:{{mHVex/yjHAWjFPpwhBuH2GKXmKJjK2FBa9faqoUVNtg=}},data:{VIN:\"1N4AL11D75C109151\",LicensePlateNumber:\"LEWISR261LL\",State:\"WA\",PendingPenaltyTicketAmount:90.25,ValidFromDate:2017-08-21,ValidToDate:2020-05-11,Owners:{PrimaryOwner:{PersonId:\"BFJKdXhnLRT27sXBnojNGW\"},SecondaryOwners:[{PersonId:\"CMVdR77XP8zAglmmFDGTvt\"}]},City:\"Everett\"},metadata:{id:\"JUJgkIcNbhS2goq8RqLuZ4\",version:3,txTime:2019-09-16T19:37:05.344Z,txId:\"FnQeJBAicTX0Ah32ZnVtSX\"}}"
    },
    "Proof": {
        "IonText": "[{{eRSwnmAM7WWANWDd5iGOyK+T4tDXyzUq6HZ/0fgLHos=}},{{VV1rdaNuf+yJZVGlmsM6gr2T52QvBO8Lg+KgpjcnWAU=}},{{7kewBXhpdbClcZKxhVmpoMHpUGOJtWQD0iY2LPfZkYA=}},{{l3+EXs69K1+rehlqyWLkt+oHDlw4Zi9pCLW/t/mgTPM=}},{{48CXG3ehPqsxCYd34EEa8Fso0ORpWWAO8010RJKf3Do=}},{{9UnwnKSQT0i3ge1JMVa+tMIqCEDaOPTkWxmyHSn8UPQ=}},{{3nW6Vryghk+7pd6wFCtLufgPM6qXHyTNeCb1sCwcDaI=}},{{Irb5fNhBrNEQ1VPhzlnGT/ZQPadSmgfdtMYcwkNOxoI=}},{{+3CWpYG/ytf/vq9GidpzSx6JJiLXt1hMQWNnqOy3jfY=}},{{NPx6cRhwsiy5m9UEWS5JTJrZoUdO2jBOAAOmyZAT+qE=}}]"
    }
}

Para obter mais informações, consulte Verificação de dados na Amazon QLDB no Amazon QLDB Developer Guide.

Exemplo 2: Para obter uma revisão do documento e uma prova para verificação usando a sintaxe abreviada

O get-revision exemplo a seguir solicita um objeto de dados de revisão e uma prova do livro contábil especificado usando a sintaxe abreviada. A solicitação é para um endereço de dica de resumo, ID do documento e endereço de bloco especificados da revisão.

aws qldb get-revision \
    --name vehicle-registration \
    --block-address 'IonText="{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100}"' \
    --document-id JUJgkIcNbhS2goq8RqLuZ4 \
    --digest-tip-address 'IonText="{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:123}"'

Saída:

{
    "Revision": {
        "IonText": "{blockAddress:{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100},hash:{{mHVex/yjHAWjFPpwhBuH2GKXmKJjK2FBa9faqoUVNtg=}},data:{VIN:\"1N4AL11D75C109151\",LicensePlateNumber:\"LEWISR261LL\",State:\"WA\",PendingPenaltyTicketAmount:90.25,ValidFromDate:2017-08-21,ValidToDate:2020-05-11,Owners:{PrimaryOwner:{PersonId:\"BFJKdXhnLRT27sXBnojNGW\"},SecondaryOwners:[{PersonId:\"CMVdR77XP8zAglmmFDGTvt\"}]},City:\"Everett\"},metadata:{id:\"JUJgkIcNbhS2goq8RqLuZ4\",version:3,txTime:2019-09-16T19:37:05.344Z,txId:\"FnQeJBAicTX0Ah32ZnVtSX\"}}"
    },
    "Proof": {
        "IonText": "[{{eRSwnmAM7WWANWDd5iGOyK+T4tDXyzUq6HZ/0fgLHos=}},{{VV1rdaNuf+yJZVGlmsM6gr2T52QvBO8Lg+KgpjcnWAU=}},{{7kewBXhpdbClcZKxhVmpoMHpUGOJtWQD0iY2LPfZkYA=}},{{l3+EXs69K1+rehlqyWLkt+oHDlw4Zi9pCLW/t/mgTPM=}},{{48CXG3ehPqsxCYd34EEa8Fso0ORpWWAO8010RJKf3Do=}},{{9UnwnKSQT0i3ge1JMVa+tMIqCEDaOPTkWxmyHSn8UPQ=}},{{3nW6Vryghk+7pd6wFCtLufgPM6qXHyTNeCb1sCwcDaI=}},{{Irb5fNhBrNEQ1VPhzlnGT/ZQPadSmgfdtMYcwkNOxoI=}},{{+3CWpYG/ytf/vq9GidpzSx6JJiLXt1hMQWNnqOy3jfY=}},{{NPx6cRhwsiy5m9UEWS5JTJrZoUdO2jBOAAOmyZAT+qE=}}]"
    }
}

Para obter mais informações, consulte Verificação de dados na Amazon QLDB no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte GetRevisionna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-journal-kinesis-streams-for-ledger.

AWS CLI

Para listar fluxos de diário para um livro contábil

O list-journal-kinesis-streams-for-ledger exemplo a seguir lista fluxos de diário para o livro contábil especificado.

aws qldb list-journal-kinesis-streams-for-ledger \
    --ledger-name myExampleLedger

Saída:

{
    "Streams": [
        {
            "LedgerName": "myExampleLedger",
            "CreationTime": 1591221984.677,
            "InclusiveStartTime": 1590710400.0,
            "ExclusiveEndTime": 1590796799.0,
            "RoleArn": "arn:aws:iam::123456789012:role/my-kinesis-stream-role",
            "StreamId": "7ISCkqwe4y25YyHLzYUFAf",
            "Arn": "arn:aws:qldb:us-east-1:123456789012:stream/myExampleLedger/7ISCkqwe4y25YyHLzYUFAf",
            "Status": "ACTIVE",
            "KinesisConfiguration": {
                "StreamArn": "arn:aws:kinesis:us-east-1:123456789012:stream/stream-for-qldb",
                "AggregationEnabled": true
            },
            "StreamName": "myExampleLedger-stream"
        }
    ]
}

Para obter mais informações, consulte Dados de periódicos de streaming da Amazon QLDB no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar list-journal-s3-exports-for-ledger.

AWS CLI

Para listar trabalhos de exportação de diário para um livro contábil

O list-journal-s3-exports-for-ledger exemplo a seguir lista os trabalhos de exportação de diário para o livro contábil especificado.

aws qldb list-journal-s3-exports-for-ledger \
    --name myExampleLedger

Saída:

{
    "JournalS3Exports": [
        {
            "LedgerName": "myExampleLedger",
            "ExclusiveEndTime": 1568847599.0,
            "ExportCreationTime": 1568847801.418,
            "S3ExportConfiguration": {
                "Bucket": "awsExampleBucket",
                "Prefix": "ledgerexport1/",
                "EncryptionConfiguration": {
                    "ObjectEncryptionType": "SSE_S3"
                }
            },
            "ExportId": "ADR2ONPKN5LINYGb4dp7yZ",
            "RoleArn": "arn:aws:iam::123456789012:role/qldb-s3-export",
            "InclusiveStartTime": 1568764800.0,
            "Status": "IN_PROGRESS"
        }
    ]
}

Para obter mais informações, consulte Exportando seu periódico na Amazon QLDB no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar list-journal-s3-exports.

AWS CLI

Para listar trabalhos de exportação de diário

O list-journal-s3-exports exemplo a seguir lista os trabalhos de exportação de diário para todos os livros contábeis associados à AWS conta corrente e à região.

aws qldb list-journal-s3-exports

Saída:

{
    "JournalS3Exports": [
        {
            "Status": "IN_PROGRESS",
            "LedgerName": "myExampleLedger",
            "S3ExportConfiguration": {
                "EncryptionConfiguration": {
                    "ObjectEncryptionType": "SSE_S3"
                },
                "Bucket": "awsExampleBucket",
                "Prefix": "ledgerexport1/"
            },
            "RoleArn": "arn:aws:iam::123456789012:role/my-s3-export-role",
            "ExportCreationTime": 1568847801.418,
            "ExportId": "ADR2ONPKN5LINYGb4dp7yZ",
            "InclusiveStartTime": 1568764800.0,
            "ExclusiveEndTime": 1568847599.0
        },
        {
            "Status": "COMPLETED",
            "LedgerName": "myExampleLedger2",
            "S3ExportConfiguration": {
                "EncryptionConfiguration": {
                    "ObjectEncryptionType": "SSE_S3"
                },
                "Bucket": "awsExampleBucket",
                "Prefix": "ledgerexport1/"
            },
            "RoleArn": "arn:aws:iam::123456789012:role/my-s3-export-role",
            "ExportCreationTime": 1568846847.638,
            "ExportId": "2pdvW8UQrjBAiYTMehEJDI",
            "InclusiveStartTime": 1568592000.0,
            "ExclusiveEndTime": 1568764800.0
        }
    ]
}

Para obter mais informações, consulte Exportando seu periódico na Amazon QLDB no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar list-ledgers.

AWS CLI

Como listar os livros de registros disponíveis

O list-ledgers exemplo a seguir lista todos os livros contábeis associados à AWS conta corrente e à região.

aws qldb list-ledgers

Saída:

{
    "Ledgers": [
        {
            "State": "ACTIVE",
            "CreationDateTime": 1568839243.951,
            "Name": "myExampleLedger"
        },
        {
            "State": "ACTIVE",
            "CreationDateTime": 1568839543.557,
            "Name": "myExampleLedger2"
        }
    ]
}

Para obter mais informações, consulte Operações básicas do Amazon QLDB Ledgers no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte ListLedgersna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Para listar as etiquetas anexadas a um livro contábil

O list-tags-for-resource exemplo a seguir lista todas as tags anexadas ao livro contábil especificado.

aws qldb list-tags-for-resource \
    --resource-arn arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger

Saída:

{
    "Tags": {
        "IsTest": "true",
        "Domain": "Test"
    }
}

Para obter mais informações, consulte Como marcar QLDB recursos da Amazon no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar stream-journal-to-kinesis.

AWS CLI

Exemplo 1: Para transmitir dados do diário para o Kinesis Data Streams usando arquivos de entrada

O stream-journal-to-kinesis exemplo a seguir cria um fluxo de dados do diário dentro de um intervalo de data e hora especificado a partir de um livro contábil com o nomemyExampleLedger. O stream envia os dados para um stream de dados específico do Amazon Kinesis.

aws qldb stream-journal-to-kinesis \
    --ledger-name myExampleLedger \
    --inclusive-start-time 2020-05-29T00:00:00Z \
    --exclusive-end-time 2020-05-29T23:59:59Z \
    --role-arn arn:aws:iam::123456789012:role/my-kinesis-stream-role \
    --kinesis-configuration file://my-kinesis-config.json \
    --stream-name myExampleLedger-stream

Conteúdo de my-kinesis-config.json:

{
    "StreamArn": "arn:aws:kinesis:us-east-1:123456789012:stream/stream-for-qldb",
    "AggregationEnabled": true
}

Saída:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Para obter mais informações, consulte Dados de periódicos de streaming da Amazon QLDB no Amazon QLDB Developer Guide.

Exemplo 2: Para transmitir dados do diário para o Kinesis Data Streams usando a sintaxe abreviada

O stream-journal-to-kinesis exemplo a seguir cria um fluxo de dados do diário dentro de um intervalo de data e hora especificado a partir de um livro contábil com o nomemyExampleLedger. O stream envia os dados para um stream de dados específico do Amazon Kinesis.

aws qldb stream-journal-to-kinesis \
    --ledger-name myExampleLedger \
    --inclusive-start-time 2020-05-29T00:00:00Z \
    --exclusive-end-time 2020-05-29T23:59:59Z \
    --role-arn arn:aws:iam::123456789012:role/my-kinesis-stream-role \
    --stream-name myExampleLedger-stream \
    --kinesis-configuration StreamArn=arn:aws:kinesis:us-east-1:123456789012:stream/stream-for-qldb,AggregationEnabled=true

Saída:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Para obter mais informações, consulte Dados de periódicos de streaming da Amazon QLDB no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Para marcar um livro contábil

O tag-resource exemplo a seguir adiciona um conjunto de tags a um livro contábil especificado.

aws qldb tag-resource \
    --resource-arn arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger \
    --tags IsTest=true,Domain=Test

Este comando não produz saída.

Para obter mais informações, consulte Como marcar QLDB recursos da Amazon no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte TagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Como remover as tags de um recurso

O untag-resource exemplo a seguir remove tags com as chaves de tag especificadas de um livro contábil especificado.

aws qldb untag-resource \
    --resource-arn arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger \
    --tag-keys IsTest Domain

Este comando não produz saída.

Para obter mais informações, consulte Como marcar QLDB recursos da Amazon no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte UntagResourcena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-ledger-permissions-mode.

AWS CLI

Exemplo 1: Para atualizar o modo de permissões de um livro contábil para STANDARD

O update-ledger-permissions-mode exemplo a seguir atribui o modo de STANDARD permissões ao livro contábil especificado.

aws qldb update-ledger-permissions-mode \
    --name myExampleLedger \
    --permissions-mode STANDARD

Saída:

{
    "Name": "myExampleLedger",
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger",
    "PermissionsMode": "STANDARD"
}

Exemplo 2: Para atualizar o modo de permissões de um livro contábil para _ ALLOW ALL

O update-ledger-permissions-mode exemplo a seguir atribui o modo de ALLOW_ALL permissões ao livro contábil especificado.

aws qldb update-ledger-permissions-mode \
    --name myExampleLedger \
    --permissions-mode ALLOW_ALL

Saída:

{
    "Name": "myExampleLedger",
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger",
    "PermissionsMode": "ALLOW_ALL"
}

Para obter mais informações, consulte Operações básicas do Amazon QLDB Ledgers no Amazon QLDB Developer Guide.

O código de exemplo a seguir mostra como usar update-ledger.

AWS CLI

Exemplo 1: Para atualizar a propriedade de proteção contra exclusão de um livro contábil

O update-ledger exemplo a seguir atualiza o livro contábil especificado para desativar o recurso de proteção contra exclusão.

aws qldb update-ledger \
    --name myExampleLedger \
    --no-deletion-protection

Saída:

{
    "CreationDateTime": 1568839243.951,
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger",
    "DeletionProtection": false,
    "Name": "myExampleLedger",
    "State": "ACTIVE"
}

Exemplo 2: Para atualizar a AWS KMS chave de um livro contábil para uma chave gerenciada pelo cliente

O update-ledger exemplo a seguir atualiza o livro contábil especificado para usar uma KMS chave gerenciada pelo cliente para criptografia em repouso.

aws qldb update-ledger \
    --name myExampleLedger \
    --kms-key arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Saída:

{
    "CreationDateTime": 1568839243.951,
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger",
    "DeletionProtection": false,
    "Name": "myExampleLedger",
    "State": "ACTIVE",
    "EncryptionDescription": {
        "KmsKeyArn": "arn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "EncryptionStatus": "UPDATING"
    }
}

Exemplo 3: Para atualizar a AWS KMS chave de um livro contábil para uma chave AWS própria

O update-ledger exemplo a seguir atualiza o livro contábil especificado para usar uma AWS KMS chave própria para criptografia em repouso.

aws qldb update-ledger \
    --name myExampleLedger \
    --kms-key AWS_OWNED_KMS_KEY

Saída:

{
    "CreationDateTime": 1568839243.951,
    "Arn": "arn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger",
    "DeletionProtection": false,
    "Name": "myExampleLedger",
    "State": "ACTIVE",
    "EncryptionDescription": {
        "KmsKeyArn": "AWS_OWNED_KMS_KEY",
        "EncryptionStatus": "UPDATING"
    }
}

Para obter mais informações, consulte Operações básicas do Amazon QLDB Ledgers no Amazon QLDB Developer Guide.

  • Para API obter detalhes, consulte UpdateLedgerna Referência de AWS CLI Comandos.