Impedir a exclusão de uma instância

Nesta página, mostramos como evitar a exclusão acidental de instâncias do Filestore.

Visão geral

A proteção contra exclusão de instâncias ajuda a evitar a remoção acidental de instâncias novas e atuais.

É possível definir a opção de proteção contra exclusão ao criar uma instância ou atualizar essa opção em uma instância atual. Em ambos os casos, a exclusão é impedida no nível da instância. Por padrão, a opção de proteção contra exclusão fica desativada.

Planejar a exclusão

Se você planeja excluir uma instância, siga estas etapas:

  • confirme se é seguro excluir a instância
  • confirme que a proteção contra exclusão está desativada. Se necessário, edite a instância para desativar a proteção contra exclusão

Limitações

As seguintes limitações de recurso são aplicáveis:

  • Não é compatível com os seguintes níveis de serviço:

    • HDD básico
    • SSD básico

  • A proteção contra exclusão não impede as seguintes operações:

    • a edição da instância
    • Como excluir um backup
    • Como reverter um snapshot
    • Exclusão de arquivos

Definir a proteção contra exclusão em uma nova instância

Nesta seção, você vai aprender a definir a opção de proteção contra exclusão ao criar uma nova instância. Por padrão, o recurso fica desativado.

Se a proteção contra exclusão estiver ativada, ocorrerá uma falha ao tentar excluir a instância.

Console do Google Cloud

  1. No console do Google Cloud, acesse a página de instâncias do Filestore.

Acessar a página de instâncias do Filestore

  1. Clique em Criar instância.
  2. Siga as instruções em Criar uma instância. Antes de clicar em Criar, adicione as seguintes especificações:
    1. Na seção Criar marcadores, expanda Opções avançadas.
    2. Em Proteção contra exclusão, clique em Ativar proteção contra exclusão. Recomendamos adicionar uma breve descrição do motivo. Essas informações ficam visíveis na página de detalhes da instância.
  3. Clique em Criar.

gcloud

  1. Instale e inicialize a gcloud CLI.

    Se a CLI gcloud já estiver instalada, atualize-a:

    gcloud components update

  2. Execute o comando gcloud filestore instances create para criar uma instância do Filestore. Siga as instruções em Criar uma instância. Antes de pressionar Enter, adicione as seguintes opções:

    --deletion-protection \
--deletion-protection-reason=PROTECTION_REASON

    Em que:

    • --deletion-protection é a flag usada para ativar a proteção contra exclusão ao criar a instância.
    • --deletion-protection-reason é a flag usada para adicionar uma descrição da justificativa da configuração de proteção contra exclusão da instância que você escolheu. PROTECTION_REASON é o texto da descrição que você quer usar. Por exemplo, "Todos os dados de genômica precisam obedecer às políticas atuais da organização". Para mais informações, consulte Proteção contra exclusão.

API REST

  1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

  2. Use cURL para chamar a API Filestore. Siga as instruções em Criar uma instância, adicionando as seguintes opções antes de executar o comando:

        "deletionProtectionEnabled",
    "deletionProtectionReason":"PROTECTION_REASON"

    Em que:

    • deletionProtectionEnabled é a flag usada para ativar a proteção contra exclusão ao criar a instância.
    • deletionProtectionReason é a flag usada para adicionar uma descrição da justificativa da configuração de proteção contra exclusão da instância que você escolheu. PROTECTION_REASON é o texto da descrição que você quer usar. Por exemplo, "Todos os dados de genômica precisam obedecer às políticas atuais da organização". Para mais informações, consulte Proteção contra exclusão.

Definir ou remover a proteção contra exclusão em uma instância

Nesta seção, você vai aprender a editar a opção de proteção contra exclusão em uma instância. Por padrão, o recurso fica desativado.

Se você ativar a opção, uma tentativa subsequente de excluir a instância vai falhar.

Console do Google Cloud

Para editar instâncias do Filestore usando o console do Google Cloud, acesse a página Editar instância, em que é possível editar a descrição da instância, gerenciar regras de controle de acesso baseadas em IP e escalonar o desempenho do compartilhamento de arquivos:

  1. No console do Google Cloud, acesse a página "Instâncias do Filestore".

    Acessar a página de instâncias do Filestore

  2. Clique no código da instância que você quer editar.

  3. Na página Detalhes da instância, clique em Editar para acessar a página Editar instância.

  4. Na seção Criar marcadores, expanda Opções avançadas.

  5. Em Proteção contra exclusão, clique em Ativar proteção contra exclusão. Recomendamos adicionar uma breve descrição do motivo. Essas informações ficam visíveis na página de detalhes da instância. Para mais detalhes, consulte Como criar instâncias.

  6. Clique em Salvar.

gcloud

Para ativar a proteção contra exclusão ao atualizar uma instância, use o comando gcloud filestore instances update semelhante ao seguinte:

  gcloud filestore instances update INSTANCE_NAME \
      --deletion-protection \
      --deletion-protection-reason=PROTECTION_REASON

Em que:

  • INSTANCE_NAME é o nome da instância que você quer editar. Por exemplo, my-genomics-instance.
  • PROTECTION_REASON é o texto da descrição que você quer usar. Por exemplo, "Todos os dados de genômica precisam obedecer às políticas atual da organização". Para mais informações, consulte Proteção contra exclusão.

Para desativar a proteção contra exclusão ao atualizar uma instância, use um comando semelhante ao seguinte:

  gcloud filestore instances update INSTANCE_NAME \
      --no-deletion-protection

Em que:

  • INSTANCE_NAME é o nome da instância que você quer editar. Por exemplo, my-genomics-instance.

Quando desativado, o campo deletion-protection-reason é limpo.

API REST

  1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

  2. Use cURL para chamar a API Filestore.

    Para definir a proteção contra exclusão em uma instância, especifique true no campo deletionProtectionEnabled. Para remover, especifique false no campo. Use uma chamada de operação semelhante a esta:

    curl --request PATCH \
    'https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances?instanceId=NAME?updateMask=deletionProtectionEnabled,deletionProtectionReason' \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{"tier":"TIER","networks":[{"network":"NETWORK"}],"fileShares":[{"capacityGb":CAPACITY,"name":"SHARE_NAME"}], "deletionProtectionEnabled": true, "deletionProtectionReason": "PROTECTION_REASON"}' \
    --compressed

    Em que:

    • deletionProtectionEnabled é a flag usada para ativar a proteção contra exclusão. Por exemplo, true ou false.
    • deletionProtectionReason é a flag usada para adicionar uma descrição da justificativa da configuração de proteção contra exclusão da instância que você escolheu. Presente apenas quando o recurso está ativado. PROTECTION_REASON é o texto da descrição que você quer usar. Por exemplo, "Todos os dados genômicos precisam obedecer às políticas atuais da organização". Para mais informações, consulte Proteção contra exclusão.

A seguir