mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-10 03:16:46 +00:00
103 lines
4.1 KiB
Text
103 lines
4.1 KiB
Text
NAME
|
|
gcloud alpha ai indexes create - create a new Vertex AI index
|
|
|
|
SYNOPSIS
|
|
gcloud alpha ai indexes create --display-name=DISPLAY_NAME
|
|
--metadata-file=METADATA_FILE [--description=DESCRIPTION]
|
|
[--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME]
|
|
[--index-update-method=INDEX_UPDATE_METHOD] [--labels=[KEY=VALUE,...]]
|
|
[--metadata-schema-uri=METADATA_SCHEMA_URI] [--region=REGION]
|
|
[GCLOUD_WIDE_FLAG ...]
|
|
|
|
EXAMPLES
|
|
To create an index under project example in region us-central1, encrypted
|
|
with KMS key kms-key-name, run:
|
|
|
|
$ gcloud alpha ai indexes create --display-name=index \
|
|
--description=test --metadata-file=path/to/your/metadata.json \
|
|
--project=example --region=us-central1 \
|
|
--encryption-kms-key-name=kms-key-name
|
|
|
|
REQUIRED FLAGS
|
|
--display-name=DISPLAY_NAME
|
|
Display name of the index.
|
|
|
|
--metadata-file=METADATA_FILE
|
|
Path to a local JSON file that contains the additional metadata
|
|
information about the index.
|
|
|
|
OPTIONAL FLAGS
|
|
--description=DESCRIPTION
|
|
Description of the index.
|
|
|
|
--encryption-kms-key-name=ENCRYPTION_KMS_KEY_NAME
|
|
The Cloud KMS resource identifier of the customer managed encryption
|
|
key used to protect a resource. Has the form:
|
|
projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key.
|
|
|
|
The key needs to be in the same region as where the compute resource is
|
|
created.
|
|
|
|
--index-update-method=INDEX_UPDATE_METHOD
|
|
The update method to use with this index. Choose stream-update or
|
|
batch-update (case insensitive). If not set, batch update will be used
|
|
by default. INDEX_UPDATE_METHOD must be one of:
|
|
|
|
batch-update
|
|
can update index with gcloud ai indexes update usingdatapoints
|
|
files on Cloud Storage.
|
|
stream-update
|
|
can update datapoints with upsert-datapoints and`delete-datapoints
|
|
and will be applied nearly real-time.
|
|
|
|
--labels=[KEY=VALUE,...]
|
|
List of label KEY=VALUE pairs to add.
|
|
|
|
Keys must start with a lowercase character and contain only hyphens
|
|
(-), underscores (_), lowercase characters, and numbers. Values must
|
|
contain only hyphens (-), underscores (_), lowercase characters, and
|
|
numbers.
|
|
|
|
--metadata-schema-uri=METADATA_SCHEMA_URI
|
|
Points to a YAML file stored on Google Cloud Storage describing
|
|
additional information about index.
|
|
|
|
Region resource - Cloud region to create index. 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 --region on the command line with a fully
|
|
specified name;
|
|
◆ set the property ai/region with a fully specified name;
|
|
◆ choose one from the prompted list of available regions with a fully
|
|
specified name;
|
|
◆ provide the argument --project on the command line;
|
|
◆ set the property core/project.
|
|
|
|
--region=REGION
|
|
ID of the region or fully qualified identifier for the region.
|
|
|
|
To set the region attribute:
|
|
▸ provide the argument --region on the command line;
|
|
▸ set the property ai/region;
|
|
▸ choose one from the prompted list of available regions.
|
|
|
|
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 ai indexes create
|
|
|
|
$ gcloud beta ai indexes create
|
|
|