REST Resource: projects.locations.buckets.links

Resource: Link

Describes a link connected to an analytics enabled bucket.

JSON representation
{"name":string,"description":string,"createTime":string,"lifecycleState":enum (`LifecycleState`),"bigqueryDataset":{object (`BigQueryDataset`)}}

Fields
`name`	`string` Output only. The resource name of the link. The name can have up to 100 characters. A valid link id (at the end of the link name) must only have alphanumeric characters and underscores within it. `"projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/links/[LINK_ID]""organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/links/[LINK_ID]""billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/links/[LINK_ID]""folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/links/[LINK_ID]"` For example: `projects/my-project/locations/global/buckets/my-bucket/links/my_link
`description`	`string` Optional. Describes this link. The maximum length of the description is 8000 characters.
`createTime`	`string (Timestamp format)` Output only. The creation timestamp of the link. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples:`"2014-10-02T15:01:23Z"`,`"2014-10-02T15:01:23.045123456Z"` or`"2014-10-02T15:01:23+05:30"`.
`lifecycleState`	`enum (LifecycleState)` Output only. The resource lifecycle state.
`bigqueryDataset`	`object (BigQueryDataset)` Optional. The information of a BigQuery Dataset. When a link is created, a BigQuery dataset is created along with it, in the same project as the LogBucket it's linked to. This dataset will also have BigQuery Views corresponding to the LogViews in the bucket.

Methods
`create`	Asynchronously creates a linked dataset in BigQuery which makes it possible to use BigQuery to read the logs stored in the log bucket.
`delete`	Deletes a link.
`get`	Gets a link.
`list`	Lists links.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-09-12 UTC.