Service Instances - Configuration Items API

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

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

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

Filtering is available for the following fields:

status rule_set

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

status: 200 OK

{}

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

status: 204 No Content

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

status: 204 No Content