CMDBGroupAPI: Bereichsbezogen
Die CMDBGroupAPI bietet Methoden zum Ausführen von Aktionen für Configuration Management Database (CMDB) -Gruppen.
CMDBGroupAPI -Objekt einfügen. Beispiel:var response = sn_cmdbgroup.CMDBGroupAPI.getManualCIList(groupSysId, false);Für den Zugriff auf diese API benötigen Sie die Rolle itil oder asset.
CMDBGroupAPI – getAllCI(String groupId, Boolean erfordernCompleteSet, Boolesch erfordernAllQueryNodesCis)
Gibt alle Configuration Items (CIs) für die angegebene Gruppe zurück. Die Ergebnisse umfassen alle manuellen CIs und die Liste der CIs aus der gespeicherten Abfrage des Abfragegenerators.
| Name | Typ | Beschreibung |
|---|---|---|
| groupId | Zeichenfolge | Sys_id der Configuration Management Database (CMDB)-Gruppe. |
| requireCompleteSet | Boolean | Optional, muss jedoch übergeben werden, wenn requireAllQueryNodesCis übergeben wird. Kennzeichnung, die angibt, ob eine leere Zeichenfolge zurückgegeben wird, wenn CIs durch Einschränkungen der Zugriffssteuerungsliste (Access Control List, ACL) herausgefiltert werden. Gültige Werte:
Standardwert: false |
| erfordernAlleAbfrageKnotenCis | Boolean | Optional. Kennzeichnung, die angibt, ob CIs aus allen CMDB-Klassen der Abfrage zurückgegeben werden sollen. Gültige Werte:
Standardwert: false |
| Typ | Beschreibung |
|---|---|
| Fehler | Liste der Fehler für einen fehlgeschlagenen Vorgang. Datentyp: Array |
| Fehler.Fehler | Fehlername. Mögliche Werte:
Datentyp: Zeichenfolge |
| Fehler.Meldung | Kurze Beschreibung der Fehlermeldung. Datentyp: Zeichenfolge |
| ID-Liste | Liste der sys_ids des CMDB-CI. Datentyp: Array |
| partielleCIListDueToACLFlag | Kennzeichnung, die angibt, ob die Liste der zurückgegebenen CIs aufgrund von ACL-Einschränkungen unvollständig ist. Hinweis:
Dies ist keine Fehlerbedingung, und es werden keine entsprechenden Fehlerinformationen zurückgegeben. Datentyp: Boolesch Gültige Werte:
|
| Ergebnis | Kennzeichnung, die angibt, ob die Methode erfolgreich abgeschlossen wurde. Mögliche Werte:
|
// Script example:
var getAllCIFunc = function(groupSysId) {
var parser = new JSONParser();
var response = sn_cmdbgroup.CMDBGroupAPI.getAllCI(groupSysId, false);
var parsed = parser.parse(response);
if (parsed.result) {
gs.info("succeed to retrieve ci list: " + parsed.idList);
} else {
gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
}
}
var groupExists = "d0d2d25113152200eef2dd828144b0e4";
var groupContainsInvalidSavedQuery = "e685a2c3d7012200de92a5f75e610387";
getAllCIFunc(groupExists);
getAllCIFunc(groupContainsInvalidSavedQuery);
Ausgabe:
// Successful response
{
'result':true,
'partialCIListDueToACLFlag': false,
'idList':[
'3a5dd3dbc0a8ce0100655f1ec66ed42c',
'6b43105c37301000deeabfc8bcbe5db2'
]
}
// Error response
{
'result':false,
'errors':[
{
'message':'Group does not exist',
'error':'GROUP_SYS_ID_IS_NOT_FOUND'
}
],
'partialCIListDueToACLFlag':false,
'idList':[]
}
CMDBGroupAPI - getAllCIFromQueryBuilder(Zeichenfolge groupId, Boolesches erfordernCompleteSet, Boolesches erfordernAllQueryNodesCis)
Gibt alle Configuration Items (CIs) zurück, die von den Abfrage-IDs aller gespeicherten Abfragegeneratoren für die angegebene Gruppe zurückgegeben wurden.
| Name | Typ | Beschreibung |
|---|---|---|
| groupId | Zeichenfolge | Sys_id der Configuration Management Database (CMDB)-Gruppe. |
| requireCompleteSet | Boolean | Optional, muss jedoch übergeben werden, wenn requireAllQueryNodesCis übergeben wird. Kennzeichnung, die angibt, ob eine leere Zeichenfolge zurückgegeben wird, wenn CIs durch Einschränkungen der Zugriffssteuerungsliste (Access Control List, ACL) herausgefiltert werden. Gültige Werte:
Standardwert: false |
| erfordernAlleAbfrageKnotenCis | Boolean | Optional. Kennzeichnung, die angibt, ob CIs aus allen CMDB-Klassen der Abfrage zurückgegeben werden sollen. Gültige Werte:
Standardwert: false |
| Typ | Beschreibung |
|---|---|
| Fehler | Liste der Fehler für einen fehlgeschlagenen Vorgang. Datentyp: Array |
| Fehler.Fehler | Fehlername. Mögliche Werte:
Datentyp: Zeichenfolge |
| Fehler.Meldung | Kurze Beschreibung der Fehlermeldung. Datentyp: Zeichenfolge |
| ID-Liste | Liste der sys_ids des CMDB-CI. Datentyp: Array |
| partielleCIListDueToACLFlag | Kennzeichnung, die angibt, ob die Liste der zurückgegebenen CIs aufgrund von ACL-Einschränkungen unvollständig ist. Hinweis:
Dies ist keine Fehlerbedingung, und es werden keine entsprechenden Fehlerinformationen zurückgegeben. Datentyp: Boolesch Gültige Werte:
|
| Ergebnis | Kennzeichnung, die angibt, ob die Methode erfolgreich abgeschlossen wurde. Mögliche Werte:
|
// Script example:
var getAllCIFromQueryBuilderFunc = function(groupSysId) {
var parser = new JSONParser();
var response = sn_cmdbgroup.CMDBGroupAPI.getAllCIFromQueryBuilder(groupSysId, false);
var parsed = parser.parse(response);
if (parsed.result) {
gs.info("succeed to retrieve ci list: " + parsed.idList);
} else {
gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
}
}
var groupExists = "d0d2d25113152200eef2dd828144b0e4";
var groupContainsInvalidSavedQuery = "e685a2c3d7012200de92a5f75e610387";
getAllCIFromQueryBuilderFunc(groupExists);
getAllCIFromQueryBuilderFunc(groupContainsInvalidSavedQuery);
Ausgabe:
// Successful response
{
'result':true,
'partialCIListDueToACLFlag': false,
'idList':[
'3a5dd3dbc0a8ce0100655f1ec66ed42c',
'6b43105c37301000deeabfc8bcbe5db2'
]
}
// Error response
{
'result':false,
'errors':[
{'message':'Group does not exist',
'error':'GROUP_SYS_ID_IS_NOT_FOUND'}
],
'partialCIListDueToACLFlag':false,
'idList':[]
}
CMDBGroupAPI – getManualCIList(String groupId, Boolean requireCompleteSet)
Gibt die manuelle CI-Liste der CMDB-Gruppe zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| groupId | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| requireCompleteSet | Boolean | Bei „true“ wird eine Fehlerzeichenfolge zurückgegeben, wenn CIs durch ACL-Beschränkungen herausgefiltert werden. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format Wobei
Wenn nicht erfolgreich, wird einer der Fehler GROUP_SYS_ID_IS_NOT_FOUND, GROUP_SYS_ID_IS_EMPTY, FAIL_TO_INSERT_GROUP_CI_PAIR, FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR, CI_CAN_NOT_FOUND, SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT ausgegeben. |
// Script example for requireCompleteSet being false:
var getManualCIList = function(groupSysId) {
var parser = new JSONParser();
var response = sn_cmdbgroup.CMDBGroupAPI.getManualCIList(groupSysId, false);
var parsed = parser.parse(response);
if (parsed.result) {
gs.info("succeed to retrieve ci list: " + parsed.idList);
} else {
gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
}
}
// create a group in cmdb_group, and add CIs to this group in Edit Manual CI form
var groupExists = "d0d2d25113152200eef2dd828144b0e4";
// use a non-exist group
var groupDoesNotExists = "d0d2d25113152200eef2dd828144b0e4111";
getManualCIList(groupExists);
getManualCIList(groupDoesNotExists);
Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)
succeed to retrieve ci
list: 6b43105c37301000deeabfc8bcbe5db2,2dfd7c8437201000deeabfc8bcbe5d56
fail to retrieve list, errors:
[{"message":"Group does not exist","error":"GROUP_SYS_ID_IS_NOT_FOUND"}]
// Script example for requireCompleteSet being true
var getManualCIList = function(groupSysId) {
var parser = new JSONParser();
var response = sn_cmdbgroup.CMDBGroupAPI.getManualCIList(groupSysId, true);
var parsed = parser.parse(response);
if (parsed.result) {
gs.info("succeed to retrieve ci list: " + parsed.idList);
} else {
gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
}
}
// create a group in cmdb_group, and add CIs to this group in Edit Manual CI form
var groupExists = "d0d2d25113152200eef2dd828144b0e4";
getManualCIList(groupExists);
Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)
fail to retrieve list, errors:
[{"message":"Some CI(s) not visible due to security constraint",
"error":"SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT"}]
CMDBGroupAPI – getSavedQueryIdList(String groupId, Boolean requireCompleteSet)
Gibt die Abfrage-IDs des Abfragegenerators für die angegebene CMDB-Gruppe zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| groupId | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| requireCompleteSet | Boolean | Bei „true“ wird eine leere Zeichenfolge zurückgegeben, wenn CIs durch ACL-Beschränkungen herausgefiltert werden. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format Wobei
Wenn nicht erfolgreich, wird einer der Fehler GROUP_SYS_ID_IS_NOT_FOUND, GROUP_SYS_ID_IS_EMPTY, FAIL_TO_INSERT_GROUP_CI_PAIR, FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR, CI_CAN_NOT_FOUND, SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT ausgegeben. |
// Script example:
var getSavedQueryIdList = function(groupSysId) {
var parser = new JSONParser();
var response = sn_cmdbgroup.CMDBGroupAPI.getSavedQueryIdList(groupSysId, false);
var parsed = parser.parse(response);
if (parsed.result) {
gs.info("succeed to retrieve saved query id list: " + parsed.idList);
} else {
gs.info("fail to retrieve list, errors: " + JSON.stringify(parsed.errors));
}
}
var groupExists = "d0d2d25113152200eef2dd828144b0e4";
var groupDoesNotExists = "d0d2d25113152200eef2dd828144b0e4111";
getSavedQueryIdList(groupExists);
getSavedQueryIdList(groupDoesNotExists);
Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)
succeed to retrieve saved query id list: 5d498532d7c12200de92a5f75e6103ce
fail to retrieve list, errors:
[{"message":"Group does not exist","error":"GROUP_SYS_ID_IS_NOT_FOUND"}]
CMDBGroupAPI – setManualCIList(String groupId, String ciSysIds)
Legt die manuelle CI-Liste für die angegebene Gruppe fest. Die vorhandene manuelle CI-Liste wird überschrieben. CI-System-IDs, die nicht in der Tabelle cmdb_ci enthalten sind, werden ignoriert.
| Name | Typ | Beschreibung |
|---|---|---|
| groupId | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| ciSysIds | Zeichenfolge | Durch Kommas getrennte Liste von CI-sysIds |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format Wobei
Wenn nicht erfolgreich, wird einer der Fehler GROUP_SYS_ID_IS_NOT_FOUND, GROUP_SYS_ID_IS_EMPTY, FAIL_TO_INSERT_GROUP_CI_PAIR, FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR, CI_CAN_NOT_FOUND, SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT ausgegeben. |
// Script example:
var setManualCIListFunc = function(groupSysId, manualCIList) {
var parser = new JSONParser();
var response = sn_cmdbgroup.CMDBGroupAPI.setManualCIList(groupSysId, manualCIList);
var parsed = parser.parse(response);
if (parsed.result) {
gs.info("succeed to set manual ci list");
} else {
gs.info("fail to set manual ci list, errors: " + JSON.stringify(parsed.errors));
}
}
var group = "d0d2d25113152200eef2dd828144b0e4";
var groupDoesNotExist = "1234";
var manualCIList = "b4fd7c8437201000deeabfc8bcbe5dc1, affd3c8437201000deeabfc8bcbe5dc3";
setManualCIListFunc(group, manualCIList);
setManualCIListFunc(groupDoesNotExist, manualCIList);
Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)
succeed to set manual ci list
fail to set manual ci list, errors: [{"message":"Group does not exist","error":
"GROUP_SYS_ID_IS_NOT_FOUND"}]
CMDBGroupAPI – setSavedQueryIdList(String groupId, String queryIds)
Legt die gespeicherte Abfrage-ID-Liste für die angegebene Gruppe fest. Die vorhandene Abfrage-ID-Liste wird überschrieben. Abfrage-sysIds, die nicht in der Tabelle qb_saved_query gefunden wurden, werden ignoriert.
| Name | Typ | Beschreibung |
|---|---|---|
| groupId | Zeichenfolge | Die sysId der CMDB-Gruppe. |
| queryIds | Zeichenfolge | Durch Kommas getrennte Listen gespeicherter Abfrage-sysIds. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Eine JSON-formatierte Zeichenfolge im Format Wobei
Wenn nicht erfolgreich, wird einer der Fehler GROUP_SYS_ID_IS_NOT_FOUND, GROUP_SYS_ID_IS_EMPTY, FAIL_TO_INSERT_GROUP_CI_PAIR, FAIL_TO_INSERT_GROUP_QUERY_ID_PAIR, CI_CAN_NOT_FOUND, SAVED_QUERY_ID_NOT_FOUND, ERROR_DURING_QUERY_BUILDER_PROCESS_QUERY, TIMEOUT_DURING_QUERY_BUILDER_PROCESS_QUERY, NOT_COMPLETE_DURING_QUERY_BUILDER_PROCESS_QUERY, MAX_LIMIT_DURING_QUERY_BUILDER_PROCESS_QUERY, GROUP_API_TIMEOUT, EXCEPTION_FROM_EXECUTE_QUERY, SOME_CI_NOT_VISIBLE_DUE_TO_SECURITY_CONSTRAINT ausgegeben. |
// Script example:
var setSavedQueryIdListFunc = function(groupSysId, queryIdList) {
var parser = new JSONParser();
var response = sn_cmdbgroup.CMDBGroupAPI.setSavedQueryIdList(groupSysId, queryIdList);
var parsed = parser.parse(response);
if (parsed.result) {
gs.info("succeed to set saved query id list");
} else {
gs.info("fail to set saved query id list, errors: " + JSON.stringify(parsed.errors));
}
}
var group = "d0d2d25113152200eef2dd828144b0e4";
var savedQueryBuilderIdList = "394585fed7812200de92a5f75e6103e8";
var savedQueryBuilderIdNotExistList = "b4fd7c8437201000deeabfc8bcbe5dc1,
affd3c8437201000deeabfc8bcbe5dc3";
setSavedQueryIdListFunc(group, savedQueryBuilderIdList);
setSavedQueryIdListFunc(group, savedQueryBuilderIdNotExistList);
Ausgabe: (Zeilenumbrüche zur Formatierung hinzugefügt.)
succeed to set saved query id list
fail to set saved query id list, errors: [{"message":
"Saved query id(b4fd7c8437201000deeabfc8bcbe5dc1) is not found for
group(d0d2d25113152200eef2dd828144b0e4)","error":
"SAVED_QUERY_ID_NOT_FOUND"},{"message":
"Saved query id(affd3c8437201000deeabfc8bcbe5dc3) is not found for
group(d0d2d25113152200eef2dd828144b0e4)","error":"SAVED_QUERY_ID_NOT_FOUND"}]