Updating a Master Encryption Key

Learn how to update a master encryption key to change its name, apply tags, or change Auto Key Rotation settings.

• Console
• CLI
• API

• 1. Open the navigation menu , select Identity & Security, and then select Vault.
  2. Under List scope select a compartment that contains the key that you want to update.
  3. On the Vaults page, select the name of the vault to open its details page.
  4. Under Resources select Master Encryption Key and click the name of key to open its details page.
  5. To edit the key name, select Edit Name.
  6. Enter a new name for the key and select Update.

• This section describes how to change the name of the key using the Command Line Interface (CLI).

  Open a command prompt and run oci kms management key update to edit a key's name.

  Command

  CopyTry It

  oci kms management key update --key-id <key_OCID> --display-name <new_key_name> --endpoint <control_plane_url>Avoid entering confidential information --is-auto-rotation-enabled enabled

  For example:

  oci kms management key update --key-id ocid1.key.region1.sea.exampleaaacu2.examplesmtpsuqmoy4m5cvblugmizcoeu2nfc6b3zfaux2lmqz245gezevsq --display-name key-A --endpoint https://exampleaaacu2-management.kms.us-ashburn-1.oraclecloud.com --is-auto-rotation-enabled enabled

  Avoid entering confidential information.

  For a complete list of parameters and values for CLI commands, see KMS CLI Command Reference.

• Use the UpdateKey API with the Management Endpoint to update a master encryption key.

  Note
  
  

  The Management Endpoint is used for management operations including Create, Update, List, Get, and Delete. The Management Endpoint is also called the control plane URL or the KMSMANAGMENT endpoint.

  The Cryptographic Endpoint is used for cryptographic operations including Encrypt, Decrypt, Generate Data Encryption Key, Sign, and Verify. The Cryptographic Endpoint is also called the data plane URL or the KMSCRYPTO endpoint.

  You can find the management and cryptographic endpoints in a vault's details metadata. See Getting a Vault's Details for instructions.

  For regional endpoints for the Key Management, Secret Management, and Secret Retrieval APIs, see API Reference and Endpoints.

  For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.