Prevent deletion of an instance

Google Cloud console

1. In the Google Cloud console, go to the Filestore Instancespage.

Go to the Filestore Instancespage

1. Click Create Instance.
2. Follow the instructions noted in Create an instance . Before clicking Create, add the following specifications:
   1. In the Tagssection, expand the Advanced optionssection.
   2. In the Deletion protectionsection, select the Enable deletion protectioncheckbox. 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 instancepage, 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 Instancespage.

   Go to the Filestore Instances page

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

3. On the Instance detailspage, click Editto go to the Edit instancepage.

4. In the Deletion protectionsection, select the Enable deletion protectioncheckbox. 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 .