Organizar volumes de armazenamento usando rótulos

Para ajudar a organizar os volumes de armazenamento, é possível usar rótulos. Os identificadores são pares de chave-valor que podem ser anexados a cada volume de armazenamento e filtrados com base nos rótulos. Por exemplo, é possível usar rótulos para agrupar volumes de armazenamento por finalidade, ambiente, local, departamento e assim por diante. Os marcadores são opcionais.

Adicionar ou atualizar rótulos para volumes de armazenamento

É possível adicionar ou atualizar rótulos para os volumes de armazenamento.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.

  2. Para o volume de armazenamento que você quer rotular, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Clique em Adicionar rótulo e adicione o par de chave-valor.
    2. Para atualizar os rótulos, selecione-os e modifique os valores.
    3. Selecione Enviar.

  5. Depois disso, atualize a página Volumes para ver as alterações.

gcloud

Para adicionar ou atualizar rótulos de um volume de armazenamento, use o comando gcloud bms volumes update com a opção --update-labels.

O comando de amostra a seguir adiciona os rótulos environment = dev e location = branch:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

Se você fornecer um novo valor para um rótulo que já existe, o sistema atualizará o rótulo atual com o novo valor. Se você fornecer um novo rótulo, o sistema o adicionará à lista de rótulos.

API

Para adicionar ou atualizar rótulos de um volume de armazenamento, insira o ID do projeto, a região, o nome do volume e uma lista de rótulos no comando curl a seguir. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return.

A amostra de comando a seguir atribui um rótulo de environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Remover rótulos dos volumes de armazenamento

Você pode remover rótulos dos volumes de armazenamento.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.

  2. Para um volume de armazenamento com rótulos que você quer remover, clique em .

  3. Clique em Editar marcadores.

  4. Na página Editor de marcadores, faça o seguinte:

    1. Para excluir um rótulo, clique em .
    2. Selecione Enviar.

  5. Depois disso, atualize a página Volumes para ver as alterações.

gcloud

Para remover rótulos de um volume de armazenamento, use o comando gcloud bms volumes update com as seguintes opções:

  • --remove-labels: remove o rótulo especificado.
  • --clear-labels: remove todos os rótulos.

A amostra de comando a seguir remove o rótulo department de um volume de armazenamento:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

O exemplo de comando a seguir remove todos os rótulos de um volume de armazenamento:

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

Para remover rótulos de um volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento no comando curl a seguir. Forneça uma lista vazia de rótulos para remover todos os rótulos ou forneça uma lista dos rótulos que você quer manter (omitindo aqueles a serem removidos). Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

O comando de exemplo a seguir remove todos os rótulos, exceto environment = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Filtrar volumes de armazenamento usando rótulos

Você pode pesquisar volumes de armazenamento e filtrar resultados usando rótulos.

Console

  1. Acesse a página Compute Engine > Solução Bare Metal > Volumes.

  2. Clique na barra Filtro acima da lista de volumes de armazenamento.

  3. Na lista Propriedades, selecione Rótulos.

  4. Insira a chave, o valor ou o par de chave-valor do seu rótulo.

    Por exemplo, para ver apenas volumes de armazenamento com o rótulo env:dev, é possível inserir qualquer um dos seguintes itens:

    • Digite a chave: env
    • Insira o valor: dev
    • Insira o par de chave-valor: env:dev

  5. Para aplicar o filtro de rótulo, clique em qualquer lugar fora da barra de filtro.

gcloud

Para filtrar volumes de armazenamento usando rótulos, use o comando gcloud bms volumes list com a opção --filter.

O valor da opção --filter precisa estar no formato labels.KEY=VALUE. Por exemplo, se você quiser filtrar um rótulo com env como a chave e dev como o valor, emita este comando:

gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

Para mais informações sobre a sintaxe do filtro na CLI gcloud, consulte a documentação gcloud topic filters.

API

Para filtrar volumes de armazenamento usando rótulos, insira o ID do projeto e a região com filter=labels e um rótulo de par de chave-valor. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

A amostra de comando a seguir limita a saída para encontrar volumes de armazenamento com o rótulo de par de chave-valor environment = test.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"?filter=labels.environment=test