Ver compromissos baseados em recursos

O Compute Engine permite visualizar uma lista de todos os compromissos baseados em recursos comprados ou recuperar as propriedades detalhadas de um compromisso específico.

É possível ver esses compromissos usando o console do Google Cloud , a CLI gcloud ou a REST.

Antes de começar

• Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

  Selecione a guia para como planeja usar as amostras nesta página:

  Console

  Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud , não é necessário configurar a autenticação.

  gcloud

  1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:

     gcloud init

     Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

     Observação:se você já instalou a CLI gcloud, verifique se tem a versão mais recente executando gcloud components update.
• Defina uma região e uma zona padrão.

REST

Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

Instale a CLI do Google Cloud.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber a permissão necessária para visualizar compromissos baseados em recursos, peça ao administrador para conceder a você o papel do IAM de Leitor do Compute (roles/compute.viewer) ou Administrador do Compute (roles/compute.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões compute.commitments.get e compute.commitments.list, que são necessárias para visualizar compromissos baseados em recursos.

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Ver uma lista de compromissos

É possível ver uma lista de todos os compromissos no projeto usando o console doGoogle Cloud , a CLI gcloud ou a REST.

Console

1. No console do Google Cloud , acesse a página Descontos por compromisso de uso. Acesse "Descontos por compromisso de uso"

2. Para ver uma lista de compromissos de uma categoria específica, selecione uma das seguintes guias:

   • Compromissos de hardware: selecione essa guia para ver os compromissos de recursos de hardware, como vCPUs, memória, GPUs, discos SSD locais e nós de locatário individual.
   • Compromissos de licença de software: selecione essa guia para ver os compromissos de licenças de SO.
   • Compromissos de armazenamento em blocos: selecione essa guia para ver os compromissos da capacidade do Exapool.

gcloud

Para listar todos os compromissos em uma região específica, use o comando gcloud compute commitments list:

gcloud compute commitments list \
    --regions=REGION \
    --project=PROJECT_ID

Substitua:

• REGION: a região em que você quer visualizar os compromissos.
• PROJECT_ID: o ID do projeto;

Exemplos

Por exemplo, para listar os compromissos na região us-central1 usando o projeto project-list-example, execute o seguinte comando:

gcloud compute commitments list \
    --regions=us-central1 \
    --project=project-list-example

REST

Para listar compromissos em uma região específica, faça uma solicitação GET ao método regionCommitments.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

Para listar compromissos em todas as regiões do projeto, faça uma solicitação GET ao método regionCommitments.aggregatedList:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments

Substitua:

• PROJECT_ID: o ID do projeto em que você quer visualizar os compromissos.
• REGION: a região em que você quer visualizar os compromissos.

Ver detalhes de um compromisso específico

É possível ver as propriedades detalhadas de um compromisso, como:

• Status
• Plano de compromisso
• Horários de início e término do compromisso
• Configurações de renovação automática
• Tipos e quantidades de recursos comprometidos

É possível ver seus compromissos usando o console do Google Cloud , a CLI gcloud ou a REST.

Console

1. No console do Google Cloud , acesse a página Descontos por compromisso de uso. Acesse "Descontos por compromisso de uso"

2. Selecione a guia da categoria de compromisso que você quer ver:

   • Para ver os compromissos de recursos de hardware, clique na guia Compromissos de hardware. Os compromissos de hardware abrangem vCPUs, memória, GPUs, discos SSD locais e nós de locatário individual.
   • Para conferir os compromissos de licenças de software premium, selecione a guia Compromissos de licença de software. Os compromissos de licença cobrem licenças de sistema operacional (SO), como SUSE Linux Enterprise Server (SLES), SLES para SAP ou Red Hat Enterprise Linux (RHEL).
   • Para ver os compromissos de pools de armazenamento conectado à rede, selecione a guia Compromissos de armazenamento em blocos. Os compromissos de armazenamento em blocos cobrem a capacidade do Exapool.

3. Para ver a página de detalhes de um compromisso, clique no nome dele.

gcloud

Para descrever um compromisso específico, use o comando gcloud compute commitments describe:

gcloud compute commitments describe COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID

Substitua:

• COMMITMENT_NAME: o nome do compromisso.
• REGION: a região em que a chave está localizada.
• PROJECT_ID: o ID do projeto;

Exemplos

Os exemplos a seguir descrevem compromissos no projeto myproject e na região us-central1.

Exemplo 1: descrever um compromisso de hardware

Para descrever um compromisso de hardware atual (example-hardware-commitment), execute o seguinte comando:

gcloud compute commitments describe example-hardware-commitment \
    --region=us-central1 \
    --project=myproject

O comando retorna as propriedades do compromisso, semelhantes às seguintes:

autoRenew: true
category: MACHINE
creationTimestamp: '2025-05-15T09:30:00.000-07:00'
endTimestamp: '2026-05-15T09:30:00.000-07:00'
kind: compute#commitment
name: example-hardware-commitment
plan: TWELVE_MONTH
region: https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1
resources:
- amount: '4'
  type: VCPU
- amount: '16384'
  type: MEMORY
status: ACTIVE
type: GENERAL_PURPOSE

Exemplo 2: descrever um compromisso de armazenamento em blocos

Para descrever um compromisso de armazenamento em blocos (example-block-storage-commitment), execute o comando gcloud beta compute commitments describe:

gcloud beta compute commitments describe example-block-storage-commitment \
    --region=us-central1 \
    --project=myproject

O comando retorna as propriedades do compromisso, estabelecendo a relação dele com os Exapools, semelhante ao seguinte:

autoRenew: true
category: PERSISTENT_DISK
creationTimestamp: '2025-08-20T14:45:00.000-07:00'
endTimestamp: '2026-08-20T14:45:00.000-07:00'
kind: compute#commitment
name: example-block-storage-commitment
persistentDiskResources:
- amount: '102400'
  dimensionType: CAPACITY_OPTIMIZED
  productType: HYPERDISK_EXAPOOL_BALANCED
plan: TWELVE_MONTH
region: https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1
status: ACTIVE

REST

Faça uma solicitação GET ao método regionCommitments.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME

Substitua:

• PROJECT_ID: o ID do projeto.
• REGION: a região em que o compromisso foi comprado.
• COMMITMENT_NAME: o nome do compromisso.

Exemplos

Os exemplos a seguir recuperam os detalhes de um compromisso no projeto myproject e na região us-central1.

Exemplo 1: descrever um compromisso de hardware

Para recuperar as propriedades de um compromisso de hardware (example-hardware-commitment), faça a seguinte solicitação GET:

GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment

A resposta contém as propriedades do compromisso de hardware, semelhante à saída a seguir:

{
  "autoRenew": true,
  "category": "MACHINE",
  "creationTimestamp": "2025-05-15T09:30:00.000-07:00",
  "endTimestamp": "2026-05-15T09:30:00.000-07:00",
  "kind": "compute#commitment",
  "name": "example-hardware-commitment",
  "plan": "TWELVE_MONTH",
  "region": "https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1",
  "resources": [
    {
      "amount": "4",
      "type": "VCPU"
    },
    {
      "amount": "16384",
      "type": "MEMORY"
    }
  ],
  "status": "ACTIVE",
  "type": "GENERAL_PURPOSE"
}

Exemplo 2: descrever um compromisso de armazenamento em blocos

Para recuperar as propriedades de um compromisso de armazenamento em blocos (example-block-storage-commitment), faça a seguinte solicitação GET ao método beta regionCommitments.get:

GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment

A resposta contém as propriedades que representam sua capacidade de compromisso de armazenamento em blocos, semelhante à seguinte saída JSON:

{
  "autoRenew": true,
  "category": "PERSISTENT_DISK",
  "creationTimestamp": "2025-08-20T14:45:00.000-07:00",
  "endTimestamp": "2026-08-20T14:45:00.000-07:00",
  "kind": "compute#commitment",
  "name": "example-block-storage-commitment",
  "persistentDiskResources": [
    {
      "amount": "102400",
      "dimensionType": "CAPACITY_OPTIMIZED",
      "productType": "HYPERDISK_EXAPOOL_BALANCED"
    }
  ],
  "plan": "TWELVE_MONTH",
  "region": "https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1",
  "status": "ACTIVE"
}