Swagger での API 呼び出しを認可する

Swagger にアクセスする

Orchestrator API Swagger にアクセスするには、Orchestrator URL に /swagger/index.html を追加します。例: https://{yourDomain}/swagger/index.html

Swagger で表示される API は、使用する Orchestrator インスタンスによって異なります。Swagger で直接簡単に要求を行うには、別のタブで Orchestrator にログインします。

アクセス トークンを取得する

Orchestrator サービスで Swagger UI を介して API 呼び出しを認可するには、次の手順を実行します。

1. Orchestrator API ページの右上隅にある [Authorize] ボタンを探します。ロックが開いている場合は、認可されていません。

   Figure 1. Authorize button
   

   

   
   

2. Select Authorize. The Available authorizations window is displayed.

   注: 現在サポートされているのは、OAuth2 という認可スキーム 1 つです。
   Figure 2. Available authorizations
   

   

   
   
3. Orchestrator API のすべてのエンドポイントを試すことができるように、すべてのスコープが事前に選択されています。特定の API へのアクセスを制限する場合は、該当するスコープをクリアしてください。
4. Select Authorize. A new window is displayed confirming you have been authorized.
5. Once done, select Close or X to close the Available authorizations window. The Authorize button shows an closed lock meaning you are authorized.

要求を送信する

認可されている間に、以下の方法で Orchestrator API リソースに要求を送信できます。

1. 操作の実行に使用する Orchestrator API リソースを展開します。閉じたロックは、認可されていることを意味します。
   Figure 3. Unauthorized API resource
   

   

   
   
2. In the expanded method window, select Try it out.
3. 必要に応じてパラメーター値を指定します。
4. Select Execute. The request is executed. A bearer authorization header is automatically used for your requests.
   Figure 4. Bearer authorization header
   

   

   
   

新しいアクセス トークンを生成する

アクセス トークンの期限が切れた場合、「401: You are not authenticated!」という応答を受信します。ベアラー認可ヘッダーは要求に対してまだ存在していますが、アクセス トークンは期限切れになっています。この場合、期限切れのトークンを無効にして、新しいアクセス トークンを生成する必要があります。

1. Orchestrator API ページの右上隅にある [Authorize] ボタンを探します。ロックは閉じているはずです。
   Figure 5. Authorize button
   

   

   
   
2. Select Authorize and on the displayed Available authorizations page, select Logout to revoke the expired token.
   Figure 6. Available authorizations
   

   

   
   
3. Close the Available authorizations window by selecting Close or X and then obtain an access token as described on the Obtaining an access token section.

アクセスを取り消す

Swagger UI の操作が完了したら、使用したアクセス トークンを無効にする必要があります。

1. Orchestrator API ページの右上隅にある [Authorize] ボタンを探します。ロックは閉じているはずです。つまり、承認されています。
2. [Authorize] をクリックし、表示される [Available authorizations] ページで [Logout] をクリックします。
3. [Close] または [X] をクリックして [Available authorizations] ウィンドウを閉じます。[Authorize] ボタンに開いているロックが表示され、認可されていないことを示します。