1.4. http://localhost:7080/rest/content : コンテンツ関連
このエンドポイントはコンテンツ(アップロード)を処理します。
Defining class: org.rhq.enterprise.server.rest.ContentHandlerBean
プロデューサー: application/json、application/xml
メソッド
POST /content/fresh
description
サーバーにコンテンツをアップロードします。これにより、後でコンテンツを取得してさらに処理できるハンドルが返されます。パラメーター: Name P.Type description 必須 type 許可される値 デフォルト値 -body- 保存する application/octet-stream true java.io.InputStream -all- -none- return type: javax.ws.rs.core.Response
GET /content/{handle}/info
description
渡されたハンドルのコンテンツの長さを取得します。パラメーター: Name P.Type description 必須 type 許可される値 デフォルト値 handle path NONE string -all- -none- 戻りタイプ: IntegerValue
PUT /content/{handle}/plugins
description
アップロードしたコンテンツをプラグインドロップボックスに配置します。注記
このエンドポイントは、以前にアップロードしたコンテンツをプラグインとしてデプロイできるようにします。プラグインの処理が正常に実行されるには、有効なプラグイン(ファイル)名を指定する必要があります。オプションで、プラグインスキャンを開始して、プラグインをシステムに登録するように要求できます。プラグインが自動的にエージェントにプッシュされる遅延(ミリ秒単位)を指定することもできます。負でない「pushOutDelay」は「scan」が true に設定されている場合、サーバーに更新されたプラグインがないため、エージェントで更新が発生することができないことに注意してください。負でない「pushOutDelay」と「scan」が false に設定されている場合、406 エラーが返されます。ハンドルで特定されたコンテンツは削除されません。このメソッドは非推奨となり、PUT から /plugins を使用します。
パラメーター: Name P.Type description 必須 type 許可される値 デフォルト値 handle path アップロードから取得したハンドルの名前 true string all Name クエリー プラグインファイルの名前 false string all scan クエリー 検出スキャンを開始すべきか? false ブール値 all false pushOutDelay クエリー エージェントがプラグインを更新するまでの遅延(ミリ秒単位)。負の値を設定すると、エージェントの自動更新が無効になります。 false long all -1 return type: javax.ws.rs.core.Response
エラーコード: code reason 406 指定されたパラメーターの名前または無効な組み合わせがない 404 ハンドルが見つからない 403 caller にはプラグインをアップロードする権限がありません。 delete /content/{handle}
description
渡されたハンドルのコンテンツを削除します。注記
この操作はデフォルトでべき等で、204. コンテンツが存在するかどうかを確認する場合は、「validate」クエリーパラメーターを渡す必要があります。
パラメーター: Name P.Type description 必須 type 許可される値 デフォルト値 handle path NONE string -all- -none- Validate クエリー コンテンツが存在するかどうかの検証 false ブール値 all false return type: javax.ws.rs.core.Response
エラーコード: code reason 204 検証が設定されていないコンテンツが削除されるか、または存在しない 404 コンテンツは存在せず、検証が設定されている