Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Discovery for IBM Cloud Platform

If your cloud resources are in an IBM cloud, create credentials that can access your IBM account.

FieldValue
NameUnique name of the IBM credentials to register with the instance.
OrderOrder \(sequence\) in which Discovery tries this credential as it attempts to log on to devices. The smaller the number, the higher in the list this credential appears. Establish credential order when using large numbers of credentials or when security locks out users after three failed login attempts. If all the credentials have the same order number \(or none\), the instance tries the credentials in a random order.
Softlayer API UserSoftlayer cloud user name.
Softlayer API KeySoftlayer API key.
Bluemix API KeyBluemix API key.

Data collected by Service Mapping during top-down discovery

To include discovered components into service instances, enable CI relationships used in tag-based discovery by Service Mapping. These CI relationships are available from the 1.0.68 release on the ServiceNow Store. For operational steps, see Tag-based discovery configuration.

Service Mapping uses tag-based discovery to create service instance maps including the Cloud components. The Service Mapping application comes with the following preconfigured CI relationships used for tag-based discovery. These CI relationships are available from the 1.0.68 release on the ServiceNow Store.

CIRelationshipCI
Configuration Item [cmdb_ci]Hosted on::HostsLogical Datacenter [cmdb_ci_logical_datacenter]
Logical Datacenter [cmdb_ci_logical_datacenter]Hosted on::HostsCloud Service Account [cmdb_ci_cloud_service_account]

IBM Cloud Discovery API list

CI AttributesIBM Constraints
object\_idname
dns\_domaindomain
namealias
short\_descriptiondisplay\_name
regionname
CI AttributesIBM Constraints
object_idid
short_descriptionlongName
namename
install_statusstatusId
CI AttributesIBM Constraints
object\_idid
short\_descriptiondescription
location\_group\_type\_idlocationGroupTypeId
namename
location\_group\_typelocationGroupType.name
CI AttributesIBM Constraints
object_idid
cpusmaxCpu/startCpus
memorymaxMemory
disks<not mapped>
disks_size<not mapped>
nics<not mapped>
terminated_on<not mapped>
statestatusId
termination_protection<not mapped>
short_descriptionnotes
namehostname
dns_domaindomain
fqdnfullyQualifiedDomainName
CI AttributesIBM Constraints
cmdb_ci_os_template 
image_type 
guest_os 
version 
offer 
OS Status 
root_device_type 
image_source 
credentials 
infuse_key 
update_host_name 
namename
object_idid
short_descriptiondescription
CI AttributesIBM Constraints
object_idid
finger_printfingerprint
created_datecreateDate
keykey
namelabel
modify_datemodifyDate
short_descriptionnotes
CI AttributesIBM Constraints
volume_idid
sizecapacityGb
size_bytescapacityGb
free_space<not mapped>
free_space_bytes<not mapped>
media_type<not mapped>
file_system<not mapped>
labelserviceResourceName
lun ( Logical Unit Number )<not mapped>
volume_container<not mapped>
state?
storage_typestorageTypeId
protected_by<not mapped>
share_count<not mapped>
sharableFALSE
deviceguestId
delete_on_termination<not mapped>
mapping_type<not mapped>
object_idid
vdisk_id<not mapped>
storage_typenasType
nameserviceResourceName
CI AttributesIBM Constraints
object_idid
capacitycapacityGb
is_encrypted 
volume_nameserviceResourceName
storage_server 
start_time 
state 
snapshotSizeBytessnapshotSizeBytes
CI AttributesIBM Constraints
state 
cidr<not_mapped>
is_externaltrue/false
netmask<not_mapped>
broadcast_address<not_mapped>
default_gateway<not_mapped>
is_shared<not_mapped>
is_dhcp_enabled<not_mapped>
scope<not_mapped>
max_ports<not_mapped>
terminated_on<not_mapped>
provided_contracts<not_mapped>
object_idid
access_port_vlanvlanNumber
<not_mapped>primarySubnetId
namevlanNumber
<not_mapped>accountId
CI AttributesIBM Constraints
subnet_masknetmask
cidrnetworkIdentifier +'/' + cidr
available_ip_countusableIpAddressCount
broadcast_addressbroadcastAddress
primary_dns<not mapped>
secondary_dns<not mapped>
tertiary_dns<not mapped>
is_dhcp_enabled<not mapped>
ipam_provider<not mapped>
domain_name<not mapped>
parent_domain_name<not mapped>
gatewaygateway
route_table_association_id<not mapped>
state<not mapped>
<not mapped>modifyDate
<not mapped>version
<not mapped>networkVlanId
<not mapped>isCustomerRoutable
object_idid
<not mapped>broadcastAddress
<not mapped>isCustomerOwned
<not mapped>sortOrder
<not mapped>networkIdentifier
<not mapped>totalIpAddresses
<not mapped>addressSpace
categorysubnetType
namenetworkIdentifier +'/' + cidr
CI AttributesIBM Constraints
region<not_mapped>
object_idid
intld<not_mapped>
tenant_name<not_mapped>
state<not_mapped>
<not_mapped>port
<not_mapped>description
<not_mapped>createDate
<not_mapped>modifyDate
namename
short_descriptiondescription
CI AttributesIBM Constraints
createdcreateDate
directiondirection
ethertypeethertype
object_idid
updatedmodifyDate
portRangeMaxportRangeMax
portRangeMinportRangeMin
protocolprotocol
remoteGroupIdremoteGroupId
securityGroupIdsecurityGroupId
CI AttributesIBM Constraints
state"operatingStatus"
canonical_hosted_zone_id 
canonical_hosted_zone_name 
dns_nameaddress
snat_ip_address 
vlan 
app_code 
component_code 
env_code 
ip_address_pool 
 "accountId"
 "address"
 "createDate"
 "description"
object_id"id"
 isPublic
 "locationId"
 "modifyDate"
name"name"
 "provisioningStatus"
 "useSystemPublicIpPool"
 "uuid"
CI AttributesIBM Constraints
cmdb_ci_lb_service 
pool 
portprotocolPort
last_port 
input_url 
host_name 
back_end_port 
front_end_portprotocolPort
listener_protocolprotocol
server_port 
server_protocol 
traffic_domain 
ssl_certificate_id 
object_idid
hit_count 
CI AttributesIBM Constraints
check_interval_secinterval
max_retriesmaxRetries
monitor_typemonitorType
provisioning_statusprovisioningStatus
timeout_sectimeout
object_idid
CI AttributesIBM Constraints
 createDate
load_balancing_methodloadBalancingAlgorithm
 modifyDate
 protocol
 protocolPort
pool_statusprovisioningStatus
object_iduuid
CI AttributesIBM Constraints
server_idaddress
object_idid
 createDate
 modifyDate
 provisioningStatus
 uuid
 weight
CI AttributesIBM Constraints
namename
need to see what is this?quota_id
 tags
object_idid
CI AttributesIBM Constraints
namename
urlurl
billing_enabledbilling_enabled
quota_definition_urlquota_definition_url
spaces_urlspaces_url
guidguid
statusstatus
object_idmetadata.guid
CI AttributesIBM Constraints
namename
urlurl
object_idmetadata.guid
allow_sshallow_ssh
guidmetadata.guid