vManageでAPIを実行するためのPostmanの設定

はじめに

このドキュメントでは、Postmanでアプリケーションプログラミングインターフェイス(API)を実行する方法について説明します。

システム要件

• Postmanがインストールされました
• vManageおよびユーザ名とパスワードのクレデンシャルへのアクセス

注：Postmanがない場合は、https://www.postman.com/downloads/からダウンロードしてください。

バックグラウンド情報

主に使用される、または最も一般的に使用されるHTTP動詞（または適切に呼び出されるメソッド）は、POST、GET、PUT、PATCH、およびDELETEです。

これらは、それぞれ作成、読み取り、更新、削除（またはCRUD）操作に対応します。

他にもたくさんの動詞がありますが、あまり使われていません。これらの頻度の低い方法のうち、OPTIONSおよびHEADは他の方法よりも頻繁に使用されます。

APIを実行するためのPostmanの設定

ステップ 1：Postmanを開き、新しいHTTP要求を作成します。

強調表示されたオプションのいずれかをクリックすると、新しいHTTP要求を作成できます。

新しいHTTP要求を作成します。

ステップ 2vManageへのユーザ名とパスワードのクレデンシャルで認証します。

別のHTTP要求を作成します。

1. HTTP動詞としてPOSTを選択します。
2. POSTの横にhttps://<vmanage-ip>/j_security_checknextを追加します。
3. Bodyをクリックし、Keyパラメータであるj_usernameとj_password、およびその値をそれぞれ追加します。
4. [Send] をクリックします。

注：この例では、vManage IPアドレスは10.88.244.30で、ポートは5301です

注：ユーザ名とパスワードの値にはadminを使用します。

Postmanのパラメータを完全にします。

vManage認証。

注意： このAPIコールの応答は空である必要があります

ステップ 3トークンの要求

1. HTTP動詞としてGETを選択します。
2. GET https://<vmanage-ip>/dataservice/client/tokenの横にAPIコールの詳細を追加します。
3. Sendをクリックします。

注：vManageバージョン19.2.1以降では、正常にログインしたユーザが、APIコールによるPOST/PUT/DELETE操作ごとにX-XSRG-TOKENまたはCSRFトークンを送信する必要があることが必須になっています。

API呼び出しが実行されると、応答ストリングが本文に表示されます。その文字列を保存します。次の図は、Postmanでの出力の例です。

vManageのトークンを要求する

警告：図に示すようにトークンを取得しなかった場合は、この手順を繰り返してください。

ステップ 4vManageへの別のAPIの実行に進みます。

この例では、POST要求が必要です

1. 実行するAPIコールを選択します。この例では、https:///dataservice/statistics/dpi/aggregationです。

ヒント：その他のAPIコールについては、vManage url https://vmanage-ip:port/apidocsを参照してください。

2. APIコール本文を収集します。

注：このAPIコールには、JSON形式の本文が含まれています

3. Headerをクリックし、Keyとして文字列X-XSRF-TOKENを値として追加します。

4. 「送信」をクリックします。

この図は、APIコールがどのように表示されるかを示しています。

DPI集計API呼び出し。

ステップ 5セッションを閉じる

vManageやデバイスから必要なすべての情報を取得したら、vManageのリソースを解放し、悪意のあるユーザがセッションを使用する可能性を排除します。

自動化された環境でAPIコールを実行

後続のAPI呼び出しで使用するCookieと変数を保存する

変数にトークンを保存する方法

後で再利用できるように、トークンを変数に保存します。

変数にトークンを保存する

トークンをJSON形式で要求する場合は、トークンを保存します。Testsタブを使用して、表示されている行を貼り付けます。

var jsonData = JSON.parse(responseBody);
postman.setEnvironmentVariable("token", jsonData.token);

pm.test("Status code is 200", () => {
 pm.expect(pm.response.code).to.eql(200);
});