Contoh QLDB menggunakan AWS CLI - AWS Contoh Kode SDK
Tindakan

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh SDK AWS Doc. GitHub

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh QLDB menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan QLDB AWS Command Line Interface with.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakancancel-journal-kinesis-stream.

AWS CLI

Untuk membatalkan aliran jurnal

cancel-journal-kinesis-streamContoh berikut membatalkan aliran jurnal yang ditentukan dari buku besar.

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

Output:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Untuk informasi selengkapnya, lihat Streaming data jurnal dari Amazon QLDB di Panduan Pengembang Amazon QLDB.

Contoh kode berikut menunjukkan cara menggunakancreate-ledger.

AWS CLI

Contoh 1: Untuk membuat buku besar dengan properti default

create-ledgerContoh berikut membuat buku besar dengan nama myExampleLedger dan modus izin. STANDARD Parameter opsional untuk perlindungan penghapusan dan kunci AWS KMS tidak ditentukan, sehingga mereka default ke true dan kunci KMS yang AWS dimiliki masing-masing.

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

Output:

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

Contoh 2: Untuk membuat buku besar dengan perlindungan penghapusan dinonaktifkan, kunci KMS yang dikelola pelanggan, dan tag yang ditentukan

create-ledgerContoh berikut membuat buku besar dengan nama myExampleLedger2 dan modus izin. STANDARD Fitur perlindungan penghapusan dinonaktifkan, kunci KMS yang dikelola pelanggan yang ditentukan digunakan untuk enkripsi saat istirahat, dan tag yang ditentukan dilampirkan ke sumber daya.

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

Output:

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

Untuk informasi selengkapnya, lihat Operasi Dasar untuk Buku Besar QLDB Amazon di Panduan Pengembang QLDB Amazon.

  • Untuk detail API, lihat CreateLedgerdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-ledger.

AWS CLI

Untuk menghapus buku besar

delete-ledgerContoh berikut menghapus buku besar yang ditentukan.

aws qldb delete-ledger \
    --name myExampleLedger

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Operasi Dasar untuk Buku Besar QLDB Amazon di Panduan Pengembang QLDB Amazon.

  • Untuk detail API, lihat DeleteLedgerdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-journal-kinesis-stream.

AWS CLI

Untuk menggambarkan aliran jurnal

describe-journal-kinesis-streamContoh berikut menampilkan rincian untuk aliran jurnal tertentu dari buku besar.

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

Output:

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

Untuk informasi selengkapnya, lihat Streaming data jurnal dari Amazon QLDB di Panduan Pengembang Amazon QLDB.

Contoh kode berikut menunjukkan cara menggunakandescribe-journal-s3-export.

AWS CLI

Untuk menggambarkan pekerjaan ekspor jurnal

describe-journal-s3-exportContoh berikut menampilkan rincian untuk pekerjaan ekspor tertentu dari buku besar.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengekspor Jurnal Anda di Amazon QLDB di Panduan Pengembang QLDB Amazon.

Contoh kode berikut menunjukkan cara menggunakandescribe-ledger.

AWS CLI

Untuk menggambarkan buku besar

describe-ledgerContoh berikut menampilkan rincian untuk buku besar yang ditentukan.

aws qldb describe-ledger \
    --name myExampleLedger

Output:

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

Untuk informasi selengkapnya, lihat Operasi Dasar untuk Buku Besar QLDB Amazon di Panduan Pengembang QLDB Amazon.

  • Untuk detail API, lihat DescribeLedgerdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanexport-journal-to-s3.

AWS CLI

Untuk mengekspor blok jurnal ke S3

export-journal-to-s3Contoh berikut membuat pekerjaan ekspor untuk blok jurnal dalam rentang tanggal dan waktu tertentu dari buku besar dengan namamyExampleLedger. Pekerjaan ekspor menulis blok ke dalam bucket Amazon S3 tertentu.

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

Isi dari my-s3-export-config.json:

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

Output:

{
    "ExportId": "ADR2ONPKN5LINYGb4dp7yZ"
}

Untuk informasi selengkapnya, lihat Mengekspor Jurnal Anda di Amazon QLDB di Panduan Pengembang QLDB Amazon.

Contoh kode berikut menunjukkan cara menggunakanget-block.

AWS CLI

Contoh 1: Untuk mendapatkan blok jurnal dan bukti verifikasi menggunakan file input

get-blockContoh berikut meminta objek data blok dan bukti dari buku besar yang ditentukan. Permintaan adalah untuk alamat tip intisari yang ditentukan dan alamat blokir.

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

Isi dari myblockaddress.json:

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

Isi dari mydigesttipaddress.json:

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

Output:

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

Untuk informasi selengkapnya, lihat Verifikasi Data di Amazon QLDB di Panduan Pengembang Amazon QLDB.

Contoh 2: Untuk mendapatkan blok jurnal dan bukti verifikasi menggunakan sintaks singkatan

get-blockContoh berikut meminta objek data blok dan bukti dari buku besar yang ditentukan menggunakan sintaks singkatan. Permintaan adalah untuk alamat tip intisari yang ditentukan dan alamat blokir.

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

Output:

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

Untuk informasi selengkapnya, lihat Verifikasi Data di Amazon QLDB di Panduan Pengembang Amazon QLDB.

  • Untuk detail API, lihat GetBlockdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-digest.

AWS CLI

Untuk mendapatkan intisari untuk buku besar

get-digestContoh berikut meminta intisari dari buku besar yang ditentukan di blok komit terbaru dalam jurnal.

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

Output:

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

Untuk informasi selengkapnya, lihat Verifikasi Data di Amazon QLDB di Panduan Pengembang Amazon QLDB.

  • Untuk detail API, lihat GetDigestdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-revision.

AWS CLI

Contoh 1: Untuk mendapatkan revisi dokumen dan bukti verifikasi menggunakan file input

get-revisionContoh berikut meminta objek data revisi dan bukti dari buku besar yang ditentukan. Permintaan adalah untuk alamat tip intisari tertentu, ID dokumen, dan alamat blok revisi.

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

Isi dari myblockaddress.json:

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

Isi dari mydigesttipaddress.json:

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

Output:

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

Untuk informasi selengkapnya, lihat Verifikasi Data di Amazon QLDB di Panduan Pengembang Amazon QLDB.

Contoh 2: Untuk mendapatkan revisi dokumen dan bukti verifikasi menggunakan sintaks singkatan

get-revisionContoh berikut meminta objek data revisi dan bukti dari buku besar yang ditentukan menggunakan sintaks singkatan. Permintaan adalah untuk alamat tip intisari tertentu, ID dokumen, dan alamat blok revisi.

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

Output:

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

Untuk informasi selengkapnya, lihat Verifikasi Data di Amazon QLDB di Panduan Pengembang Amazon QLDB.

  • Untuk detail API, lihat GetRevisiondi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-journal-kinesis-streams-for-ledger.

AWS CLI

Untuk membuat daftar aliran jurnal untuk buku besar

list-journal-kinesis-streams-for-ledgerContoh berikut mencantumkan aliran jurnal untuk buku besar yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Streaming data jurnal dari Amazon QLDB di Panduan Pengembang Amazon QLDB.

Contoh kode berikut menunjukkan cara menggunakanlist-journal-s3-exports-for-ledger.

AWS CLI

Untuk membuat daftar pekerjaan ekspor jurnal untuk buku besar

list-journal-s3-exports-for-ledgerContoh berikut mencantumkan pekerjaan ekspor jurnal untuk buku besar yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengekspor Jurnal Anda di Amazon QLDB di Panduan Pengembang QLDB Amazon.

Contoh kode berikut menunjukkan cara menggunakanlist-journal-s3-exports.

AWS CLI

Untuk daftar pekerjaan ekspor jurnal

list-journal-s3-exportsContoh berikut mencantumkan pekerjaan ekspor jurnal untuk semua buku besar yang terkait dengan AWS akun saat ini dan Wilayah.

aws qldb list-journal-s3-exports

Output:

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

Untuk informasi selengkapnya, lihat Mengekspor Jurnal Anda di Amazon QLDB di Panduan Pengembang QLDB Amazon.

Contoh kode berikut menunjukkan cara menggunakanlist-ledgers.

AWS CLI

Untuk membuat daftar buku besar yang tersedia

list-ledgersContoh berikut mencantumkan semua buku besar yang terkait dengan AWS akun saat ini dan Wilayah.

aws qldb list-ledgers

Output:

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

Untuk informasi selengkapnya, lihat Operasi Dasar untuk Buku Besar QLDB Amazon di Panduan Pengembang QLDB Amazon.

  • Untuk detail API, lihat ListLedgersdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan tag yang dilampirkan pada buku besar

list-tags-for-resourceContoh berikut mencantumkan semua tag yang dilampirkan pada buku besar yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Menandai Sumber Daya QLDB Amazon di Panduan Pengembang Amazon QLDB.

Contoh kode berikut menunjukkan cara menggunakanstream-journal-to-kinesis.

AWS CLI

Contoh 1: Untuk mengalirkan data jurnal ke Kinesis Data Streams menggunakan file input

stream-journal-to-kinesisContoh berikut membuat aliran data jurnal dalam rentang tanggal dan waktu tertentu dari buku besar dengan namamyExampleLedger. Aliran mengirimkan data ke aliran data Amazon Kinesis tertentu.

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

Isi dari my-kinesis-config.json:

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

Output:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Untuk informasi selengkapnya, lihat Streaming data jurnal dari Amazon QLDB di Panduan Pengembang Amazon QLDB.

Contoh 2: Untuk mengalirkan data jurnal ke Kinesis Data Streams menggunakan sintaks singkatan

stream-journal-to-kinesisContoh berikut membuat aliran data jurnal dalam rentang tanggal dan waktu tertentu dari buku besar dengan namamyExampleLedger. Aliran mengirimkan data ke aliran data Amazon Kinesis tertentu.

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

Output:

{
    "StreamId": "7ISCkqwe4y25YyHLzYUFAf"
}

Untuk informasi selengkapnya, lihat Streaming data jurnal dari Amazon QLDB di Panduan Pengembang Amazon QLDB.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menandai buku besar

tag-resourceContoh berikut menambahkan satu set tag ke buku besar tertentu.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Sumber Daya QLDB Amazon di Panduan Pengembang Amazon QLDB.

  • Untuk detail API, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber daya

untag-resourceContoh berikut menghapus tag dengan kunci tag yang ditentukan dari buku besar tertentu.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai Sumber Daya QLDB Amazon di Panduan Pengembang Amazon QLDB.

  • Untuk detail API, lihat UntagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-ledger-permissions-mode.

AWS CLI

Contoh 1: Untuk memperbarui mode izin buku besar ke STANDARD

update-ledger-permissions-modeContoh berikut menetapkan modus STANDARD izin untuk buku besar yang ditentukan.

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

Output:

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

Contoh 2: Untuk memperbarui mode izin buku besar ke ALLOW_ALL

update-ledger-permissions-modeContoh berikut menetapkan modus ALLOW_ALL izin untuk buku besar yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Operasi Dasar untuk Buku Besar QLDB Amazon di Panduan Pengembang QLDB Amazon.

Contoh kode berikut menunjukkan cara menggunakanupdate-ledger.

AWS CLI

Contoh 1: Untuk memperbarui properti perlindungan penghapusan buku besar

update-ledgerContoh berikut memperbarui buku besar yang ditentukan untuk menonaktifkan fitur perlindungan penghapusan.

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

Output:

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

Contoh 2: Untuk memperbarui kunci AWS KMS buku besar ke kunci yang dikelola pelanggan

update-ledgerContoh berikut memperbarui buku besar yang ditentukan untuk menggunakan kunci KMS yang dikelola pelanggan untuk enkripsi saat istirahat.

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

Output:

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

Contoh 3: Untuk memperbarui kunci AWS KMS buku besar ke kunci yang dimiliki AWS

update-ledgerContoh berikut memperbarui buku besar yang ditentukan untuk menggunakan kunci KMS yang AWS dimiliki untuk enkripsi saat istirahat.

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

Output:

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

Untuk informasi selengkapnya, lihat Operasi Dasar untuk Buku Besar QLDB Amazon di Panduan Pengembang QLDB Amazon.

  • Untuk detail API, lihat UpdateLedgerdi Referensi AWS CLI Perintah.