Sign in

v1

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

Creates a data product.

post/v1/{+parent}/dataProducts

Path parameters

parentstring required

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

Query parameters

dataProductIdstring

Optional. The ID of the data product 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 product. Default: false.

Request body

namestring

Identifier. Resource name of the data product. Format: projects/{project_id_or_number}/locations/{location_id}/dataProducts/{data_product_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.

descriptionstring

Optional. Description of the data product.

assetCountinteger

Output only. Number of data assets associated with this data product.

updateTimestring google-datetime

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

createTimestring google-datetime

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

labelsobject

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

displayNamestring

Required. User-friendly display name of the data product.

ownerEmailsstring[]

Required. Emails of the data product owners.

iconstring byte

Optional. Base64 encoded image representing the data product. Max Size: 3.0MiB Expected image dimensions are 512x512 pixels, however the API only performs validation on size of the encoded data. Note: For byte fields, the content of the fields are base64-encoded (which increases the size of the data by 33-36%) when using JSON on the wire.

uidstring

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

accessGroupsobject

Optional. Data product access groups by access group id as key. If data product is used only for packaging data assets, then access groups may be empty. However, if a data product is used for sharing data assets, then at least one access group must be specified.Example: { "analyst": { "id": "analyst", "displayName": "Analyst", "description": "Access group for analysts", "principal": { "googleGroup": "analysts@example.com" } } }

Response

Successful response