---
title: "POST /v1/{+parent}/assets"
method: POST
path: "/v1/{+parent}/assets"
tags: ["projects"]
---

# POST /v1/{+parent}/assets

`POST /v1/{+parent}/assets`

Creates an asset resource.

## Path parameters

- `parent` string, required

## Query parameters

- `assetId` string
- `validateOnly` boolean

## Request body

- GoogleCloudDataplexV1Asset — An asset represents a cloud resource that is being managed within a lake as a member of a zone.
  - `securityStatus` GoogleCloudDataplexV1AssetSecurityStatus — Security policy status of the asset. Data security policy, i.e., readers, writers & owners, should be specified in the lake/zone/asset IAM policy.
    - `updateTime` string, google-datetime — Last update time of the status.
    - `state` 'STATE_UNSPECIFIED' | 'READY' | 'APPLYING' | 'ERROR' — The current state of the security policy applied to the attached resource.
    - `message` string — Additional information about the current state.
  - `description` string — Optional. Description of the asset.
  - `name` string — Output only. The relative resource name of the asset, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}/assets/{asset_id}.
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'CREATING' | 'DELETING' | 'ACTION_REQUIRED' — Output only. Current state of the asset.
  - `createTime` string, google-datetime — Output only. The time when the asset was created.
  - `resourceStatus` GoogleCloudDataplexV1AssetResourceStatus — Status of the resource referenced by an asset.
    - `updateTime` string, google-datetime — Last update time of the status.
    - `managedAccessIdentity` string — Output only. Service account associated with the BigQuery Connection.
    - `state` 'STATE_UNSPECIFIED' | 'READY' | 'ERROR' — The current state of the managed resource.
    - `message` string — Additional information about the current state.
  - `updateTime` string, google-datetime — Output only. The time when the asset was last updated.
  - `discoverySpec` GoogleCloudDataplexV1AssetDiscoverySpec — Settings to manage the metadata discovery and publishing for an asset.
    - `excludePatterns` string[] — Optional. The list of patterns to apply for selecting data to exclude during discovery. For Cloud Storage bucket assets, these are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these are interpreted as patterns to match table names.
    - `enabled` boolean — Optional. Whether discovery is enabled.
    - `csvOptions` GoogleCloudDataplexV1AssetDiscoverySpecCsvOptions — Describe CSV and similar semi-structured data formats.
      - `headerRows` integer — Optional. The number of rows to interpret as header rows that should be skipped when reading data rows.
      - `delimiter` string — Optional. The delimiter being used to separate values. This defaults to ','.
      - `encoding` string — Optional. The character encoding of the data. The default is UTF-8.
      - `disableTypeInference` boolean — Optional. Whether to disable the inference of data type for CSV data. If true, all columns will be registered as strings.
    - `jsonOptions` GoogleCloudDataplexV1AssetDiscoverySpecJsonOptions — Describe JSON data format.
      - `encoding` string — Optional. The character encoding of the data. The default is UTF-8.
      - `disableTypeInference` boolean — Optional. Whether to disable the inference of data type for Json data. If true, all columns will be registered as their primitive types (strings, number or boolean).
    - `includePatterns` string[] — Optional. The list of patterns to apply for selecting data to include during discovery if only a subset of the data should considered. For Cloud Storage bucket assets, these are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these are interpreted as patterns to match table names.
    - `schedule` string — Optional. Cron schedule (https://en.wikipedia.org/wiki/Cron) for running discovery periodically. Successive discovery runs must be scheduled at least 60 minutes apart. The default value is to run discovery every 60 minutes.To explicitly set a timezone to the cron tab, apply a prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid string from IANA time zone database. For example, CRON_TZ=America/New_York 1 * * * *, or TZ=America/New_York 1 * * * *.
  - `displayName` string — Optional. User friendly display name.
  - `labels` object — Optional. User defined labels for the asset.
  - `uid` string — Output only. System generated globally unique ID for the asset. This ID will be different if the asset is deleted and re-created with the same name.
  - `discoveryStatus` GoogleCloudDataplexV1AssetDiscoveryStatus — Status of discovery for an asset.
    - `state` 'STATE_UNSPECIFIED' | 'SCHEDULED' | 'IN_PROGRESS' | 'PAUSED' | 'DISABLED' — The current status of the discovery feature.
    - `stats` GoogleCloudDataplexV1AssetDiscoveryStatusStats — The aggregated data statistics for the asset reported by discovery.
      - `tables` string, int64 — The count of table entities within the referenced resource.
      - `filesets` string, int64 — The count of fileset entities within the referenced resource.
      - `dataItems` string, int64 — The count of data items within the referenced resource.
      - `dataSize` string, int64 — The number of stored data bytes within the referenced resource.
    - `updateTime` string, google-datetime — Last update time of the status.
    - `lastRunTime` string, google-datetime — The start time of the last discovery run.
    - `lastRunDuration` string, google-duration — The duration of the last discovery run.
    - `message` string — Additional information about the current state.
  - `resourceSpec` GoogleCloudDataplexV1AssetResourceSpec — Identifies the cloud resource that is referenced by this asset.
    - `name` string — Immutable. Relative name of the cloud resource that contains the data that is being managed within a lake. For example: projects/{project_number}/buckets/{bucket_id} projects/{project_number}/datasets/{dataset_id}
    - `type` 'TYPE_UNSPECIFIED' | 'STORAGE_BUCKET' | 'BIGQUERY_DATASET' — Required. Immutable. Type of resource.
    - `readAccessMode` 'ACCESS_MODE_UNSPECIFIED' | 'DIRECT' | 'MANAGED' — Optional. Determines how read permissions are handled for each asset and their associated tables. Only available to storage buckets assets.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/dataplex.md) · [All operations](https://skmtc.net/google/apis/dataplex/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/dataplex/versions/43a3b60ca93b/schema)