Merge remote-tracking branch 'origin/cloud-2.0' into DOC-10386

cockroachdb · Sep 23, 2024 · 3b89e6b · 3b89e6b
2 parents 6255ef6 + bfd4d63
commit 3b89e6b
Show file tree

Hide file tree

Showing 3 changed files with 103 additions and 518 deletions.
diff --git a/src/current/_includes/v24.2/sidebar-data/cloud-deployments.json b/src/current/_includes/v24.2/sidebar-data/cloud-deployments.json
@@ -48,7 +48,7 @@
                     ]
             },
             {
-                "title": "Provision a Serverless Cluster with Terraform",
+                "title": "Use the Terraform provider",
                 "urls": [
                     "/cockroachcloud/provision-a-cluster-with-terraform.html"
                 ]

diff --git a/src/current/cockroachcloud/cloud-api.md b/src/current/cockroachcloud/cloud-api.md
@@ -47,7 +47,7 @@ Where `{secret_key}` is the [secret key string you stored when you created the A
 
 ## Set the API version
 
-The `Cc-Version` HTTP header specifies the version of the Cloud API to use. If you omit the `Cc-Version` header, the Cloud API will default to version `2022-03-31` (the initial release of the Cloud API). The Cloud API uses date-based versions of the form `YYYY-MM-DD`, in [ISO 8601 format](https://www.w3.org/TR/NOTE-datetime).
+The Cloud API uses date-based versions of the form `YYYY-MM-DD`, in [ISO 8601 format](https://www.w3.org/TR/NOTE-datetime). It is strongly recommended that you use the `Cc-Version` HTTP header to specify the version of the Cloud API to use. If you omit the `Cc-Version` header, the Cloud API will default to the latest version. If you don’t specify the version your application expects, breakage may occur. While we try to minimize the risk of breaking API changes, passing the version explicitly helps to mitigate against this risk and is strongly recommended.
 
 If you set an invalid version, you will get an HTTP 400 response with the message "invalid Cc-Version."