Aufrufen des REST-Diensts

Wichtig

Diese Version von Orchestrator hat das Ende des Support erreicht. Es wird empfohlen, ein Upgrade auf Orchestrator 2019 zu durchführen.

Die Aktivität REST-Dienst aufrufen wird in einem Runbook verwendet, um Anforderungen an RESTful-Webdienste zu senden und Daten abzurufen oder Funktionen auszuführen.

Die Aktivität veröffentlicht alle Daten von den erforderlichen und optionalen Eigenschaften in veröffentlichte Daten. In der folgenden Tabelle sind die erforderlichen und optionalen Eigenschaften sowie veröffentlichte Daten für diese Aktivität aufgeführt.

Erforderliche Eigenschaften des REST-Diensts aufrufen

Element Beschreibung Gültige Werte
HTTP-Version Die zu verwendende HTTP-Version. 1.0, 1.1
HTTP-Methode Die zu verwendende HTTP-Methode. Die unterstützten HTTP-Methoden sind GET, PUT, POST und DELETE.
URL Die zu verwendende URL. Beliebige gültige URL
Codierungs-URL Gibt an, ob die URL codiert werden soll. True, False
Timeout Die maximale Zeit, die auf eine Antwort gewartet werden soll. Positive ganze Zahl
Authentifizierungstyp Das Authentifizierungsschema, das beim Herstellen einer Verbindung mit dem REST-Dienst verwendet werden soll. Default, Basic, Negotiate, Digest
Ungültiges Zertifikat akzeptieren Wenn Sie HTTPS verwenden, legen Sie diesen Schalter auf True fest, um ein ungültiges Serverzertifikat zu akzeptieren, oder legen Sie es auf False fest, um es nicht zu akzeptieren. „true“ oder „false“
Domain Die Domäne, die für die Authentifizierung verwendet werden soll. Eine Zeichenfolge. Kann leer sein.
User Der Für die Authentifizierung zu verwendende Benutzername. Eine Zeichenfolge. Kann leer sein.
Kennwort Das Kennwort, das für die Authentifizierung verwendet werden soll. Eine Zeichenfolge. Kann verschlüsselt werden. Kann leer sein.
Anforderungsheader Spezielle Anforderungsheader, die in diesem Format eingegeben werden:
<Parameter: >< Wert>
Gültige Http-Anforderungsheaderparameter und -werte. Kann leer sein.
Jeder Parameter: Das Wertpaar muss in einer separaten Zeile stehen.
Anforderungstext Anforderungstext Wenn dies nicht leer ist, muss der Pfad der Nutzlastdatei leer sein. Eine Zeichenfolge. Kann leer sein.
Nutzlastdateipfad Der Speicherort der Nutzlastdatei, die mit der Anforderung verwendet werden soll. Wenn dieser Wert nicht leer ist, muss der Anforderungskörper leer sein. Ein gültiger Dateispeicherort. Kann leer sein.
PFX-Dateipfad Der Speicherort der verschlüsselten Clientzertifikatdatei, die für Anforderungen an Windows Azure verwendet wird. Ein gültiger Dateispeicherort. Kann leer sein.
PFX-Dateikennwort Das Kennwort für die verschlüsselte Datei ini . PFX-Format. Zeichenfolge. Kann verschlüsselt werden. Kann leer sein.

Aufrufen optionaler Eigenschaften des REST-Diensts

Es gibt keine optionalen Eigenschaften für diese Aktivität.

Aufrufen veröffentlichter REST-Dienstdaten

Element Beschreibung Werttyp
Ungültiges Zertifikat akzeptieren Wenn Sie HTTPS verwenden, legen Sie diesen Schalter auf True fest, um ein ungültiges Serverzertifikat zu akzeptieren, oder legen Sie es auf False fest, um es nicht zu akzeptieren. Boolean
Authentifizierungstyp Das Authentifizierungsschema, das beim Herstellen einer Verbindung mit dem REST-Dienst verwendet werden soll. Zeichenfolge
Codierungs-URL Gibt an, ob die URL codiert werden soll. Boolean
HTTP-Methode Die zu verwendende HTTP-Methode. Zeichenfolge
HTTP-Version Die zu verwendende HTTP-Version. Zeichenfolge
PFX-Dateipfad Der Speicherort der verschlüsselten Clientzertifikatdatei, die für Anforderungen an Windows Azure verwendet wird. Zeichenfolge
Nutzlastdateipfad Der Speicherort der Nutzlastdatei, die mit der Anforderung verwendet werden soll. Wenn dieser Wert nicht leer ist, muss der Anforderungskörper leer sein. Zeichenfolge
Anforderungstext Anforderungstext Wenn dies nicht leer ist, muss der Pfad der Nutzlastdatei leer sein. Zeichenfolge
Anforderungsheader Spezielle Anforderungsheader, die in diesem Format eingegeben werden:
<Parameter: >< Wert>
String
Antwortcookies HTTP-Antwortcookies. Zeichenfolge im HTTP-Antwortcookieformat
Antwortheader HTTP-Antwortheader. Zeichenfolge im HTTP-Antwortheaderformat
Antwortnachrichtentext HTTP-Antwortnachrichtentext. Zeichenfolge im HTTP-Antwortnachrichtenformat
Statuscode der Antwort Der Antwortstatuscode (z. B. 200). Ein gültiger Antwortstatuscode
Antwortstatuszeile Die Antwortstatuszeile. Eine gültige Antwortstatuszeile
Timeout Die maximale Zeit, die auf eine Antwort gewartet werden soll. Ganze Zahl
URL Die zu verwendende URL. Zeichenfolge