Ejemplos de QLDB utilizando AWS CLI - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de ejemplos de AWS Doc SDK.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de QLDB utilizando AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de AWS Command Line Interface QLDB.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar cancel-journal-kinesis-stream.

AWS CLI

Para cancelar una transmisión de diario

En el siguiente ejemplo de cancel-journal-kinesis-stream, se cancela una transmisión de diario específica de un libro mayor.

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

Salida:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Para obtener más información, consulte Streaming journal data from Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

En el siguiente ejemplo de código, se muestra cómo utilizar create-ledger.

AWS CLI

Ejemplo 1: Creación de un libro mayor con las propiedades predeterminadas

En el siguiente ejemplo de create-ledger se crea un libro mayor con el nombre myExampleLedger y el modo de permisos STANDARD. Los parámetros opcionales para la protección contra la eliminación y la clave de AWS KMS no están especificados, por lo que de forma predeterminada son una clave de KMS true propia y una AWS clave de KMS propia, respectivamente.

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

Salida:

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

Ejemplo 2: Creación de un libro mayor con la protección contra eliminación desactivada, una clave de KMS administrada por el cliente y etiquetas especificadas

En el siguiente ejemplo de create-ledger se crea un libro mayor con el nombre myExampleLedger2 y el modo de permisos STANDARD. La característica de protección contra la eliminación está deshabilitada, la clave de KMS administrada por el cliente especificada se utiliza para el cifrado en reposo y las etiquetas especificadas se adjuntan al 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

Salida:

{
    "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 obtener más información, consulte Operaciones básicas de libros mayores de Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte CreateLedgerla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-ledger.

AWS CLI

Para eliminar el libro mayor

En el siguiente ejemplo de delete-ledger se elimina el libro mayor especificado.

aws qldb delete-ledger \
    --name myExampleLedger

Este comando no genera ninguna salida.

Para obtener más información, consulte Operaciones básicas de libros mayores de Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte DeleteLedgerla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-journal-kinesis-stream.

AWS CLI

Para describir una transmisión de diario

El siguiente ejemplo de describe-journal-kinesis-stream muestra los detalles de la transmisión de diario específica desde un libro mayor.

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

Salida:

{
    "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 obtener más información, consulte Streaming journal data from Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-journal-s3-export.

AWS CLI

Para describir un trabajo de exportación de diarios

El siguiente ejemplo de describe-journal-s3-export muestra los detalles de un trabajo de exportación específico desde un libro mayor.

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

Salida:

{
    "ExportDescription": {
        "S3ExportConfiguration": {
            "Bucket": "amzn-s3-demo-bucket",
            "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 obtener más información, consulte Exporting Your Journal in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-ledger.

AWS CLI

Descripción de un libro mayor

En el siguiente ejemplo de describe-ledger, se muestran los detalles del libro mayor especificado.

aws qldb describe-ledger \
    --name myExampleLedger

Salida:

{
    "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 obtener más información, consulte Operaciones básicas de libros mayores de Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte la Referencia DescribeLedgerde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar export-journal-to-s3.

AWS CLI

Para exportar bloques de diarios a S3

En el siguiente ejemplo de export-journal-to-s3, se crea un trabajo de exportación de bloques de diario dentro de un intervalo de fechas y horas especificado a partir de un libro mayor con el nombre myExampleLedger. El trabajo de exportación escribe los bloques en un bucket de Amazon S3 especificado.

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

Contenido de my-s3-export-config.json:

{
    "Bucket": "amzn-s3-demo-bucket",
    "Prefix": "ledgerexport1/",
    "EncryptionConfiguration": {
        "ObjectEncryptionType": "SSE_S3"
    }
}

Salida:

{
    "ExportId": "ADR2ONPKN5LINYGb4dp7yZ"
}

Para obtener más información, consulte Exporting Your Journal in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener información sobre la API, consulte ExportJournalToS3 en la referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-block.

AWS CLI

Ejemplo 1: obtención de un bloque de diario y una prueba de verificación mediante archivos de entrada

En el siguiente ejemplo de get-block, se solicita un objeto de datos de bloque y una prueba del libro mayor especificado. La solicitud es para una dirección para la sugerencia de resumen y una dirección de bloque especificadas.

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

Contenido de myblockaddress.json:

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

Contenido de mydigesttipaddress.json:

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

Salida:

{
    "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 obtener más información, consulte Data Verification in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

Ejemplo 2: Obtención de un bloque de diario y una prueba de verificación mediante sintaxis abreviada

En el siguiente ejemplo de get-block, se solicita un objeto de datos de bloque y una prueba del libro mayor especificado mediante sintaxis abreviada. La solicitud es para una dirección para la sugerencia de resumen y una dirección de bloque especificadas.

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

Salida:

{
    "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 obtener más información, consulte Data Verification in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte GetBlockla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-digest.

AWS CLI

Para obtener un resumen de un libro mayor

En el siguiente ejemplo de get-digest se solicita un resumen del libro mayor especificado en el último bloque confirmado del diario.

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

Salida:

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

Para obtener más información, consulte Data Verification in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte GetDigestla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-revision.

AWS CLI

Ejemplo 1: obtención de una revisión de documento y una prueba de verificación mediante archivos de entrada

En el siguiente ejemplo de get-revision, se solicita un objeto de datos de revisión y una prueba del libro mayor especificado. La solicitud es para una dirección de la sugerencia de resumen y una dirección de bloque especificadas.

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

Contenido de myblockaddress.json:

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

Contenido de mydigesttipaddress.json:

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

Salida:

{
    "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 obtener más información, consulte Data Verification in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

Ejemplo 2: Obtención de la revisión de un documento y una prueba de verificación mediante una sintaxis abreviada

En el siguiente ejemplo de get-revision, se solicita un objeto de datos de revisión y una prueba del libro mayor especificado mediante sintaxis abreviada. La solicitud es para una dirección de la sugerencia de resumen y una dirección de bloque especificadas.

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}"'

Salida:

{
    "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 obtener más información, consulte Data Verification in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte GetRevisionla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-journal-kinesis-streams-for-ledger.

AWS CLI

Para enumerar las transmisiones de diario de un libro mayor

En el siguiente ejemplo de list-journal-kinesis-streams-for-ledger, se enumeran las transmisiones de diario para el libro mayor especificado.

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

Salida:

{
    "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 obtener más información, consulte Streaming journal data from Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

En el siguiente ejemplo de código, se muestra cómo utilizar list-journal-s3-exports-for-ledger.

AWS CLI

Para enumerar los trabajos de exportación del diario para un libro mayor

En el siguiente ejemplo de list-journal-s3-exports-for-ledger, se enumeran los trabajos de exportación del diario para el libro mayor especificado.

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

Salida:

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

Para obtener más información, consulte Exporting Your Journal in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

En el siguiente ejemplo de código, se muestra cómo utilizar list-journal-s3-exports.

AWS CLI

Para enumerar los trabajos de exportación de un diario

En el siguiente list-journal-s3-exports ejemplo, se enumeran los trabajos de exportación de diarios de todos los libros de contabilidad asociados a la AWS cuenta corriente y a la región.

aws qldb list-journal-s3-exports

Salida:

{
    "JournalS3Exports": [
        {
            "Status": "IN_PROGRESS",
            "LedgerName": "myExampleLedger",
            "S3ExportConfiguration": {
                "EncryptionConfiguration": {
                    "ObjectEncryptionType": "SSE_S3"
                },
                "Bucket": "amzn-s3-demo-bucket",
                "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": "amzn-s3-demo-bucket",
                "Prefix": "ledgerexport1/"
            },
            "RoleArn": "arn:aws:iam::123456789012:role/my-s3-export-role",
            "ExportCreationTime": 1568846847.638,
            "ExportId": "2pdvW8UQrjBAiYTMehEJDI",
            "InclusiveStartTime": 1568592000.0,
            "ExclusiveEndTime": 1568764800.0
        }
    ]
}

Para obtener más información, consulte Exporting Your Journal in Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener información sobre la API, consulte ListJournalS3Exports en AWS CLI la referencia de comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-ledgers.

AWS CLI

Creación de una lista de los libros mayores disponibles

En el siguiente list-ledgers ejemplo, se enumeran todos los libros de contabilidad asociados a la AWS cuenta corriente y a la región.

aws qldb list-ledgers

Salida:

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

Para obtener más información, consulte Operaciones básicas de libros mayores de Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte ListLedgersla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource.

AWS CLI

Para enumerar las etiquetas adjuntas a un libro mayor

En el siguiente ejemplo de list-tags-for-resource se enumeran todas las etiquetas asociadas al libro mayor específico.

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

Salida:

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

Para obtener más información, consulte Tagging Amazon QLDB Resources en la Guía del desarrollador de Amazon QLDB.

  • Para obtener más información sobre la API, consulte ListTagsForResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar stream-journal-to-kinesis.

AWS CLI

Ejemplo 1: transmisión de datos del diario a Kinesis Data Streams mediante archivos de entrada

En el siguiente ejemplo de stream-journal-to-kinesis, se crea una transmisión de datos del diario dentro de un intervalo de fechas y horas específico a partir de un libro mayor con el nombre myExampleLedger. La transmisión envía los datos a una transmisión de datos de Amazon Kinesis específica.

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

Contenido de my-kinesis-config.json:

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

Salida:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Para obtener más información, consulte Streaming journal data from Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

Ejemplo 2: transmisión de datos del diario a Kinesis Data Streams mediante una sintaxis abreviada

En el siguiente ejemplo de stream-journal-to-kinesis, se crea una transmisión de datos del diario dentro de un intervalo de fechas y horas específico a partir de un libro mayor con el nombre myExampleLedger. La transmisión envía los datos a una transmisión de datos de Amazon Kinesis específica.

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

Salida:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Para obtener más información, consulte Streaming journal data from Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte StreamJournalToKinesisla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar tag-resource.

AWS CLI

Para etiquetar un libro mayor

En el siguiente ejemplo de tag-resource, se agrega un conjunto de etiquetas a un libro mayor especificado.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Tagging Amazon QLDB Resources en la Guía del desarrollador de Amazon QLDB.

  • Para obtener más información sobre la API, consulte TagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar untag-resource.

AWS CLI

Para eliminar etiquetas de un recurso

En el siguiente ejemplo de untag-resource se eliminan las etiquetas con las claves de etiqueta específicas desde un libro mayor específico.

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Tagging Amazon QLDB Resources en la Guía del desarrollador de Amazon QLDB.

  • Para obtener más información sobre la API, consulte UntagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar update-ledger-permissions-mode.

AWS CLI

Ejemplo 1: actualización del modo de permisos de un libro mayor a STANDARD

El siguiente ejemplo de update-ledger-permissions-mode asigna el modo de permisos de STANDARD al libro mayor especificado.

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

Salida:

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

Ejemplo 2: actualización del modo de permisos de un libro mayor a ALLOW_ALL

El siguiente ejemplo de update-ledger-permissions-mode asigna el modo de permisos de ALLOW_ALL al libro mayor especificado.

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

Salida:

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

Para obtener más información, consulte Operaciones básicas de libros mayores de Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

En el siguiente ejemplo de código, se muestra cómo utilizar update-ledger.

AWS CLI

Ejemplo 1: actualización de la propiedad de protección contra la eliminación de un libro mayor

En el siguiente ejemplo de update-ledger, se actualiza el libro mayor especificado para deshabilitar la característica de protección contra la eliminación.

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

Salida:

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

Ejemplo 2: Para actualizar la clave AWS KMS de un libro mayor a una clave gestionada por el cliente

En el siguiente ejemplo de update-ledger se actualiza el libro mayor especificado para usar una clave de KMS administrada por el cliente para el cifrado en reposo.

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

Salida:

{
    "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"
    }
}

Ejemplo 3: Para actualizar la clave AWS KMS de un libro mayor a una AWS clave propia

En el siguiente update-ledger ejemplo, se actualiza el libro mayor especificado para usar una clave AWS KMS propia para el cifrado en reposo.

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

Salida:

{
    "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 obtener más información, consulte Operaciones básicas de libros mayores de Amazon QLDB en la Guía para desarrolladores de Amazon QLDB.

  • Para obtener más información sobre la API, consulte UpdateLedgerla Referencia de AWS CLI comandos.