Ausdrücke in Cloud Provisioning and Governance verwenden

Ausdrücke verwenden

Ausdrücke können die Werte für Informationen enthalten, die dynamisch im System generiert werden, z. B. die Werte für die Auswahlen, die Benutzer im Cloudbenutzerportal treffen. Ausdrücke sind in Ressourcenblöcken, Blaupausen, Richtlinien und überall sonst verfügbar, wo Cloud Provisioning and Governance Skripts zulässt.

Ausdrücke in Ressourcenblöcken verwenden

Jeder Ressourcenblockvorgang verwendet einen Ausdruck, der einen Wert für jeden Parameter enthält. Der Ausdruck kann hartcodierte Werte, Daten aus dem Stapel, den der Benutzer im Cloudbenutzerportal bereitstellt, Daten in der CMDB und Daten, die aus Skripts abgeleitet sind, verwenden. Standardmäßig generiert Cloud Provisioning and Governance eine Reihe von Parametern und ihren Ausdrücken für jeden Ressourcenblockvorgang.

Beispiel: Der Parameter Location, der das Rechenzentrum enthält, zu dem eine Ressource gehört, verwendet den Ausdruck ${parameter.Location}.

Standortparameter für einen Ressourcenblock — Abbildung : 1. Ausdrücke in einem Ressourcenblock

Ausdrücke in Blaupausen verwenden

Blaupausen können Ausdrücke verwenden, um Eingabeparameter für jeden Vorgang in einem Ressourcenblock zuzuordnen. Standardmäßig zeigt die Blaupause die gleichen Parameter und Werte an, die im Ressourcenblock angegeben sind.

Sie können auf Blaupausenattribute mit Ausdrücken zugreifen. Der Ausdruck in der Spalte Zuordnung definiert Blaupausenattribute für jeden Vorgang in einem Schritt. Beispielsweise kann auf das Attribut Standort, das auf dem Stack-Anforderungsformular angezeigt wird, über den Ausdruck ${parameter.Location} zugegriffen werden. Der Standortparameter mit dem Wert ${parameter.Location} wird auf der Registerkarte Eingaben angezeigt, wenn Sie einen Blaupausenvorgang auswählen.

Standortparameter und -ausdruck — Abbildung : 2. Ausdrücke in einer Blaupause

Ausdrücke in Richtlinienaktionen verwenden

Richtlinienaktionen können Ausdrücke verwenden, um Parameterwerte zu überschreiben, die Benutzer in einem Anforderungsformular im Cloudbenutzerportal übermitteln. Sie können auch in Stack-Vorgängen auf Benutzerdaten zugreifen und diese überschreiben. Verwenden Sie beispielsweise den folgenden Ausdruck, um einen Stapel umzubenennen: formData.Stackname = "Ihre-Namenskonvention";.

Richtlinienbeispielskript — Abbildung : 3. Ausdrücke in einem Richtlinienskript

Sie können auf Blaupausenattribute mit Ausdrücken zugreifen. Der Ausdruck in der Spalte Zuordnung definiert Blaupausenattribute für jeden Vorgang in einem Schritt. Beispielsweise kann auf das Attribut Standort, das auf dem Anforderungsformular für einen virtuellen Computer angezeigt wird, über den Ausdruck ${parameter.Location} zugegriffen werden.

Ausdruckstypen

Definitionsausdrücke: Definitionsausdrücke sind eine Form der frühen Bindung (oder statischen Bindung). Diese Bindungen beziehen sich auf die Bindung zur Kompilierungszeit und werden ausgewertet, wenn der Benutzer das Stapelanforderungsformular übermittelt (wenn die Stapel- oder Ressourcenbereitstellung beginnt). Definitionsausdrücke haben keinen Zugriff auf die Daten, die während Orchestration generiert werden. Definitionsausdrücke werden in geschweifte Klammern eingeschlossen. Beispiel: ${parameter.CloudAccount}
Laufzeitausdrücke: Laufzeitausdrücke sind eine Form der späten Bindung (oder dynamischen Bindung). Diese Bindungen beziehen sich auf die Bindung zur Laufzeit und haben Zugriff auf die Daten, die während Orchestration erstellt werden (z. B. Stapelelemente). Laufzeitausdrücke werden ausgewertet, wenn sie während einer Ausführung von Orchestration aufgerufen werden. Laufzeitausdrücke werden normalerweise für Dot-Walking mit Daten in Tabellen verwendet. Laufzeitausdrücke sind in Klammern eingeschlossen. Beispiel: $(Stack.items[VM1].attributes[node_id])
Definitions-/Laufzeitausdrücke: Einige Ausdrücke enthalten sowohl Definitions- als auch Laufzeitausdrücke.
Komplexe Ausdrücke: Sie können Ausdrücke beliebigen Typs in anderen Ausdrücken verschachteln.

Syntax und Beispiele für Definitionsausdrücke

Die zulässige Syntax verwendet ein Dollarzeichen und geschweifte Klammern. Diese Typen sind verfügbar:

${parameter.}. Verwenden Sie diese Art von Ausdruck, um Werte aus Eingabeattributen von Prozessen wie der Bereitstellung von Blaupausen abzurufen. Daten werden nicht aus Tabellen abgerufen.
${Stack.items[]}. Verwenden Sie diese Syntax für den Zugriff auf Attribute bestimmter Elemente in einem Stapel.
${randomNumber}. Verwenden Sie diese Syntax, um eine Zufallszahl zu generieren. Beispielsweise können Sie eine VM mit einem zufälligen Knotennamen oder Stapelnamen bereitstellen.

Tabelle : 1. Beispiele für Definitionsausdrücke
Beispiel	Beschreibung
${parameter.BillingCode}	Dieser Ausdruck zeigt, wie ein Abrechnungscode-Parameter in einer Blaupause angezeigt wird.
${parameter.formData.CatalogAttributeType}	Dieser Ausdruck verwendet ein Katalogattribut, das von einem Benutzer übermittelt wird, während der Benutzer das Formular für ein Katalogelement im Cloudbenutzerportal ausfüllt.
${parameter.userData.userId}	Dieser Ausdruck verwendet die ID eines Benutzers, während der Benutzer das Formular für ein Katalogelement im Cloudbenutzerportal ausfüllt.
${Stack.items[Virtueller Server].attributes[sys_id]}	Dieser Ausdruck ruft die sys_id eines virtuellen Servers ab, der Teil eines Stapels ist. „Virtueller Server“ ist der Alias eines Ressourcenblocks, der im Stapel verwendet wird.

Syntax und Beispiele für Laufzeitausdrücke

Die zulässige Syntax verwendet ein Dollarzeichen und Klammern. Diese Typen sind verfügbar:

$(ci.tablename), wobei tablename eine Tabelle im System ist, normalerweise eine CI-Tabelle in der CMDB. Verwenden Sie diese Syntax, um auf Werte von Feldern in der Tabelle zuzugreifen.
$(Stack.items[]). Verwenden Sie diese Syntax für den Zugriff auf Attribute bestimmter Elemente in einem Stapel.

Tabelle : 2. Beispiele für Laufzeitausdrücke
Beispiel	Beschreibung
`$(ci.cmdb_ci_cloud_subnet[ sys_id=12231231231231231231].cidr)`	Dieser Ausdruck führt ein Dot-Walking mit der Tabelle „Cloud-Subnetz“ durch, sucht den spezifischen Datensatz mit der angegebenen sys_id und übernimmt den Wert aus der Spalte `cidr`.
`$(ci.sn_cmp _ip_pool[subnet=${parameter.formData.Subnet Id}])`	Dieser Ausdruck kombiniert Ausdrücke der Typen Laufzeit und Definition. Das Gleichheitszeichen „=“ wird verwendet, um einen Wert für eine Übereinstimmung auszuwerten. Der Ausdruck führt ein Dot-Walking für die Tabelle „IP-Pool“ durch und sucht nach dem Subnetz mit der Subnetz-ID, die der Benutzer übermittelt hat.
`$(ci.cmdb_ci_cloud_subnet[${parameter.formData.SubnetId}].cidr)`	Dieser Ausdruck kombiniert Ausdrücke der Typen Laufzeit und Definition. Der Ausdruck übernimmt den Wert des Felds cidr aus einem Subnetz, das der Benutzer bei der Bereitstellung ausgewählt hat. Die eckigen Klammern `[]` geben an, dass der Ausdruck die Tabelle „Cloud-Subnetz“ per Dot-Walking auswertet und dann den Wert für „Subnetz“ betrachtet, den der Benutzer für eine Blaupausenbereitstellung übermittelt hat. Der Ausdruck erfasst den Wert des Felds cidr und geht dann zu dem Wert im Feld cidr der sys_id des Subnetzes.
$(Stack.items[Virtueller Server].attributes[sys_id])	Wie auch im Beispiel zum Definitionsausdruck ruft dieser Ausdruck die sys_id eines virtuellen Servers ab, der Teil eines Stapels ist.

Beispielausdruck

$(ci.cmdb_ci_nic[$(Script:CMPVMNICs.getNICs[arg=$(Stack.items[Virtueller Server].attributes[sys_id])])].private_ip)

$(ci: Laufzeitausdruck zum Abrufen von Daten aus der Tabelle.
cmdb_ci_nic: CI für Netzwerkschnittstellenkarte (NIC).
$(Script: Skriptbasierter Ausdruck.
CMPVMNICs: Skripteinbindung.
getNICs: Funktion in einer Skripteinbindung.
arg: Argumente für die Funktion in der Skripteinbindung. Argumente werden durch Komma (,) getrennt, wenn mehrere Attribute vorhanden sind.
$(Stack.items: Laufzeit-Stapelausdruck zum Abrufen eines Stapelelements aus einem Stapel. Argument ist der in der Blaupause angegebene Alias.
Virtual Server: Alias der in der Blaupause verwendeten Ressource.
$(Stack.items[Virtual Server].attributes[sys_id]): Ruft die sys_id der Ressourceninstanz des Stapelelements („Virtueller Server“) in einem Stapel ab.
private_ip: Attribut von cmdb_ci_nic. Bei Bedarf durch öffentliche IP-Adresse ersetzen.

Ausdrücke


Simple parameter mapping expression Dieser Ausdruckstyp ruft Werte aus Eingabeattributen von Prozessen ab, z. B. Blaupausenvorgängen, Ressourcenblöcken und Richtlinien. Daten werden nicht aus Tabellen abgerufen. Er ordnet Werte einer Ebene einer anderen zu, z. B. von einer Blaupause zu einer Ressource zur Cloud API. Typ: Definition Syntax: `${parameter.}` Beispiele: `${parameter.BillingCode}` gibt den Abrechnungscode zurück. `${parameter.formData.CatalogAttributeType}` akzeptiert ein Katalogattribut, das auf dem Anforderungsformular im Cloudbenutzerportal übermittelt wird. `${parameter.userData.userId}` verwendet die ID eines Benutzers, der das Anforderungsformular im Cloudbenutzerportal bearbeitet.
Stack item expression Jedes Stapelelement wird durch eine CI-Instanz in der CMDB dargestellt. Verwenden Sie Stapelelementausdrücke, um Eigenschaften der ersten Ebene im CI oder im Stapelelement selbst zu suchen, die das Stapelelement unterstützen. Typ: Definition/Laufzeit Syntax: `${Stack.items[]}` oder `$(Stack.items[])` Beispiele: `${Stack.items[VirtualServer1].attributes[sys_id]}` ist ein Ausdruck vom Typ Definition, der die sys_id eines virtuellen Servers in einem Stapel abruft. `VirtualServer1` ist der Alias eines Ressourcenblocks, der im Stapel verwendet wird. `$(Stack.items[VirtualServer2].attributes[sys_id])` ist ein Ausdruck vom Typ Laufzeit, der die sys_id eines virtuellen Servers in einem Stapel abruft. `${Stack.items[vm1].attributes[node_id]}` liest das Attribut `node_id` des CI, das für die VM erstellt wurde. `vm1` ist der Name des Stapelelements (oder der Alias der Ressource in der Blaupause). `$(Stack.items[vm1].status)` liest den Status des Stapelelements.
Property override expressions in policies In Richtlinien können Sie Eigenschaften überschreiben, indem Sie einen Wert aus dem System abrufen oder eine Zufallszahl verwenden. Sie können Daten sowohl aus den Formularen im Cloudbenutzerportal als auch von dem Benutzer verwenden, der den Vorgang auf dem Formular ausgeführt hat. Typ: Definition/Laufzeit Syntax: `${parameter.formData.xyz}` oder `${this.parameter.userData.xyz}` Beispiele: Der folgende Wert kann den Stapelnamen auf Stack_Bob.Smith@company.com festlegen: `Stack_${parameter.userData.userId}` Legen Sie Stapel- oder Tabellenwerte mithilfe von Laufzeitausdrücken fest, indem Sie das Subnetz aus der Tabelle „IP-Pool“ verwenden: `$(ci.sn_cmp _ip_pool[subnet=${parameter.formData.Subnet Id}])` In Skripts können Sie Werte wie folgt zuweisen: `formData.App_Server_NodeName = "MyNodeName";` `this.parameter.userData.userId == 'servicenowuserId';` Siehe auch Richtlinienaktionsskript erstellen.
Script expression Im Beispiel ist `VMProperties` eine Skripteinbindung mit einer Funktion namens `getIP`. Ein Skriptausdruck ist auch ein Beispiel für einen komplexen Ausdruck (der Ausdruck ist verschachtelt). Typ: Laufzeit Syntax: `$(Script:scriptName.function[])` Beispiele: `$(Script:VMPropertiesUtil.getIP[ arg=$(Stack.items[VM1].attributes[object_id])])` Ausdruck für private IP:`$(ci.cmdb_ci_nic[$(Script:CMPVMNICs.getNICs[arg=$(Stack.items[Virtual Server].attributes[sys_id])])].private_ip)` Ausdruck für öffentliche IP: `$(ci.cmdb_ci_nic[$(Script:CMPVMNICs.getNICs[arg=$(Stack.items[Virtual Server].attributes[sys_id])])].public_ip)` Ausdruck zum Abrufen des Anmeldeinformationsalias: `$(Script:CMPVMUtils.getCredentialAlias[arg=${Stack.items[Virtual Server].attributes[sys_id]}])` Ausdruck zum Abrufen der IP-Adresse: `$(Script:CMPVMUtils.getReachableIp[arg=$(Stack.items[Virtual Server].attributes[sys_id])])`
CI lookup expression Greift auf Werte von Feldern in einer Tabelle zu, normalerweise eine CI-Tabelle in der CMDB. Typ: Definition/Laufzeit Syntax: `$(ci.tableName)` Beispiele: `$(ci.sn_cmp _ip_pool[subnet=${parameter.formData.Subnet Id}])` kombiniert Laufzeit- und Definitionsausdrücke. Der Operator „=“ wertet einen Wert für eine Übereinstimmung aus. Der Ausdruck führt ein Dot-Walking für die Tabelle „IP-Pool“ durch und sucht nach dem Subnetz mit der Subnetz-ID, die der Benutzer übermittelt hat. `$(ci.cmdb_ci_cloud_subnet[${parameter.formData.SubnetId}].cidr)` ruft den Wert des Felds `cidr` aus einem Subnetz ab, das der Benutzer während der Bereitstellung angegeben hat. Der Ausdruck führt ein Dot-Walking für die Tabelle „Cloud-Subnetz“ durch, betrachtet den Subnetzwert, den der Benutzer in einer Blaupausenbereitstellung angegeben hat, extrahiert den Wert des Felds `cidr` und geht dann zum Wert im Feld `cidr` der sys_id des Subnetzes.
Random number expression Generiert eine Zufallszahl. Beispielsweise können Sie eine VM mit einem zufälligen Knotennamen oder Stapelnamen bereitstellen. Typ: Laufzeit Syntax und Beispiel: `${randomNumber}`
Scratchpad expression/Resource operation output attribute expression Liest Ausgabeattribute aus einem Vorgang in einen anderen Vorgang. Typ: Laufzeit Syntax: variiert Beispiel: Ausgaben für einen Vorgang festlegen/verfügbar machen: `${Compute Interface.CreateNode.Output.resp.nodeId}` So lesen Sie die Ausgabeattribute (wobei `VM1.Provision` der Vorgang ist, dessen Ausgabeattribute gelesen werden): `$(Outputs[VM1.Provision].NodeId)`
Conditions in expressions Sie können bedingte Ausdrücke in Blaupausenschritten und Ressourcenvorgangsschritten verwenden, um den Schritt bedingt auszuführen oder zu überspringen. Die bedingten Ausdrücke sind Javascript-Ausdrücke und unterstützen das Ersetzen von Ausdrücken. Typ: Definition/Laufzeit Syntax: variiert Beispiele: ‘${parameter.CloudAccount}’==’Amazon Cloud Account’ ‘$(Stack.items[vm1].attributes[node_id]) ’== ’VM1’
Complex expression Sie können Ausdrücke schachteln. Im Beispiel ordnet `${parameter.ServerID}` die sys_id des CI zu und wird ersetzt, bevor der äußere Ausdruck angewendet wird. Typ: beliebig Syntax: variiert Beispiel: `$(ci.cmdb_ci_vm_instance[${parameter.ServerID}].name)`
Order context Dieser Ausdruck ist für Lebenszyklusvorgänge nützlich und ermöglicht Ihnen das Dot-Walking für die Bestellattribute als Teil der Tabelle sn_cmp_order. Typ: Laufzeit Syntax: `$(context.order.column_name)` Beispiele: Anforderungselement: `$(context.order.sc_req_item)` Dot-Walking für Anforderungselementobjekt: `$(context.order.sc_req_item.number)` Gemischter Ausdruck (Konstante + Ausdruck): `"ram$(context.order.sc_req_item.number)"`