Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # UpdateLedger Aggiorna le proprietà su un libro mastro. ## Sintassi della richiesta ``` PATCH /ledgers/name HTTP/1.1 Content-type: application/json { "DeletionProtection": boolean, "KmsKey": "string" } ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [name](#API_UpdateLedger_RequestSyntax) ** Il nome del libro mastro. Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri. Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` Campo obbligatorio: sì ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [DeletionProtection](#API_UpdateLedger_RequestSyntax) ** Specifica se il libro mastro è protetto dall'eliminazione da parte di un utente qualsiasi. Se non definita al momento della creazione del libro mastro, questa caratteristica è abilitata (`true`) per impostazione predefinita. Se la protezione dall'eliminazione è abilitata, è necessario innanzitutto disabilitarla prima di poter eliminare il libro mastro. Puoi disabilitarla chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`. Tipo: Booleano Campo obbligatorio: no ** [KmsKey](#API_UpdateLedger_RequestSyntax) ** La chiave in AWS Key Management Service (AWS KMS) da utilizzare per la crittografia dei dati inattivi nel registro. Per ulteriori informazioni, consulta [Crittografia dei dati inattivi](https://docs.aws.amazon.com/qldb/latest/developerguide/encryption-at-rest.html) nella *Guida per gli sviluppatori di Amazon QLDB*. Per specificare questo parametro, puoi utilizzare una delle opzioni seguenti: + `AWS_OWNED_KMS_KEY`: utilizza una AWS KMS chiave posseduta e gestita da per tuo AWS conto. + **Non definito**: non apporta modifiche alla chiave KMS del registro. + **Una chiave KMS simmetrica valida gestita dal cliente**: usa le chiave KMS di crittografia simmetrica specificata nell'account che crei, possiedi e gestisci. Amazon QLDB non supporta le chiavi asimmetriche. *Per ulteriori informazioni, consulta [Uso delle chiavi simmetriche e asimmetriche](https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html) nella Guida per gli sviluppatori. AWS Key Management Service * Per specificare una chiave KMS gestita dal cliente, utilizza il relativo ID chiave, il nome della risorsa Amazon (ARN), il nome dell'alias o l'ARN dell'alias. Quando utilizzi un nome alias, aggiungi il prefisso `"alias/"`. Per specificare una chiave in un'altra Account AWS, è necessario utilizzare la chiave ARN o l'alias ARN. Per esempio: + ID chiave: `1234abcd-12ab-34cd-56ef-1234567890ab` + ARN chiave: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` + Nome alias: `alias/ExampleAlias` + ARN alias: `arn:aws:kms:us-east-2:111122223333:alias/ExampleAlias` *Per ulteriori informazioni, consulta [Key identifiers (KeyId)](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-id) nella Developer Guide. AWS Key Management Service * Tipo: stringa Vincoli di lunghezza: lunghezza massima di 1600. Campo obbligatorio: no ## Sintassi della risposta ``` HTTP/1.1 200 Content-type: application/json { "Arn": "string", "CreationDateTime": number, "DeletionProtection": boolean, "EncryptionDescription": { "EncryptionStatus": "string", "InaccessibleKmsKeyDateTime": number, "KmsKeyArn": "string" }, "Name": "string", "State": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [Arn](#API_UpdateLedger_ResponseSyntax) ** L'Amazon Resource Name (ARN) per il registro. Tipo: stringa Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri. ** [CreationDateTime](#API_UpdateLedger_ResponseSyntax) ** La data e l'ora, in formato epoch time, in cui è stato creato il libro mastro. (Il formato dell'ora epoch è il numero di secondi trascorsi dalle 00:00 del 1° gennaio 1970 UTC.) Tipo: Timestamp ** [DeletionProtection](#API_UpdateLedger_ResponseSyntax) ** Specifica se il libro mastro è protetto dall'eliminazione da parte di un utente qualsiasi. Se non definita al momento della creazione del libro mastro, questa caratteristica è abilitata (`true`) per impostazione predefinita. Se la protezione dall'eliminazione è abilitata, è necessario innanzitutto disabilitarla prima di poter eliminare il libro mastro. Puoi disabilitarla chiamando l'operazione `UpdateLedger` per impostare questo parametro su `false`. Tipo: Booleano ** [EncryptionDescription](#API_UpdateLedger_ResponseSyntax) ** Informazioni sulla crittografia dei dati inattivi nel registro. Ciò include lo stato corrente, la AWS KMS chiave e il momento in cui la chiave è diventata inaccessibile (in caso di errore). Tipo: oggetto [LedgerEncryptionDescription](API_LedgerEncryptionDescription.md) ** [Name](#API_UpdateLedger_ResponseSyntax) ** Il nome del libro mastro. Tipo: stringa Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 32 caratteri. Modello: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` ** [State](#API_UpdateLedger_ResponseSyntax) ** Lo stato attuale del libro mastro. Tipo: stringa Valori validi: `CREATING | ACTIVE | DELETING | DELETED` ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md). ** InvalidParameterException ** Uno o più parametri nella richiesta non sono validi. Codice di stato HTTP: 400 ** ResourceNotFoundException ** La risorsa specificata non esiste. Codice di stato HTTP: 404 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedger) + [AWS SDK per.NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedger) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedger) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedger) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedger) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedger) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedger) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedger) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedger) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedger)