REST Resource: projects.locations.services

Resource: Service

A managed metastore service that serves metadata queries.

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "network": string,
  "endpointUri": string,
  "port": integer,
  "state": enum (State),
  "stateMessage": string,
  "artifactGcsUri": string,
  "tier": enum (Tier),
  "metadataIntegration": {
    object (MetadataIntegration)
  },
  "maintenanceWindow": {
    object (MaintenanceWindow)
  },
  "uid": string,
  "metadataManagementActivity": {
    object (MetadataManagementActivity)
  },
  "releaseChannel": enum (ReleaseChannel),
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "hiveMetastoreConfig": {
    object (HiveMetastoreConfig)
  }
}
Fields
name

string

Immutable. The relative resource name of the metastore service, of the form:

projects/{projectNumber}/locations/{locationId}/services/{serviceId}.

createTime

string (Timestamp format)

Output only. The time when the metastore service 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. The time when the metastore service 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".

labels

map (key: string, value: string)

User-defined labels for the metastore service.

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

network

string

Immutable. The relative resource name of the VPC network on which the instance can be accessed. It is specified in the following form:

projects/{projectNumber}/global/networks/{network_id}.

endpointUri

string

Output only. The URI of the endpoint used to access the metastore service.

port

integer

The TCP port at which the metastore service is reached. Default: 9083.

state

enum (State)

Output only. The current state of the metastore service.

stateMessage

string

Output only. Additional information about the current state of the metastore service, if available.

artifactGcsUri

string

Output only. A Cloud Storage URI (starting with gs://) that specifies where artifacts related to the metastore service are stored.

tier

enum (Tier)

The tier of the service.

metadataIntegration

object (MetadataIntegration)

The setting that defines how metastore metadata should be integrated with external services and systems.

maintenanceWindow

object (MaintenanceWindow)

The one hour maintenance window of the metastore service. This specifies when the service can be restarted for maintenance purposes in UTC time.

uid

string

Output only. The globally unique resource identifier of the metastore service.

metadataManagementActivity

object (MetadataManagementActivity)

Output only. The metadata management activities of the metastore service.

releaseChannel

enum (ReleaseChannel)

Immutable. The release channel of the service. If unspecified, defaults to STABLE.

encryptionConfig

object (EncryptionConfig)

Immutable. Information used to configure the Dataproc Metastore service to encrypt customer data at rest. Cannot be updated.

hiveMetastoreConfig

object (HiveMetastoreConfig)

Configuration information specific to running Hive metastore software as the metastore service.

HiveMetastoreConfig

Specifies configuration information specific to running Hive metastore software as the metastore service.

JSON representation
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "kerberosConfig": {
    object (KerberosConfig)
  }
}
Fields
version

string

Immutable. The Hive metastore schema version.

configOverrides

map (key: string, value: string)

A mapping of Hive metastore configuration key-value pairs to apply to the Hive metastore (configured in hive-site.xml). The mappings override system defaults (some keys cannot be overridden).

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

kerberosConfig

object (KerberosConfig)

Information used to configure the Hive metastore service as a service principal in a Kerberos realm. To disable Kerberos, use the services.patch method and specify this field's path (hiveMetastoreConfig.kerberos_config) in the request's updateMask while omitting this field from the request's service.

KerberosConfig

Configuration information for a Kerberos principal.

JSON representation
{
  "keytab": {
    object (Secret)
  },
  "principal": string,
  "krb5ConfigGcsUri": string
}
Fields
keytab

object (Secret)

A Kerberos keytab file that can be used to authenticate a service principal with a Kerberos Key Distribution Center (KDC).

principal

string

A Kerberos principal that exists in the both the keytab the KDC to authenticate as. A typical principal is of the form primary/instance@REALM, but there is no exact format.

krb5ConfigGcsUri

string

A Cloud Storage URI that specifies the path to a krb5.conf file. It is of the form gs://{bucket_name}/path/to/krb5.conf, although the file does not need to be named krb5.conf explicitly.

Secret

A securely stored value.

JSON representation
{
  "cloudSecret": string
}
Fields
cloudSecret

string

The relative resource name of a Secret Manager secret version, in the following form:

projects/{projectNumber}/secrets/{secret_id}/versions/{version_id}.

State

The current state of the metastore service.

Enums
STATE_UNSPECIFIED The state of the metastore service is unknown.
CREATING The metastore service is in the process of being created.
ACTIVE The metastore service is running and ready to serve queries.
SUSPENDING The metastore service is entering suspension. Its query-serving availability may cease unexpectedly.
SUSPENDED The metastore service is suspended and unable to serve queries.
UPDATING The metastore service is being updated. It remains usable but cannot accept additional update requests or be deleted at this time.
DELETING The metastore service is undergoing deletion. It cannot be used.
ERROR The metastore service has encountered an error and cannot be used. The metastore service should be deleted.

Tier

Available service tiers.

Enums
TIER_UNSPECIFIED The tier is not set.
DEVELOPER The developer tier provides limited scalability and no fault tolerance. Good for low-cost proof-of-concept.
ENTERPRISE The enterprise tier provides multi-zone high availability, and sufficient scalability for enterprise-level Dataproc Metastore workloads.

MetadataIntegration

Specifies how metastore metadata should be integrated with external services.

JSON representation
{
  "dataCatalogConfig": {
    object (DataCatalogConfig)
  }
}
Fields
dataCatalogConfig

object (DataCatalogConfig)

The integration config for the Data Catalog service.

DataCatalogConfig

Specifies how metastore metadata should be integrated with the Data Catalog service.

JSON representation
{
  "enabled": boolean
}
Fields
enabled

boolean

Defines whether the metastore metadata should be synced to Data Catalog. The default value is to disable syncing metastore metadata to Data Catalog.

MaintenanceWindow

Maintenance window. This specifies when Dataproc Metastore may perform system maintenance operation to the service.

JSON representation
{
  "hourOfDay": integer,
  "dayOfWeek": enum (DayOfWeek)
}
Fields
hourOfDay

integer

The hour of day (0-23) when the window starts.

dayOfWeek

enum (DayOfWeek)

The day of week, when the window starts.

MetadataManagementActivity

The metadata management activities of the metastore service.

JSON representation
{
  "metadataExports": [
    {
      object (MetadataExport)
    }
  ],
  "restores": [
    {
      object (Restore)
    }
  ]
}
Fields
metadataExports[]

object (MetadataExport)

Output only. The latest metadata exports of the metastore service.

restores[]

object (Restore)

Output only. The latest restores of the metastore service.

MetadataExport

The details of a metadata export operation.

JSON representation
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "databaseDumpType": enum (Type),
  "destinationGcsUri": string
}
Fields
startTime

string (Timestamp format)

Output only. The time when the export started.

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

endTime

string (Timestamp format)

Output only. The time when the export ended.

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

databaseDumpType

enum (Type)

Output only. The type of the database dump.

destinationGcsUri

string

Output only. A Cloud Storage URI of a folder that metadata are exported to, in the form of gs://<bucket_name>/<path_inside_bucket>/<export_folder>, where <export_folder> is automatically generated.

State

The current state of the metadata export.

Enums
STATE_UNSPECIFIED The state of the metadata export is unknown.
RUNNING The metadata export is running.
SUCCEEDED The metadata export completed successfully.
FAILED The metadata export failed.
CANCELLED The metadata export is cancelled.

Restore

The details of a metadata restore operation.

JSON representation
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "backup": string,
  "type": enum (RestoreType),
  "details": string
}
Fields
startTime

string (Timestamp format)

Output only. The time when the restore started.

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

endTime

string (Timestamp format)

Output only. The time when the restore ended.

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

backup

string

Output only. The relative resource name of the metastore service backup to restore from, in the following form:

projects/{projectId}/locations/{locationId}/services/{serviceId}/backups/{backupId}.

type

enum (RestoreType)

Output only. The type of restore.

details

string

Output only. The restore details containing the revision of the service to be restored to, in format of JSON.

State

The current state of the restore.

Enums
STATE_UNSPECIFIED The state of the metadata restore is unknown.
RUNNING The metadata restore is running.
SUCCEEDED The metadata restore completed successfully.
FAILED The metadata restore failed.
CANCELLED The metadata restore is cancelled.

RestoreType

The type of restore. If unspecified, defaults to METADATA_ONLY.

Enums
RESTORE_TYPE_UNSPECIFIED The restore type is unknown.
FULL The service's metadata and configuration are restored.
METADATA_ONLY Only the service's metadata is restored.

ReleaseChannel

Release channels bundle features of varying levels of stability. Newer features may be introduced initially into less stable release channels and can be automatically promoted into more stable release channels.

Enums
RELEASE_CHANNEL_UNSPECIFIED Release channel is not specified.
CANARY The CANARY release channel contains the newest features, which may be unstable and subject to unresolved issues with no known workarounds. Services using the CANARY release channel are not subject to any SLAs.
STABLE The STABLE release channel contains features that are considered stable and have been validated for production use.

EncryptionConfig

Encryption settings for the service.

JSON representation
{
  "kmsKey": string
}
Fields
kmsKey

string

The fully qualified customer provided Cloud KMS key name to use for customer data encryption, in the following form:

projects/{projectNumber}/locations/{locationId}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}.

Methods

create

Creates a metastore service in a project and location.

delete

Deletes a single service.

exportMetadata

Exports metadata from a service.

get

Gets the details of a single service.

getIamPolicy

Gets the access control policy for a resource.

list

Lists services in a project and location.

patch

Updates the parameters of a single service.

restore

Restores a service from a backup.

setIamPolicy

Sets the access control policy on the specified resource.

testIamPermissions

Returns permissions that a caller has on the specified resource.