REST Resource: projects.locations.apiHubInstances

Resource: ApiHubInstance

An ApiHubInstance represents the instance resources of the API Hub. Currently, only one ApiHub instance is allowed for each project.

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "stateMessage": string,
  "config": {
    object (Config)
  },
  "labels": {
    string: string,
    ...
  },
  "description": string
}
Fields
name

string

Identifier. Format: projects/{project}/locations/{location}/apiHubInstances/{apiHubInstance}.

createTime

string (Timestamp format)

Output only. Creation timestamp.

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. Last update timestamp.

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

state

enum (State)

Output only. The current state of the ApiHub instance.

stateMessage

string

Output only. Extra information about ApiHub instance state. Currently the message would be populated when state is FAILED.

config

object (Config)

Required. Config of the ApiHub instance.

labels

map (key: string, value: string)

Optional. Instance labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources

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

description

string

Optional. Description of the ApiHub instance.

State

State of the ApiHub Instance.

Enums
STATE_UNSPECIFIED The default value. This value is used if the state is omitted.
INACTIVE The ApiHub instance has not been initialized or has been deleted.
CREATING The ApiHub instance is being created.
ACTIVE The ApiHub instance has been created and is ready for use.
UPDATING The ApiHub instance is being updated.
DELETING The ApiHub instance is being deleted.
FAILED The ApiHub instance encountered an error during a state change.

Config

Available configurations to provision an ApiHub Instance.

JSON representation
{
  "cmekKeyName": string
}
Fields
cmekKeyName

string

Required. The Customer Managed Encryption Key (CMEK) used for data encryption. The CMEK name should follow the format of projects/([^/]+)/locations/([^/]+)/keyRings/([^/]+)/cryptoKeys/([^/]+), where the location must match the instance location.

Methods

create

Provisions instance resources for the API Hub.

get

Gets details of a single API Hub instance.

lookup

Looks up an Api Hub instance in a given Google Cloud project.