Prevent deletion of an instance

Google Cloud console

1. In the Google Cloud console, go to the Filestore Instances page.

Go to the Filestore Instances page

1. Click Create Instance.
2. Follow the instructions noted in Create an instance. Before clicking Create, add the following specifications:
   1. In the Tags section, expand the Advanced options section.
   2. In the Deletion protection section, select the Enable deletion protection checkbox. We recommend stating the reason for enabling deletion protection to provide more context.
3. Click Create.

gcloud

1. Install and initialize the gcloud CLI.

   If you already have the gcloud CLI installed, update it:

   gcloud components update
   

2. Run the gcloud filestore instances create command to create a Filestore instance. Follow the instructions noted in Create an instance. Before you press Enter, add the following options:

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

   Where:

   • --deletion-protection is the flag used to enable deletion protection when creating the instance.
   • --deletion-protection-reason is the flag used to add a description of the justification for the instance's deletion protection setting you chose. PROTECTION_REASON is the description text you want to use. For example, "All genomics data must adhere to current organization policies." For more information, see Deletion protection.

REST API

1. Have gcloud CLI installed and initialized, which lets you generate an access token for the Authorization header.

2. Use cURL to call the Filestore API. Follow the instructions noted in Create an instance, adding the following options before running the command:

       "deletionProtectionEnabled",
       "deletionProtectionReason":"PROTECTION_REASON"
   

   Where:

   • deletionProtectionEnabled is the flag used to enable deletion protection when creating the instance.
   • deletionProtectionReason is the flag used to add a description of the justification for the instance's deletion protection setting you chose. PROTECTION_REASON is the description text you want to use. For example, "All genomics data must adhere to current organization policies." For more information, see Deletion protection.

Google Cloud console

To edit Filestore instances using the Google Cloud console, navigate to the Edit instance page, where you can edit the instance description, manage IP-based access control rules, and scale the file share performance:

1. In the Google Cloud console, go to the Filestore Instances page.

   Go to the Filestore Instances page

2. Click the instance ID of the instance you want to edit.

3. On the Instance details page, click Edit to go to the Edit instance page.

4. In the Deletion protection section, select the Enable deletion protection checkbox. We recommend stating the reason for enabling deletion protection to provide more context.

5. Click Save.

gcloud

To enable deletion protection when you update an instance, use the gcloud filestore instances update command similar to the following:

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

Where:

• INSTANCE_NAME is the name of the instance you want to edit. For example, my-genomics-instance.
• PROTECTION_REASON is the description text you want to use. For example, "All genomics data must adhere to current organization policies." For more information, see Deletion protection.

To deactivate deletion protection when you update an instance, use a command similar to the following:

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

Where:

• INSTANCE_NAME is the name of the instance you want to edit. For example, my-genomics-instance.

Once deactivated, the deletion-protection-reason field is cleared.

REST API

1. Have gcloud CLI installed and initialized, which lets you generate an access token for the Authorization header.

2. Use cURL to call the Filestore API.

   To set deletion protection on an instance, specify true in the deletionProtectionEnabled field. To remove it, specify false in the field. Use an operation call similar to the following:

   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
   

   Where:

   • deletionProtectionEnabled is the flag used to enable deletion protection. For example, true or false.
   • deletionProtectionReason is the flag used to add a description of the justification for the instance's deletion protection setting you chose. Only present when the feature is enabled. PROTECTION_REASON is the description text you want to use. For example, "All genomics data must adhere to current organization policies." For more information, see Deletion protection.