Manter o ambiente da Solução Bare Metal

Depois que o ambiente da Solução Bare Metal estiver em execução, use as informações incluídas neste guia para manter os servidores, o armazenamento e a rede da Solução Bare Metal.

Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution

A API Solução Bare Metal oferece muitas ferramentas para permitir que você monitore e mantenha o ambiente da solução Bare Metal. Normalmente, você só precisa usar esse procedimento na primeira vez que usar a API Bare Metal Solution. No entanto, reutilize essas instruções conforme necessário para fins de solução de problemas, caso a API não responda como esperado.

Atribua o papel de IAM predefinido do Administrador da Solução Bare Metal ou do Editor da Solução Bare Metal aos principais. Para saber como mapear papéis do IAM, consulte Conceder um papel do IAM.
Ative a API Bare Metal Solution no projeto do Cloud.

Observação: para ativar um serviço da API, você precisa ter um papel do IAM que conceda permissão para ativar serviços, como Proprietárioou Administrador do Service Usage. Consulte Controle de acesso para mais informações.
Console
1. Acesse a API de Solução Bare Metal no painel do Console do Google Cloud. Também é possível pesquisar a API Bare Metal Solution na biblioteca de APIs: APIs e serviços > Biblioteca.
2. Na página da API Bare Metal Solution, clique em Ativar.
3. Clique no botão "Voltar" do navegador. Se você vir uma marca de seleção verde ao lado das palavras API ativada, quer dizer que é possível usar a API.
gcloud
- Para ativar a API da Solução Bare Metal por meio de gcloud insira o ID do projeto do Google Cloud no comando a seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione Entrar ouou a chave Retornar:
```
 gcloud services enable baremetalsolution.googleapis.com --project=PROJECT_ID
 
```
Permita que a Google Cloud CLI funcione com seu projeto do Cloud.
1. Na janela do Cloud Shell, digite o comando gcloud auth login.
```
gcloud auth login
```
2. Copie o URL resultante e cole-o em outra janela ou guia do navegador.
3. Faça login na página usando seu nome de usuário associado ao projeto do Cloud.
4. Clique em Permitir para ativar a CLI gcloud.
5. Copie o código de autorização.
6. Cole o código na linha de comando do cliente do Cloud Shell.
7. Pressione a tecla Enter ou Retornar.

Para mais informações sobre as etapas gerais necessárias para configurar uma API no Google Cloud, consulte Primeiros passos com as APIs do Google Cloud.

Operar o servidor da Solução Bare Metal

Há várias operações que você pode executar no servidor, como reiniciar e ligar. Use os seguintes comandos com seu servidor.

gcloud

Para desligar e reiniciar o servidor da Solução Bare Metal, siga as etapas a seguir.
1. Siga as etapas de configuração da API.
  
  A reinicialização de um servidor requer a ativação da API Solução Bare Metal e da CLI gcloud. Você também precisa conceder o papel de administrador da Solução Bare Metal ou Editor da solução Bare Metal à sua principal. Para concluir as etapas de configuração, consulte Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution.
2. Para desligar e reiniciar um servidor da Solução Bare Metal, emita o comando gcloud bms instances reset:
  
  Observação: por padrão, esse comando é executado no modo síncrono e impede que você emita comandos adicionais até que a operação de reinicialização seja concluída. Se você tiver um ambiente automatizado ou precisar trabalhar em outras tarefas durante a operação de reinicialização, adicione a opção --async para executar esse comando no modo assíncrono.
```
gcloud bms instances reset SERVER_NAME --project=PROJECT_ID --region=REGION
```
  A saída exibe o status da solicitação de reinicialização do servidor.
```
Reset request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
  Depois de inserir o comando, o servidor da Solução Bare Metal será reiniciado. Ela pode levar de 15 a 60 minutos para ser concluída, dependendo da configuração do seu servidor.
  
  A saída desse comando fornece um ID de operações que pode ser usado para verificar o status da reinicialização. Para usar o ID das operações e visualizar o status, consulte Visualizar o status de uma operação de longa duração.
Para ligar a energia do servidor, use o comando gcloud bms instances start.

Observação: por padrão, esse comando é executado no modo síncrono e impede você de emitir comandos adicionais até que a operação de inicialização seja concluída. Se você tiver um ambiente automatizado ou precisar trabalhar em outras tarefas durante a operação de inicialização, adicione a opção --async para executar esse comando no modo assíncrono.
```
gcloud bms instances start SERVER_NAME --project=PROJECT_ID --region=REGION
```
A saída exibe o status da solicitação de reinicialização do servidor.
```
Start request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
Na maioria dos casos, a energia do servidor permanece ligada. Se você precisar desligar a energia, use as seguintes opções:
- Use os comandos de desligamento do sistema operacional do seu servidor.
- Alguns aplicativos desligam a energia do servidor automaticamente após uma nova imagem.

API

Para desligar e reiniciar o servidor da Solução Bare Metal, siga as etapas a seguir.
1. Siga as etapas de configuração da API.
  
  A reinicialização de um servidor requer a ativação da API Solução Bare Metal e da CLI gcloud. Você também precisa garantir o papel de administrador ou de administrador da solução Bare Metal. Para concluir as etapas de configuração, consulte Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution.
2. Fazer login no servidor da Solução Bare Metal para ver a reinicialização do servidor.
  - Abra uma janela do Console do Cloud.
  - Navegue até a instância de VM do jump host: Compute Engine >Instâncias de VM
  - Clique no botão SSH para se conectar à instância de VM do host jump.
  - Para fazer login no servidor da Solução Bare Metal, insira o comando SSH na linha de comando do host de salto.
```
[username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
customeradmin@bms-ip-address's password: bms-password
Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
[customeradmin@BMS_SERVER_NAME ~]$
```
  - Digite o comando toptop para verificar se o servidor está em execução. Use essa janela para monitorar o progresso da reinicialização.
3. Executar o comando de reinicialização
  - Abra a janela do Cloud Shell.
  - Adicione o ID do projeto do Cloud, a região e o nome do servidor da Solução Bare Metal no comando a seguir.
```
curl -X POST \
-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/instances/BMS_SERVER_NAME:reset"
```
    Observação: a versão V2 desse comando substituiu a versão V1. Recomendamos usar a versão V2 desse comando.
  - Copie e cole o comando na janela do Cloud Shell e pressione a tecla Enter ou Retornar.
    
    O servidor da Solução Bare Metal será reiniciado. Ela pode levar de 15 a 60 minutos para ser concluída, dependendo da configuração do seu servidor.
    
    A saída desse comando fornece um ID de operações que pode ser usado para verificar o status da reinicialização. Para usar o ID das operações e visualizar o status, consulte Visualizar o status de uma operação de longa duração.
```
{
 "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
}
```
    Enquanto o servidor é reinicializado, não é possível fazer ping ou SSH da instância de VM do jump de salto para acessar o servidor da Solução Bare Metal. Depois de alguns minutos, o servidor da Solução Bare Metal volta a ficar on-line.
    
    Quando o servidor estiver on-line novamente, é possível emitir um ping ou usar SSH da instância de VM do host de salto para acessar o servidor da Solução Bare Metal.
    
    Observação: a reinicialização leva de 15 a 60 minutos para ser concluída. Se você tentar reemitir o comando de reinicialização antes do servidor ficar pronto, uma mensagem de erro será exibida. Aguarde e execute o comando novamente depois que o servidor ficar on-line novamente.
Para mais informações sobre como reiniciar o servidor da Solução Bare Metal, consulte a API Bare Metal Solution.
Para ligar a energia do servidor, insira o ID do projeto, a região e o nome do servidor. Em seguida, emita o seguinte comando curl.
```
curl -X POST \
-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/instances/SERVER_NAME:start"
```
Na maioria dos casos, a energia do servidor permanece ligada. Se você precisar desligar a energia, use as seguintes opções:
- Use os comandos de desligamento do sistema operacional do seu servidor.
- Alguns aplicativos desligam a energia do servidor automaticamente após uma nova imagem.

Gerenciar recursos no ambiente da Solução Bare Metal

As APIs de gerenciamento da Solução Bare Metal, os comandos gcloud e o Console do Google Cloud permitem visualizar o status dos recursos no ambiente da Solução Bare Metal, como servidores, rede e armazenamento.

Configure a API Bare Metal Solution

Para ver o status do recurso, você precisa ativar a API Solução Bare Metal e a CLI gcloud. Você também precisa garantir um dos papéis do IAM da Solução Bare Metal aos principais, como Administrador da Solução Bare Metal ou Editor da Solução Bare Metal. Para concluir as etapas de configuração da API antes de gerenciar seus recursos, consulte Configurar seu projeto do Google Cloud para usar a API Bare Metal Solution.

Ver servidores no ambiente da Solução Bare Metal

Ao emitir comandos para chamar as APIs de gerenciamento da Solução Bare Metal, você pode aprender sobre o status dos dispositivos no ambiente da Solução Bare Metal. Para ver o status atual, escolha uma das seguintes opções de comando:

Console

Verifique o status dos servidores da Solução Bare Metal e dos componentes de rede e armazenamento associados no Console do Cloud.

Acesse Compute Engine > Solução Bare Metal > Servidores.

Veja as informações disponíveis.

Field	Descrição	Exemplo
Status	Indica a disponibilidade de um servidor.	Um círculo verde com uma marca de seleção indica que o servidor está provisionado e disponível.
Código	Identificador atribuído ao seu servidor. Clique nele para ver informações básicas sobre o servidor. Compartilhe o código com o suporte do Google Cloud ao solucionar esse recurso.	`at-1234567-svr001`
Nome	Nome do servidor Clique no nome para ver mais informações sobre o servidor. Observação: se você não tiver inserido um nome ao provisionar seu servidor, o ID aparecerá este campo.	`server-1`
Local	Região da Solução Bare Metal	`asia-southeast1`
Tipo de servidor	Especificações do servidor	`o2-standard-32-metal`
IP do cliente	Endereço IP do servidor que se conecta à sua nuvem privada virtual do Google	`10.200.0.5`
IP particular	Endereço IP do servidor que se conecta a outros recursos do ambiente da Solução Bare Metal	`192.168.2.5`
Marcadores	Exibe os rótulos que você adicionou a este servidor. Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.	`environment:test`

Para ver mais informações sobre o servidor e os recursos de rede e de armazenamento dele, clique no Nome do servidor.
- Em Informações básicas, é possível saber se o servidor é compatível com o hiperencadeamento.
- Em Rede, é possível ver os nomes das interfaces de rede, tipos de interface (cliente ou particular), endereços IP e endereços MAC.
- Em Armazenamento, você pode ver as informações do número de unidade lógica (LUN, na sigla em inglês), como estado, nome, volume, tamanho e tipo. Também é possível ver se a LUN é compartilhável e inicializável.

gcloud

Para listar os servidores no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e emita o comando gcloud bms instances list:
```
gcloud bms instances list --project=PROJECT_ID
```
O exemplo de saída a seguir mostra informações sobre um servidor, como nome, tipo, endereços IP e estado do servidor.
```
NAME               PROJECT              REGION           MACHINE_TYPE          IP_ADDRESSES             STATE
SERVER_NAME      PROJECT_ID        REGION         o2-standard-32-metal  192.168.1.1,192.168.2.1  RUNNING
```
Outras opções de comando incluem:
- --region--region: exibe dispositivos em uma região específica do Google Cloud.
- --limit--limit: limita a saída para mostrar um número específico de dispositivos

Para informações de rede e armazenamento de um servidor específico no ambiente da Solução Bare Metal, digite o nome do servidor, o ID do projeto e a região e emita o comando gcloud bms instances describe:

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

O exemplo de saída a seguir mostra um servidor operacional com 12 LUNs, uma rede cliente de 192.168.1.1 e uma rede particular de 192.168.2.1.

luns:
- bootLun: true
  name: SERVER_NAME-lun000-b1
  sizeGb: '200'
  state: READY
  storageVolume: SERVER_NAME-vol000-b1
- name: STORAGE_DEVICE_NAME-lun001
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun002
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun003
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun004
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun005
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun006
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun007
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun008
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun009
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun010
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun011
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun012
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
machineType: o2-standard-32-metal
name: projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME
networks:
- ipAddress: 192.168.1.1
  macAddress:
  - 34:80:0D:52:AF:28
  - 34:80:0D:15:3E:0D
  network: STORAGE_DEVICE_NAME-vlan001
- ipAddress: 192.168.2.1
  macAddress:
  - 34:80:0D:52:AF:38
  - 34:80:0D:15:3E:1D
  network: STORAGE_DEVICE_NAME-vlan002
state: RUNNING

Para adicionar, atualizar ou remover rótulos de servidores, emita o comando gcloud bms instances update. Você pode usar as seguintes opções:
- --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = test.
- --remove-labels: Remove rótulos específicos
- --clear-labels: Remove todos os rótulos.
Aqui está um comando de amostra que adiciona os rótulos environment = dev e location = branch e remove o rótulo department de
```
gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch --remove-labels=department
```
O comando a seguir remove todos os rótulos de um servidor:
```
gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels
```
Para ver as alterações dos rótulos do servidor, emita o seguinte comando:
```
gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
```
Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms instances list, adicione --filter labels.KEY=VALUE ao final do comando. No exemplo a seguir, limita a saída para um servidor rotulado com o par de chave-valor environment = dev.
```
gcloud bms instances list --project=PROJECT_ID --region=REGION --filter labels.environment=dev
```

API

Abra uma janela do terminal do Cloud Shell no Console do Google Cloud.
Para listar os servidores no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e a região no comando curl a seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione. use a tecla Enterou chave de Retorno
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"
```

Para receber informações de rede e armazenamento de um servidor no ambiente da Solução Bare Metal, emita o seguinte comando:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

Para adicionar rótulos a um servidor, digite o ID do projeto, a região e o nome do servidor no seguinte comando curl. No par de chave-valor neste exemplo, é atribuído um rótulo de environment = test. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:

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/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Para usar um rótulo para filtrar a saída de um comando GET curl de um servidor da Solução Bare Metal, insira o ID e a região do projeto e, em seguida, anexe ?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar servidores com o rótulo do par de chave-valor ambiente = teste.
```
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/instances"?filter=labels.environment=test
```

Ver redes no ambiente da Solução Bare Metal

O monitoramento dos recursos de rede no ambiente da Solução Bare Metal permite saber como os servidores se conectam a outros recursos. Para ver o status da rede, escolha uma das seguintes opções:

Console

No Console do Google Cloud, navegue para Compute Engine > Solução Bare Metal > Redes.

Veja as informações disponíveis.

Field	Descrição	Exemplo
Status	Indica a disponibilidade de uma rede.	Um círculo verde com uma marca de seleção indica que a rede está provisionada e disponível.
Código	Identificador atribuído à sua rede. Clique nele para ver informações básicas sobre a rede. Compartilhe o código com o suporte do Google Cloud ao solucionar esse recurso.	`at-1234567-vlan001`
Nome	Nome da rede. Clique no nome para ver mais informações sobre a rede. Observação: se você não tiver inserido um nome ao provisionar a rede, o ID aparecerá neste campo.	`network-1`
Local	Região onde a rede está localizada	`asia-southeast1`
Tipo	Cliente ou rede privada	`Client`
CIDR	Intervalo de endereços IP da rede	`192.168.1.0/24`
ID VLAN	Identificador da VLAN atribuído pelo Google Cloud	`100`
Marcadores	Exibe os rótulos adicionados a esse recurso de rede. Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.	`environment:test`

gcloud

Para visualizar todas as redes no ambiente da Solução Bare Metal e ver o status delas, insira o ID do projeto e emita o comando gcloud bms networks list.
```
gcloud bms networks list --project=PROJECT_ID
```
O exemplo de saída a seguir mostra um nome da rede, região, intervalo de endereços IP, tipo de rede e ID da VLAN de cada rede.
```
NAME                REGION           RANGE           TYPE     VLAN_ID
at-1111111-vlan001  REGION         192.168.1.0/24  CLIENT   122
at-1111111-vlan002  REGION         192.168.2.0/24  PRIVATE  123
```

Para ver detalhes de uma única rede, insira o ID do projeto, a região e o nome da rede e emita o seguinte comando gcloud bms networks describe:

gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION

O exemplo de saída a seguir mostra o intervalo de endereços IP, nome da rede, estado, tipo de rede, ID da VLAN e detalhes do roteamento virtual e de encaminhamento (VRF, na sigla em inglês).

cidr: 192.168.1.0/24
name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
state: PROVISIONED
type: CLIENT
vlanId: '122'
vrf:
  autonomousSystemNumber: '65500'
  juniperAlias: g00000-at-1111111-ic001
  name: at-1111111-ic001
  routeTarget: '282'
  state: PROVISIONED

Para adicionar, atualizar ou remover rótulos de redes, emita o comando gcloud bms networks update. Você pode usar as seguintes opções:
- --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = test.
- --remove-labels: Remove rótulos específicos
- --clear-labels: Remove todos os rótulos.
Aqui está um comando de amostra que adiciona os rótulos environment = dev e location = center e remove o rótulo cost-center de um network:
```
gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=downtown --remove-labels=cost-center
```
O comando a seguir remove todos os rótulos de uma rede:
```
gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels
```
Para ver as mudanças nos rótulos de rede, emita o seguinte comando:
```
gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
```
Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms networks list, adicione --filter labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para uma rede rotulada com o par de chave-valor environment = dev.
```
gcloud bms networks list --project=PROJECT_ID --region=REGION --filter labels.environment=dev
```

API

Abra uma janela do terminal do Cloud Shell no Console do Cloud.

Para ver todos os servidores no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e a região no comando curl a seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione a tecla Enter ou Return:

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/networks"

Para ver detalhes de uma única rede, insira o ID do projeto, a região e o nome da rede e emita o seguinte comando:

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/networks/NETWORK_NAME"

Para adicionar rótulos a uma rede, insira a ID do projeto, a região e o nome da rede, em seguida, execute o seguinte comando curl. No par de chave-valor neste exemplo, é atribuído 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/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Para usar um rótulo para filtrar a saída de um comando GET curl de uma rede da Solução Bare Metal, digite o ID e a região do projeto e, em seguida, anexe ?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar redes com o rótulo de par de chave-valor ambiente = teste.
```
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/networks"?filter=labels.environment=test
```

Ver o armazenamento no ambiente da Solução Bare Metal

Prestar atenção aos recursos de armazenamento no ambiente da Solução Bare Metal ajuda a determinar se os servidores têm capacidade de armazenamento suficiente para aplicativos e cargas de trabalho. Para ver o status do armazenamento, escolha uma das seguintes opções:

Console

No Console do Cloud, navegue até Compute Engine > Solução Bare Metal > Volumes.

Veja as informações disponíveis.

Field	Descrição	Exemplo
Status	Indica a disponibilidade de um volume de armazenamento.	Um círculo verde com uma marca de seleção indica que o volume de armazenamento está pronto.
Código	Identificador atribuído ao seu volume de armazenamento. Clique nele para ver informações básicas sobre o volume de armazenamento, incluindo LUNs e snapshots. Compartilhe o ID com o suporte do Google Cloud ao solucionar problemas desse recurso.	Volume de inicialização: `at-1234567-svr001-vol000-b1` Volume do canal de fibra: `at-1111111-vol001` Compartilhamento de NFS: `at-2222222-nfs001-vol000`
Nome	Nome do volume de armazenamento. Clique no nome para ver mais informações sobre o volume de armazenamento, incluindo LUNs e snapshots. Observação: se você não tiver inserido um nome ao provisionar seu volume de armazenamento, o ID será exibido. nesse campo.	Volume de inicialização: `boot-volume-1` Volume do canal de fibra: `fibre-channel-volume-5` Compartilhamento de NFS: `nfs-share-7`
Local	Região em que o volume de armazenamento está localizado	`asia-southeast1`
Tipo	Disco rígido ou disco de estado sólido	`HDD - Hard drive`
Marcadores	Exibe os rótulos adicionados ao recurso de armazenamento. Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.	`environment:test`

gcloud

Para visualizar todos os volumes de armazenamento no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e emita o comando gcloud bms volumes list:

gcloud bms volumes list --project=PROJECT_ID

O exemplo de saída a seguir mostra três volumes de armazenamento: ID do projeto, região, tamanho do volume e tipo de armazenamento.

NAME                         PROJECT              REGION           REQUESTED_SIZE_GIB  STORAGE_TYPE  STATE
at-1234567-svr001-vol000-b1  PROJECT_ID         REGION         200                 SSD           READY
at-1111111-vol001            PROJECT_ID         REGION         1024                SSD           READY
at-2222222-nfs001-vol000     PROJECT_ID         REGION         400                 HDD           READY

Para visualizar um único volume de armazenamento, digite o nome do volume de armazenamento, o ID do projeto e a região e emita o comando gcloud bms volumes describe:

gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION

O exemplo de saída a seguir mostra o tamanho do volume de armazenamento, o nome, a política de exclusão automática de snapshots, o estado e o tipo de armazenamento.

currentSizeGib: '250'
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME
requestedSizeGib: '250'
snapshotAutoDeleteBehavior: OLDEST_FIRST
snapshotReservationDetail:
  reservedSpaceGib: '50'
  reservedSpaceRemainingGib: '50'
state: READY
storageType: SSD

Para adicionar, atualizar ou remover rótulos de volumes de armazenamento, emita o comando gcloud bms volumes update. É possível usar as seguintes opções:
- --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = production.
- --remove-labels: Remove rótulos específicos
- --clear-labels: Remove todos os rótulos.
Veja um exemplo de comando que adiciona os rótulosambiente = produção elocal = q e removerá o rótulo.rack de um volume de armazenamento:
```
gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=production,location=hq --remove-labels=rack
```
O seguinte comando remove todos os rótulos de um volume de armazenamento:
```
gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels
```
Para ver as alterações dos rótulos de volume de armazenamento, execute o seguinte comando:
```
gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
```
Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms volumes list, adicione --filter labels.KEY=VALUE ao final do comando. No exemplo a seguir, limita a saída para um volume de armazenamento rotulado com o par de chave-valor ambiente = produção.
```
gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=production
```
Para visualizar todas as LUNs do volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e emita o comando gcloud bms volumes luns list:
```
gcloud bms volumes luns list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
```
O exemplo de saída a seguir mostra os nomes das LUNs, a região, o nome do volume de armazenamento, o tamanho do volume e o estado.
```
NAME                         REGION           VOLUME       SIZE_GB  STATE
at-11111111-vol001-lun000    REGION        VOLUME_NAME 200      READY
```

Para ver detalhes de uma única LUN, digite o ID do projeto, a região e o nome da LUN e emita o comando gcloud bms volumes luns describe:

gcloud bms volumes luns describe LUN_NAME --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME

O exemplo de saída a seguir mostra o nome LUN e as informações de volume de armazenamento, como tamanho, estado, tipo de armazenamento, nome e ID.

bootLun: true
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME
sizeGb: '200'
state: READY
storageType: SSD
storageVolume: VOLUME_NAME
wwid: 600a09803831434434244f774d616b94

API

Abra uma janela do terminal do Cloud Shell no Console do Cloud.
Para ver todos os servidores no ambiente da Solução Bare Metal e ver o status deles, insira o ID do projeto e a região no comando curl. A seguir, copie o comando, cole-o no prompt do Cloud Shell e pressione a tecla Enter ou Return:
```
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"
```
Observação: quando uma atualização de volume está em andamento, o campo de estado aparece como Criando. Quando a atualização do volume for concluída, o campo de estado aparecerá como Pronto.

Para visualizar um único volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e execute o seguinte comando:

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/VOLUME_NAME"

Para ver todos os números de unidades lógicas (LUNs, na sigla em inglês) do volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e execute o seguinte comando:

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/VOLUME_NAME/luns

Para ver detalhes de uma única LUN, digite o código do seu projeto, a região, o nome do volume de armazenamento e o nome da LUN, além do seguinte comando:

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/VOLUME_NAME/luns/LUN_NAME"

Para adicionar rótulos a um volume de armazenamento, insira o ID do projeto, a região e o nome do volume de armazenamento e, em seguida, emita o comando curl a seguir. O par de chave-valor neste exemplo 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'}
}"

Para usar um rótulo para filtrar a saída de umDOWNLOAD curl comando para um volume de armazenamento da Solução Bare Metal, digite o ID e a região do projeto e anexe?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar volumes de armazenamento com o rótulo do par de chave-valor ambiente = teste.
```
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
```

Ver o armazenamento de arquivos NFS no ambiente da Solução Bare Metal

Depois de solicitar e provisionar o NFS para Solução Bare Metal, você poderá ver o status do armazenamento de arquivos NFS e confirmar se o Google Cloud implementou as configurações definidas como esperado. Para ver o status atual, escolha uma das seguintes opções de comando:

Console

No Console do Cloud, navegue até Compute Engine > Solução Bare Metal > Compartilhamentos de NFS.

Veja as informações disponíveis.

Field	Descrição	Exemplo
Status	Indica a disponibilidade de um volume NFS.	Um círculo verde com uma marca de seleção indica que o volume NFS foi provisionado.
Código	Identificador atribuído ao seu dispositivo de armazenamento NFS que hospeda seu volume. Clique no ID para ver mais informações sobre o volume de armazenamento, incluindo os clientes e as propriedades NFS permitidos. Compartilhe o ID com o suporte do Google Cloud ao solucionar problemas desse recurso.	`at-2222222-nfs001`
Nome	Nome do dispositivo de armazenamento NFS que hospeda seu volume. Clique no nome para ver mais informações sobre o volume de armazenamento, incluindo os clientes e as propriedades NFS permitidos. Observação: se você não tiver inserido um nome ao provisionar o dispositivo de armazenamento NFS, o ID aparecerá neste campo.	`nfs-share-7`
Local	Região do volume de armazenamento NFS	`asia-southeast1`
Volume	Nome do volume de armazenamento NFS. Clique no nome para ver mais informações sobre o volume de armazenamento do NFS, como snapshots.	`at-2222222-nfs001-vol000`
Marcadores	Exibe os rótulos adicionados ao recurso de armazenamento de arquivos NFS Para usar os rótulos e filtrar a saída do console, copie o texto de um rótulo e cole-o no Filtro logo acima do campo Status.	`environment:test`

gcloud

Para ver o status do armazenamento de arquivos NFS no ambiente da Solução Bare Metal, emita o comando gcloud bms nfs-shares list:
```
gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION
```
Outras opções de comando incluem:
- --limit:--limit: limita a saída para mostrar um número específico de dispositivos
- --filter: Limite a saída para mostrar dispositivos com um rótulo específico ou outro parâmetro de filtro.
A saída fornece detalhes sobre o armazenamento de arquivos NFS, incluindo nome, ID, volume e clientes permitidos.
```
NAME: nfs-share-7
ID: at-2222222-nfs001
PROJECT: PROJECT_ID
REGION: REGION
VOLUME_NAME: at-2222222-nfs001-vol000
STATE: PROVISIONED
ALLOWED_CLIENTS: [{"allowedCidr": "192.168.1.1/32", "networkName": "at-1111111-vlan001", "shareIp": "192.168.1.240"}]
```

Para ver o status de um dispositivo de armazenamento de arquivos NFS específico, emita o comando gcloud bms nfs-shares describe. É possível usar o nome ou o ID de compartilhamento do NFS como a variável NFS_SHARE:

gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION

A saída fornece detalhes sobre os clientes permitidos, as configurações de NFS, o servidor NFS e seu estado, além do volume de armazenamento.

allowedClients:
– allowDev: true
  allowedClientsCidr: 192.168.1.1/32
  mountPermissions: READ_WRITE
  network: projects/PROJECT_ID/locations/REGION/networks/at-1111111-vlan001
  noRootSquash: true
  shareIp: 192.168.1.240
name: projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE
nfsShareId: at-2222222-nfs001
state: PROVISIONED
volume: projects/PROJECT_ID/locations/REGION/volumes/at-2222222-nfs001-vol000

Para adicionar, atualizar ou remover rótulos do armazenamento de arquivos NFS, emita o comando gcloud bms nfs-shares update. É possível usar as seguintes opções:
- --update-labels: Adiciona rótulos aos recursos para que você possa filtrar a saída dos comandos de status. É necessário adicionar cada rótulo com um par de chave-valor, como environment = test.
- --remove-labels: Remove rótulos específicos
- --clear-labels: Remove todos os rótulos.
Aqui está um comando de amostra que adiciona os rótulos environment = test e location = centro, além de remover o rótulo cost-center de um Dispositivo de armazenamento de arquivos NFS:
```
gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --update-labels environment=test,location=downtown --remove-labels=cost-center
```
O seguinte comando remove todos os rótulos de um dispositivo de armazenamento de arquivos NFS:
```
gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --clear-labels
```
Para ver as alterações nos rótulos de armazenamento de arquivos NFS, emita o seguinte comando:
```
gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
```
Se quiser usar um rótulo para filtrar a saída de um comando gcloud bms nfs-shares list, adicione --filter labels.KEY=VALUE ao final do comando. No exemplo a seguir, limita a saída para um dispositivo de armazenamento de arquivos NFS rotulado com o par de chave-valor environment = test.
```
gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION --filter labels.environment=test
```

API

Para ver o status do armazenamento de arquivos NFS no ambiente da Solução Bare Metal, incluindo clientes permitidos e propriedades NFS, insira o ID e a região do projeto no seguinte comando curl. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:
```
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/nfsShares"
```

Para ver o status de um dispositivo de armazenamento de arquivos NFS específico, digite o ID do projeto, a região e o nome ou ID do servidor NFS. Em seguida, emita o seguinte comando:

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/nfsShares/NFS_SHARE"

Para adicionar rótulos a um dispositivo de armazenamento de arquivos NFS, insira o ID do projeto, a região e o nome ou ID do servidor NFS no seguinte comando curl. Os pares de chave-valor neste exemplo atribuem três rótulos: user = test, env = staging e purpose = new_hardware_cert. } Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:
```
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/nfsShares/NFS_SHARE?updateMask=labels"
 -d "{
  'labels' : {
     'user': 'test',
     'env': 'staging',
     'purpose': 'new_hardware_cert'
   }
}"
```
- Se você emitir o comando curl sem rótulos ou valores, limpará todos os rótulos.
```
'labels' : {
 }
```
- Se você emitir o comando curl com novos valores para um rótulo, o novo valor substituirá o anterior.
```
'labels' : {
     'user': 'production',
     'env': 'production',
     'purpose': 'shared_data_store'
 }
```
Para usar um rótulo para filtrar a saída de um comando GET curl de um dispositivo de armazenamento de arquivos NFS da Solução Bare Metal, digite o ID e a região do projeto e, em seguida, anexe ?filter=labels.KEY=VALUE ao final do comando. O exemplo a seguir limita a saída para encontrar dispositivos de armazenamento de arquivos NFS com o rótulo do par de chave-valor env = staging.
```
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/nfsShares"?filter=labels.env=staging
```

Ver o status de uma operação de longa duração

Alguns comandos "gcloud" ou chamadas de API, como uma redefinição do servidor, podem levar muito tempo para serem concluídos. Se você quiser verificar o status de uma operação de longa duração, use as seguintes opções de comando:

gcloud

Para visualizar o status de uma operação de longa duração, use o comando gcloud bms operations describe.
```
gcloud bms operations describe --project=PROJECT_ID --region=REGION operations/OPERATION_ID
```

API

Abra uma janela do terminal do Cloud Shell no Console do Cloud.
Para ver o status de uma operação de longa duração no ambiente da Solução Bare Metal, insira o ID do projeto e o ID da operação no seguinte comando curl. Copie e cole o comando no prompt do Cloud Shell e pressione a tecla Enter ou Return:
```
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/v1/operations/OPERATION_ID"
```
Quando a operação for concluída, o campo done será exibido como true na saída.
```
{
  "name": "operations/OPERATION_ID",
  "done": true
}
```