NAME

gcloud alpha kms import-jobs describe - get metadata for a given import job

SYNOPSIS

gcloud alpha kms import-jobs describe IMPORT_JOB [--attestation-file=ATTESTATION_FILE] [--keyring=KEYRING] [--location=LOCATION] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) Returns metadata for the given import job.

The optional flag --attestation-file specifies file to write the attestation into. The attestation enables the user to verify the integrity and provenance of the key. See https://cloud.google.com/kms/docs/attest-key for more information about attestations.

EXAMPLES

The following command returns metadata for import job 'strider' within the keyring 'fellowship' in the location 'us-central1':

$ gcloud alpha kms import-jobs describe strider \ --keyring=fellowship --location=us-central1

For import jobs with protection level HSM, use the --attestation-file flag to save the attestation to a local file.

$ gcloud alpha kms import-jobs describe strider \ --keyring=fellowship --location=us-central1 \ --attestation-file=path/to/attestation.dat

POSITIONAL ARGUMENTS

IMPORT_JOB

Name of the import job to describe.

FLAGS

--attestation-file=ATTESTATION_FILE

Path to the output attestation file.

--keyring=KEYRING

Key ring of the import job.

--location=LOCATION

Location of the import job.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES

This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available:

$ gcloud kms import-jobs describe

$ gcloud beta kms import-jobs describe