Preview template upgrade
curl --request GET \
--url https://api.instacloud.com/template-deployments/{deploymentId}/upgrade \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instacloud.com/template-deployments/{deploymentId}/upgrade"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.instacloud.com/template-deployments/{deploymentId}/upgrade', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instacloud.com/template-deployments/{deploymentId}/upgrade",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.instacloud.com/template-deployments/{deploymentId}/upgrade"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.instacloud.com/template-deployments/{deploymentId}/upgrade")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instacloud.com/template-deployments/{deploymentId}/upgrade")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"plan": {
"from_version": "<string>",
"to_version": "<string>",
"to_digest": "<string>",
"services": [
{
"key": "<string>",
"gone": true,
"added": true,
"fields": [
{
"field": "<string>",
"label": "<string>",
"drifted": true,
"verdict": "applied",
"deployed": "<string>",
"live": "<string>",
"next": "<string>"
}
],
"missing_variables": [
"<string>"
],
"service_id": "<string>",
"service_name": "<string>"
}
],
"removed": [
"<string>"
],
"refusals": [
"<string>"
]
}
}{
"error": "<string>"
}{
"error": "<string>",
"code": "<string>"
}Templates
Preview template upgrade
Token scope: account · org · project — read-only tokens allowed.
What upgrading this deployment to the version the registry serves now would do: per-service field changes, which of them the upgrade writes and which it only reports, required variables with no value yet, and anything that makes the upgrade impossible. Each field row carries the label to show for it — render that label as given, because it is where a change states how far it reaches (public access on a storage service applies to that bucket on every branch). Reads only.
GET
/
template-deployments
/
{deploymentId}
/
upgrade
Preview template upgrade
curl --request GET \
--url https://api.instacloud.com/template-deployments/{deploymentId}/upgrade \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instacloud.com/template-deployments/{deploymentId}/upgrade"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.instacloud.com/template-deployments/{deploymentId}/upgrade', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instacloud.com/template-deployments/{deploymentId}/upgrade",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.instacloud.com/template-deployments/{deploymentId}/upgrade"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.instacloud.com/template-deployments/{deploymentId}/upgrade")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instacloud.com/template-deployments/{deploymentId}/upgrade")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"plan": {
"from_version": "<string>",
"to_version": "<string>",
"to_digest": "<string>",
"services": [
{
"key": "<string>",
"gone": true,
"added": true,
"fields": [
{
"field": "<string>",
"label": "<string>",
"drifted": true,
"verdict": "applied",
"deployed": "<string>",
"live": "<string>",
"next": "<string>"
}
],
"missing_variables": [
"<string>"
],
"service_id": "<string>",
"service_name": "<string>"
}
],
"removed": [
"<string>"
],
"refusals": [
"<string>"
]
}
}{
"error": "<string>"
}{
"error": "<string>",
"code": "<string>"
}