Depois de criar uma instância, o Google Cloud Managed Lustre permite listar, receber, atualizar e excluir instâncias.
Ao atualizar instâncias gerenciadas do Lustre, apenas a descrição e os rótulos podem ser modificados.
Listar instâncias
Para listar todas as instâncias em um projeto:
Console do Google Cloud
Acesse a página Lustre gerenciado no console do Google Cloud .
As instâncias do seu projeto são listadas.
CLI da gcloud
Use o comando gcloud lustre instances list:
gcloud lustre instances list --location=LOCATION
Substitua LOCATION por uma zona específica para listar todas as instâncias nesse local. Para ver projetos em todos os locais, insira - como valor. Exemplo:
gcloud lustre instances list --location=-
REST
Para listar instâncias usando a API REST, envie uma solicitação para o seguinte endpoint:
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Em que os seguintes valores precisam ser especificados:
PROJECT_ID é o ID do projeto Google Cloud .
ZONE é a zona em que todas as instâncias serão listadas. Para listar instâncias de todas as zonas, use
-como o valor.
Consulte a referência da API instances.list para mais detalhes.
Acessar uma instância
Para conferir os detalhes de uma instância:
Console do Google Cloud
Acesse a página Lustre gerenciado no console do Google Cloud .
Clique no nome da instância para ver detalhes sobre uma instância específica.
CLI da gcloud
Use o comando gcloud lustre instances describe:
gcloud lustre instances describe INSTANCE_NAME --location=LOCATION
REST
Para receber detalhes sobre uma instância específica usando a API REST, envie uma solicitação para o seguinte endpoint:
GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Em que os seguintes valores precisam ser especificados:
PROJECT_ID é o ID do projeto Google Cloud .
ZONE precisa ser uma Google Cloud zona válida compatível com o Lustre gerenciado. Consulte Locais disponíveis para conferir uma lista completa.
INSTANCE_NAME é o nome da instância do Lustre gerenciado a ser retornada.
Consulte a referência da API instances.get para mais detalhes.
Atualizar uma instância
É possível atualizar as seguintes propriedades de uma instância:
- descrição
- rótulos
- capacidade de armazenamento
Para saber como aumentar a capacidade de armazenamento de uma instância, consulte Aumentar a capacidade de uma instância.
Para atualizar uma instância:
Console do Google Cloud
Acesse a página Lustre gerenciado no console do Google Cloud .
Clique no Nome da instância da instância que você quer atualizar. A página de visão geral da instância é exibida.
Clique em Editar.
Insira os novos valores.
Clique em Enviar.
CLI do Google Cloud
Use o comando gcloud lustre instances update:
gcloud lustre instances update INSTANCE_NAME \
--location=LOCATION \
--capacity-gib=NEW_CAPACITY \
--description=NEW_DESCRIPTION
Em que:
- INSTANCE_NAME é a instância a ser atualizada.
- LOCATION é a zona em que a instância reside.
- NEW_CAPACITY é a nova capacidade de armazenamento para essa instância em gibibytes (GiB). O valor não pode exceder a capacidade máxima permitida e precisa ser um múltiplo da taxa de incremento. Consulte Aumentar a capacidade de uma instância para mais detalhes.
- NEW_DESCRIPTION é um novo valor para o campo de descrição, que substitui qualquer descrição atual.
Para atualizar rótulos, consulte os comandos disponíveis na documentação de gcloud lustre instances update.
REST
Para atualizar uma instância usando a API REST, envie uma solicitação PATCH ao endpoint específico dela:
PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]
{
"capacityGib": 72000,
"description": "updated description",
"labels": {
"key1": "value1"
}
}
Em que os seguintes valores precisam ser especificados:
- PROJECT_ID é o ID do projeto Google Cloud .
- ZONE é a Google Cloud zona da instância.
- INSTANCE_NAME é o nome da instância gerenciada do Lustre a ser atualizada.
- UPDATE_MASK é uma lista de campos separados por vírgulas que serão atualizados. Um campo só será substituído se estiver na máscara.
O corpo da solicitação precisa conter um ou mais dos seguintes campos:
capacityGiBé a nova capacidade de armazenamento para essa instância em gibibytes (GiB). O valor não pode exceder a capacidade máxima permitida e precisa ser um múltiplo da taxa de incremento. Consulte Aumentar a capacidade de uma instância para mais detalhes.descriptioné a nova descrição da instância.labelsé o novo conjunto de rótulos para esta instância. O valor delabelsé um objeto JSON que contém um ou mais pares chave:valor.
Consulte a referência da API instances.patch para mais detalhes.
Excluir uma instância
Para excluir uma instância:
Console do Google Cloud
Acesse a página Lustre gerenciado no console do Google Cloud .
Selecione o menu de três pontos ao lado da instância que você quer excluir.
Selecione Excluir instância. Confirme a exclusão clicando em Excluir novamente.
CLI da gcloud
Use o comando gcloud lustre instances delete:
gcloud lustre instances delete INSTANCE_NAME --location=LOCATION
Será preciso confirmar a exclusão. Digite Y ou pressione Enter para continuar.
REST
Para excluir uma instância usando a API REST, envie uma solicitação ao seguinte endpoint:
DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]
Em que os seguintes valores precisam ser especificados:
PROJECT_ID é o ID do projeto Google Cloud .
ZONE é a Google Cloud zona em que a instância está localizada.
INSTANCE_NAME é o nome da instância do Lustre gerenciado a ser excluída.
Consulte a referência da API instances.delete para mais detalhes.
As solicitações de exclusão são de longa duração e retornam um ID de operação que pode ser consultado para verificar o status da operação. Consulte a referência operations.get para mais detalhes.