REST Resource: projects.locations.featurestores

Resource: Featurestore

Vertex AI feature Store provides a centralized repository for organizing, storing, and serving ML features. The Featurestore is a top-level container for your features and their values.

Fields
name string

Output only. name of the Featurestore. Format: projects/{project}/locations/{location}/featurestores/{featurestore}

createTime string (Timestamp format)

Output only. timestamp when this Featurestore was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime string (Timestamp format)

Output only. timestamp when this Featurestore was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

etag string

Optional. Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.

labels map (key: string, value: string)

Optional. The labels with user-defined metadata to organize your Featurestore.

label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information on and examples of labels. No more than 64 user labels can be associated with one Featurestore(System labels are excluded)." System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable.

onlineServingConfig object (OnlineServingConfig)

Optional. Config for online storage resources. The field should not co-exist with the field of OnlineStoreReplicationConfig. If both of it and OnlineStoreReplicationConfig are unset, the feature store will not have an online store and cannot be used for online serving.

state enum (State)

Output only. state of the featurestore.

onlineStorageTtlDays integer

Optional. TTL in days for feature values that will be stored in online serving storage. The feature Store online storage periodically removes obsolete feature values older than onlineStorageTtlDays since the feature generation time. Note that onlineStorageTtlDays should be less than or equal to offlineStorageTtlDays for each EntityType under a featurestore. If not set, default to 4000 days

encryptionSpec object (EncryptionSpec)

Optional. Customer-managed encryption key spec for data storage. If set, both of the online and offline data storage will be secured by this key.

satisfiesPzs boolean

Output only. reserved for future use.

satisfiesPzi boolean

Output only. reserved for future use.

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "labels": {
    string: string,
    ...
  },
  "onlineServingConfig": {
    object (OnlineServingConfig)
  },
  "state": enum (State),
  "onlineStorageTtlDays": integer,
  "encryptionSpec": {
    object (EncryptionSpec)
  },
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean
}

OnlineServingConfig

OnlineServingConfig specifies the details for provisioning online serving resources.

Fields
fixedNodeCount integer

The number of nodes for the online store. The number of nodes doesn't scale automatically, but you can manually update the number of nodes. If set to 0, the featurestore will not have an online store and cannot be used for online serving.

scaling object (Scaling)

Online serving scaling configuration. Only one of fixedNodeCount and scaling can be set. Setting one will reset the other.

JSON representation
{
  "fixedNodeCount": integer,
  "scaling": {
    object (Scaling)
  }
}

Scaling

Online serving scaling configuration. If minNodeCount and maxNodeCount are set to the same value, the cluster will be configured with the fixed number of node (no auto-scaling).

Fields
minNodeCount integer

Required. The minimum number of nodes to scale down to. Must be greater than or equal to 1.

maxNodeCount integer

The maximum number of nodes to scale up to. Must be greater than minNodeCount, and less than or equal to 10 times of 'minNodeCount'.

cpuUtilizationTarget integer

Optional. The cpu utilization that the Autoscaler should be trying to achieve. This number is on a scale from 0 (no utilization) to 100 (total utilization), and is limited between 10 and 80. When a cluster's CPU utilization exceeds the target that you have set, Bigtable immediately adds nodes to the cluster. When CPU utilization is substantially lower than the target, Bigtable removes nodes. If not set or set to 0, default to 50.

JSON representation
{
  "minNodeCount": integer,
  "maxNodeCount": integer,
  "cpuUtilizationTarget": integer
}

State

Possible states a featurestore can have.

Enums
STATE_UNSPECIFIED Default value. This value is unused.
STABLE state when the featurestore configuration is not being updated and the fields reflect the current configuration of the featurestore. The featurestore is usable in this state.
UPDATING The state of the featurestore configuration when it is being updated. During an update, the fields reflect either the original configuration or the updated configuration of the featurestore. For example, onlineServingConfig.fixed_node_count can take minutes to update. While the update is in progress, the featurestore is in the UPDATING state, and the value of fixedNodeCount can be the original value or the updated value, depending on the progress of the operation. Until the update completes, the actual number of nodes can still be the original value of fixedNodeCount. The featurestore is still usable in this state.

Methods

batchReadFeatureValues

Batch reads Feature values from a Featurestore.

create

Creates a new Featurestore in a given project and location.

delete

Deletes a single Featurestore.

get

Gets details of a single Featurestore.

getIamPolicy

Gets the access control policy for a resource.

list

Lists Featurestores in a given project and location.

patch

Updates the parameters of a single Featurestore.

searchFeatures

Searches Features matching a query in a given project.

setIamPolicy

Sets the access control policy on the specified resource.

testIamPermissions

Returns permissions that a caller has on the specified resource.