You can use the Observability API or the Google Cloud CLI to list your
observability buckets, datasets, views, and links, and to create
BigQuery links to analyze stored data with SQL. To create links,
you can also use Terraform.

observability datasets store your trace data. For
information about log and metric storage or the trace data format, see
[Telemetry storage overview](https://docs.cloud.google.com/stackdriver/docs/observability/storage-overview.md.txt) and
[Trace schema](https://docs.cloud.google.com/stackdriver/docs/reference/telemetry/trace-schema.md.txt).

## Before you begin

Before managing observability storage, configure your project and
Identity and Access Management (IAM) roles, and choose the interface you plan to use.

### Configure your project and roles

1.

   To get the permissions that
   you need to list buckets, links, and views,

   ask your administrator to grant you the
   [Observability Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/observability.md.txt#observability.viewer) (`roles/observability.viewer`) IAM role on your project.


   For more information about granting roles, see [Manage access to projects, folders, and organizations](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).


   You might also be able to get
   the required permissions through [custom
   roles](https://docs.cloud.google.com/iam/docs/creating-custom-roles) or other [predefined
   roles](https://docs.cloud.google.com/iam/docs/roles-overview#predefined).

### Select the interface you plan to use

### gcloud

<br />

> [!NOTE]
> **Note**: You must use gcloud CLI version 586.0.0 or later.

<br />


In the Google Cloud console, activate Cloud Shell.

[Activate Cloud Shell](https://console.cloud.google.com/?cloudshell=true)


At the bottom of the Google Cloud console, a
[Cloud Shell](https://docs.cloud.google.com/shell/docs/how-cloud-shell-works.md.txt)
session starts and displays a command-line prompt. Cloud Shell is a shell environment
with the Google Cloud CLI
already installed and with values already set for
your current project. It can take a few seconds for the session to initialize.

<br />

### Terraform


To use the Terraform samples on this page in a local development environment, install and
initialize the gcloud CLI, and then set up Application Default Credentials with
your user credentials.

1.
   [Install](https://docs.cloud.google.com/sdk/docs/install) the Google Cloud CLI.

2. If you're using an external identity provider (IdP), you must first
   [sign in to the gcloud CLI with your federated identity](https://docs.cloud.google.com/iam/docs/workforce-log-in-gcloud.md.txt).

3.

   If you're using a local shell, then create local authentication credentials for your user
   account:

   ```bash
   gcloud auth application-default login
   ```

   You don't need to do this if you're using Cloud Shell.


   If an authentication error is returned, and you are using an external identity provider
   (IdP), confirm that you have
   [signed in to the gcloud CLI with your federated identity](https://docs.cloud.google.com/iam/docs/workforce-log-in-gcloud.md.txt).


For more information, see
[Set up ADC for a local development environment](https://docs.cloud.google.com/docs/authentication/set-up-adc-local-dev-environment.md.txt)
in the Google Cloud authentication documentation.

<br />

### REST


To use the REST API samples on this page in a local development environment, you use the
credentials you provide to the gcloud CLI.

1. [Install](https://docs.cloud.google.com/sdk/docs/install) the Google Cloud CLI.
2. If you're using an external identity provider (IdP), you must first [sign in to the gcloud CLI with your federated identity](https://docs.cloud.google.com/iam/docs/workforce-log-in-gcloud.md.txt).


For more information, see
[Authenticate for using REST](https://docs.cloud.google.com/docs/authentication/rest.md.txt)
in the Google Cloud authentication documentation.

<br />

## List observability buckets

This section describes how to list your observability buckets. An
observability bucket is the management entity for datasets, which store data.

### gcloud

<br />

> [!NOTE]
> **Note**: You must use gcloud CLI version 586.0.0 or later.

<br />


Before using any of the command data below,
make the following replacements:

- <var translate="no">LOCATION</var>: The location of the observability buckets. To list all observability buckets, regardless of location, set the location to a hyphen (`-`).
- <var translate="no">PROJECT_ID</var>: The identifier of the project..


Execute the

[`gcloud observability buckets list`](https://docs.cloud.google.com/sdk/gcloud/reference/observability/buckets/list)

command:

#### Linux, macOS, or Cloud Shell

```bash
gcloud observability buckets list \
 --location=LOCATION --project=PROJECT_ID
```

#### Windows (PowerShell)

```bash
gcloud observability buckets list `
 --location=LOCATION --project=PROJECT_ID
```

#### Windows (cmd.exe)

```bash
gcloud observability buckets list ^
 --location=LOCATION --project=PROJECT_ID
```


The response lists the name, description, and create time of each observability buckets.
The following is an example of a response when the command is successful:

```
---
createTime: '2026-01-21T21:39:22.381083860Z'
description: Bucket for storing spans from Cloud Trace.
name: projects/my-project/locations/us/buckets/_Trace
```

<br />

### Terraform

You can't use Terraform to list observability buckets.

### REST

To list the observability buckets that are in your project and in a specific
location, use the
[`projects.locations.buckets.list`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets/list.md.txt) method.

You must specify the parent parameter, which has the following form:

    projects/PROJECT_ID/locations/LOCATION

The fields in the previous expression have the following meanings:

- <var translate="no">PROJECT_ID</var>: The identifier of the project.
- <var translate="no">LOCATION</var>: The [location of the observability bucket](https://docs.cloud.google.com/stackdriver/docs/observability/observability-bucket-locations.md.txt). If you set <var translate="no">LOCATION</var> to a hyphen (`-`), then all observability buckets in your project are listed.

The response is an array of
[`Bucket`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.md.txt#Bucket) objects. For each object, the value of the
`name` field has the following format:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

The following shows a sample response:

    {
      "buckets": [
        {
          "name": "projects/my-project/locations/us/buckets/_Trace",
          "description": "Trace Bucket",
          "createTime": "2025-01-01T15:42:30.988919645Z",
          "updateTime": "2025-02-04T15:42:30.988919645Z",
          "retentionDays": 30
        }
      ]
    }

You can use the Observability API to get more
information about the bucket whose ID is <var translate="no">BUCKET_ID</var>. For example, you can
list the datasets on that bucket, and the views and links on each
dataset. For more information,
see the [Observability API reference documentation](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest.md.txt).

## List datasets on an observability bucket

This section describes how to list the observability datasets on an
observability bucket. An observability bucket is the management container for
datasets, which store data. When Google Cloud Observability creates a bucket, it
automatically creates a dataset.

### gcloud

<br />

> [!NOTE]
> **Note**: You must use gcloud CLI version 586.0.0 or later.

<br />


Before using any of the command data below,
make the following replacements:

- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.
- <var translate="no">LOCATION</var>: The location of the observability bucket.
- <var translate="no">PROJECT_ID</var>: The identifier of the project.


Execute the

[`gcloud observability buckets datasets list`](https://docs.cloud.google.com/sdk/gcloud/reference/observability/buckets/datasets/list)

command:

#### Linux, macOS, or Cloud Shell

```bash
gcloud observability buckets datasets list \
 --bucket=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID
```

#### Windows (PowerShell)

```bash
gcloud observability buckets datasets list `
 --bucket=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID
```

#### Windows (cmd.exe)

```bash
gcloud observability buckets datasets list ^
 --bucket=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID
```


The response lists the name, description, and create time of each dataset. The following is
an example of a response when the command is successful:

```
---
createTime: '2026-01-21T21:39:22.381083860Z'
description: Dataset for storing spans from Cloud Trace.
name: projects/my-project/locations/us/buckets/_Trace/datasets/Spans
```

<br />

### Terraform

You can't use Terraform to list observability datasets.

### REST

To list the datasets for an observability bucket, use the
[`projects.locations.buckets.datasets.list`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets/list.md.txt)
method.

You must specify the parent parameter, which has the following form:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

The fields in the preceding expression have the following meanings:

- <var translate="no">PROJECT_ID</var>: The identifier of the project.
- <var translate="no">LOCATION</var>: The [location of the observability bucket](https://docs.cloud.google.com/stackdriver/docs/observability/observability-bucket-locations.md.txt).
- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.

The response is an array of [`Dataset`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets.md.txt#Dataset) objects.
For each object, the value of the `name` field has the following format:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

The following shows a sample response:

    {
      "datasets": [
        {
          "name": "projects/my-project/locations/us/buckets/_Trace/datasets/Spans",
          "description": "Trace Spans",
          "createTime": "2025-01-01T15:42:30.988919645Z",
          "updateTime": "2025-02-04T15:42:30.988919645Z",
        }
      ]
    }

You can use the Observability API to get information about the
dataset whose ID is <var translate="no">DATASET_ID</var>. For example, you can
list the views and links on each dataset. For more information, see the
[Observability API reference documentation](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest.md.txt).

## List views on a dataset

This section describes how to list your observability views.
Each observability dataset hosts one or more views. A view provides read access
to a subset of entries in the dataset. Google Cloud Observability creates a view when it
creates a dataset. That view includes all data in the dataset.

### gcloud

<br />

> [!NOTE]
> **Note**: You must use gcloud CLI version 586.0.0 or later.

<br />


Before using any of the command data below,
make the following replacements:

- <var translate="no">DATASET_ID</var>: The ID of the dataset. Your trace data is stored in a dataset named `Spans`.
- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.
- <var translate="no">LOCATION</var>: The location of the observability bucket.
- <var translate="no">PROJECT_ID</var>: The identifier of the project.


Execute the

[`gcloud observability buckets datasets views list`](https://docs.cloud.google.com/sdk/gcloud/reference/observability/buckets/datasets/views/list)

command:

#### Linux, macOS, or Cloud Shell

```bash
gcloud observability buckets datasets views list \
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID \
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID
```

#### Windows (PowerShell)

```bash
gcloud observability buckets datasets views list `
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID `
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID
```

#### Windows (cmd.exe)

```bash
gcloud observability buckets datasets views list ^
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID ^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID
```


The response lists the name, create time, and update time of each observability views.
The following is an example of a response when the command is successful:

```
---
createTime: '2026-01-21T21:39:22.381083860Z'
displayName: _AllSpans
name: projects/pamstestproject1/locations/us/buckets/_Trace/datasets/Spans/views/_AllSpans
updateTime: '2026-01-21T21:39:22.381083860Z'
```

<br />

### Terraform

You can't use Terraform to list observability views.

### REST

To list the views on a dataset, use the
[`projects.locations.buckets.datasets.views.list`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets.views/list.md.txt)
method.

You must specify the parent parameter, which has the following form:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views

The fields in the preceding expression have the following meanings:

- <var translate="no">PROJECT_ID</var>: The identifier of the project.
- <var translate="no">LOCATION</var>: The [location of the observability bucket](https://docs.cloud.google.com/stackdriver/docs/observability/observability-bucket-locations.md.txt).
- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.
- <var translate="no">DATASET_ID</var>: The ID of the dataset being queried. For example, this ID might be `Spans`.

The response is an array of
[`View`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets.views.md.txt#View) objects.
For each object, the value of the `name` field has the following format:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views/OBS_VIEW_ID

In the preceding expression, the ID of a view is represented by <var translate="no">OBS_VIEW_ID</var>.
For example, this field might have a value of `_AllSpans`.

The following shows a sample response:

    {
      "views": [
        {
          "name": "projects/my-project/locations/us/buckets/_Trace/datasets/Spans/views/_AllSpans",
          "filter": "",
          "createTime": "2025-01-01T15:42:30.988919645Z",
          "updateTime": "2025-02-04T15:42:30.988919645Z",
        }
      ]
    }

For more information,
see the [Observability API reference documentation](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest.md.txt).

## List links on a dataset

This section describes how to list the links on your observability datasets. A
link can let you query your data by using BigQuery services or it can
let a Google Cloud service query a subset of that data.

### gcloud

<br />

> [!NOTE]
> **Note**: You must use gcloud CLI version 586.0.0 or later.

<br />


Before using any of the command data below,
make the following replacements:

- <var translate="no">DATASET_ID</var>: The ID of the dataset. Your trace data is stored in a dataset named `Spans`.
- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.
- <var translate="no">LOCATION</var>: The location of the observability bucket.
- <var translate="no">PROJECT_ID</var>: The identifier of the project.


Execute the

[`gcloud observability buckets datasets links list`](https://docs.cloud.google.com/sdk/gcloud/reference/observability/buckets/datasets/links/list)

command:

#### Linux, macOS, or Cloud Shell

```bash
gcloud observability buckets datasets links list \
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID\
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID
```

#### Windows (PowerShell)

```bash
gcloud observability buckets datasets links list `
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID`
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID
```

#### Windows (cmd.exe)

```bash
gcloud observability buckets datasets links list ^
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID
```


The response lists the name and create time of each link. The following is
an example of a response when the command is successful:

```
---
createTime: '2026-04-02T21:23:09.272323714Z'
name: projects/my-project/locations/us/buckets/_Trace/datasets/Spans/links/mydataset
```

<br />

### Terraform

You can't use Terraform to list links on observability datasets.

### REST

To list the links on a dataset, use the
[`projects.locations.buckets.datasets.links.list`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets.links/list.md.txt)
method.

You must specify the parent parameter, which has the following form:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

The fields in the preceding expression have the following meanings:

- <var translate="no">PROJECT_ID</var>: The identifier of the project.
- <var translate="no">LOCATION</var>: The [location of the observability bucket](https://docs.cloud.google.com/stackdriver/docs/observability/observability-bucket-locations.md.txt).
- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.
- <var translate="no">DATASET_ID</var>: The ID of the dataset being queried. For example, this ID might be `Spans`.

The response is an array of
[`Link`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets.links.md.txt#Link) objects.
For each object, the value of the `name` field has the following format:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID

The <var translate="no">LINK_ID</var> is the name of the BigQuery dataset. This field
must be unique within your Google Cloud project.

The following shows a sample response:

    {
      "links": [
        {
          "name": "projects/my-project/locations/us/buckets/_Trace/datasets/Spans/links/my_link",
          "description": "My link for traces to BigQuery",
          "createTime": "2025-01-12T15:42:30.988919645Z"
        }
      ]
    }

For more information,
see the [Observability API reference documentation](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest.md.txt).

## Create a link on a dataset

This section describes how to create a linked BigQuery dataset on an
observability dataset, which lets you use BigQuery services to
query your trace data. Each observability dataset supports one linked
BigQuery dataset.

When you create a link on an observability dataset, the following occurs:

- Google Cloud Observability might create the following service accounts or modify their
  IAM role grants:

  - [Monitoring Service Account](https://docs.cloud.google.com/iam/docs/service-agents.md.txt#monitoring-service-account):
    Required to create a link to a linked BigQuery dataset.
    The Cloud Monitoring API must be enabled for Google Cloud Observability to create this
    service account.

  - [Cloud Observability Service Account](https://docs.cloud.google.com/iam/docs/service-agents.md.txt#cloud-observability-service-account):
    Required to create a link on an observability dataset.

  - [Cloud Logging Service Account](https://docs.cloud.google.com/iam/docs/service-agents.md.txt#cloud-logging-service-account):
    Required to create a link on a log bucket.

- Audit logs record the request to create a link and the request from the
  service agent manager to grant the Monitoring Service Account the
  IAM role of
  [Monitoring Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/monitoring.md.txt#monitoring.notificationServiceAgent).
  These logs also record the completion of the long-running operation.

### Before you begin

1.

   To get the permissions that
   you need to create a link on an observability dataset,

   ask your administrator to grant you the
   [Observability Editor](https://docs.cloud.google.com/iam/docs/roles-permissions/observability.md.txt#observability.editor) (`roles/observability.editor`) IAM role on your project.


   For more information about granting roles, see [Manage access to projects, folders, and organizations](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).


   You might also be able to get
   the required permissions through [custom
   roles](https://docs.cloud.google.com/iam/docs/creating-custom-roles) or other [predefined
   roles](https://docs.cloud.google.com/iam/docs/roles-overview#predefined).

### Create a linked BigQuery dataset

### gcloud

<br />

> [!NOTE]
> **Note**: You must use gcloud CLI version 586.0.0 or later.

<br />


Before using any of the command data below,
make the following replacements:

- <var translate="no">LINK_ID</var>: The name of the BigQuery dataset.
- <var translate="no">DATASET_ID</var>: The ID of the dataset. Your trace data is stored in a dataset named `Spans`.
- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.
- <var translate="no">LOCATION</var>: The location of the observability bucket.
- <var translate="no">PROJECT_ID</var>: The identifier of the project.


Execute the

[`gcloud observability buckets datasets links create`](https://docs.cloud.google.com/sdk/gcloud/reference/observability/buckets/datasets/links/create)

command:

#### Linux, macOS, or Cloud Shell

```bash
gcloud observability buckets datasets links create \
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID \
 --dataset=DATASET_ID\
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID
```

#### Windows (PowerShell)

```bash
gcloud observability buckets datasets links create `
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID `
 --dataset=DATASET_ID`
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID
```

#### Windows (cmd.exe)

```bash
gcloud observability buckets datasets links create ^
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID ^
 --dataset=DATASET_ID^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID
```


The create command initiates a long-running operation. The following is
an example of a response when the command is successful:

```
Create request issued for: [mydataset]
Waiting for operation [projects/my-project/locations/us/operations/operation-1775164903749-64e80c9817833-9ff804b6-c3e9cbe7] to complete...done.
Created link [mydataset].
```

<br />

### Terraform

To create a link on an observability dataset, use the Terraform resource
[`google_observability_link`](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/observability_link)
and set the following fields:

- `project`: The ID of your project.
- `location`: The location of the link. This location must match the location of the observability bucket.
- `bucket`: The ID of the observability bucket. For example, `_Trace`.
- `dataset`: The ID of the observability dataset. For example, `Spans`.
- `link_id`: The ID of the BigQuery dataset.

You can also update and delete links.

### REST

To create a link to a BigQuery dataset, send a request to the
[`projects.locations.buckets.datasets.links.create`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets.links/create.md.txt)
endpoint.

You must specify the parent parameter, which has the following form:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

The fields in the preceding expression have the following meanings:

- <var translate="no">PROJECT_ID</var>: The identifier of the project.
- <var translate="no">LOCATION</var>: The [location of the observability bucket](https://docs.cloud.google.com/stackdriver/docs/observability/observability-bucket-locations.md.txt).
- <var translate="no">BUCKET_ID</var>: The ID of the observability bucket. For example, this ID might be `_Trace`.
- <var translate="no">DATASET_ID</var>: The ID of the dataset being queried. For example, this ID might be `Spans`.

This command requires a query parameter and a request body:

- The query parameter, `linkId`, must be specified and set to the name of the
  BigQuery dataset. For example, `linkId="my_link"`. The
  BigQuery dataset name must be unique for your Google Cloud project,
  and must be limited to 100 characters and can include only letters,
  digits, and underscores.

- The request body is a [`Link`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/projects.locations.buckets.datasets.links.md.txt#Link) object. The value of the
  `name` field has the following format:

      projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID

  The value you provide for the `name` field must match the
  linked BigQuery dataset referenced by the query parameter.

  The <var translate="no">LINK_ID</var> field is the name of the BigQuery dataset.

The response is an [`Operation`](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest/v1/folders.locations.operations.md.txt#Operation) object.
This object contains information about the progress of the method. When the
method completes, the `Operation` object contains status data.

For a complete list of Observability API endpoints,
see the [Observability API reference documentation](https://docs.cloud.google.com/stackdriver/docs/reference/observability/api/rest.md.txt).

If you encounter permission errors when creating a linked dataset,
then see [Troubleshoot permission errors](https://docs.cloud.google.com/trace/docs/troubleshooting.md.txt#linked-dataset-permission-error).

## What's next

- [View and analyze telemetry](https://docs.cloud.google.com/stackdriver/docs/observability/query-and-view-overview.md.txt)
- [Set defaults for observability buckets](https://docs.cloud.google.com/stackdriver/docs/observability/set-defaults-for-observability-buckets.md.txt): Configure a default storage location and a default customer-managed encryption key (CMEK) for your observability buckets.