Updating workspaces

• For GitHub, GitLab, or Bitbucket repository URL <provide your Terraform template Git repository URL.

• For Personal access token <leave it blank>. To securely validate and clone the template, you can click the Open reference picker to select your Secrets Manager key reference. For more information, see creating a Secrets Manager instance.

• For Terraform Version terraform_v1.6. You need to select Terraform version 1.6 or greater version. For example, if your Terraform templates are created by using Terraform v1.6, select the Terraform version parameter as terraform_v1.6. You can select Terraform_v1.4 to use Terraform version 1.4, terraform_v1.6 to use Terraform version 1.6. When you specify terraform_v1.5 means that users can have template that is of Terraform v1.5.0, v1.5.1, or v1.5.7, so on. Schematics supports Terraform_v1.x and also plans to make releases available after 30 to 45 days of HashiCorp Configuration Language (HCL) release.

  Schematics supports the current release of Terraform v1.4, through terraform_v1.6. The Terraform template must use the version constraint, such as > or >= or ~> for the required_version of Terraform, to automatically pick the current version.

  terraform {
  required_version = "~> 1.5"
  }
  

• Click Save.

• In Variables section. Click the Edit from the overflow menu to edit the variables. Enter a name for your workspace name. The name can be up to 128 characters long and can include alphanumeric characters, spaces, dashes, and underscores.

• Click Save.

Update a JSON file on your local workstation and add your workspace configuration. For more configuration options when updating the workspace, see the ibmcloud schematics workspace update command.

 ```json {: codeblock}
 {
     "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"
             }
         ]
         }
     ]
 }
 ```

Syntax

 ```sh {: pre}
 ibmcloud schematics workspace update --id WORKSPACE_ID [--file FILE_NAME] [--github-token GITHUB_TOKEN] [--pull-latest]  [--output OUTPUT]
 ```

Update the workspace details for an existing workspace, such as the workspace name, variables, or source control URL.

 ```sh {: pre}
 ibmcloud schematics workspace update --id <WORKSPACE_ID>
 ```

Verify that your workspace is updated. Make sure that your workspace is in an Inactive state.

 ```sh {: pre}
 ibmcloud schematics workspace list
 ```

Refer to, Managing Cloud resources with Schematics to start creating, updating, or deleting Cloud resources with Terraform.

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

Updating the details for an existing workspace, such as the workspace name, variables, or source control URL.

Example

 ```json {: codeblock}
 PUT /v1/workspaces/{w_id} HTTP/1.1
 Host: schematics.cloud.ibm.com
 Content-Type: application/json
 Authorization: <auth_token>
 {
 "name":"testwspace03jan",
 "type":[
     "terraform_v1.4"
 ],
 "description":"terraform workspace updated",
 "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"
             }
         ]
     }
 ]
 }
 ```

Verify that the workspace is successfully updated.

 ```sh {: pre}
 curl -X GET https://schematics.cloud.ibm.com/v1/workspaces -H "Authorization: <iam_access_token>"
 ```

see Managing Cloud resources with Schematics to start creating, updating, or deleting Cloud resources with Terraform.

Follow the steps in Setting up Terraform for Schematics to create your workspace with Terraform.

See Managing Cloud resources with Schematics to create, update, or delete Cloud resources with Terraform.