Method: projects.locations.featurestores.entityTypes.streamingReadFeatureValues

Reads Feature values for multiple entities. Depending on their size, data for different entities may be broken up across multiple responses.

HTTP request

POST https://{service-endpoint}/v1beta1/{entityType}:streamingReadFeatureValues

Where {service-endpoint} is one of the supported service endpoints.

Path parameters

Parameters
entityType

string

Required. The resource name of the entities' type. Value format: projects/{project}/locations/{location}/featurestores/ {featurestore}/entityTypes/{entityType}. For example, for a machine learning model predicting user clicks on a website, an EntityType ID could be "user".

Request body

The request body contains data with the following structure:

JSON representation
{
  "entityIds": [
    string
  ],
  "featureSelector": {
    object (FeatureSelector)
  }
}
Fields
entityIds[]

string

Required. IDs of entities to read Feature values of. The maximum number of IDs is 100. For example, for a machine learning model predicting user clicks on a website, an entity ID could be "user_123".

featureSelector

object (FeatureSelector)

Required. Selector choosing Features of the target EntityType. Feature IDs will be deduplicated.

Response body

If successful, the response body contains an instance of ReadFeatureValuesResponse.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the entityType resource:

  • aiplatform.entityTypes.streamingReadFeatureValues

For more information, see the IAM documentation.