Sostituisci tutte le variabili d'ambiente

PUT

apps

{app_id}

envs

Sostituisci tutte le variabili d'ambiente

curl --request PUT \
  --url https://api.squarecloud.app/v2/apps/{app_id}/envs \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "envs": {}
}'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/envs"

payload = { "envs": {} }
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({envs: {}})
};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/envs', 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.squarecloud.app/v2/apps/{app_id}/envs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'envs' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/envs"

	payload := strings.NewReader("{\n  \"envs\": {}\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.squarecloud.app/v2/apps/{app_id}/envs")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"envs\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/envs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"envs\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "TEST": "overwriteTest"
  }
}

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope envs:write. Sovrascrivi sostituisce l’intero ambiente dell’applicazione esattamente con le variabili che invii: qualsiasi cosa già impostata che non sia inclusa nel corpo della richiesta viene eliminata. Inviare un oggetto envs vuoto cancella ogni variabile, il che rende questo l’endpoint da usare per un reset completo invece che per una modifica incrementale. Si applicano gli stessi limiti degli altri endpoint per le variabili d’ambiente: fino a 256 variabili per applicazione, 1024 caratteri per chiave, 4096 per valore. Le applicazioni statiche non sono supportate e restituiscono un errore, e sulle applicazioni condivise in un workspace chi effettua la richiesta deve avere il ruolo admin o essere il proprietario. La tua applicazione carica le variabili con una shell, quindi un valore con spazi o caratteri della shell (come & o ;) viene salvato tra virgolette singole, come fa la dashboard, e restituito così; un valore che hai già messo tra virgolette viene mantenuto come inviato. Un riferimento a un’altra variabile ($HOST, ${HOST}, da solo o tra virgolette doppie) continua a funzionare, mentre la sostituzione di comando ($(...) o backtick) viene sempre salvata come testo semplice. I nomi sono composti da lettere, cifre, underscore, punti e trattini, e non iniziano con una cifra. Poiché viene inviato l’intero insieme, una variabile già salvata con un nome non valido (con uno spazio, o che inizia con una cifra) fa rispondere alla richiesta INVALID_ENV_CONTENT: rinominala nella richiesta. Se devi modificare solo alcune variabili senza toccare le altre, usa invece Aggiungi/Modifica Variabili, oppure Rimuovere Variabili per eliminare chiavi specifiche.

Parametri

string

obbligatorio

L’ID dell’applicazione.

object

La chiave e il valore delle variabili che vuoi impostare nell’ambiente.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

object

La chiave e il valore di tutte le variabili d’ambiente che hai definito.

{
  "status": "success",
  "response": {
    "TEST": "overwriteTest"
  }
}

Errori comuni

Codice	HTTP	Significato
`STATIC_APP_ENV_NOT_SUPPORTED`	400	L’applicazione è statica; le applicazioni statiche non supportano le variabili d’ambiente.
`INVALID_ENV_CONTENT`	400	`envs` è mancante, non è un oggetto, o è un array, oppure un nome di variabile non è valido.
`TOO_MANY_ENV_VARS`	400	Il nuovo insieme supererebbe le 256 variabili d’ambiente.
`ENV_NAME_TOO_LONG`	400	Una chiave di variabile supera i 1024 caratteri.
`ENV_CONTENT_TOO_LONG`	400	Un valore di variabile supera i 4096 caratteri.

Vedi anche

CLI: squarecloud app env replace
SDK: api.apps.envs.replace() (JavaScript), client.apps.envs.replace() (Python), c.Apps.Envs.Replace() (Go)

Sostituisci tutte le variabili d'ambiente

curl --request PUT \
  --url https://api.squarecloud.app/v2/apps/{app_id}/envs \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "envs": {}
}'

import requests

url = "https://api.squarecloud.app/v2/apps/{app_id}/envs"

payload = { "envs": {} }
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({envs: {}})
};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/envs', 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.squarecloud.app/v2/apps/{app_id}/envs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'envs' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/envs"

	payload := strings.NewReader("{\n  \"envs\": {}\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.squarecloud.app/v2/apps/{app_id}/envs")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"envs\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/envs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"envs\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": {
    "TEST": "overwriteTest"
  }
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Sostituisci tutte le variabili d'ambiente

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche