カスタムAPIアクション
ServiceNow REST APIに対してカスタムの認証済みHTTP呼び出しを行います。使用可能な処理の詳細については、「ServiceNow APIリファレンス」を参照してください。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
| Request Type（リクエストタイプ） | カスタムAPI呼び出しでサポートされているHTTPリクエストメソッド、つまりHTTP動詞を以下に示します（「HTTPリクエストメソッド」を参照）。
| ドロップダウン | TRUE |
GETリクエストに対して返されるレコードの最大数はsysparm_limitによって設定されます。sysparm_limitの例については、「テーブルAPI GET」を参照してください。警告：異常に大きなsysparm_limit値はシステムパフォーマンスに影響を及ぼす可能性があります。
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
| Relative URL (相対URL) | 対話を試みるWebサーバーのアドレス。Relative URLは、URLの先頭でプロトコルを明示する必要がないことを意味します (たとえば「http://」など)。これにより、対話は (この場合の) サーバー上で発生することがWebサーバーに示されます。 例：https://{{auth.instance}}.service-now.com{{input.Request.Relative URL}} | 文字列 | FALSE |
| Query (クエリー) | URLで実行されるアクションを定めるJSONオブジェクト。 例：{"name":"something-urgent"} | オブジェクトまたは文字列 | FALSE |
| Headers（ヘッダー） | リクエストのコンテンツタイプを定めるJSONオブジェクト。通常、次のようになります。 例：{"Content-type":"application/json"} | オブジェクト | FALSE |
出力
| フィールド | 定義 | タイプ |
|---|---|---|
| Status Code（ステータスコード） | 操作の結果。HTTPステータスコードはコネクタによって返され、カードによって実行されたアクションが成功したか失敗したかを示します。以下に例を挙げます。
発生する可能性があるステータスコードの完全なリストについては、「 HTTPステータスコード」を参照してください。 | 数値 |
| Headers (ヘッダー) | 出力ボディーとは関係のない、ステータスコードの詳細なコンテキスト。レスポンスヘッダーは選択されたHTTPリクエストオプションに依存します。すべてのヘッダーがレスポンスヘッダーではないことに注意してください。通常、{"Content-type":"application/json"}のようになります。 | オブジェクト |
| Body (ボディー) | 選択されたHTTPリクエストから返されるデータ (たとえば、GETリクエストからのデータなど)。 | オブジェクト |