Sintassi della richiesta Parametri della richiesta URI Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

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

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

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

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 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 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) 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

L'Amazon Resource Name (ARN) per il registro.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 1600 caratteri.

CreationDateTime

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

Tipo: Booleano

EncryptionDescription

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

Name