5.3. インベントリー API を使用してカスタムの staleness と削除の制限を設定する

手順

1. Web ブラウザーで Red Hat Insights API Catalog を開きます。
2. カタログから Managed Inventory を選択します。Insights Host Inventory REST Interface ページが表示されます。
3. Operations リストの下で、GET /account/staleness/defaults の横にあるドロップダウン矢印をクリックします。操作の説明には、サーバーからの予想されるレスポンスが含まれます。さらに、ページの右側のパネルでは、GET 操作の API 呼び出しの例が複数の言語で生成されます。
4. パネルでドロップダウンをクリックし、オプションのリストから希望する言語 (例: Python) を選択します。パネルには、Python 構文でフォーマットされた GET 操作のサンプルコードが表示されます。

5. サンプルコードをコピーし、GET コマンドを呼び出す Python コードファイルに貼り付けます。以下に例を示します。

   import requests
   
   url = "https://console.redhat.com/account/staleness/defaults"
   
   headers = {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
   }
   
   response = requests.get(url, headers=headers)
   
   print(response.json())

   Copy to Clipboard
6. <token> の代わりに認証用のアクセストークンを貼り付けます。
7. コードを実行します。

手順

1. Hybrid Cloud Console の API ドキュメントページ に移動します。API ドキュメントページが表示されます。
2. サービスのリストから Managed Inventory を選択します。Detail ページが表示され、https://console.redhat.com/api/inventory/v1 エンドポイントを使用して実行できる操作が表示されます。
3. GET/accounts/staleness/defaults 操作の横にあるドロップダウン矢印をクリックします。GET リクエストに入力する必要はないため、パラメーターのリストには No parameters と表示されます。
4. Try It Out をクリックします。このページには、成功したサーバーレスポンスの形式が表示されます。
5. Execute をクリックします。このページには、サーバーへの curl リクエスト、リクエスト URL、およびサーバーレスポンスが表示されます。
6. 後で再利用するために curl リクエストをクリップボードにコピーするには、curl リクエストの右側にあるクリップボードアイコンをクリックします。必要に応じて、テキストエディターに貼り付けて保存します。
7. サーバーレスポンスをクリップボードにコピーするには、右上隅のクリップボードアイコンをクリックします。必要に応じて、テキストエディターに貼り付けて保存します。

8. サーバーレスポンスを JSON ファイルとしてダウンロードするには、Download をクリックします。

   注記

   サーバーが 403 レスポンスまたはその他の失敗したレスポンスを返す場合は、正しい RBAC 権限があることを確認してから、リクエストを再試行してください。

   オプション: サーバーレスポンスをクリアしてコマンドを再試行するには、Clear をクリックします。

手順

1. Web ブラウザーで Red Hat Insights API Catalog を開きます。
2. カタログから Managed Inventory を選択します。Insights Host Inventory REST Interface ページが表示されます。
3. POST/account/staleness 操作の横にあるドロップダウン矢印をクリックします。操作の説明には、API 呼び出しを調整するために使用できるパラメーターと、サーバーからの予想されるレスポンスが含まれます。さらに、ページの右側のパネルでは、POST リクエストの API 呼び出しの例が複数の言語で生成されます。
4. パネルでドロップダウンをクリックし、オプションのリストから希望する言語 (例: Python) を選択します。パネルには、Python 構文でフォーマットされた POST リクエストのサンプルコードが表示されます。

5. サンプルコードをコピーし、POST リクエストを呼び出す Python コードファイルに貼り付けます。以下に例を示します。

   import requests
   
   url = "https://console.redhat.com/account/staleness"
   
   payload = {
         "conventional_time_to_delete": 1,
      "conventional_time_to_stale": 1,
      "conventional_time_to_stale_warning": 1,
   }
   headers = {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
   }
   
   response = requests.post(url, json=payload, headers=headers)
   
   print(response.json())

   Copy to Clipboard
6. サンプルに示されている値 1 の代わりに、使用するカスタム staleness の時間を秒単位で追加します。API の 1 という値は 1 日ではなく 1 秒に相当することに注意してください。
7. <token> の代わりに認証用のアクセストークンを貼り付けます。

8. コードを実行します。

   サーバーがレスポンス 201 を返した場合、API 呼び出しは成功しています。

手順

1. Hybrid Cloud Console の API ドキュメントページ に移動します。API ドキュメントページが表示されます。
2. サービスのリストから Managed Inventory を選択します。Detail ページが表示され、link:https://console.redhat.com/api/inventory/v1 エンドポイントを使用して実行できる操作が表示されます。
3. POST/accounts/staleness 操作の横にあるドロップダウン矢印をクリックします。
4. Try It Out をクリックします。このページには、成功したサーバーレスポンスの形式が表示されます。
5. リクエストボディーの各パラメーターの数値 1 の代わりに、カスタム staleness の値を追加します。API の 1 の値は 1 日ではなく 1 秒に相当することに注意してください。
6. Execute をクリックします。このページには、サーバーへの curl リクエスト、リクエスト URL、およびサーバーレスポンスが表示されます。
7. curl リクエストをクリップボードにコピーするには、curl リクエストの右側にあるクリップボードアイコンをクリックします。
8. サーバーレスポンスをクリップボードにコピーするには、右上隅のクリップボードアイコンをクリックします。

9. サーバーレスポンスを JSON ファイルとしてダウンロードするには、Download をクリックします。

   注記

   サーバーが 403 レスポンスまたはその他の失敗したレスポンスを返す場合は、正しい RBAC 権限があることを確認してから、リクエストを再試行してください。

   オプション: サーバーレスポンスをクリアしてコマンドを再試行するには、Clear をクリックします。