generate-data-encryption-key
****************************


Description
===========

Generates a key that you can use to encrypt or decrypt data.

The top level --endpoint parameter must be supplied for this
operation.


Usage
=====

   oci kms crypto generate-data-encryption-key [OPTIONS]


Options
=======


--include-plaintext-key [boolean]
---------------------------------

If true, the generated key is also returned unencrypted. [required]


--key-id [text]
---------------

The OCID of the master encryption key to encrypt the generated data
encryption key with. [required]


--key-shape [complex type]
--------------------------

This is a complex type whose value must be valid JSON. The value can
be provided as a string on the command line or passed in as a file
using the file://path/to/file syntax.

The --generate-param-json-input option can be used to generate an
example of the JSON which must be provided. We recommend storing this
example in a file, modifying it as needed and then passing it back in
via the file:// syntax.

   [required]


--associated-data [complex type]
--------------------------------

Information that can be used to provide an encryption context for the
encrypted data. The length of the string representation of the
associatedData must be fewer than 4096 characters. This is a complex
type whose value must be valid JSON. The value can be provided as a
string on the command line or passed in as a file using the
file://path/to/file syntax.

The --generate-param-json-input option can be used to generate an
example of the JSON which must be provided. We recommend storing this
example in a file, modifying it as needed and then passing it back in
via the file:// syntax.


--from-json [text]
------------------

Provide input to this command as a JSON document from a file.

Options can still be provided on the command line. If an option exists
in both the JSON document and the command line then the command line
specified value will be used


-?, -h, --help
--------------

For detailed help on any of these individual commands, enter <command>
--help.
