zones

Creates, updates, deletes, gets or lists a zones resource.

Overview

Name	zones
Type	Resource
Id	google.dataplex.zones

Fields

The following fields are returned by SELECT queries:

projects_locations_lakes_zones_get

Successful response

Name	Datatype	Description
name	string	Output only. The relative resource name of the zone, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}.
assetStatus	object	Output only. Aggregated status of the underlying assets of the zone. (id: GoogleCloudDataplexV1AssetStatus)
createTime	string (google-datetime)	Output only. The time when the zone was created.
description	string	Optional. Description of the zone.
discoverySpec	object	Optional. Specification of the discovery feature applied to data in this zone. (id: GoogleCloudDataplexV1ZoneDiscoverySpec)
displayName	string	Optional. User friendly display name.
labels	object	Optional. User defined labels for the zone.
resourceSpec	object	Required. Specification of the resources that are referenced by the assets within this zone. (id: GoogleCloudDataplexV1ZoneResourceSpec)
state	string	Output only. Current state of the zone.
type	string	Required. Immutable. The type of the zone.
uid	string	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.
updateTime	string (google-datetime)	Output only. The time when the zone was last updated.

projects_locations_lakes_zones_list

Successful response

Name	Datatype	Description
name	string	Output only. The relative resource name of the zone, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}.
assetStatus	object	Output only. Aggregated status of the underlying assets of the zone. (id: GoogleCloudDataplexV1AssetStatus)
createTime	string (google-datetime)	Output only. The time when the zone was created.
description	string	Optional. Description of the zone.
discoverySpec	object	Optional. Specification of the discovery feature applied to data in this zone. (id: GoogleCloudDataplexV1ZoneDiscoverySpec)
displayName	string	Optional. User friendly display name.
labels	object	Optional. User defined labels for the zone.
resourceSpec	object	Required. Specification of the resources that are referenced by the assets within this zone. (id: GoogleCloudDataplexV1ZoneResourceSpec)
state	string	Output only. Current state of the zone.
type	string	Required. Immutable. The type of the zone.
uid	string	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.
updateTime	string (google-datetime)	Output only. The time when the zone was last updated.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_lakes_zones_get	select	projectsId, locationsId, lakesId, zonesId		Retrieves a zone resource.
projects_locations_lakes_zones_list	select	projectsId, locationsId, lakesId	pageSize, pageToken, filter, orderBy	Lists zone resources in a lake.
projects_locations_lakes_zones_create	insert	projectsId, locationsId, lakesId	zoneId, validateOnly	Creates a zone resource within a lake.
projects_locations_lakes_zones_patch	update	projectsId, locationsId, lakesId, zonesId	updateMask, validateOnly	Updates a zone resource.
projects_locations_lakes_zones_delete	delete	projectsId, locationsId, lakesId, zonesId		Deletes a zone resource. All assets within a zone must be deleted before the zone can be deleted.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
lakesId	string
locationsId	string
projectsId	string
zonesId	string
filter	string
orderBy	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)
validateOnly	boolean
zoneId	string

SELECT examples

projects_locations_lakes_zones_get

Retrieves a zone resource.

SELECT
name,
assetStatus,
createTime,
description,
discoverySpec,
displayName,
labels,
resourceSpec,
state,
type,
uid,
updateTime
FROM google.dataplex.zones
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND lakesId = '{{ lakesId }}' -- required
AND zonesId = '{{ zonesId }}' -- required;

projects_locations_lakes_zones_list

Lists zone resources in a lake.

SELECT
name,
assetStatus,
createTime,
description,
discoverySpec,
displayName,
labels,
resourceSpec,
state,
type,
uid,
updateTime
FROM google.dataplex.zones
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND lakesId = '{{ lakesId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}';

INSERT examples

projects_locations_lakes_zones_create

Creates a zone resource within a lake.

INSERT INTO google.dataplex.zones (
data__displayName,
data__labels,
data__description,
data__type,
data__discoverySpec,
data__resourceSpec,
projectsId,
locationsId,
lakesId,
zoneId,
validateOnly
)
SELECT 
'{{ displayName }}',
'{{ labels }}',
'{{ description }}',
'{{ type }}',
'{{ discoverySpec }}',
'{{ resourceSpec }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ lakesId }}',
'{{ zoneId }}',
'{{ validateOnly }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: zones
  props:
    - name: projectsId
      value: string
      description: Required parameter for the zones resource.
    - name: locationsId
      value: string
      description: Required parameter for the zones resource.
    - name: lakesId
      value: string
      description: Required parameter for the zones resource.
    - name: displayName
      value: string
      description: >
        Optional. User friendly display name.
        
    - name: labels
      value: object
      description: >
        Optional. User defined labels for the zone.
        
    - name: description
      value: string
      description: >
        Optional. Description of the zone.
        
    - name: type
      value: string
      description: >
        Required. Immutable. The type of the zone.
        
      valid_values: ['TYPE_UNSPECIFIED', 'RAW', 'CURATED']
    - name: discoverySpec
      value: object
      description: >
        Optional. Specification of the discovery feature applied to data in this zone.
        
    - name: resourceSpec
      value: object
      description: >
        Required. Specification of the resources that are referenced by the assets within this zone.
        
    - name: zoneId
      value: string
    - name: validateOnly
      value: boolean

UPDATE examples

projects_locations_lakes_zones_patch

Updates a zone resource.

UPDATE google.dataplex.zones
SET 
data__displayName = '{{ displayName }}',
data__labels = '{{ labels }}',
data__description = '{{ description }}',
data__type = '{{ type }}',
data__discoverySpec = '{{ discoverySpec }}',
data__resourceSpec = '{{ resourceSpec }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND lakesId = '{{ lakesId }}' --required
AND zonesId = '{{ zonesId }}' --required
AND updateMask = '{{ updateMask}}'
AND validateOnly = {{ validateOnly}}
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

projects_locations_lakes_zones_delete

Deletes a zone resource. All assets within a zone must be deleted before the zone can be deleted.

DELETE FROM google.dataplex.zones
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND lakesId = '{{ lakesId }}' --required
AND zonesId = '{{ zonesId }}' --required;