Delete realms and attachments

This document explains how to delete realms and attachments. After you create a realm, you can't edit it. If you want to make changes to the realm, you must delete it and create a new realm.

Required roles

Delete attachments

To delete attachments, do the following.

gcloud

Run the gcloud beta network-security secure-access-connect attachments delete command:

gcloud beta network-security secure-access-connect attachments delete ATTACHMENT_ID \
    --project=PROJECT_ID \
    --location=REGION

Replace the following:

  • ATTACHMENT_ID: the attachment ID
  • PROJECT_ID: the project that contains the attachment
  • REGION: the region where the attachment is located

API

Use the projects.locations.sacAttachments.delete method

DELETE https://networksecurity.googleapis.com/v1beta1/{name=project/PROJECT_ID/locations/REGION}/sacAttachments/ATTACHMENT_ID

Replace the following:

  • PROJECT_ID: the project that contains the attachment
  • REGION: the region where the attachment is located
  • ATTACHMENT_ID: the attachment ID

Delete realms

You must delete all attachments before you can delete a realm. To delete a realm, do the following.

gcloud

Run the gcloud beta network-security secure-access-connect realms delete command:

gcloud beta network-security secure-access-connect realms delete REALM_ID \
    --project=PROJECT_ID

Replace the following:

  • REALM_ID: the realm ID
  • PROJECT_ID: the project that contains the realm

API

Use the projects.locations.sacRealms.delete method

DELETE https://networksecurity.googleapis.com/v1beta1/project/PROJECT_ID/locations/global/sacRealms/REALM_ID

Replace the following:

  • PROJECT_ID: the project that contains the realm
  • REALM_ID: the realm ID