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.
Temas
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-namemyExampleLedger\ --stream-id7ISCkqwe4y25YyHLzYUFAfSalida:
{ "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 la Referencia CancelJournalKinesisStream
de AWS CLI comandos.
-
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-ledgerse crea un libro mayor con el nombremyExampleLedgery el modo de permisosSTANDARD. 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 se utilizan de forma predeterminada una clave de KMStruepropia y una AWS clave de KMS propia, respectivamente.aws qldb create-ledger \ --namemyExampleLedger\ --permissions-modeSTANDARDSalida:
{ "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-ledgerse crea un libro mayor con el nombremyExampleLedger2y el modo de permisosSTANDARD. 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 \ --namemyExampleLedger2\ --permissions-modeSTANDARD\ --no-deletion-protection \ --kms-keyarn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111\ --tagsIsTest=true,Domain=TestSalida:
{ "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 CreateLedger
la 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-ledgerse elimina el libro mayor especificado.aws qldb delete-ledger \ --namemyExampleLedgerEste 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 DeleteLedger
la 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-streammuestra los detalles de la transmisión de diario específica desde un libro mayor.aws qldb describe-journal-kinesis-stream \ --ledger-namemyExampleLedger\ --stream-id7ISCkqwe4y25YyHLzYUFAfSalida:
{ "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.
-
Para obtener más información sobre la API, consulte DescribeJournalKinesisStream
la Referencia de AWS CLI comandos.
-
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-exportmuestra los detalles de un trabajo de exportación específico desde un libro mayor.aws qldb describe-journal-s3-export \ --namemyExampleLedger\ --export-idADR2ONPKN5LINYGb4dp7yZSalida:
{ "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.
-
Para obtener información sobre la API, consulte DescribeJournalS3Export
en la referencia de AWS CLI comandos.
-
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 \ --namemyExampleLedgerSalida:
{ "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 DescribeLedger
de 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 nombremyExampleLedger. El trabajo de exportación escribe los bloques en un bucket de Amazon S3 especificado.aws qldb export-journal-to-s3 \ --namemyExampleLedger\ --inclusive-start-time2019-09-18T00:00:00Z\ --exclusive-end-time2019-09-18T22:59:59Z\ --role-arnarn:aws:iam::123456789012:role/my-s3-export-role\ --s3-export-configurationfile://my-s3-export-config.jsonContenido 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 \ --namevehicle-registration\ --block-addressfile://myblockaddress.json\ --digest-tip-addressfile://mydigesttipaddress.jsonContenido 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 \ --namevehicle-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 GetBlock
la 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-digestse solicita un resumen del libro mayor especificado en el último bloque confirmado del diario.aws qldb get-digest \ --namevehicle-registrationSalida:
{ "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 GetDigest
la 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 \ --namevehicle-registration\ --block-addressfile://myblockaddress.json\ --document-idJUJgkIcNbhS2goq8RqLuZ4\ --digest-tip-addressfile://mydigesttipaddress.jsonContenido 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 \ --namevehicle-registration\ --block-address 'IonText="{strandId:\"KmA3ZZca7vAIiJAK9S5Iwl\",sequenceNo:100}"' \ --document-idJUJgkIcNbhS2goq8RqLuZ4\ --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 GetRevision
la 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-namemyExampleLedgerSalida:
{ "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.
-
Para obtener más información sobre la API, consulte ListJournalKinesisStreamsForLedger
la Referencia de AWS CLI comandos.
-
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 \ --namemyExampleLedgerSalida:
{ "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.
-
Para obtener información sobre la API, consulte ListJournalS3 ExportsForLedger
en la referencia de AWS CLI comandos.
-
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-exportsejemplo, 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-exportsSalida:
{ "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-ledgersejemplo, se enumeran todos los libros de contabilidad asociados a la AWS cuenta corriente y a la región.aws qldb list-ledgersSalida:
{ "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 ListLedgers
la 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-resourcese enumeran todas las etiquetas asociadas al libro mayor específico.aws qldb list-tags-for-resource \ --resource-arnarn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedgerSalida:
{ "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 ListTagsForResource
la 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 nombremyExampleLedger. 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-namemyExampleLedger\ --inclusive-start-time2020-05-29T00:00:00Z\ --exclusive-end-time2020-05-29T23:59:59Z\ --role-arnarn:aws:iam::123456789012:role/my-kinesis-stream-role\ --kinesis-configurationfile://my-kinesis-config.json\ --stream-namemyExampleLedger-streamContenido 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 nombremyExampleLedger. 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-namemyExampleLedger\ --inclusive-start-time2020-05-29T00:00:00Z\ --exclusive-end-time2020-05-29T23:59:59Z\ --role-arnarn:aws:iam::123456789012:role/my-kinesis-stream-role\ --stream-namemyExampleLedger-stream\ --kinesis-configurationStreamArn=arn:aws:kinesis:us-east-1:123456789012:stream/stream-for-qldb,AggregationEnabled=trueSalida:
{ "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 StreamJournalToKinesis
la 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-arnarn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger\ --tagsIsTest=true,Domain=TestEste 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 TagResource
la 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-resourcese eliminan las etiquetas con las claves de etiqueta específicas desde un libro mayor específico.aws qldb untag-resource \ --resource-arnarn:aws:qldb:us-west-2:123456789012:ledger/myExampleLedger\ --tag-keysIsTestDomainEste 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 UntagResource
la 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-modeasigna el modo de permisos deSTANDARDal libro mayor especificado.aws qldb update-ledger-permissions-mode \ --namemyExampleLedger\ --permissions-modeSTANDARDSalida:
{ "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-modeasigna el modo de permisos deALLOW_ALLal libro mayor especificado.aws qldb update-ledger-permissions-mode \ --namemyExampleLedger\ --permissions-modeALLOW_ALLSalida:
{ "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.
-
Para obtener más información sobre la API, consulte UpdateLedgerPermissionsMode
la Referencia de AWS CLI comandos.
-
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 \ --namemyExampleLedger\ --no-deletion-protectionSalida:
{ "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-ledgerse actualiza el libro mayor especificado para usar una clave de KMS administrada por el cliente para el cifrado en reposo.aws qldb update-ledger \ --namemyExampleLedger\ --kms-keyarn:aws:kms:us-west-2:123456789012:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111Salida:
{ "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-ledgerejemplo, se actualiza el libro mayor especificado para usar una clave AWS KMS propia para el cifrado en reposo.aws qldb update-ledger \ --namemyExampleLedger\ --kms-keyAWS_OWNED_KMS_KEYSalida:
{ "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 UpdateLedger
la Referencia de AWS CLI comandos.
-
