Sign in

v1

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

Creates a data asset.

post/v1/{+parent}/dataAssets

Path parameters

parentstring required

Required. The parent resource where this data asset will be created. Format: projects/{project_id_or_number}/locations/{location_id}/dataProducts/{data_product_id}

Query parameters

dataAssetIdstring

Optional. The ID of the data asset to create.The ID must conform to RFC-1034 and contain only lower-case letters (a-z), numbers (0-9), or hyphens, with the first character a letter, the last a letter or a number, and a 63 character maximum. Characters outside of ASCII are not permitted. Valid format regex: ^a-z?$ If not provided, a system generated ID will be used.

validateOnlyboolean

Optional. Validates the request without actually creating the data asset. Defaults to false.

Request body

createTimestring google-datetime

Output only. The time at which the data asset was created.

resourcestring

Required. Immutable. Full resource name of the cloud resource represented by the data asset. This must follow https://cloud.google.com/iam/docs/full-resource-names. Example: //bigquery.googleapis.com/projects/my_project_123/datasets/dataset_456/tables/table_789 Only BigQuery tables and datasets are currently supported. Data asset creator must have getIamPolicy and setIamPolicy permissions on the resource. Data asset creator must also have resource specific get permission, for instance, bigquery.tables.get for BigQuery tables.

updateTimestring google-datetime

Output only. The time at which the data asset was last updated.

namestring

Identifier. Resource name of the data asset. Format: projects/{project_id_or_number}/locations/{location_id}/dataProducts/{data_product_id}/dataAssets/{data_asset_id}

etagstring

Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.

accessGroupConfigsobject

Optional. Access groups configurations for this data asset.The key is DataProduct.AccessGroup.id and the value is AccessGroupConfig.Example: { "analyst": { "iamRoles": ["roles/bigquery.dataViewer"] } } Currently, at most one IAM role is allowed per access group. For providing multiple predefined IAM roles, wrap them in a custom IAM role as per https://cloud.google.com/iam/docs/creating-custom-roles.

uidstring

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

labelsobject

Optional. User-defined labels for the data asset.Example: { "environment": "production", "billing": "marketing-department" }

Response

Successful response