REST Resource: projects.configs.variables

Risorsa: variabile

Descrive una singola variabile all'interno di una risorsa RuntimeConfig. Il nome indica il nome della variabile gerarchica. Ad esempio, ports/serving_port è un nome di variabile valido. Il valore della variabile è una stringa opaca e solo le variabili foglia possono avere valori (ovvero variabili che non hanno variabili secondarie).

Rappresentazione JSON 
{
  "name": string,
  "updateTime": string,
  "state": enum(VariableState),

  // Union field contents can be only one of the following:
  "value": string,
  "text": string
  // End of list of possible types for union field contents.
}
Campi
name

string

Il nome della risorsa variabile, nel formato:

projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]

[PROJECT_ID] deve essere un ID progetto valido, [CONFIG_NAME] deve essere una risorsa RuntimeConfig valida e [VARIABLE_NAME] deve seguire la convenzione di denominazione dei percorsi dei file del file system Unix.

[VARIABLE_NAME] può contenere lettere, numeri, barre e trattini ASCII. Le barre vengono utilizzate come separatori degli elementi del percorso e non fanno parte di [VARIABLE_NAME] stesso, pertanto [VARIABLE_NAME] deve contenere almeno un carattere diverso dalla barra. Più barre vengono unite in un unico carattere barra. Ogni segmento del percorso deve corrispondere all'espressione regolare 0-9A-Za-z?. La lunghezza di un [VARIABLE_NAME] deve essere inferiore a 256 caratteri.

Una volta creata una variabile, non puoi modificarne il nome.
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento della variabile. Il timestamp sarà in formato UTC.

Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".
state

enum(VariableState)

Solo output. Lo stato attuale della variabile. Lo stato della variabile indica l'esito della chiamata variables().watch ed è visibile tramite le chiamate get e list.

Campo unione contents. Il valore della variabile. Può essere un valore binario o una stringa. Devi specificare uno tra value o text. Se ne specifichi entrambi, il server restituirà un errore. contents può essere solo uno dei seguenti:
value

string (bytes format)

Il valore binario della variabile. La lunghezza del valore deve essere inferiore a 4096 byte. Sono accettati anche valori vuoti. Il valore deve essere codificato in base64 e deve essere conforme allo standard IETF RFC4648 (https://www.ietf.org/rfc/rfc4648.txt). È possibile impostare un solo elemento (value o text).

Una stringa con codifica Base64.
text

string

Il valore stringa della variabile. La lunghezza del valore deve essere inferiore a 4096 byte. Sono accettati anche valori vuoti. Ad esempio, text: "my text value". La stringa deve essere UTF-8 valida.

VariableState

VariableState descrive l'ultimo stato noto della variabile e viene utilizzato durante una chiamata a variables().watch per distinguere lo stato della variabile.

Enum
VARIABLE_STATE_UNSPECIFIED Stato predefinito della variabile.
UPDATED La variabile è stata aggiornata durante l'esecuzione di variables().watch.
DELETED La variabile è stata eliminata durante l'esecuzione di variables().watch.

Metodi

create

 Crea una variabile all'interno della configurazione specificata.

delete

 Consente di eliminare una o più variabili.

get

 Recupera le informazioni su una singola variabile.

list

 Elenca le variabili all'interno di una determinata configurazione, corrispondenti a eventuali filtri forniti.

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante sulla risorsa specificata.

update

 Aggiorna una variabile esistente con un nuovo valore.

watch

 Monitora una variabile specifica e attende una variazione del relativo valore.