QLDBejemplos que utilizan AWS CLI - AWS Command Line Interface
Acciones

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.

QLDBejemplos que utilizan AWS CLI

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

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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

El siguiente ejemplo de código muestra cómo usarlocancel-journal-kinesis-stream.

AWS CLI

Para cancelar la transmisión de un diario

En el siguiente cancel-journal-kinesis-stream ejemplo, se cancela el flujo de diario especificado 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 Transmitir datos de revistas de Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

El siguiente ejemplo de código muestra cómo usarlocreate-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 AWS KMS clave no están especificados, por lo que los valores predeterminados son una clave true propia y AWS una KMS clave 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: Para crear un libro mayor con la protección contra la eliminación desactivada, una KMS clave gestionada 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 función de protección contra la eliminación está desactivada, la KMS clave gestionada 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 Amazon QLDB Ledgers en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlodelete-ledger.

AWS CLI

Para eliminar un libro mayor

En el siguiente delete-ledger ejemplo, 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 Amazon QLDB Ledgers en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlodescribe-journal-kinesis-stream.

AWS CLI

Para describir un flujo de diario

En el siguiente describe-journal-kinesis-stream ejemplo, se muestran los detalles del flujo de diario especificado 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 Transmitir datos de revistas de Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

El siguiente ejemplo de código muestra cómo usarlodescribe-journal-s3-export.

AWS CLI

Para describir un trabajo de exportación de revistas

En el siguiente describe-journal-s3-export ejemplo, se muestran los detalles del trabajo de exportación especificado desde un libro mayor.

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

Salida:

{
    "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 obtener más información, consulta Cómo exportar tu diario en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

El siguiente ejemplo de código muestra cómo usarlo. describe-ledger

AWS CLI

Para describir un libro mayor

En el siguiente describe-ledger ejemplo, 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 Amazon QLDB Ledgers en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarloexport-journal-to-s3.

AWS CLI

Para exportar bloques de diario a S3

En el siguiente export-journal-to-s3 ejemplo, 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 ese nombremyExampleLedger. El trabajo de exportación escribe los bloques en un bucket de Amazon S3 específico.

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

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

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

Salida:

{
    "ExportId": "ADR2ONPKN5LINYGb4dp7yZ"
}

Para obtener más información, consulta Cómo exportar tu diario en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarloget-block.

AWS CLI

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

En el siguiente get-block ejemplo, se solicita un objeto de datos en bloque y una prueba del libro mayor especificado. La solicitud es para una dirección 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

Contenidos de myblockaddress.json:

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

Contenidos 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, consulta la verificación de datos en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

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

En el siguiente get-block ejemplo, se solicita un objeto de datos en bloque y una prueba del libro mayor especificado mediante una sintaxis abreviada. La solicitud es para una dirección de sugerencia resumida 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, consulta la verificación de datos en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarloget-digest.

AWS CLI

Para obtener un resumen de un libro mayor

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

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

Salida:

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

Para obtener más información, consulta la verificación de datos en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarloget-revision.

AWS CLI

Ejemplo 1: Para obtener una revisión de un documento y una prueba de verificación mediante archivos de entrada

En el siguiente get-revision ejemplo, se solicita un objeto de datos de revisión y una prueba del libro mayor especificado. La solicitud se refiere a una dirección de sugerencia resumida, un identificador de documento y una dirección de bloque específicos de la revisión.

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

Contenidos de myblockaddress.json:

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

Contenidos 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, consulta la verificación de datos en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

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

En el siguiente get-revision ejemplo, se solicita un objeto de datos de revisión y una prueba del libro mayor especificado mediante una sintaxis abreviada. La solicitud se refiere a una dirección de sugerencia resumida, un identificador de documento y una dirección de bloque específicos de la revisión.

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, consulta la verificación de datos en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlolist-journal-kinesis-streams-for-ledger.

AWS CLI

Para enumerar los flujos de diario de un libro mayor

En el siguiente list-journal-kinesis-streams-for-ledger ejemplo, se muestran los flujos de diario del 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 Transmitir datos de revistas de Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

El siguiente ejemplo de código muestra cómo usarlolist-journal-s3-exports-for-ledger.

AWS CLI

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

En el siguiente list-journal-s3-exports-for-ledger ejemplo, se enumeran los trabajos de exportación de asientos 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": "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 obtener más información, consulta Cómo exportar tu diario en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

El siguiente ejemplo de código muestra cómo usarlolist-journal-s3-exports.

AWS CLI

Para enumerar los trabajos de exportación de revistas

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": "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 obtener más información, consulta Cómo exportar tu diario en Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlo. 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 Amazon QLDB Ledgers en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlolist-tags-for-resource.

AWS CLI

Para enumerar las etiquetas adjuntas a un libro mayor

En el siguiente list-tags-for-resource ejemplo, se enumeran todas las etiquetas adjuntas al libro mayor especificado.

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 Etiquetado de QLDB los recursos de Amazon en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlostream-journal-to-kinesis.

AWS CLI

Ejemplo 1: Para transmitir datos del diario a Kinesis Data Streams mediante archivos de entrada

El siguiente stream-journal-to-kinesis ejemplo crea un flujo de datos del diario dentro de un intervalo de fechas y horas especificado a partir de un libro mayor con ese 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

Contenidos 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 Transmitir datos de revistas de Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

Ejemplo 2: Para transmitir los datos del diario a Kinesis Data Streams mediante una sintaxis abreviada

El siguiente stream-journal-to-kinesis ejemplo crea un flujo de datos del diario dentro de un intervalo de fechas y horas especificado a partir de un libro mayor con ese 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 Transmitir datos de revistas de Amazon QLDB en la Guía para QLDB desarrolladores de Amazon.

El siguiente ejemplo de código muestra cómo usarlotag-resource.

AWS CLI

Para etiquetar un libro mayor

En el siguiente tag-resource ejemplo, 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 Etiquetado de QLDB los recursos de Amazon en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarlountag-resource.

AWS CLI

Cómo eliminar etiquetas de un recurso

En el siguiente untag-resource ejemplo, se quitan las etiquetas con las claves de etiqueta especificadas de un libro mayor especificado.

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 Etiquetado de QLDB los recursos de Amazon en la Guía para QLDB desarrolladores de Amazon.

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

El siguiente ejemplo de código muestra cómo usarloupdate-ledger-permissions-mode.

AWS CLI

Ejemplo 1: Para actualizar el modo de permisos de un libro mayor a STANDARD

El siguiente update-ledger-permissions-mode ejemplo asigna el modo de STANDARD permisos 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: Para actualizar el modo de permisos de un libro mayor a _ ALLOW ALL

El siguiente update-ledger-permissions-mode ejemplo asigna el modo de ALLOW_ALL permisos 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 Amazon QLDB Ledgers en la Guía para QLDB desarrolladores de Amazon.

El siguiente ejemplo de código muestra cómo usarloupdate-ledger.

AWS CLI

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

En el siguiente update-ledger ejemplo, se actualiza el libro mayor especificado para deshabilitar la función 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 AWS KMS clave de un libro mayor a una clave gestionada por el cliente

En el siguiente update-ledger ejemplo, se actualiza el libro mayor especificado para utilizar una KMS clave gestionada 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 AWS KMS clave de un libro mayor a una AWS clave propia

En el siguiente update-ledger ejemplo, se actualiza el libro mayor especificado para usar una KMS clave AWS 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 Amazon QLDB Ledgers en la Guía para QLDB desarrolladores de Amazon.

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