gcloud artifacts image-streaming-cache create

NAME
gcloud artifacts image-streaming-cache create - initiates the prewarming of a specified artifact version or tag
SYNOPSIS
gcloud artifacts image-streaming-cache create ([ARTIFACT] [(--tag=TAG | --version=VERSION) : [--package=PACKAGE : --location=LOCATION --repository=REPOSITORY]]) --stream-location=STREAM_LOCATION [--force] [--retention-days=RETENTION_DAYS; default=3] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
Initiates the prewarming of a specified artifact version or tag.
EXAMPLES
Prewarm a version by full resource name in a specific stream location
gcloud artifacts image-streaming-cache create projects/my-proj/locations/us-central1/repositories/my-repo/packages/my-pkg/versions/sha256:abc123 --stream-location=us-east1
Prewarm a tagged artifact in the repository's region, asynchronously
gcloud artifacts image-streaming-cache create --package=my-pkg --tag=latest --location=us-central1 --repository=my-repo --stream-location=us-east1
Prewarm with custom retention and force
gcloud artifacts image-streaming-cache create --package=my-pkg --version=sha256:abc123 --repository=my-repo --location=us-west1 --stream-location=us-west1 --retention-days=7 --force
POSITIONAL ARGUMENTS
Exactly one of these must be specified:
[ARTIFACT]
The full resource name of the version or tag to prewarm.
Or at least one of these can be specified:
Exactly one of these must be specified:
--tag=TAG
The tag name to prewarm (e.g., 'latest').
--version=VERSION
The version ID to prewarm (e.g., 'sha256:abc123').
Package resource - The package to prewarm. The arguments in this group can be used to specify the attributes of this 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 --package on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.
--package=PACKAGE
ID of the package or fully qualified identifier for the package.

To set the name attribute:

  • provide the argument --package on the command line.

This flag argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION
Location of the package.

To set the location attribute:

  • provide the argument --package on the command line with a fully specified name;
  • provide the argument --location on the command line;
  • set the property artifacts/location.
--repository=REPOSITORY
Repository of the package.

To set the repository attribute:

  • provide the argument --package on the command line with a fully specified name;
  • provide the argument --repository on the command line;
  • set the property artifacts/repository.
REQUIRED FLAGS
--stream-location=STREAM_LOCATION
The target Cloud Region where the artifact should be prewarmed.
OPTIONAL FLAGS
--force
If set, evicts older items from the cache if the quota is reached.
--retention-days=RETENTION_DAYS; default=3
Number of days to retain the artifact in the cache (e.g., 1-7).
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.