{-# LANGUAGE DeriveGeneric #-} {-# LANGUAGE DuplicateRecordFields #-} {-# LANGUAGE NamedFieldPuns #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE RecordWildCards #-} {-# LANGUAGE StrictData #-} {-# LANGUAGE TypeFamilies #-} {-# LANGUAGE NoImplicitPrelude #-} {-# OPTIONS_GHC -fno-warn-unused-binds #-} {-# OPTIONS_GHC -fno-warn-unused-imports #-} {-# OPTIONS_GHC -fno-warn-unused-matches #-} -- Derived from AWS service descriptions, licensed under Apache 2.0. -- | -- Module : Amazonka.QLDB.UpdateLedger -- Copyright : (c) 2013-2023 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Updates properties on a ledger. module Amazonka.QLDB.UpdateLedger ( -- * Creating a Request UpdateLedger (..), newUpdateLedger, -- * Request Lenses updateLedger_deletionProtection, updateLedger_kmsKey, updateLedger_name, -- * Destructuring the Response UpdateLedgerResponse (..), newUpdateLedgerResponse, -- * Response Lenses updateLedgerResponse_arn, updateLedgerResponse_creationDateTime, updateLedgerResponse_deletionProtection, updateLedgerResponse_encryptionDescription, updateLedgerResponse_name, updateLedgerResponse_state, updateLedgerResponse_httpStatus, ) where import qualified Amazonka.Core as Core import qualified Amazonka.Core.Lens.Internal as Lens import qualified Amazonka.Data as Data import qualified Amazonka.Prelude as Prelude import Amazonka.QLDB.Types import qualified Amazonka.Request as Request import qualified Amazonka.Response as Response -- | /See:/ 'newUpdateLedger' smart constructor. data UpdateLedger = UpdateLedger' { -- | The flag that prevents a ledger from being deleted by any user. If not -- provided on ledger creation, this feature is enabled (@true@) by -- default. -- -- If deletion protection is enabled, you must first disable it before you -- can delete the ledger. You can disable it by calling the @UpdateLedger@ -- operation to set the flag to @false@. deletionProtection :: Prelude.Maybe Prelude.Bool, -- | The key in Key Management Service (KMS) to use for encryption of data at -- rest in the ledger. For more information, see -- -- in the /Amazon QLDB Developer Guide/. -- -- Use one of the following options to specify this parameter: -- -- - @AWS_OWNED_KMS_KEY@: Use an KMS key that is owned and managed by -- Amazon Web Services on your behalf. -- -- - __Undefined__: Make no changes to the KMS key of the ledger. -- -- - __A valid symmetric customer managed KMS key__: Use the specified -- KMS key in your account that you create, own, and manage. -- -- Amazon QLDB does not support asymmetric keys. For more information, -- see -- -- in the /Key Management Service Developer Guide/. -- -- To specify a customer managed KMS key, you can use its key ID, Amazon -- Resource Name (ARN), alias name, or alias ARN. When using an alias name, -- prefix it with @\"alias\/\"@. To specify a key in a different Amazon Web -- Services account, you must use the key ARN or alias ARN. -- -- For example: -- -- - Key ID: @1234abcd-12ab-34cd-56ef-1234567890ab@ -- -- - Key ARN: -- @arn:aws:kms:us-east-2:111122223333:key\/1234abcd-12ab-34cd-56ef-1234567890ab@ -- -- - Alias name: @alias\/ExampleAlias@ -- -- - Alias ARN: @arn:aws:kms:us-east-2:111122223333:alias\/ExampleAlias@ -- -- For more information, see -- -- in the /Key Management Service Developer Guide/. kmsKey :: Prelude.Maybe Prelude.Text, -- | The name of the ledger. name :: Prelude.Text } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'UpdateLedger' with all optional fields omitted. -- -- Use or to modify other optional fields. -- -- The following record fields are available, with the corresponding lenses provided -- for backwards compatibility: -- -- 'deletionProtection', 'updateLedger_deletionProtection' - The flag that prevents a ledger from being deleted by any user. If not -- provided on ledger creation, this feature is enabled (@true@) by -- default. -- -- If deletion protection is enabled, you must first disable it before you -- can delete the ledger. You can disable it by calling the @UpdateLedger@ -- operation to set the flag to @false@. -- -- 'kmsKey', 'updateLedger_kmsKey' - The key in Key Management Service (KMS) to use for encryption of data at -- rest in the ledger. For more information, see -- -- in the /Amazon QLDB Developer Guide/. -- -- Use one of the following options to specify this parameter: -- -- - @AWS_OWNED_KMS_KEY@: Use an KMS key that is owned and managed by -- Amazon Web Services on your behalf. -- -- - __Undefined__: Make no changes to the KMS key of the ledger. -- -- - __A valid symmetric customer managed KMS key__: Use the specified -- KMS key in your account that you create, own, and manage. -- -- Amazon QLDB does not support asymmetric keys. For more information, -- see -- -- in the /Key Management Service Developer Guide/. -- -- To specify a customer managed KMS key, you can use its key ID, Amazon -- Resource Name (ARN), alias name, or alias ARN. When using an alias name, -- prefix it with @\"alias\/\"@. To specify a key in a different Amazon Web -- Services account, you must use the key ARN or alias ARN. -- -- For example: -- -- - Key ID: @1234abcd-12ab-34cd-56ef-1234567890ab@ -- -- - Key ARN: -- @arn:aws:kms:us-east-2:111122223333:key\/1234abcd-12ab-34cd-56ef-1234567890ab@ -- -- - Alias name: @alias\/ExampleAlias@ -- -- - Alias ARN: @arn:aws:kms:us-east-2:111122223333:alias\/ExampleAlias@ -- -- For more information, see -- -- in the /Key Management Service Developer Guide/. -- -- 'name', 'updateLedger_name' - The name of the ledger. newUpdateLedger :: -- | 'name' Prelude.Text -> UpdateLedger newUpdateLedger pName_ = UpdateLedger' { deletionProtection = Prelude.Nothing, kmsKey = Prelude.Nothing, name = pName_ } -- | The flag that prevents a ledger from being deleted by any user. If not -- provided on ledger creation, this feature is enabled (@true@) by -- default. -- -- If deletion protection is enabled, you must first disable it before you -- can delete the ledger. You can disable it by calling the @UpdateLedger@ -- operation to set the flag to @false@. updateLedger_deletionProtection :: Lens.Lens' UpdateLedger (Prelude.Maybe Prelude.Bool) updateLedger_deletionProtection = Lens.lens (\UpdateLedger' {deletionProtection} -> deletionProtection) (\s@UpdateLedger' {} a -> s {deletionProtection = a} :: UpdateLedger) -- | The key in Key Management Service (KMS) to use for encryption of data at -- rest in the ledger. For more information, see -- -- in the /Amazon QLDB Developer Guide/. -- -- Use one of the following options to specify this parameter: -- -- - @AWS_OWNED_KMS_KEY@: Use an KMS key that is owned and managed by -- Amazon Web Services on your behalf. -- -- - __Undefined__: Make no changes to the KMS key of the ledger. -- -- - __A valid symmetric customer managed KMS key__: Use the specified -- KMS key in your account that you create, own, and manage. -- -- Amazon QLDB does not support asymmetric keys. For more information, -- see -- -- in the /Key Management Service Developer Guide/. -- -- To specify a customer managed KMS key, you can use its key ID, Amazon -- Resource Name (ARN), alias name, or alias ARN. When using an alias name, -- prefix it with @\"alias\/\"@. To specify a key in a different Amazon Web -- Services account, you must use the key ARN or alias ARN. -- -- For example: -- -- - Key ID: @1234abcd-12ab-34cd-56ef-1234567890ab@ -- -- - Key ARN: -- @arn:aws:kms:us-east-2:111122223333:key\/1234abcd-12ab-34cd-56ef-1234567890ab@ -- -- - Alias name: @alias\/ExampleAlias@ -- -- - Alias ARN: @arn:aws:kms:us-east-2:111122223333:alias\/ExampleAlias@ -- -- For more information, see -- -- in the /Key Management Service Developer Guide/. updateLedger_kmsKey :: Lens.Lens' UpdateLedger (Prelude.Maybe Prelude.Text) updateLedger_kmsKey = Lens.lens (\UpdateLedger' {kmsKey} -> kmsKey) (\s@UpdateLedger' {} a -> s {kmsKey = a} :: UpdateLedger) -- | The name of the ledger. updateLedger_name :: Lens.Lens' UpdateLedger Prelude.Text updateLedger_name = Lens.lens (\UpdateLedger' {name} -> name) (\s@UpdateLedger' {} a -> s {name = a} :: UpdateLedger) instance Core.AWSRequest UpdateLedger where type AWSResponse UpdateLedger = UpdateLedgerResponse request overrides = Request.patchJSON (overrides defaultService) response = Response.receiveJSON ( \s h x -> UpdateLedgerResponse' Prelude.<$> (x Data..?> "Arn") Prelude.<*> (x Data..?> "CreationDateTime") Prelude.<*> (x Data..?> "DeletionProtection") Prelude.<*> (x Data..?> "EncryptionDescription") Prelude.<*> (x Data..?> "Name") Prelude.<*> (x Data..?> "State") Prelude.<*> (Prelude.pure (Prelude.fromEnum s)) ) instance Prelude.Hashable UpdateLedger where hashWithSalt _salt UpdateLedger' {..} = _salt `Prelude.hashWithSalt` deletionProtection `Prelude.hashWithSalt` kmsKey `Prelude.hashWithSalt` name instance Prelude.NFData UpdateLedger where rnf UpdateLedger' {..} = Prelude.rnf deletionProtection `Prelude.seq` Prelude.rnf kmsKey `Prelude.seq` Prelude.rnf name instance Data.ToHeaders UpdateLedger where toHeaders = Prelude.const ( Prelude.mconcat [ "Content-Type" Data.=# ( "application/x-amz-json-1.0" :: Prelude.ByteString ) ] ) instance Data.ToJSON UpdateLedger where toJSON UpdateLedger' {..} = Data.object ( Prelude.catMaybes [ ("DeletionProtection" Data..=) Prelude.<$> deletionProtection, ("KmsKey" Data..=) Prelude.<$> kmsKey ] ) instance Data.ToPath UpdateLedger where toPath UpdateLedger' {..} = Prelude.mconcat ["/ledgers/", Data.toBS name] instance Data.ToQuery UpdateLedger where toQuery = Prelude.const Prelude.mempty -- | /See:/ 'newUpdateLedgerResponse' smart constructor. data UpdateLedgerResponse = UpdateLedgerResponse' { -- | The Amazon Resource Name (ARN) for the ledger. arn :: Prelude.Maybe Prelude.Text, -- | The date and time, in epoch time format, when the ledger was created. -- (Epoch time format is the number of seconds elapsed since 12:00:00 AM -- January 1, 1970 UTC.) creationDateTime :: Prelude.Maybe Data.POSIX, -- | The flag that prevents a ledger from being deleted by any user. If not -- provided on ledger creation, this feature is enabled (@true@) by -- default. -- -- If deletion protection is enabled, you must first disable it before you -- can delete the ledger. You can disable it by calling the @UpdateLedger@ -- operation to set the flag to @false@. deletionProtection :: Prelude.Maybe Prelude.Bool, -- | Information about the encryption of data at rest in the ledger. This -- includes the current status, the KMS key, and when the key became -- inaccessible (in the case of an error). encryptionDescription :: Prelude.Maybe LedgerEncryptionDescription, -- | The name of the ledger. name :: Prelude.Maybe Prelude.Text, -- | The current status of the ledger. state :: Prelude.Maybe LedgerState, -- | The response's http status code. httpStatus :: Prelude.Int } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'UpdateLedgerResponse' with all optional fields omitted. -- -- Use or to modify other optional fields. -- -- The following record fields are available, with the corresponding lenses provided -- for backwards compatibility: -- -- 'arn', 'updateLedgerResponse_arn' - The Amazon Resource Name (ARN) for the ledger. -- -- 'creationDateTime', 'updateLedgerResponse_creationDateTime' - The date and time, in epoch time format, when the ledger was created. -- (Epoch time format is the number of seconds elapsed since 12:00:00 AM -- January 1, 1970 UTC.) -- -- 'deletionProtection', 'updateLedgerResponse_deletionProtection' - The flag that prevents a ledger from being deleted by any user. If not -- provided on ledger creation, this feature is enabled (@true@) by -- default. -- -- If deletion protection is enabled, you must first disable it before you -- can delete the ledger. You can disable it by calling the @UpdateLedger@ -- operation to set the flag to @false@. -- -- 'encryptionDescription', 'updateLedgerResponse_encryptionDescription' - Information about the encryption of data at rest in the ledger. This -- includes the current status, the KMS key, and when the key became -- inaccessible (in the case of an error). -- -- 'name', 'updateLedgerResponse_name' - The name of the ledger. -- -- 'state', 'updateLedgerResponse_state' - The current status of the ledger. -- -- 'httpStatus', 'updateLedgerResponse_httpStatus' - The response's http status code. newUpdateLedgerResponse :: -- | 'httpStatus' Prelude.Int -> UpdateLedgerResponse newUpdateLedgerResponse pHttpStatus_ = UpdateLedgerResponse' { arn = Prelude.Nothing, creationDateTime = Prelude.Nothing, deletionProtection = Prelude.Nothing, encryptionDescription = Prelude.Nothing, name = Prelude.Nothing, state = Prelude.Nothing, httpStatus = pHttpStatus_ } -- | The Amazon Resource Name (ARN) for the ledger. updateLedgerResponse_arn :: Lens.Lens' UpdateLedgerResponse (Prelude.Maybe Prelude.Text) updateLedgerResponse_arn = Lens.lens (\UpdateLedgerResponse' {arn} -> arn) (\s@UpdateLedgerResponse' {} a -> s {arn = a} :: UpdateLedgerResponse) -- | The date and time, in epoch time format, when the ledger was created. -- (Epoch time format is the number of seconds elapsed since 12:00:00 AM -- January 1, 1970 UTC.) updateLedgerResponse_creationDateTime :: Lens.Lens' UpdateLedgerResponse (Prelude.Maybe Prelude.UTCTime) updateLedgerResponse_creationDateTime = Lens.lens (\UpdateLedgerResponse' {creationDateTime} -> creationDateTime) (\s@UpdateLedgerResponse' {} a -> s {creationDateTime = a} :: UpdateLedgerResponse) Prelude.. Lens.mapping Data._Time -- | The flag that prevents a ledger from being deleted by any user. If not -- provided on ledger creation, this feature is enabled (@true@) by -- default. -- -- If deletion protection is enabled, you must first disable it before you -- can delete the ledger. You can disable it by calling the @UpdateLedger@ -- operation to set the flag to @false@. updateLedgerResponse_deletionProtection :: Lens.Lens' UpdateLedgerResponse (Prelude.Maybe Prelude.Bool) updateLedgerResponse_deletionProtection = Lens.lens (\UpdateLedgerResponse' {deletionProtection} -> deletionProtection) (\s@UpdateLedgerResponse' {} a -> s {deletionProtection = a} :: UpdateLedgerResponse) -- | Information about the encryption of data at rest in the ledger. This -- includes the current status, the KMS key, and when the key became -- inaccessible (in the case of an error). updateLedgerResponse_encryptionDescription :: Lens.Lens' UpdateLedgerResponse (Prelude.Maybe LedgerEncryptionDescription) updateLedgerResponse_encryptionDescription = Lens.lens (\UpdateLedgerResponse' {encryptionDescription} -> encryptionDescription) (\s@UpdateLedgerResponse' {} a -> s {encryptionDescription = a} :: UpdateLedgerResponse) -- | The name of the ledger. updateLedgerResponse_name :: Lens.Lens' UpdateLedgerResponse (Prelude.Maybe Prelude.Text) updateLedgerResponse_name = Lens.lens (\UpdateLedgerResponse' {name} -> name) (\s@UpdateLedgerResponse' {} a -> s {name = a} :: UpdateLedgerResponse) -- | The current status of the ledger. updateLedgerResponse_state :: Lens.Lens' UpdateLedgerResponse (Prelude.Maybe LedgerState) updateLedgerResponse_state = Lens.lens (\UpdateLedgerResponse' {state} -> state) (\s@UpdateLedgerResponse' {} a -> s {state = a} :: UpdateLedgerResponse) -- | The response's http status code. updateLedgerResponse_httpStatus :: Lens.Lens' UpdateLedgerResponse Prelude.Int updateLedgerResponse_httpStatus = Lens.lens (\UpdateLedgerResponse' {httpStatus} -> httpStatus) (\s@UpdateLedgerResponse' {} a -> s {httpStatus = a} :: UpdateLedgerResponse) instance Prelude.NFData UpdateLedgerResponse where rnf UpdateLedgerResponse' {..} = Prelude.rnf arn `Prelude.seq` Prelude.rnf creationDateTime `Prelude.seq` Prelude.rnf deletionProtection `Prelude.seq` Prelude.rnf encryptionDescription `Prelude.seq` Prelude.rnf name `Prelude.seq` Prelude.rnf state `Prelude.seq` Prelude.rnf httpStatus