Destroying workspace resources

Remove the IBM Cloud® resources that you provisioned with your Schematics workspace, even if these resources are active.

IBM Cloud Schematics is deprecating older versions of Terraform and introducing support for newer Terraform version. For more information, see the Schematics Terraform deprecation lifecycle and the Deprecation Schedule.

Before you begin

Create a Terraform configuration, and store the configuration in a GitHub, GitLab, or Bitbucket repository. You can also upload a tape archive file (.tar) from your local workstation to provide your template to IBM Cloud Schematics. For more information, see the ibmcloud schematics workspace upload command and see the upload a tar file to your workspace API.
Make sure that you have the permissions to create a workspace.

Ensure the location and the url endpoint are pointing to the same region when you create or update the Schematics workspace or action. For more information about location and endpoint, see Where is your information stored?

Destroying workspace resources using the UI

Log in to IBM Cloud console.
Click the Menu icon > Platform Automation > Schematics > Terraform.
- In workspace List section:
  - Click required Workspace to destroy a required workspace. If you do not see the required workspace in the list, check your navigation page.
  - Click Next.
- In Workspace list section. Click workspace name and click Actions dropdown. Click Destroy resources and enter workspace name for confirmation before delete. Enter the name while creation and click destroy.
- Click Destroy. Your resource of workspace are destroyed.

Verifying a workspace destroy operation

Click your workspace that is listed in the IBM Cloud console to view the results of the destroy operation.
Click Jobs tab to see the workspace logs.
Click Jobs history tab view the result of the destroy job and operations that were run by the automation modules.

Destroying workspace resources using the CLI

Destroy workspace configuration. For more information about destroy the resource in workspace, see the ibmcloud schematics destroy workspace command.

ibmcloud schematics destroy workspace --id <WORKSPACE_ID>

ibmcloud schematics destroy --id WORKSPACE_ID [--target RESOURCE1] [--target RESOURCE2] [--force] [--output OUTPUT]

{ pre}

Verify that your source created through workspace is destroyed.
```
ibmcloud schematics workspace list
```
Refer to, Managing Cloud resources with Schematics to start Deleting, updating, or deleting Cloud resources with Terraform.

Verifying a workspace destroy operation

Verify that the workspace was created successfully. When you destroy the resource by using the CLI, the command removes the resources of the workspace.

   ibmcloud schematics destroy --id us-east.workspace.testwspace03jan.811182d2 --target vpc_name --target vpc_tags
   Do you really want to perform this action? [y/N]> y

   Activity ID   c10fc92ddfd2d9ec645fc5dbece5e341

   OK

On successful destroying, it returns the unique Activity ID of the workspace.

For more information, see workspace FAQs.

Destroying workspace resources using the API

Follow the steps to retrieve your IAM access token and authenticate with IBM Cloud Schematics by using the API.

Destroy the workspace.

Example:

   PUT /v1/workspaces/{w_id}/destroy HTTP/1.1
   Host: schematics.cloud.ibm.com
   Content-Type: application/json
   Authorization: <auth_token>

   {
      "name":"testwspace03jan",
      "type":[
         "terraform_v1.4"
      ],
      "description":"terraform workspace",
      "location":"us-east",
      "tags":[
         "department:HR",
         "application:compensation",
         "environment:production"
      ],
      "template_repo":{
         "url":"https://github.com/Anil-CM/newrepo"
      },
      "workspace_status":{
         "frozen":true
      },
      "template_data":[
         {
            "folder":".",
            "type":"terraform_v1.4",
         "variablestore":[
            {
               "name":"sample_var",
               "secure":true,
               "value":"THIS IS IBM CLOUD TERRAFORM CLI DEMO",
               "description":"Description of sample_var"
            },
            {
               "name":"sleepy_time",
               "value":"15"
               }
            ]
         }
      ]
   }

See Managing Cloud resources with Schematics to start Deleting, updating, or deleting Cloud resources with Terraform.

Verifying a workspace destroy operation

Verify that the resource is destroyed successfully.

Verify that the workspace resource is destroyed successfully as shown in the output.

Output

{
    "activityid": "6e5c84b58100472395b53a056cc27edc"
}

On successful, destroy the unique activity ID of the workspace is returned.

For more information, see workspace FAQs.

destroying workspace resources with Terraform

Follow the steps in Deleting Schematics data to destroy your workspace with Terraform.
See Managing Cloud resources with Schematics to create, update, or delete the Cloud resources.

Next steps

Looking for additional workspace samples to work with? Check out the sample workspaces. Check the Readme files of the examples for further customization and usage.