ConfigurationItem Object
Configuration item
Root Connection
All ConfigurationItem objects of an account are accessible by a query on the root connection configurationItems
.
Such a query will return a ConfigurationItemConnection!
, which contains the ConfigurationItem objects in its
nodes
field.
ConfigurationItemConnection!
)
Root connection for retrieving ConfigurationItem records.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
filter |
ConfigurationItemFilter
|
Filter to determine which ConfigurationItem records are returned. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
order |
[ConfigurationItemOrder!]
|
Order of the ConfigurationItem records returned. |
view |
ConfigurationItemView
|
View name. The default value is |
Fields
The fields in this section list which values can be retrieved when querying ConfigurationItem records.
Account
)
The account this record belongs to.
[String!]
)
Alternate names the configuration item is also known by.
String
)
Number under which the configuration item has been registered in the financial application (e.g. SAP).
ISO8601Timestamp
)
The date and time at which the record was created.
[CustomField!]
)
Values of custom fields.
ISO8601Date
)
The date at which the support for this configuration item ends.
Organization
)
The internal organization which budget is used to pay for the configuration item. If the CI is leased or rented, the organization that pays the lease or rent is selected in this field. When creating a new CI and a value is not specified for this field, it is set to the financial owner of the CI's product.
ID!
)
Unique identifier of the record.
ISO8601Date
)
The date on which the expense for the configuration item (CI) was incurred or, if the CI is depreciated over time, the date on which the depreciation was started. This is typically the invoice date.
String
)
The label that is attached to the configuration item (CI). A label is automatically generated using the same prefix of other CIs of the same product category, followed by the next available number as the suffix.
ISO8601Timestamp
)
The date and time at which the configuration item was last seen.
ISO8601Date
)
The date through which the temporary software license certificate is valid. The license certificate expires at the end of this day.
CiLicenseType
)
The type of license that the license certificate covers.
String
)
The name or number of the room in which the CI is located, if it concerns a hardware CI.
String
)
The name of the configuration item (CI). When creating a new CI and a value is not specified for this field, it is set to the name of the CI's product.
Int
)
The total number of processor cores that are installed in the server.
Int
)
The number of licenses that the license certificate covers.
Int
)
The number of processors that are installed in the server.
ConfigurationItem
)
The (software) configuration item representing the operating system of this configuration item.
String
)
The hyperlink to the image file for the record.
Product
)
Related product.
Int
)
The amount of RAM (in GB) of this configuration item.
Recurrence
)
Recurrence for maintenance of the configuration item.
String
)
Any additional information about the configuration item that might prove useful. When creating a new CI and a value is not specified for this field, it is set to the remarks of the CI's product.
ProductCategoryRuleSet
)
The Rule set field is automatically set to the rule set of the product
category, except when the CI is a license certificate, in which case the rule
set is license_certificate
.
String
)
Serial number of the configuration item. The concatenation of product
's'
brand
and serialNr
must be unique within a R-Service account.
Service
)
Which service instance(s) the configuration item is, or will be, a part of. When creating a new CI and a value is not specified for this field, it is set to the service of the CI's product.
Site
)
Where the CI is located, if it concerns a hardware CI.
Boolean
)
true
for license certificates that may only be used at one or more specific locations.
String
)
An identifier for the client application submitting the resource or the name of an external system.
String
)
The unique identifier of the resource in an external system.
CiStatus
)
The appropriate status for the configuration item (CI).
Organization
)
The supplier from which the configuration item (CI) has been obtained. When creating a new CI and a value is not specified for this field, it is set to the supplier of the CI's product.
Account
)
The account of the team that supports this configuration item.
Team
)
The team responsible for supporting the configuration item and maintaining its information in the configuration management database (CMDB). When creating a new CI and a value is not specified for this field, it is set to the support team of the CI's product. Optional when status of CI equals "Removed", required otherwise.
String
)
System identifier of the configuration item.
Boolean
)
true
for license certificates that are not valid indefinitely.
ISO8601Timestamp
)
The date and time of the last update of the record. If the record has no updates it contains the createdAt
value.
ISO8601Date
)
The date through which the warranty coverage for the configuration item is valid. The warranty expires at the end of this day.
Person
)
The person who will be responsible for coordinating the workflows that will be generated automatically in accordance with the recurrence schedule.
WorkflowTemplate
)
The workflow template that is used to periodically maintain the configuration item.
Connections
The connection fields in this section allow (paged) access to objects related to a specific ConfigurationItem record.
The actual objects will be in the nodes
field of the connection.
ConfigurationItemRelationConnection
)
Relations to other configuration items.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
ContractConnection
)
All contracts of this configuration item.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
AttachmentConnection
)
Inline images linked to one of the custom fields.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
InvoiceConnection
)
Invoices associated with this object.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
SiteConnection
)
Sites at which the software that is covered by the license certificate may be used.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
ProblemConnection
)
All problems of this configuration item.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
AttachmentConnection
)
Files and inline images linked to the Remarks field.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
RequestConnection
)
All requests of this configuration item.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
ServiceInstanceConnection
)
All service instances of this configuration item.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
PersonConnection
)
All users of this configuration item.
Argument | Type | Description |
---|---|---|
after |
String
|
Returns the elements in the list that come after the specified cursor. |
before |
String
|
Returns the elements in the list that come before the specified cursor. |
first |
Int
|
Returns the first n elements from the list. |
last |
Int
|
Returns the last n elements from the list. |
Implements
ConfigurationItem implements the following interfaces. This means that fragments defined on these interfaces may be used in queries returning a ConfigurationItem.