Beschreibt eine einzelne Variable innerhalb einer RuntimeConfig-Ressource. Der Name bezeichnet den hierarchischen Namen einer Variable. ports/serving_port ist beispielsweise ein gültiger Variablenname. Die Variable ist ein opaker String und nur Blatt-Variablen können Werte haben (also Variablen, die keine untergeordneten Variablen haben).
JSON-Darstellung
{"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.}
[PROJECT_ID] muss eine gültige Projekt-ID sein, [CONFIG_NAME] muss eine gültige RuntimeConfig-Ressource sein und [VARIABLE_NAME] muss der Benennung von Dateipfaden im Unix-Dateisystem entsprechen.
Der [VARIABLE_NAME] kann ASCII-Buchstaben, Ziffern, Schrägstriche und Bindestriche enthalten. Schrägstriche werden als Trennzeichen für Pfadelemente verwendet und sind nicht Teil von [VARIABLE_NAME] selbst. [VARIABLE_NAME] muss daher mindestens ein Zeichen enthalten, das kein Schrägstrich ist. Mehrere Schrägstriche werden zu einem Schrägstrichzeichen verbunden. Jedes Pfadsegment muss dem regulären Ausdruck 0-9A-Za-z? entsprechen. Die Länge einer [VARIABLE_NAME] darf maximal 256 Zeichen betragen.
Sobald Sie die Variable erstellt haben, können sie den Namen der Variable nicht mehr ändern.
Nur Ausgabe. Der aktuelle Status der Variablen. Der Variablenstatus gibt das Ergebnis des variables().watch-Aufrufs an und ist über die Aufrufe get und list sichtbar.
Union-Feld contents. Der Wert der Variablen. Es kann sich entweder um einen binären Wert oder einen String-Wert handeln. Sie müssen entweder value oder text angeben. Wenn Sie beide angeben, gibt der Server einen Fehler zurück. Für contents ist nur einer der folgenden Werte zulässig:
Der binäre Wert der Variable. Die Länge des Werts muss kleiner als 4096 Byte sein. Leere Werte werden auch akzeptiert. Der Wert muss base64-codiert sein und IETF RFC4648 (https://www.ietf.org/rfc/rfc4648.txt) entsprechen. Es kann nur value oder text festgelegt werden.
Ein base64-codierter String.
text
string
Der String-Wert der Variable. Die Länge des Werts muss kleiner als 4096 Byte sein. Leere Werte werden auch akzeptiert. Beispiel: text: "my text value". Der String muss UTF-8-gültig sein.
VariableState
Die VariableState beschreibt den letzten bekannten Status der Variablen und wird bei einem variables().watch-Aufruf verwendet, um den Status der Variablen zu unterscheiden.
Enums
VARIABLE_STATE_UNSPECIFIED
Standardstatus der Variable.
UPDATED
Die Variable wurde aktualisiert, während variables().watch ausgeführt wurde.
DELETED
Die Variable wurde gelöscht, während variables().watch ausgeführt wurde.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-03-04 (UTC)."],[[["\u003cp\u003eA Variable describes a single variable within a RuntimeConfig resource, with a hierarchical name (e.g., \u003ccode\u003eports/serving_port\u003c/code\u003e), and only leaf variables can have values.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a Variable includes its name, update time, state, and either a \u003ccode\u003evalue\u003c/code\u003e (binary) or \u003ccode\u003etext\u003c/code\u003e (string) content, but not both.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eVariableState\u003c/code\u003e indicates the last known state of the variable, and the \u003ccode\u003evariables().watch\u003c/code\u003e call will update its status to either \u003ccode\u003eUPDATED\u003c/code\u003e or \u003ccode\u003eDELETED\u003c/code\u003e, it also has an \u003ccode\u003eVARIABLE_STATE_UNSPECIFIED\u003c/code\u003e state.\u003c/p\u003e\n"],["\u003cp\u003eKey fields for a Variable include \u003ccode\u003ename\u003c/code\u003e (the resource name with project, config, and variable identifiers), \u003ccode\u003eupdateTime\u003c/code\u003e (last update timestamp), and \u003ccode\u003estate\u003c/code\u003e (current state), along with either a binary \u003ccode\u003evalue\u003c/code\u003e or string \u003ccode\u003etext\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSeveral methods can be performed on variables, including create, delete, get, list, testIamPermissions, update, and watch, allowing for managing and monitoring variable changes.\u003c/p\u003e\n"]]],[],null,["# REST Resource: projects.configs.variables\n\n- [Resource: Variable](#Variable)\n - [JSON representation](#Variable.SCHEMA_REPRESENTATION)\n- [VariableState](#VariableState)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Variable\n------------------\n\nDescribes a single variable within a RuntimeConfig resource. The name denotes the hierarchical variable name. For example, `ports/serving_port` is a valid variable name. The variable value is an opaque string and only leaf variables can have values (that is, variables that do not have any child variables).\n\nVariableState\n-------------\n\nThe `VariableState` describes the last known state of the variable and is used during a `variables().watch` call to distinguish the state of the variable."]]
