gcloud alpha agent-registry skill-encryption-spec update

NAME
gcloud alpha agent-registry skill-encryption-spec update - update the Skill encryption spec of a location
SYNOPSIS
gcloud alpha agent-registry skill-encryption-spec update --kms-key=KMS_KEY --location=LOCATION [--async] [--endpoint-mode=ENDPOINT_MODE] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Set or change the Cloud KMS key that is used to encrypt Skills in a project and location.

The Skill encryption spec can only be updated while no Skills exist in the project and location.

Customer-managed encryption keys are supported only for Skills in the us and eu locations. The key must be in the matching Cloud KMS location: us for Skills in us, and europe for Skills in eu.

Before the key is set, the Agent Registry service agent of the project, service-PROJECT_NUMBER@gcp-sa-agentregistry.iam.gserviceaccount.com, must have the Cloud KMS CryptoKey Encrypter/Decrypter role (roles/cloudkms.cryptoKeyEncrypterDecrypter) on the key. The update fails if the key doesn't exist, isn't enabled, or can't be used by the service agent.

EXAMPLES
To encrypt Skills in location us with the Cloud KMS key projects/my-project/locations/us/keyRings/my-key-ring/cryptoKeys/my-key, run:
gcloud alpha agent-registry skill-encryption-spec update --location=us --kms-key=projects/my-project/locations/us/keyRings/my-key-ring/cryptoKeys/my-key
REQUIRED FLAGS
--kms-key=KMS_KEY
Resource name of the Cloud KMS key that is used to encrypt Skills in the location, in the format projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY.
Location resource - The location of the Skill encryption spec to update. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument --location on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

This must be specified.

--location=LOCATION
ID of the location or fully qualified identifier for the location.

To set the location attribute:

  • provide the argument --location on the command line.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide enhanced data residency and reliability by ensuring your request is handled entirely within the specified Google Cloud region. This differs from global endpoints, which may process parts of the request outside the target region. Overrides the default regional/endpoint_mode property value for this command invocation. ENDPOINT_MODE must be one of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global endpoints. Recommended for most users.
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.

API REFERENCE
This command uses the agentregistry/v1alpha API. The full documentation for this API can be found at: https://docs.cloud.google.com/agent-registry/overview
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for this command, use the --endpoint-mode=regional-preferred flag. To use regional endpoints by default, run $ gcloud config set regional/endpoint_mode regional-preferred.
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. This variant is also available:
gcloud agent-registry skill-encryption-spec update