Reverse Update of Consumable Resource
post
/service/updateResource
Updates existing resources of the services with new resources provided in the input. The services to be updated can be filtered using the
criteria.
The includeAll query parameter is required to update all services, including CFS and RFS. The default includes only CFS.
The service filtering criteria can include these properties:
- id
- filterAssignAndRefState
- filterServiceState
- filterConfigurationState
Request
Query Parameters
-
depth: integer
Minimum Value:
0
Maximum Value:10
The depth of the expansion.Default Value:0
-
expand: string
The additional details to include in the response.
-
fields: string
The fields to include in the response.
-
filterAssignAndRefState: string
Filter on assignment and reference states with comma separated values. Valid values are ASSIGNED,PENDING_ASSIGN,REFERENCED,PENDING_REFERENCED. Ex:If ASSIGNED,REFERENCED is provided in filter then only resources with these assignment states are updated with new resources. Default includes all above mentioned states.
-
filterConfigurationState: string
Filter on configuration state with comma separated values. Valid values are COMPLETED, IN_PROGRESS, DESIGNED, ISSUED. Ex:If COMPLETED is provided in filter then only latest service configuration with these states are considered for updates.
-
filterServiceState: string
Filter on service states with comma separated values. Valid values are ACTIVE, DESIGNED, INACTIVE. Ex:If ACTIVE is provided in filter then only services with these states are considered for updates. By default updates happen only for ACTIVE,DESIGNED,INACTIVE. Services with states TERMINATED,CANCELLED,PENDING_CANCEL, PENDING_DISCONNECT and CANCELPENDINGDISCONNECT are not considered for updates.
-
id: string
Optional Service ID's , comma separated values, on which resource updates to be made.
Supported Media Types
- application/json
Nested Schema : UpdateConsumableResource
Type:
Show Source
object
-
entityClass: string
Allowed Values:
[ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicPlace", "GeographicLocation", "GeographicSite", "GeographicAddress", "GeographicAddressRange", "PropertyAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "NetworkEdge", "NetworkNode", "NetworkEntityCode", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "PipeTerminationPoint", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
The list of valid values for an entity class. -
newResourceId: string
-
oldResourceId: string
Response
Supported Media Types
- application/json
200 Response
The services were updated successfully.
Nested Schema : schema
Type:
object
Service Class.
Show Source
-
businessInteraction: object
BusinessInteractionRef
-
category: string
Indicates if it is customer facing or resource facing service.
-
description: string
A free-text description for the service.
-
effectiveDate: string
(date-time)
The date and time when the service changes goes to activate.
-
endDate: string
(date-time)
The date and time when the service is no longer effective.
-
externalIdentity: object
ExternalIdentity
An external identity.
-
hasStarted: boolean
Read Only:
true
Flag indicates that service is started. -
href: string
Read Only:
true
The URI for the service class. -
id: string
Read Only:
true
The ID of the service. -
isServiceEnabled: boolean
Read Only:
true
If FALSE, this particular Service has NOT been enabled for use -
name: string
The name of the service.
-
place: array
place
The list of associated geographic places, list of assigned/referenced geographic places, list of associated places on supported resources.
- relatedParty: array relatedParty
-
serviceCharacteristic: array
serviceCharacteristic
A list of characteristics that characterize this service (ServiceCharacteristic [*])
-
serviceDate: string
(date-time)
Read Only:
true
Date and time when the service was created (whatever its status). -
serviceOrderItem: array
serviceOrderItem
A list of related service order items (RelatedServiceOrderItem [*]). A list of service order items related to this service.
-
serviceRelationship: array
serviceRelationship
A list of service relationships (ServiceRelationship [*]). Describes links with other service(s) in the inventory (useful for describing relies-on, relies-from between CFS for example).
-
serviceSpecification: object
Specification
A specification.
-
serviceType: string
The business type of the service.
-
startDate: string
(date-time)
The date and time when the service is started.
-
state: string
Allowed Values:
[ "designed", "inactive", "active", "terminated", "pendingCancel", "cancelled", "pendingDisconnect", "cancelPendingDisconnect" ]
Valid values for the lifecycle state of the service. -
supportingResource: array
supportingResource
A list of supporting resources (SupportingResource [*]).For CFS list includes all the supporting resources of RFS.
-
supportingService: array
supportingService
A list of supporting services (SupportingService [*]). A collection of services that support this service (bundling, link CFS to RFS).
Nested Schema : BusinessInteractionRef
Type:
Show Source
object
-
id: string
The id of Business Interaction
-
state: string
The state of Business Interaction
Nested Schema : ExternalIdentity
Type:
object
An external identity.
Show Source
-
externalArrangement: string
Allowed Values:
[ "LEASED_IN", "FEDERATED", "LEASED_OUT", "SHARED" ]
The type of federation model between UIM and the external party for the given entity. -
externalManagementDomain: string
The external system, domain name, party, or participant in a federation solution.
-
externalName: string
The business-meaningful name of the business entity.
-
externalObjectId: string
The ID for a business entity.
Nested Schema : place
Type:
array
The list of associated geographic places, list of assigned/referenced geographic places, list of associated places on supported resources.
Show Source
-
Array of:
PlaceServiceRef
The place reference on a service.
Nested Schema : serviceCharacteristic
Type:
array
A list of characteristics that characterize this service (ServiceCharacteristic [*])
Show Source
-
Array of:
ServiceCharacteristic
The service characteristic details.
Nested Schema : serviceOrderItem
Type:
array
A list of related service order items (RelatedServiceOrderItem [*]). A list of service order items related to this service.
Show Source
-
Array of:
object RelatedServiceOrderItem
The service order item which triggered service creation/change/termination.
Nested Schema : serviceRelationship
Type:
array
A list of service relationships (ServiceRelationship [*]). Describes links with other service(s) in the inventory (useful for describing relies-on, relies-from between CFS for example).
Show Source
-
Array of:
object ServiceRelationship
Describes links with services of the same category (useful for bundled services).
Nested Schema : Specification
Type:
object
A specification.
Show Source
-
autoGenId: boolean
The boolean value to indicate if id has to be auto-generated or entered manually by user.
-
characteristics: array
characteristics
List of characteristics including hard attributes defined for the specification. Currently characteristics will be displayed only for Network/Pipe/PL/LD/PD/Equipment required for NPD. Only available hard attributes as per design studio layout are displayed.
-
description: string
Details about the specification.
-
displayName: string
The display name of the specification.
-
endDate: string
(date-time)
The date and time when the specification ends.
-
entityType: string
Allowed Values:
[ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicPlace", "GeographicLocation", "GeographicSite", "GeographicAddress", "GeographicAddressRange", "PropertyAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "NetworkEdge", "NetworkNode", "NetworkEntityCode", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "PipeTerminationPoint", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
The list of valid values for an entity class. -
href: string
(uri)
The URI for the specification.
-
id(required): string
The ID of the specification, which is the same as the name of the specification.
-
name: string
The name of the specification.
-
pageEditLayout: object
PageLayout
Layout information for Create and Edit Pages
-
startDate: string
(date-time)
The date and time when the specification starts.
-
version: string
The version of the specification, which is always 1.
Nested Schema : supportingResource
Type:
array
A list of supporting resources (SupportingResource [*]).For CFS list includes all the supporting resources of RFS.
Show Source
-
Array of:
ResourceServiceRef
The resource reference on a service.
Nested Schema : supportingService
Type:
array
A list of supporting services (SupportingService [*]). A collection of services that support this service (bundling, link CFS to RFS).
Show Source
-
Array of:
object schema
Service Class.
Nested Schema : PlaceServiceRef
The place reference on a service.
Match All
The place reference on a service.
The place reference on a service.
Show Source
-
object
PlaceRef
A place to associate with the resource/service.
-
object
PlaceServiceRef-allOf[1]
Nested Schema : PlaceRef
Type:
object
A place to associate with the resource/service.
Show Source
-
@referredType: string
Allowed Values:
[ "GeographicAddress", "GeographicLocation", "GeographicSite", "PropertyLocation", "NetworkEntityCode" ]
The list of valid values for place referred type. -
href: string
(uri)
The URI for the place.
-
id: string
The ID of the place.
-
name: string
The name of the place.
-
referrerRole: string
The role of the associated resource.
-
role: string
The role of the place.
Nested Schema : PlaceServiceRef-allOf[1]
Type:
Show Source
object
-
assignmentState: string
Allowed Values:
[ "PENDING_ASSIGN", "ASSIGNED", "PENDING_UNASSIGN", "UNASSIGNED", "DISCONNECTED", "TRANSITIONAL", "PORTED" ]
The list of valid values for assignment state. -
configItemDisplayName: string
The config item display name of the place which is editable from UI.
-
configItemId: string
The config item id of the place.
-
configItemName: string
The config item name of the place.
-
consumerName: string
The name of the service consumer.
-
latitude: string
Latitude of the place.
-
longitude: string
Longitude of the place.
-
placeCharacteristic: array
placeCharacteristic
The list of characteristics for the place.
-
placeSpecification: object
Specification
A specification.
-
referenceState: string
Allowed Values:
[ "PENDING_REFERENCE", "REFERENCED", "PENDING_UNREFERENCE", "UNREFERENCED" ]
The list of valid values for reference state. -
referenceType: string
Allowed Values:
[ "Association", "Assignment", "Reference", "ResourceNetworkLocation", "ResourceAssociation" ]
Valid values for the list of supported reference types. -
resourceName: string
The name of the resource on which place is associated. This will be populated when ReferenceType is set to 'ResourceNetworkLocation' or 'ResourceAssociation'.
Nested Schema : placeCharacteristic
Type:
array
The list of characteristics for the place.
Show Source
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
Nested Schema : Characteristic
Type:
object
A characteristic of an object or entity represented by a name-value pair.
Show Source
-
@schemaLocation: string
(uri)
The URI for the JSON Schema file that defines additional attributes and relationships.
-
@type: string
The entity type of the object. This is useful for EntityLink characters and when the value is set with an actual object and the valueType is an object.
-
code: string
The enumeration code in case of enum type characteristics.
-
displayName: string
The display label of the charatcteristic.
-
name(required): string
The name of the characteristic.
-
value(required): object
value
The value of the characteristic.
-
valueType: string
Allowed Values:
[ "ALPHANUMERIC", "NUMERIC", "BOOLEAN", "DATE", "OBJECT", "URL" ]
The data type for the characteristics's value.
Nested Schema : value
Type:
object
The value of the characteristic.
Nested Schema : RelatedPartyServiceRef
The party reference on a service.
Match All
The party reference on a service.
The party reference on a service.
Show Source
-
object
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
-
object
RelatedPartyServiceRef-allOf[1]
Nested Schema : RelatedPartyRef
Type:
object
A related party, which defines a party or party role linked to a specific entity.
Show Source
-
@referredType: string
Concrete Type of the Party, in case of dis-ambiguity. Default is 'Party'.
-
href: string
(uri)
The URI for the related party.
-
id: string
The ID of the related party.
-
name: string
The name of the related party.
-
role: string
The role of the related party.
Nested Schema : RelatedPartyServiceRef-allOf[1]
Type:
Show Source
object
-
configItemDisplayName: string
The config item display name of the party which is editable from UI.
-
configItemId: string
The config item id of the party.
-
configItemName: string
The config item name of the party.
-
consumerName: string
The name of the service consumer.
-
partyCharacteristic: array
partyCharacteristic
The list of characteristics for the party.
-
partySpecification: object
Specification
A specification.
-
referenceState: string
Allowed Values:
[ "PENDING_REFERENCE", "REFERENCED", "PENDING_UNREFERENCE", "UNREFERENCED" ]
The list of valid values for reference state. -
referenceType: string
Allowed Values:
[ "Association", "Assignment", "Reference", "ResourceNetworkLocation", "ResourceAssociation" ]
Valid values for the list of supported reference types.
Nested Schema : partyCharacteristic
Type:
array
The list of characteristics for the party.
Show Source
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
Nested Schema : ServiceCharacteristic
The service characteristic details.
Match All
The service characteristic details.
The service characteristic details.
Show Source
-
object
Characteristic
A characteristic of an object or entity represented by a name-value pair.
-
object
ServiceCharacteristic-allOf[1]
Nested Schema : ServiceCharacteristic-allOf[1]
Type:
Show Source
object
-
configItemDisplayName: string
The config item display name of the service characteristic which is editable from UI.
-
configItemId: string
The config item id of the service characteristic.
-
configItemName: string
The config item name of the service characteristic.
-
configItemPath: string
The path of the config item's property. Its value can be get from design studio catridges where this property was designed.
-
isDesignParameter: boolean
Default Value:
false
If TRUE, this will be considered as a design parameter and not as a service characteristic. In this case, serviceSpecName or configItemPath are not mandatory. -
serviceName: string
The name of the service consumer.
-
serviceSpecName: string
The specification name of service.Required only for creation of the service.
Nested Schema : RelatedServiceOrderItem
Type:
object
The service order item which triggered service creation/change/termination.
Show Source
-
itemAction: string
Allowed Values:
[ "add", "modify", "delete", "noChange" ]
Valid values for the lifecycle state of the orderItemAction. -
itemId: string
Identifier of the order item where the service was managed.
-
role: string
Role of the service order item for this service.
-
serviceOrderHref: string
Reference of the related entity.
-
serviceOrderId: string
Unique identifier of a related entity.
Nested Schema : ServiceRelationship
Type:
object
Describes links with services of the same category (useful for bundled services).
Show Source
-
relationshipType(required): string
The type of relationship (e.g. depends on, enables)
-
service(required): object
schema
Service Class.
-
serviceRelationshipCharacteristic: array
serviceRelationshipCharacteristic
Nested Schema : serviceRelationshipCharacteristic
Type:
Show Source
array
-
Array of:
ServiceCharacteristic
The service characteristic details.
Nested Schema : characteristics
Type:
array
List of characteristics including hard attributes defined for the specification. Currently characteristics will be displayed only for Network/Pipe/PL/LD/PD/Equipment required for NPD. Only available hard attributes as per design studio layout are displayed.
Show Source
-
Array of:
object CharacteristicSpecification
A characteristic of an object or entity represented by a name-value pair.
Nested Schema : PageLayout
Type:
object
Layout information for Create and Edit Pages
Show Source
-
pageName: string
Name of the panel chosed in Layout
-
sections: array
SectionLayoutArr
Nested Schema : CharacteristicSpecification
Type:
object
A characteristic of an object or entity represented by a name-value pair.
Show Source
-
controlType:
controlType
-
displayName: string
The display name of the characteristic.
-
isHardAttribute: boolean
-
isRequired: boolean
The requirement of the element
-
name(required): string
The name of the characteristic.
-
primitiveType: string
Allowed Values:
[ "BOOLEAN", "DATE", "DATETIME", "DECIMAL", "DOUBLE", "FLOAT", "HEXBINARY", "INTEGER", "LONG", "STRING", "TIME" ]
The data type for the characteristics's value. -
valueChangeListener: boolean
Indicates if it is parent char and there are dependent chars when value is enterted for this char.
Nested Schema : controlType
Match One Schema
Show Source
-
object
DropDownCharSpec
List of attributes applicable only if Characteristic is of type dropdown.
-
object
TextCharSpec
List of attributes applicable only if Characteristic is of control type text.
-
object
URLCharSpec
List of attributes applicable only if Characteristic is of control type URL.
-
object
CalendarCharSpec
List of attributes applicable only if Characteristic is of control type Calendar.
-
object
NumericCharSpec
List of attributes applicable only if Characteristic is of control type Numeric.
-
object
CheckboxCharSpec
List of attributes applicable only if Characteristic is of control type Checkbox.
Nested Schema : DropDownCharSpec
Type:
object
List of attributes applicable only if Characteristic is of type dropdown.
Show Source
-
@type: string
Allowed Values:
[ "DropDown", "Text", "URL", "Calendar", "Numeric", "Checkbox" ]
The list of valid values for the control type. -
defaultValue: string
The default value from the enumeration options.
-
enumerationOptions: array
enumerationOptions
The list of options.
-
options: string
Allowed Values:
[ "ENUMERATIONS", "ENTITYLINK", "QUERY" ]
The dropdown option for the element. -
sort: string
Allowed Values:
[ "ALPHANUMERIC", "NUMERIC" ]
The sorting order of the enumeration options.
Nested Schema : TextCharSpec
Type:
object
List of attributes applicable only if Characteristic is of control type text.
Show Source
-
@type: string
Allowed Values:
[ "DropDown", "Text", "URL", "Calendar", "Numeric", "Checkbox" ]
The list of valid values for the control type. -
case: string
Allowed Values:
[ "MIXED", "UPPER", "LOWER" ]
The case of the characteristic. -
defaultValue: string
The default value of the characteristic.
-
defaultValueLocalized: string
The localized default value of the characteristic.
-
displayMask: string
The displayMask of the characteristic.
-
editMask: string
The editMask of the characteristic.
-
isReadOnly: boolean
Indicates if element is read only.
-
isSensitive: boolean
Indicates if element is to be hidden.
-
maxLength: integer
The maximum length of the characteristic.
-
minLength: integer
The minimum length of the characteristic.
Nested Schema : URLCharSpec
Type:
object
List of attributes applicable only if Characteristic is of control type URL.
Show Source
-
@type: string
Allowed Values:
[ "DropDown", "Text", "URL", "Calendar", "Numeric", "Checkbox" ]
The list of valid values for the control type. -
defaultValue: string
The default value of the URL char
-
isReadOnly: boolean
The readOnly of the URL char
Nested Schema : CalendarCharSpec
Type:
object
List of attributes applicable only if Characteristic is of control type Calendar.
Show Source
-
@type: string
Allowed Values:
[ "DropDown", "Text", "URL", "Calendar", "Numeric", "Checkbox" ]
The list of valid values for the control type. -
defaultValue: string
The default value of the Calendar char.
-
fromDateRange: string
The end date range of the Calendar char.
-
isReadOnly: boolean
The readOnly of the Calendar char.
-
toDateRange: string
The start date range of the Calendar char.
Nested Schema : NumericCharSpec
Type:
object
List of attributes applicable only if Characteristic is of control type Numeric.
Show Source
-
@type: string
Allowed Values:
[ "DropDown", "Text", "URL", "Calendar", "Numeric", "Checkbox" ]
The list of valid values for the control type. -
defaultValue: integer
The default value of the Numeric char.
-
displayMask: string
The display mask of the Numeric char.
-
editMask: string
The edit mask of the Numeric char.
-
isReadOnly: boolean
The readOnly of the Numeric char.
-
isSensitive: boolean
The sensitive of the Numeric char.
-
maxValue: integer
The maximum value of the Numeric char.
-
minValue: integer
The minimum value of the Numeric char.
Nested Schema : CheckboxCharSpec
Type:
object
List of attributes applicable only if Characteristic is of control type Checkbox.
Show Source
-
@type: string
Allowed Values:
[ "DropDown", "Text", "URL", "Calendar", "Numeric", "Checkbox" ]
The list of valid values for the control type. -
defaultValue: boolean
The default value of the Checkbox char.
-
isReadOnly: boolean
The readOnly of the Checkbox char.
Nested Schema : Enumerations
Type:
Show Source
object
-
code: string
Key for the enum element.
-
default: boolean
Indicates if the code is default selected attribute in dropdown.
-
description: string
Description for the enum element.
-
language: string
The language of the element.
Nested Schema : SectionLayout
Type:
Show Source
object
-
elements: array
elements
The elements of the section.
-
localizedSectionNames: array
localizedSectionNames
The localized name of the section. This is for internal usage.
-
localizedSectionToolTip: array
localizedSectionToolTip
Localized Tool Tip of the section. This is for internal usage.
-
sectionName: string
The localized name of the section.
-
sectionTooltip: string
The localized tool tip of the section.
Nested Schema : localizedSectionNames
Type:
array
The localized name of the section. This is for internal usage.
Show Source
Nested Schema : localizedSectionToolTip
Type:
array
Localized Tool Tip of the section. This is for internal usage.
Show Source
Nested Schema : ComponentSpecification
Type:
Show Source
object
-
case: string
The case of the element. Possible values are MIXED,UPPER,LOWER.
-
defaultValue: string
The default Value of the element.
-
displayMask: string
The displayMask of the element.
-
displayName: string
The localized display name of the element.
-
editMask: string
The editMask of the element.
-
elementName: string
The name of the hard attribute or char name.
-
fromDateRange: string
The end date Range of the element for Date Chars.
-
isExternal: boolean
Applicable only for URL Chars. Indicates if URL to be opened in new tab.
-
isHardAttribute: boolean
Indicates if element is hard attribute or not.
-
isReadOnly: boolean
Indicates if element is read only.
-
isRequired: boolean
Indicates if element is required.
-
isSensitive: boolean
Indicates if element has to be hidden.
-
localizedDisplayNames: array
localizedDisplayNames
The localized display names of the element. This is for internal usage.
-
localizedToolTips: array
localizedToolTips
The localized tool tips of the element. This is for internal usage.
-
maxValue: string
The maximum value of the element.
-
minValue: string
The minimum value of the element.
-
sort: string
Allowed Values:
[ "ALPHANUMERIC", "NUMERIC" ]
Applicable only for Enum chars. -
toDateRange: string
The start date Range of the element for Date Chars.
-
tooltip: string
The localized tooltip of the element.
Nested Schema : localizedDisplayNames
Type:
array
The localized display names of the element. This is for internal usage.
Show Source
Nested Schema : localizedToolTips
Type:
array
The localized tool tips of the element. This is for internal usage.
Show Source
Nested Schema : LocalizedSpec
Type:
Show Source
object
-
language: string
Language of the element.
-
value: string
Value of the element.
Nested Schema : ResourceServiceRef
The resource reference on a service.
Match All
The resource reference on a service.
The resource reference on a service.
Show Source
Nested Schema : ResourceRef
Type:
Show Source
object
-
@referredType: string
Allowed Values:
[ "DeviceInterface", "Equipment", "EquipmentHolder", "LogicalDevice", "LogicalDeviceAccount", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPNetwork", "IPSubnet", "NetworkAddressDomain", "FlowIdentifier", "CustomObject", "CustomNetworkAddress", "Pipe", "PipeTerminationPoint", "Connectivity" ]
The list of valid values for the resource type. -
href: string
Read Only:
true
Reference of the supporting resource. -
id: string
Unique identifier of the supporting resource.
-
name: string
Name of the resource supporting the service.
Nested Schema : ResourceServiceRef-allOf[1]
Type:
Show Source
object
-
assignmentState: string
Allowed Values:
[ "PENDING_ASSIGN", "ASSIGNED", "PENDING_UNASSIGN", "UNASSIGNED", "DISCONNECTED", "TRANSITIONAL", "PORTED" ]
The list of valid values for assignment state. -
configItemDisplayName: string
The config item display name of the resource which is editable from UI.
-
configItemId: string
The config item id of the resource.
-
configItemName: string
The config item name of the resource.
-
consumerName: string
The name of the service consumer.
-
expandResource: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
referenceState: string
Allowed Values:
[ "PENDING_REFERENCE", "REFERENCED", "PENDING_UNREFERENCE", "UNREFERENCED" ]
The list of valid values for reference state.
Nested Schema : Discriminator: @type
Type:
object
A base resource Class.
Show Source
-
@baseType: string
Read Only:
true
Allowed Values:[ "PhysicalResource", "LogicalResource" ]
The list of valid values for the type of base resource. -
@type: string
Allowed Values:
[ "DeviceInterface", "Equipment", "EquipmentHolder", "LogicalDevice", "LogicalDeviceAccount", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPNetwork", "IPSubnet", "NetworkAddressDomain", "FlowIdentifier", "CustomObject", "CustomNetworkAddress", "Pipe", "PipeTerminationPoint", "Connectivity" ]
The list of valid values for the resource type. -
category: string
The category of the concrete resource, such as Gold or Silver for a MSISDN concrete resource.
-
description: string
A free-text description for the resource.
-
endOperatingDate: string
(date-time)
The date and time when the resource is no longer effective.
-
externalIdentity: object
externalIdentity
Read Only:
true
The external identity details for the federated resource. -
href: string
(uri)
Read Only:
true
The URI for the resource class. -
id: string
The ID of the resource.
-
lifecycleState: string
Allowed Values:
[ "END_OF_LIFE", "INSTALLED", "PENDING_INSTALL", "PENDING_REMOVE", "PENDING_UNAVAILABLE", "PENDING_AVAILABLE", "PLANNED", "UNAVAILABLE", "PENDING_DISCONNECT", "DISCONNECTED", "IN_DESIGN" ]
The list of valid values for inventory state. -
lifecycleSubState: string
Allowed Values:
[ "PENDING_ASSIGN", "ASSIGNED", "PENDING_UNASSIGN", "UNASSIGNED", "DISCONNECTED", "TRANSITIONAL", "PORTED" ]
The list of valid values for assignment state. -
name: string
The name of the resource.
-
place: array
place
The list of associated geographic places.
-
resourceCharacteristic: array
resourceCharacteristic
The list of characteristics for the resource.
-
resourceRelationship: array
resourceRelationship
The list of all resources referenced with the current resource. For example, parent resource, associated resource, etc.
-
resourceSpecification: object
Specification
A specification.
-
resourceStatus: string
Allowed Values:
[ "Standby", "Alarm", "Available", "Reserved", "Unknown", "Suspended" ]
The list of valid values for resource status type, which indicates if entity has reservations. -
resourceVersion: string
Read Only:
true
A field that identifies the version of a resource instance. -
startOperatingDate: string
(date-time)
Read Only:
true
The starting date and time when the resource becomes effective.
Nested Schema : externalIdentity
Type:
object
Read Only:
true
The external identity details for the federated resource.
Match All
The external identity details for the federated resource.
Show Source
-
object
ExternalIdentity
An external identity.
Nested Schema : place
Type:
array
The list of associated geographic places.
Show Source
-
Array of:
object PlaceRef
A place to associate with the resource/service.
Nested Schema : resourceCharacteristic
Type:
array
The list of characteristics for the resource.
Show Source
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
Nested Schema : resourceRelationship
Type:
array
The list of all resources referenced with the current resource. For example, parent resource, associated resource, etc.
Show Source
-
Array of:
object ResourceRelationship
A relationship to a resource.
Nested Schema : ResourceRelationship
Type:
object
A relationship to a resource.
Show Source
-
fromRole: string
The role name for the from-resource. Applies only to INVOLVE relationship types.
-
relationshipType: string
Allowed Values:
[ "ASSOCIATES", "MAPPEDTO", "PARENT", "CHILD", "INVOLVE", "ASSIGN", "CONSUMER" ]
The list of valid values for relationship type. -
resourceRef: object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
toRole: string
The role name for the to-resource. Applies only to INVOLVE relationship types.
400 Response
The request isn't valid.
Root Schema : Error
Type:
object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
-
code: string
The error code.
-
entityType: string
Allowed Values:
[ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicPlace", "GeographicLocation", "GeographicSite", "GeographicAddress", "GeographicAddressRange", "PropertyAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "NetworkEdge", "NetworkNode", "NetworkEntityCode", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "PipeTerminationPoint", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
The list of valid values for an entity class. -
message: array
message
The text that provides more details about the error as well as corrective actions.
-
reason: string
The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
-
referenceError: string
The URL pointing to the documentation that describes the error.
-
status: string
The HTTP error code extension, such as 400-2.
Nested Schema : message
Type:
array
The text that provides more details about the error as well as corrective actions.
Show Source
401 Response
You aren't authorized to make this request.
Root Schema : Error
Type:
object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
-
code: string
The error code.
-
entityType: string
Allowed Values:
[ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicPlace", "GeographicLocation", "GeographicSite", "GeographicAddress", "GeographicAddressRange", "PropertyAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "NetworkEdge", "NetworkNode", "NetworkEntityCode", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "PipeTerminationPoint", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
The list of valid values for an entity class. -
message: array
message
The text that provides more details about the error as well as corrective actions.
-
reason: string
The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
-
referenceError: string
The URL pointing to the documentation that describes the error.
-
status: string
The HTTP error code extension, such as 400-2.
Nested Schema : message
Type:
array
The text that provides more details about the error as well as corrective actions.
Show Source
403 Response
The request is forbidden.
Root Schema : Error
Type:
object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
-
code: string
The error code.
-
entityType: string
Allowed Values:
[ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicPlace", "GeographicLocation", "GeographicSite", "GeographicAddress", "GeographicAddressRange", "PropertyAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "NetworkEdge", "NetworkNode", "NetworkEntityCode", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "PipeTerminationPoint", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
The list of valid values for an entity class. -
message: array
message
The text that provides more details about the error as well as corrective actions.
-
reason: string
The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
-
referenceError: string
The URL pointing to the documentation that describes the error.
-
status: string
The HTTP error code extension, such as 400-2.
Nested Schema : message
Type:
array
The text that provides more details about the error as well as corrective actions.
Show Source
500 Response
An internal server error occurred.
Root Schema : Error
Type:
object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
-
code: string
The error code.
-
entityType: string
Allowed Values:
[ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicPlace", "GeographicLocation", "GeographicSite", "GeographicAddress", "GeographicAddressRange", "PropertyAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "NetworkEdge", "NetworkNode", "NetworkEntityCode", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "PipeTerminationPoint", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
The list of valid values for an entity class. -
message: array
message
The text that provides more details about the error as well as corrective actions.
-
reason: string
The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
-
referenceError: string
The URL pointing to the documentation that describes the error.
-
status: string
The HTTP error code extension, such as 400-2.
Nested Schema : message
Type:
array
The text that provides more details about the error as well as corrective actions.
Show Source
Examples
This example shows how to update the resource details for all services by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Install and Use cURL".
cURL Command
curl -X POST "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/service/updateResource -H 'content-type: application/json' -H credentials -d @resourceupdate.json
where:
- hostname is the URL for the UIM REST server.
- port is the port for the UIM REST server.
- version is the version of the API you're using.
- credentials is the base64 encoding of the user ID and password joined by a single colon (ID:password). See "Authentication and Authorization".
- resourceupdate.json is the JSON file that specifies the resource to update.
Example of Request Body
This shows an example of the contents of the resourceupdate.json file sent as the request body.
[
{
"oldResourceId":"{{BI-ld}}-300007",
"newResourceId":"{{BI-ld}}-75001",
"entityClass":"LogicalDevice"
},
{
"oldResourceId":"{{BI-FI}}-FlowIdentifier%230",
"newResourceId":"{{BI-FI}}-FlowIdentifier%231",
"entityClass":"FlowIdentifier"
},
{
"oldResourceId":"{{BI-Eq}}-5",
"newResourceId":"{{BI-Eq}}-12",
"entityClass":"Equipment"
},
{
"oldResourceId":"{{BI-LDA}}-75001",
"newResourceId":"{{BI-LDA}}-2",
"entityClass":"LogicalDeviceAccount"
},
{
"newResourceId":"4",
"oldResourceId":"3",
"entityClass":"GeographicSite"
},
{
"newResourceId":"1",
"oldResourceId":"75001",
"entityClass":"Party"
},
{
"newResourceId":"{{BI-pd}}-75003",
"oldResourceId":"{{BI-pd}}-5",
"entityClass":"PhysicalDevice"
},
{
"newResourceId":"{{BI-PC}}-75001-7",
"oldResourceId":"{{BI-PC}}-75001-8",
"entityClass":"PhysicalConnector"
}
]
Example of Response Body
This example shows the contents of the response body in JSON format.
[
{
"id": "225005",
"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/service/225005",
"category": "CFS",
"hasStarted": true,
"isServiceEnabled": true,
"name": "BroadbandCFS",
"serviceDate": "2021-03-25T09:03:21.286Z",
"supportingResource": [
{
"id": "4-1",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/4-1",
"name": "PD1",
"@referredType": "PhysicalDevice",
"consumerName": "BroadbandCFS",
"assignmentState": "ASSIGNED"
},
{
"id": "8-3",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/8-3",
"name": "Equipment",
"@referredType": "Equipment",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_UNASSIGN"
},
{
"id": "8-150035",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/8-150035",
"@referredType": "Equipment",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_ASSIGN"
},
{
"id": "29-150006",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/29-150006",
"name": "CNA2",
"@referredType": "CustomNetworkAddress",
"consumerName": "BroadbandCFS",
"assignmentState": "ASSIGNED"
},
{
"id": "22-75011",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/22-75011",
"name": "LDA",
"@referredType": "LogicalDeviceAccount",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_UNASSIGN"
},
{
"id": "22-1",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/22-1",
"name": "LDA1",
"@referredType": "LogicalDeviceAccount",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_ASSIGN"
},
{
"id": "12-150011",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/12-150011",
"name": "CO2",
"@referredType": "CustomObject",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_UNASSIGN"
},
{
"id": "12-1",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/12-1",
"name": "CO1",
"@referredType": "CustomObject",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_ASSIGN"
},
{
"id": "20-1-2",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/20-1-2",
"@referredType": "DeviceInterface",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_ASSIGN"
},
{
"id": "21-80765",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/21-80765",
"name": "80765",
"@referredType": "TelephoneNumber",
"consumerName": "BroadbandCFS",
"assignmentState": "PENDING_ASSIGN"
},
{
"id": "1-75023",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/1-75023",
"name": "LD_Pipe_Resource_651220",
"@referredType": "LogicalDevice",
"consumerName": "VDSLRFS",
"assignmentState": "ASSIGNED"
},
{
"id": "26-12.11.0.2 - Global IP Address Domain",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/26-12.11.0.2+-+Global+IP+Address+Domain",
"@referredType": "IPV4Address",
"consumerName": "VDSLRFS",
"assignmentState": "ASSIGNED"
},
{
"id": "24-12.11.0.0-24 - Global IP Address Domain",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/24-12.11.0.0-24 - Global IP Address Domain",
"@referredType": "IPSubnet",
"consumerName": "VDSLRFS",
"referenceState": "REFERENCED"
},
{
"id": "28-NAD-FI#FlowIdentifier#0",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/28-NAD-FI%23FlowIdentifier%230",
"name": "0",
"@referredType": "FlowIdentifier",
"consumerName": "VDSLRFS",
"referenceState": "REFERENCED"
}
],
"startDate": "2021-03-25T09:03:21.128Z",
"relatedParty": [
{
"id": "75002",
"href": "http://hostname:port/InventoryRSOpenAPI/party/75002",
"name": "Party_Automated_634866",
"referenceType": "Reference",
"consumerName": "BroadbandCFS",
"referenceState": "REFERENCED"
}
],
"serviceCharacteristic": [
{
"name": "serviceRelType",
"valueType": "ALPHANUMERIC",
"value": "P-C",
"serviceName": "BroadbandCFS"
},
{
"name": "serviceRel",
"valueType": "ALPHANUMERIC",
"value": "VDSLRFS",
"serviceName": "BroadbandCFS"
},
{
"name": "category",
"valueType": "ALPHANUMERIC",
"value": "CFS",
"serviceName": "BroadbandCFS"
},
{
"name": "category",
"valueType": "ALPHANUMERIC",
"value": "CFS",
"serviceName": "VDSLRFS",
"configItemName": "Email_Access_CFS",
"configItemDisplayName": "Email_Access_CFS"
},
{
"name": "UserName",
"valueType": "ALPHANUMERIC",
"value": "REST",
"serviceName": "Email"
},
{
"name": "MaxNumberOfAccounts",
"valueType": "ALPHANUMERIC",
"value": "2",
"serviceName": "Email"
}
],
"serviceRelationship": [
{
"relationshipType": "P-C",
"service": {
"id": "75005",
"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/service/75005"
}
}
],
"supportingService": [
{
"id": "75005",
"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/service/75005",
"name": "VDSLRFS"
}
],
"serviceSpecification": {
"id": "Broadband_Internet_REST_Junit_CFS",
"href": "http://hostname:port/InventoryRSOpenAPI/specification/Broadband_Internet_REST_Junit_CFS",
"name": "Broadband_Internet_REST_Junit_CFS",
"version": "1",
"entityType": "Service",
"startDate": "2021-03-23T18:30:01.000Z",
"endDate": "2038-01-19T03:14:07.000Z"
},
"state": "active",
"place": [
{
"id": "1",
"href": "http://hostname:port/InventoryRSOpenAPI/place/1",
"name": "CustomerLocation",
"@referredType": "GeographicLocation",
"referenceType": "Reference",
"consumerName": "BroadbandCFS",
"referenceState": "PENDING_REFERENCE"
},
{
"id": "150004",
"href": "http://hostname:port/InventoryRSOpenAPI/place/150004",
"name": "Place_Automated_490303",
"@referredType": "GeographicSite",
"referenceType": "Reference",
"consumerName": "BroadbandCFS",
"referenceState": "PENDING_REFERENCE"
}
]
}
]