REST Resource: projects.locations.instances.engineConfigs

Resource: EngineConfig

The EngineConfig resource creates the configuration for training a model.

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "engineVersion": string,
  "tuning": {
    object (Tuning)
  },
  "performanceTarget": {
    object (PerformanceTarget)
  },
  "lineOfBusiness": enum (LineOfBusiness)
}
Fields
name

string

Output only. The resource name of the EngineConfig. format: "/projects/{project_num}/locations/{location}/instances/{instance}/engineConfigs/{engineConfig}"

createTime

string (Timestamp format)

Output only. The timestamp of creation of this resource.

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. The timestamp of the most recent update of this resource.

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".

labels

map (key: string, value: string)

Labels

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

state

enum (State)

Output only. State of the EngineConfig (creating, active, deleting, etc.)

engineVersion

string

Required. The resource name of the EngineVersion used in this model tuning. format: "/projects/{project_num}/locations/{location}/instances/{instance}/engineVersions/{engineVersion}"

tuning

object (Tuning)

Optional. Configuration for tuning in creation of the EngineConfig. This field is required if hyperparameterSource.type is not INHERITED, and output-only otherwise.

performanceTarget

object (PerformanceTarget)

Optional. PerformanceTarget gives information on how the tuning and training will be evaluated. This field is required if hyperparameterSource.type is not INHERITED, and output-only otherwise.

lineOfBusiness

enum (LineOfBusiness)

Output only. The line of business (Retail/Commercial) this engine config is used for. Determined by EngineVersion, cannot be set by user.

State

The possible states of a resource.

Enums
STATE_UNSPECIFIED State is unspecified, should not occur.
CREATING The resource has not finished being created.
ACTIVE The resource is active/ready to be used.
UPDATING The resource is in the process of being updated.
DELETING The resource is in the process of being deleted.

Tuning

The parameters needed for the tuning operation, these are used only in tuning and not passed on to training.

JSON representation
{
  "primaryDataset": string,
  "endTime": string
}
Fields
primaryDataset

string

Required. The resource name of the Primary Dataset used in this model tuning. For information about how primary and auxiliary datasets are used, refer to the engine version's documentation. Format: "/projects/{project_num}/locations/{location}/instances/{instance}/datasets/{dataset}"

endTime

string (Timestamp format)

Required. End_time specifies the latest time from which labels are used and from which data is used to generate features for tuning. End_time should be no later than the end of the dateRange of the dataset.

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".

PerformanceTarget

PerformanceTarget gives hints on how to evaluate the performance of a model.

JSON representation
{
  "partyInvestigationsPerPeriodHint": string
}
Fields
partyInvestigationsPerPeriodHint

string (int64 format)

Required. This value gives the tuner a hint on the number of investigations that will be performed on this data per period (currently month). This is used to control how the model is evaluated.

Methods

create

Creates an engine config.

delete

Deletes an engine config.

exportMetadata

Export governance information for an EngineConfig resource.

get

Gets an engine config.

list

Lists engine configs.

patch

Updates the parameters of a single EngineConfig.