Skip to content
R-Service R-Service
RR Tech Service Management Developer Guide

Service Instances - Configuration Items API

List all configuration items of a service instance

Section titled “List all configuration items of a service instance”

List all configuration items of a service instance with a specific ID.

GET /service_instances/:id/cis

Response

Section titled “Response”
Status: 200 OK
[
  {
    "name": "Adobe Reader 9.1.0",
    "label": "Adobe Reader 9.1.0",
    "created_at": "2016-03-14T03:11:22-06:00",
    "sourceID": null,
    "updated_at": "2016-03-14T03:11:22-06:00",
    "service": {
      "name": "Personal Computing",
      "id": 22,
      "provider": {
        "name": "Widget Data Center, Internal IT",
        "id": 32
      }
    },
    "support_team": {
      "name": "End-User Support, Houston",
      "id": 9
    },
    "id": 711,
    "product": {
      "name": "Adobe Reader",
      "brand": "Adobe",
      "category": "software/browser_viewer_application",
      "id": 33
    },
    "status": "in_production",
    "software": true,
    "rule_set": "software"
  },
  "..."
]

The response contains these fields by default.

Predefined Filters

Section titled “Predefined Filters”

The following predefined filters are available:

  • /service_instances/:id/cis/active : List all active configuration items of a service instance with a specific ID
  • /service_instances/:id/cis/inactive : List all inactive configuration items of a service instance with a specific ID

Filtering

Section titled “Filtering”

Filtering is available for the following fields :

status rule_set

Add a configuration item to a service instance

Section titled “Add a configuration item to a service instance”

Add a link between a service instance with a specific ID and a configuration item with a specific ID.

POST /service_instances/:id/cis/:ci_id

Response

Section titled “Response”
Status: 200 OK
{}

Remove a configuration item from a service instance

Section titled “Remove a configuration item from a service instance”

Remove the link between a service instance with a specific ID and a configuration item with a specific ID.

DELETE /service_instances/:id/cis/:ci_id

Response

Section titled “Response”
Status: 204 No Content

Remove all configuration items from a service instance

Section titled “Remove all configuration items from a service instance”

Remove all links between a service instance with a specific ID and its configuration items.

DELETE /service_instances/:id/cis

Response

Section titled “Response”
Status: 204 No Content