Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

このコンテンツは選択した言語では利用できません。

REST API (TECH PREVIEW)

JBoss Operations Network 3.1

The web path for the REST interface, unless otherwise specified, is http://localhost:7080/rest/1

Copyright © 2012 Red Hat, Inc.

June 12, 2012

Abstract

This is an API reference for the REST interface for JBoss Operations Network.

Important

This REST API is under active development. While some interfaces are probably stable (such as resources and metrics methods), some interfaces are still being designed and could change significantly as development progresses (such as the alerts methods). As with all preview technologies, expect significant changes in subsequent releases of the REST API. Compatibility is not guaranteed, so use caution when developing clients using the tech preview version of the JBoss ON REST API.

1.  /alert: Deal with Alerts
リンクのコピー

This API deals with alerts that have fired. It does not offer to create/update AlertDefinitions (yet)
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.AlertHandlerLocal

1.1. GET alert/
リンクのコピー

Expand
Table 1. Parameters
Name P.Type Description Required Type Allowed values Default value
page Query Page number false int all 0
status Query Limit to status, UNUSED AT THE MOMENT false java.lang.String all  
Return type: java.util.List<org.rhq.enterprise.server.rest.domain.AlertRest>

1.2. GET alert/{id}
リンクのコピー

Expand
Table 2. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the alert to retrieve true int all  
Return type: org.rhq.enterprise.server.rest.domain.AlertRest

1.3. PUT alert/{id}
リンクのコピー

Expand
Table 3. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the alert to acknowledge true int all  
Return type: org.rhq.enterprise.server.rest.domain.AlertRest

1.4. DELETE alert/{id}
リンクのコピー

Expand
Table 4. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the alert to remove true int all  
Return type: void

1.5. GET alert/{id}/definition
リンクのコピー

Expand
Table 5. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the alert to show the definition true int all  
Return type: org.rhq.enterprise.server.rest.domain.AlertDefinitionRest

1.6. GET alert/definition
リンクのコピー

Expand
Table 6. Parameters
Name P.Type Description Required Type Allowed values Default value
page Query Page number false int all 0
status Query Limit to status, UNUSED AT THE MOMENT false java.lang.String all  
Return type: java.util.List<org.rhq.enterprise.server.rest.domain.AlertDefinitionRest>

1.7. GET alert/definition/{id}
リンクのコピー

Expand
Table 7. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the alert definition to retrieve true int all  
Return type: org.rhq.enterprise.server.rest.domain.AlertDefinitionRest

2.  /configurationHistory
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.ConfigurationHistoryLocal

2.1. GET configurationHistory/
リンクのコピー

This method has no parameters
Return type: javax.ws.rs.core.StreamingOutput

3.  /driftCompliance
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.DriftComplianceLocal

3.1. GET driftCompliance/
リンクのコピー

Expand
Table 8. Parameters
Name P.Type Description Required Type Allowed values Default value
resourceTypeId Query none false java.lang.String all -none-
version Query none false java.lang.String all -none-
Return type: javax.ws.rs.core.StreamingOutput

4.  /group: Deal with groups
リンクのコピー

API that deals with resource groups
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.GroupHandlerLocal

4.1. GET group/
リンクのコピー

This method has no parameters
Return type: javax.ws.rs.core.Response

4.2. GET group/{id}
リンクのコピー

Expand
Table 9. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the group true int all  
Return type: javax.ws.rs.core.Response

4.3. POST group/
リンクのコピー

Expand
Table 10. Parameters
Name P.Type Description Required Type Allowed values Default value
-body- A GroupRest object containing at least a name for the group false org.rhq.enterprise.server.rest.domain.GroupRest all   
Return type: javax.ws.rs.core.Response

4.4. PUT group/{id}
リンクのコピー

Expand
Table 11. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the group to update true int all  
-body- New version of the group false org.rhq.enterprise.server.rest.domain.GroupRest all   
Return type: javax.ws.rs.core.Response

4.5. DELETE group/{id}
リンクのコピー

Expand
Table 12. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the group to delete true int all  
Return type: javax.ws.rs.core.Response

4.6. GET group/{id}/resources
リンクのコピー

Expand
Table 13. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the group to retrieve the resources for true int all  
Return type: javax.ws.rs.core.Response

4.7. PUT group/{id}/resource/{resourceId}
リンクのコピー

Expand
Table 14. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the existing group true int all  
resourceId Path Id of the resource to add true int all  
Return type: javax.ws.rs.core.Response
Expand
Table 15. Error Codes
Code Reason
404 If there is no resource or group with the passed id
409 Resource type does not match the group one

4.8. DELETE group/{id}/resource/{resourceId}
リンクのコピー

Expand
Table 16. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the existing group true int all  
resourceId Path Id of the resource to remove true int all  
Return type: javax.ws.rs.core.Response

5.  /inventorySummary
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.InventorySummaryLocal

5.1. GET inventorySummary/
リンクのコピー

Expand
Table 17. Parameters
Name P.Type Description Required Type Allowed values Default value
resourceTypeId Query none false java.lang.String all -none-
version Query none false java.lang.String all -none-
Return type: javax.ws.rs.core.StreamingOutput

6.  /metric: Deal with metrics
リンクのコピー

This part of the API deals with exporting metrics
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.MetricHandlerLocal

6.1. GET metric/data/{scheduleId}
リンクのコピー

Expand
Table 18. Parameters
Name P.Type Description Required Type Allowed values Default value
scheduleId Path Schedule Id of the values to query true int all  
startTime Query Start time since epoch false long all  
endTime Query End time since epoch false long all  
dataPoints Query Number of buckets - currently fixed at 60 false int all 60
hideEmpty Query none false boolean all -none-
Return type: javax.ws.rs.core.Response
Expand
Table 19. Error Codes
Code Reason
404 No schedule with the passed id exists

6.2. GET metric/data
リンクのコピー

Expand
Table 20. Parameters
Name P.Type Description Required Type Allowed values Default value
sid Query none false java.lang.String all -none-
startTime Query none false long all -none-
endTime Query none false long all -none-
dataPoints Query none false int all -none-
hideEmpty Query none false boolean all -none-
Return type: javax.ws.rs.core.Response

6.3. GET metric/data/resource/{resourceId}
リンクのコピー

Expand
Table 21. Parameters
Name P.Type Description Required Type Allowed values Default value
resourceId Path Resource to query true int all  
Return type: java.util.List<org.rhq.enterprise.server.rest.domain.MetricAggregate>
Expand
Table 22. Error Codes
Code Reason
404 If no resource with the passed id exists

6.4. GET metric/schedule/{id}
リンクのコピー

Expand
Table 23. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Schedule Id true int all  
Return type: javax.ws.rs.core.Response
Expand
Table 24. Error Codes
Code Reason
404 No schedule with the passed id exists

6.5. PUT metric/schedule/{id}
リンクのコピー

Expand
Table 25. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the schedule to query true int all  
-body- New schedule data true org.rhq.enterprise.server.rest.domain.MetricSchedule all   
Return type: MetricSchedule
Expand
Table 26. Error Codes
Code Reason
404 No schedule with the passed id exists

6.6. GET metric/data/{scheduleId}/raw
リンクのコピー

Expand
Table 27. Parameters
Name P.Type Description Required Type Allowed values Default value
scheduleId Path none true int all  
startTime Query Start time since epoch false long all Now - 8h
endTime Query End time since epoch false long all Now
duration Query Timespan in ms false long all 8h = 28800000ms
Return type: javax.ws.rs.core.StreamingOutput
Expand
Table 28. Error Codes
Code Reason
404 No schedule with the passed id exists

6.7. PUT metric/data/{scheduleId}/raw/{timeStamp}
リンクのコピー

Expand
Table 29. Parameters
Name P.Type Description Required Type Allowed values Default value
scheduleId Path Id of the schedule true int all  
timeStamp Path Timestamp of the metric true long all  
-body- Data point true org.rhq.enterprise.server.rest.domain.NumericDataPoint all   
Return type: javax.ws.rs.core.Response
Expand
Table 30. Error Codes
Code Reason
404 No schedule with the passed id exists

6.8. POST metric/data/raw
リンクのコピー

Expand
Table 31. Parameters
Name P.Type Description Required Type Allowed values Default value
points -body- none false java.util.Collection<org.rhq.enterprise.server.rest.domain.NumericDataPoint> all -none-
Return type: javax.ws.rs.core.Response

6.9. GET metric/data/{scheduleId}/baseline
リンクのコピー

Expand
Table 32. Parameters
Name P.Type Description Required Type Allowed values Default value
scheduleId Path Id of the schedule true int all  
Return type: org.rhq.enterprise.server.rest.domain.Baseline
Expand
Table 33. Error Codes
Code Reason
404 No schedule with the passed id exists

6.10. PUT metric/data/{scheduleId}/baseline
リンクのコピー

Expand
Table 34. Parameters
Name P.Type Description Required Type Allowed values Default value
scheduleId Path Id of the schedule true int all  
baseline -body- none false org.rhq.enterprise.server.rest.domain.Baseline all -none-
Return type: void
Expand
Table 35. Error Codes
Code Reason
404 No schedule with the passed id exists

6.11. PUT metric/data/{scheduleId}/trait
リンクのコピー

Expand
Table 36. Parameters
Name P.Type Description Required Type Allowed values Default value
scheduleId Path Id of the schedule true int all  
value -body- none false org.rhq.enterprise.server.rest.domain.StringValue all -none-
Return type: javax.ws.rs.core.Response
Expand
Table 37. Error Codes
Code Reason
404 No schedule with the passed id exists

6.12. GET metric/data/{scheduleId}/trait
リンクのコピー

Expand
Table 38. Parameters
Name P.Type Description Required Type Allowed values Default value
scheduleId Path Id of the schedule true int all  
Return type: StringValue
Expand
Table 39. Error Codes
Code Reason
404 No schedule with the passed id exists

7.  /operation
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.OperationsHandlerLocal

7.1. GET operation/definition/{id}
リンクのコピー

Expand
Table 40. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path none true int all -none-
resourceId Query none false java.lang.Integer all -none-
Return type: javax.ws.rs.core.Response

7.2. GET operation/definitions
リンクのコピー

Expand
Table 41. Parameters
Name P.Type Description Required Type Allowed values Default value
resourceId Query none false java.lang.Integer all -none-
Return type: javax.ws.rs.core.Response

7.3. POST operation/definition/{id}
リンクのコピー

Expand
Table 42. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path none true int all -none-
resourceId Query none false java.lang.Integer all -none-
Return type: javax.ws.rs.core.Response

7.4. GET operation/{id}
リンクのコピー

Expand
Table 43. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path none true int all -none-
Return type: javax.ws.rs.core.Response

7.5. PUT operation/{id}
リンクのコピー

Expand
Table 44. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path none true int all -none-
operation -body- none false org.rhq.enterprise.server.rest.domain.OperationRest all -none-
Return type: javax.ws.rs.core.Response

7.6. DELETE operation/{id}
リンクのコピー

Expand
Table 45. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path none true int all -none-
Return type: javax.ws.rs.core.Response

7.7. GET operation/history/{id}
リンクのコピー

Expand
Table 46. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path none true java.lang.String all -none-
Return type: javax.ws.rs.core.Response

8.  /platformUtilization
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.PlatformUtilizationLocal

8.1. GET platformUtilization/
リンクのコピー

This method has no parameters
Return type: javax.ws.rs.core.StreamingOutput

9.  /recentAlerts
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.RecentAlertLocal

9.1. GET recentAlerts/
リンクのコピー

Expand
Table 47. Parameters
Name P.Type Description Required Type Allowed values Default value
alertPriority Query none false java.lang.String all high,medium,low
startTime Query none false java.lang.Long all -none-
endTime Query none false java.lang.Long all -none-
Return type: javax.ws.rs.core.StreamingOutput

10.  /recentDrift
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.RecentDriftLocal

10.1. GET recentDrift/
リンクのコピー

Expand
Table 48. Parameters
Name P.Type Description Required Type Allowed values Default value
categories Query none false java.lang.String all -none-
snapshot Query none false java.lang.Integer all -none-
path Query none false java.lang.String all -none-
definition Query none false java.lang.String all -none-
startTime Query none false java.lang.Long all -none-
endTime Query none false java.lang.Long all -none-
Return type: javax.ws.rs.core.StreamingOutput

11.  /recentOperations
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.RecentOperationsLocal

11.1. GET recentOperations/
リンクのコピー

Expand
Table 49. Parameters
Name P.Type Description Required Type Allowed values Default value
status Query none false java.lang.String all inprogress,success,failure,canceled
startTime Query none false java.lang.Long all -none-
endTime Query none false java.lang.Long all -none-
Return type: javax.ws.rs.core.StreamingOutput

12.  /resource: Resource related
リンクのコピー

This endpoint deals with single resources, not groups
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.ResourceHandlerLocal

12.1. GET resource/{id}
リンクのコピー

Expand
Table 50. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource to retrieve true int all  
Return type: ResourceWithType
Expand
Table 51. Error Codes
Code Reason
404 If no resource with the passed id exists

12.2. GET resource/platforms
リンクのコピー

This method has no parameters
Return type: ResourceWithType

12.3. GET resource/{id}/hierarchy
リンクのコピー

Expand
Table 52. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource to start with true int all  
Return type: ResourceWithType
Expand
Table 53. Error Codes
Code Reason
404 If no resource with the passed id exists

12.4. GET resource/{id}/availability
リンクのコピー

Expand
Table 54. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource to query true int all  
Return type: org.rhq.enterprise.server.rest.domain.AvailabilityRest
Expand
Table 55. Error Codes
Code Reason
404 If no resource with the passed id exists

12.5. PUT resource/{id}/availability
リンクのコピー

Expand
Table 56. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource to update true int all  
-body- New Availability setting true org.rhq.enterprise.server.rest.domain.AvailabilityRest all   
Return type: void

12.6. GET resource/{id}/schedules
リンクのコピー

Expand
Table 57. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource to obtain the schedules for true int all  
type Query Limit by type false java.lang.String <empty>, all, metric, trait, measurement all
enabledOnly Query Limit by enabled schedules false boolean all true
name Query Limit by name false java.lang.String all  
Return type: MetricSchedule
Expand
Table 58. Error Codes
Code Reason
404 If no resource with the passed id exists

12.7. GET resource/{id}/children
リンクのコピー

Expand
Table 59. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource to get children true int all  
Return type: javax.ws.rs.core.Response
Expand
Table 60. Error Codes
Code Reason
404 If no resource with the passed id exists

12.8. GET resource/{id}/alerts
リンクのコピー

Expand
Table 61. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource to query true int all  
Return type: java.util.List<org.rhq.enterprise.server.rest.domain.Link>
Expand
Table 62. Error Codes
Code Reason
404 If no resource with the passed id exists

12.9. POST resource/platform/{name}
リンクのコピー

Expand
Table 63. Parameters
Name P.Type Description Required Type Allowed values Default value
name Path Name of the platform true java.lang.String all  
-body- Type of the platform false org.rhq.enterprise.server.rest.domain.StringValue Linux,Windows,... TODO   
Return type: javax.ws.rs.core.Response

12.10. POST resource/{name}
リンクのコピー

Expand
Table 64. Parameters
Name P.Type Description Required Type Allowed values Default value
name Path Name of the new resource true java.lang.String all  
-body- Name of the Resource tpye false org.rhq.enterprise.server.rest.domain.StringValue all   
plugin Query Name of the plugin providing the type false java.lang.String all  
parentId Query Id of the future parent to attach this to false int all  
Return type: javax.ws.rs.core.Response

13.  /status: Provide system status information
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.StatusHandlerLocal

13.1. GET status/
リンクのコピー

This method has no parameters
Return type: javax.ws.rs.core.Response

14.  /suspectMetrics
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.SuspectMetricLocal

14.1. GET suspectMetrics/
リンクのコピー

This method has no parameters
Return type: javax.ws.rs.core.StreamingOutput

15.  /user: API that deals with user related stuff
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.UserHandlerLocal

15.1. GET user/favorites/resource
リンクのコピー

This method has no parameters
Return type: java.util.List<org.rhq.enterprise.server.rest.domain.ResourceWithType>

15.2. PUT user/favorites/resource/{id}
リンクのコピー

Expand
Table 65. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource true int all  
Return type: void

15.3. DELETE user/favorites/resource/{id}
リンクのコピー

Expand
Table 66. Parameters
Name P.Type Description Required Type Allowed values Default value
id Path Id of the resource true int all  
Return type: void

16.  /alertDefinitions: The Alert definitions report
リンクのコピー

Defining class: org.rhq.enterprise.server.rest.reporting.AlertDefinitionLocal

16.1. GET alertDefinitions/
リンクのコピー

This method has no parameters
Return type: javax.ws.rs.core.StreamingOutput
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat