Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1372300401.5 KB
projects

Creates a zone resource within a lake.

post/v1/{+parent}/zones

Path parameters

parentstring required

Required. The resource name of the parent lake: projects/{project_number}/locations/{location_id}/lakes/{lake_id}.

Query parameters

validateOnlyboolean

Optional. Only validate the request, but do not perform mutations. The default is false.

zoneIdstring

Required. Zone identifier. This ID will be used to generate names such as database and dataset names when publishing metadata to Hive Metastore and BigQuery. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must end with a number or a letter. * Must be between 1-63 characters. * Must be unique across all lakes from all locations in a project. * Must not be one of the reserved IDs (i.e. "default", "global-temp")

Request body

createTimestring google-datetime

Output only. The time when the zone was created.

updateTimestring google-datetime

Output only. The time when the zone was last updated.

state'STATE_UNSPECIFIED' | 'ACTIVE' | 'CREATING' | 'DELETING' | 'ACTION_REQUIRED'

Output only. Current state of the zone.

type'TYPE_UNSPECIFIED' | 'RAW' | 'CURATED'

Required. Immutable. The type of the zone.

uidstring

Output only. System generated globally unique ID for the zone. This ID will be different if the zone is deleted and re-created with the same name.

descriptionstring

Optional. Description of the zone.

namestring

Output only. The relative resource name of the zone, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}.

labelsobject

Optional. User defined labels for the zone.

displayNamestring

Optional. User friendly display name.

Response

Successful response