Package google.cloud.observability.v1

Índice

Observabilidade

Serviço que descreve gerenciadores de recursos

CreateBucket

rpc CreateBucket(CreateBucketRequest) returns (Operation)

Crie um novo bucket.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • observability.buckets.create

Para mais informações, consulte a documentação do IAM.
CreateTraceScope

rpc CreateTraceScope(CreateTraceScopeRequest) returns (TraceScope)

Cria um novo TraceScope.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • observability.traceScopes.create

Para mais informações, consulte a documentação do IAM.
DeleteTraceScope

rpc DeleteTraceScope(DeleteTraceScopeRequest) returns (Empty)

Exclui um TraceScope.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.traceScopes.delete

Para mais informações, consulte a documentação do IAM.
GetBucket

rpc GetBucket(GetBucketRequest) returns (Bucket)

Acessar o recurso do bucket.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.buckets.get

Para mais informações, consulte a documentação do IAM.
GetDataset

rpc GetDataset(GetDatasetRequest) returns (Dataset)

Receber um conjunto de dados.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.datasets.get

Para mais informações, consulte a documentação do IAM.
GetScope

rpc GetScope(GetScopeRequest) returns (Scope)

Recebe detalhes de um único escopo.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.scopes.get

Para mais informações, consulte a documentação do IAM.
GetSettings

rpc GetSettings(GetSettingsRequest) returns (Settings)

Acessar as configurações

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.settings.get

Para mais informações, consulte a documentação do IAM.
GetTraceScope

rpc GetTraceScope(GetTraceScopeRequest) returns (TraceScope)

Receber o recurso TraceScope.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.traceScopes.get

Para mais informações, consulte a documentação do IAM.
GetView

rpc GetView(GetViewRequest) returns (View)

Receba uma visualização.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.views.get

Para mais informações, consulte a documentação do IAM.
ListBuckets

rpc ListBuckets(ListBucketsRequest) returns (ListBucketsResponse)

Listar buckets de um projeto em um local específico.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • observability.buckets.list

Para mais informações, consulte a documentação do IAM.
ListDatasets

rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse)

Listar conjuntos de dados de um bucket.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • observability.datasets.list

Para mais informações, consulte a documentação do IAM.
ListTraceScopes

rpc ListTraceScopes(ListTraceScopesRequest) returns (ListTraceScopesResponse)

Lista os TraceScopes de um projeto em um local específico.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • observability.traceScopes.list

Para mais informações, consulte a documentação do IAM.
ListViews

rpc ListViews(ListViewsRequest) returns (ListViewsResponse)

Visualizações em lista de um conjunto de dados.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • observability.views.list

Para mais informações, consulte a documentação do IAM.
UpdateBucket

rpc UpdateBucket(UpdateBucketRequest) returns (Operation)

Atualizar um bucket.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.buckets.update

Para mais informações, consulte a documentação do IAM.
UpdateScope

rpc UpdateScope(UpdateScopeRequest) returns (Scope)

Atualiza os parâmetros de um único escopo.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.scopes.update

Para mais informações, consulte a documentação do IAM.
UpdateSettings

rpc UpdateSettings(UpdateSettingsRequest) returns (Operation)

Atualizar configurações

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.settings.update

Para mais informações, consulte a documentação do IAM.
UpdateTraceScope

rpc UpdateTraceScope(UpdateTraceScopeRequest) returns (TraceScope)

Atualizar um TraceScope.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • observability.traceScopes.update

Para mais informações, consulte a documentação do IAM.

Bucket

Configuração do bucket para armazenar dados observáveis.

Campos
name

string

Identificador. Nome do bloco. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]
display_name

string

Opcional. É um nome de exibição fácil de usar.
description

string

Opcional. Descrição do bucket.
create_time

Timestamp

Apenas saída. Criar carimbo de data/hora.
update_time

Timestamp

Apenas saída. Atualizar carimbo de data/hora.
delete_time

Timestamp

Apenas saída. Excluir marcação de tempo.
purge_time

Timestamp

Apenas saída. Carimbo de data/hora em que o bucket no estado de exclusão reversível é limpo.
cmek_settings

CmekSettings

Opcional. Configurações para definir a CMEK em um bucket.

CmekSettings

Configurações para definir a CMEK de um bucket.

Campos
kms_key

string

Opcional. O nome do recurso da chave do Cloud KMS configurada. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]

Exemplo:

projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key
kms_key_version

string

Apenas saída. O nome do recurso CryptoKeyVersion da chave do Cloud KMS configurada. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]/cryptoKeyVersions/[VERSION]

Exemplo:

projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key/cryptoKeyVersions/1

Esse campo somente leitura é usado para transmitir a CryptoKeyVersion configurada específica da kms_key que foi configurada. Ele é preenchido quando as configurações de CMEK estão vinculadas a uma única versão de chave.
service_account_id

string

Apenas saída. A conta de serviço usada para acessar a chave.

CreateBucketRequest

Solicitação para criar um bucket.

Campos
parent

string

Obrigatório. Nome do projeto e local do bucket. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]
bucket_id

string

Obrigatório. ID do bucket a ser criado.
bucket

Bucket

Obrigatório. Bucket a ser criado.

CreateLinkRequest

Solicitação para criar um link.

Campos
parent

string

Obrigatório. Nome do conjunto de dados que contém esse link. O formato é:

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

CreateTraceScopeRequest

Solicitação para criar um TraceScope.

Campos
parent

string

Obrigatório. O nome completo do recurso do local em que o escopo de trace deve ser criado

projects/[PROJECT_ID]/locations/[LOCATION_ID]

Exemplo:

projects/my-project/locations/global
trace_scope_id

string

Obrigatório. Um identificador atribuído pelo cliente para o escopo do trace.
trace_scope

TraceScope

Obrigatório. O novo escopo de trace.

Conjunto de dados

Um conjunto de dados é uma coleção de dados com uma configuração específica. Um conjunto de dados pode ter o suporte de várias tabelas. Um bucket pode ter vários conjuntos de dados.

Campos
name

string

Identificador. Nome do conjunto de dados. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
display_name

string

Opcional. É um nome de exibição fácil de usar.
description

string

Opcional. Descrição do conjunto de dados.
create_time

Timestamp

Apenas saída. Criar carimbo de data/hora.
delete_time

Timestamp

Apenas saída. Excluir marcação de tempo.
purge_time

Timestamp

Apenas saída. Carimbo de data/hora em que o conjunto de dados no estado de exclusão reversível é limpo.

DeleteLinkRequest

Solicitação para excluir um link.

Campos
name

string

Obrigatório. Nome do link a ser excluído. O formato é:

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

DeleteTraceScopeRequest

Solicitação para excluir um TraceScope.

Campos
name

string

Obrigatório. O nome completo do recurso do escopo de trace a ser excluído:

projects/[PROJECT_ID]/locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID]

Exemplo:

projects/my-project/locations/global/traceScopes/my-trace-scope

GetBucketRequest

Solicitação para receber um bucket.

Campos
name

string

Obrigatório. Nome do bucket a ser recuperado. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]

GetDatasetRequest

Solicitação para receber um conjunto de dados.

Campos
name

string

Obrigatório. Nome do conjunto de dados a ser recuperado. O formato é:

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

GetLinkRequest

Solicitação para receber um link.

Campos
name

string

Obrigatório. Nome do link a ser recuperado. O formato é:

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

GetScopeRequest

Mensagem para receber um escopo.

Campos
name

string

Obrigatório. Nome do recurso. O formato é:

projects/{project}/locations/{location}/scopes/{scope}

O campo {location} precisa ser definido como global. O campo {scope} precisa ser definido como _Default.

GetSettingsRequest

Solicitação para acessar as configurações.

Campos
name

string

Obrigatório. Nome das configurações a serem recuperadas.

Formato do nome:

"projects/[PROJECT_ID]/locations/[LOCATION]/settings"
"folders/[FOLDER_ID]/locations/[LOCATION]/settings"
"organizations/[ORGANIZATION_ID]/locations/[LOCATION]/settings"

GetTraceScopeRequest

Solicitação para receber um TraceScope.

Campos
name

string

Obrigatório. O nome do recurso do escopo do trace:

projects/[PROJECT_ID]/locations/[LOCATION_ID]/traceScopes/[TRACE_SCOPE_ID]

Exemplo:

projects/my-project/locations/global/traceScopes/my-trace-scope

GetViewRequest

Solicitação para receber uma visualização.

Campos
name

string

Obrigatório. Nome da visualização a ser recuperada. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/views/[VIEW_ID]

ListBucketsRequest

Solicitação para listar buckets.

Campos
parent

string

Obrigatório. O pai, que é proprietário dessa coleção de buckets. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]
page_size

int32

Opcional. O número máximo de buckets a serem retornados. Se não for especificado, no máximo 100 buckets serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
page_token

string

Opcional. Um token de página recebido de uma chamada ListBuckets anterior. Forneça isso para recuperar a página subsequente.
show_deleted

bool

Opcional. Se for verdadeiro, a resposta vai incluir buckets excluídos.

ListBucketsResponse

Resposta para listar buckets.

Campos
buckets[]

Bucket

Opcional. A lista de buckets.
next_page_token

string

Opcional. Um token que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

ListDatasetsRequest

Solicitação para listar conjuntos de dados.

Campos
parent

string

Obrigatório. O bucket pai que é proprietário dessa coleção de conjuntos de dados. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]
page_size

int32

Opcional. O número máximo de conjuntos de dados a serem retornados. Se não for especificado, no máximo 100 conjuntos de dados serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
page_token

string

Opcional. Um token de página recebido de uma chamada ListDatasets anterior. Forneça isso para recuperar a página subsequente.
show_deleted

bool

Opcional. Se for verdadeiro, a resposta vai incluir conjuntos de dados excluídos.

ListDatasetsResponse

Resposta para listar conjuntos de dados.

Campos
datasets[]

Dataset

A lista de conjuntos de dados.
next_page_token

string

Um token que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

ListLinksRequest

Solicitação para listar links.

Campos
parent

string

Obrigatório. O conjunto de dados pai que é proprietário dessa coleção de links. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
page_size

int32

Opcional. O número máximo de links a serem retornados. Se não for especificado, no máximo 100 links serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
page_token

string

Opcional. Um token de página recebido de uma chamada ListLinks anterior. Forneça isso para recuperar a página subsequente.

ListLinksResponse

Resposta para listar links.

Campos
next_page_token

string

Opcional. Um token que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

ListTraceScopesRequest

Solicitação para listar TraceScopes.

Campos
parent

string

Obrigatório. O nome completo do recurso do local para procurar escopos de trace:

projects/[PROJECT_ID]/locations/[LOCATION_ID]

Exemplo:

projects/my-project/locations/global
page_size

int32

Opcional. O número máximo de resultados a serem retornados dessa solicitação.

Valores não positivos são ignorados. A presença de next_page_token na resposta indica que mais resultados podem estar disponíveis.
page_token

string

Opcional. Se presente, recupere o próximo lote de resultados da chamada anterior para esse método. page_token precisa ser o valor de next_page_token da resposta anterior. Os valores de outros parâmetros de método precisam ser idênticos aos da chamada anterior.

ListTraceScopesResponse

Resposta para listar TraceScopes.

Campos
trace_scopes[]

TraceScope

Opcional. Uma lista de escopos de trace.
next_page_token

string

Opcional. Se houver mais resultados do que os que aparecem nesta resposta, next_page_token será incluído. Para receber o próximo conjunto de resultados, chame o mesmo método novamente usando o valor de next_page_token como page_token.

ListViewsRequest

Solicitação para listar visualizações em lista.

Campos
parent

string

Obrigatório. Conjunto de dados com as visualizações que serão listadas. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]
page_size

int32

Opcional. O número máximo de visualizações a serem retornadas. Se não for especificado, no máximo 100 visualizações serão retornadas. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
page_token

string

Opcional. Um token de página recebido de uma chamada ListViews anterior. Forneça isso para recuperar a página subsequente.

ListViewsResponse

Resposta para visualizações em lista.

Campos
views[]

View

A lista de visualizações.
next_page_token

string

Opcional. Um token que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

OperationMetadata

Representa os metadados da operação de longa duração.

Campos
create_time

Timestamp

Somente saída: a hora em que a operação foi criada.
end_time

Timestamp

Somente saída: a hora em que a operação terminou de ser executada.
target

string

Apenas saída. Caminho do recurso definido pelo servidor para o destino da operação.
verb

string

Apenas saída. Nome do verbo executado pela operação.
status_message

string

Apenas saída. Status legível por humanos da operação, caso haja um.
requested_cancellation

bool

Apenas saída. Identifica se o usuário solicitou o cancelamento da operação. As operações que foram canceladas têm o valor [Operation.error][] com um google.rpc.Status.code de 1, correspondente a Code.CANCELLED.
api_version

string

Apenas saída. Versão da API usada para iniciar a operação.

Escopo

Mensagem que descreve o objeto Scope

Campos
name

string

Identificador. Nome do recurso. O formato é:

projects/{project}/locations/{location}/scopes/{scope}

O campo {location} precisa ser definido como global. O campo {scope} precisa ser definido como _Default.
update_time

Timestamp

Apenas saída. Atualizar carimbo de data/hora. Observação: o carimbo de data/hora de atualização do escopo padrão não é definido inicialmente.
log_scope

string

Obrigatório. O nome completo do recurso do logging.googleapis.com/LogScope. Exemplo:

//logging.googleapis.com/projects/myproject/locations/global/logScopes/my-log-scope
trace_scope

string

Obrigatório. O nome do recurso não qualificado do cloudtrace.googleapis.com/TraceScope. Exemplo:

projects/myproject/locations/global/traceScopes/my-trace-scope

Configurações

Descreve as configurações associadas a um projeto, uma organização ou uma pasta.

Campos
name

string

Identificador. O nome do recurso das configurações.
default_storage_location

string

Opcional. O local que deve ser usado quando recursos regionais são provisionados pelo Google Cloud.
service_account_id

string

Apenas saída. A conta de serviço do contêiner de recursos, como projeto ou pasta. Ela será usada pelo Cloud Observability para realizar ações no projeto do contêiner, como acessar chaves do KMS ou criar links. Sempre a mesma conta de serviço por contêiner de recursos, independentemente da região.
kms_key_name

string

Opcional. O nome do recurso da chave do Cloud KMS configurada.

Formato do nome da chave KMS:

"projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]"

Exemplo:

"projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key"

TraceScope

Um escopo de trace é uma coleção de recursos cujos traces são consultados juntos.

Campos
name

string

Identificador. O nome do recurso do escopo de trace.

Exemplo:

projects/my-project/locations/global/traceScopes/my-trace-scope
resource_names[]

string

Obrigatório. Nomes dos projetos incluídos neste escopo de trace.

  • projects/[PROJECT_ID]

Um escopo de trace pode incluir no máximo 20 projetos.
description

string

Opcional. Descreve esse escopo de trace.

O tamanho máximo da descrição é de 8.000 caracteres.
create_time

Timestamp

Apenas saída. O carimbo de data/hora de criação do escopo do trace.
update_time

Timestamp

Apenas saída. O carimbo de data/hora da última atualização do escopo do trace.

UpdateBucketRequest

Solicitação para atualizar um bucket.

Campos
bucket

Bucket

Obrigatório. O bucket a ser atualizado.

O campo de nome do bucket identifica o recurso a ser atualizado.
update_mask

FieldMask

Opcional. Lista de campos a serem atualizados.

UpdateLinkRequest

Solicitação para atualizar um link.

Campos
update_mask

FieldMask

Opcional. Lista de campos a serem atualizados.

UpdateScopeRequest

Mensagem para atualizar um escopo.

Campos
update_mask

FieldMask

Opcional. A máscara de campo é usada para especificar os campos a serem substituídos no recurso Scope pela atualização. Os campos especificados em update_mask são relativos ao recurso, não à solicitação completa. Um campo é substituído quando está na máscara. Se o usuário não fornecer uma máscara, todos os campos presentes na solicitação serão substituídos.
scope

Scope

Obrigatório. O recurso que está sendo atualizado.

UpdateSettingsRequest

Solicitação para atualizar as configurações.

Campos
settings

Settings

Obrigatório. As configurações a serem atualizadas.

O campo de nome das configurações é usado para identificar o recurso a ser atualizado.
update_mask

FieldMask

Opcional. A máscara de campo que especifica quais campos das configurações serão atualizados.

UpdateTraceScopeRequest

Solicitação para atualizar um TraceScope.

Campos
trace_scope

TraceScope

Obrigatório. O escopo de trace atualizado.
update_mask

FieldMask

Opcional. Lista de campos a serem atualizados.

Ver

Uma visualização corresponde a uma representação somente leitura de um subconjunto dos dados em um conjunto de dados.

Campos
name

string

Identificador. Nome da visualização. O formato é:

projects/[PROJECT_ID]/locations/[LOCATION]/buckets/[BUCKET_ID]/datasets/[DATASET_ID]/views/[VIEW_ID]
display_name

string

Opcional. É um nome de exibição fácil de usar.
description

string

Opcional. Descrição da visualização.
create_time

Timestamp

Apenas saída. Criar carimbo de data/hora.
update_time

Timestamp

Apenas saída. Atualizar carimbo de data/hora.