Create a Resource
/resource
- name
- @type
- resourceSpecification This field isn't mandatory the IPNetwork, IPv4Address, and IPV6Address resource types.
To create a resource relationship, resourceRelationship.type and resourceRelationship.resourceRef are mandatory. ResourceRef should contain the minimum details of id and @type.
The created resource will be shown in the response along with the location URL, except when "fields=none" is provided in the request.
Additional attributes could be required for specific resources and the details are provided in POST PATH of concrete resources. For example, physicalDeviceRef is mandatory for creating physical ports.
Request
-
fields: string
The fields to include in the response.
- application/json
object
-
@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.
object
true
-
object
ExternalIdentity
An external identity.
array
-
Array of:
object PlaceRef
A place to associate with the resource/service.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
array
-
Array of:
object ResourceRelationship
A relationship to a resource.
object
-
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.
object
-
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.
object
-
@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.
object
-
@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.
object
object
-
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.
array
-
Array of:
object CharacteristicSpecification
A characteristic of an object or entity represented by a name-value pair.
object
-
pageName: string
Name of the panel chosed in Layout
-
sections: array
SectionLayoutArr
object
-
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.
-
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.
object
-
@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.
object
-
@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.
object
-
@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
object
-
@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.
object
-
@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.
object
-
@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.
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.
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.
array
array
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.
array
array
object
-
language: string
Language of the element.
-
value: string
Value of the element.
Response
- application/json
201 Response
object
-
@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.
object
true
-
object
ExternalIdentity
An external identity.
array
-
Array of:
object PlaceRef
A place to associate with the resource/service.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
array
-
Array of:
object ResourceRelationship
A relationship to a resource.
object
-
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.
object
-
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.
object
-
@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.
object
-
@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.
object
object
-
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.
array
-
Array of:
object CharacteristicSpecification
A characteristic of an object or entity represented by a name-value pair.
object
-
pageName: string
Name of the panel chosed in Layout
-
sections: array
SectionLayoutArr
object
-
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.
-
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.
object
-
@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.
object
-
@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.
object
-
@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
object
-
@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.
object
-
@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.
object
-
@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.
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.
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.
array
array
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.
array
array
object
-
language: string
Language of the element.
-
value: string
Value of the element.
400 Response
object
-
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.
array
401 Response
object
-
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.
array
403 Response
object
-
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.
array
500 Response
object
-
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.
array
Examples
This example shows how to create a resource for a given discriminator "@type" and specification 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/resourceInventoryManagement/version/resource -H 'content-type: application/json' -H credentials -d @resourcecreate.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".
- resourcecreate.json is the JSON file that specifies the resource to create.
Example of Request Body
This shows an example of the contents of the resourcecreate.json file sent as the request body. The discriminator "@type=LogicalDevice" indicates to create a logical device.
{
"@type": "LogicalDevice",
"name": "DSL LD",
"description": "DSL CPE",
"resourceCharacteristic": [
{
"name": "CPE_Type",
"valueType": "ALPHANUMERIC",
"value": "Switch"
},
{
"name": "CPE_MAC",
"valueType": "ALPHANUMERIC",
"value": "00:A0:C9:14:C8:29"
},
{
"name": "Model",
"valueType": "ALPHANUMERIC",
"value": "GSW-2020P"
},
{
"name": "Vendor",
"valueType": "ALPHANUMERIC",
"value": "Cisco"
}
],
"resourceSpecification": {
"id": "DSL_CPE"
},
"networkLocation": {
"id": "HYD",
"@referredType": "PropertyLocation"
},
"deviceIdentifier": "HYDDISwitch"
}
Example of Response Body
This example shows the contents of the response body in JSON format. The ID is auto-generated and included in the response, because the input specification indicates auto-generation.
{
"id": "1-825024",
"href": "http://hostname:port/InventoryRSOpenAPI/resourceInventoryManagement/version/resource/1-825024",
"@type": "LogicalDevice",
"@baseType": "LogicalResource",
"name": "DSL LD",
"description": "DSL CPE",
"version": "1",
"lifecycleState": "INSTALLED",
"lifecycleSubState": "UNASSIGNED",
"startDate": "2020-01-10T10:48:54.334Z",
"endDate": "2038-01-19T08:44:07.000Z",
"resourceCharacteristic": [
{
"name": "Vendor",
"valueType": "ALPHANUMERIC",
"value": "Cisco"
},
{
"name": "Model",
"valueType": "ALPHANUMERIC",
"value": "GSW-2020P"
},
{
"name": "CPE_MAC",
"valueType": "ALPHANUMERIC",
"value": "00:A0:C9:14:C8:29"
},
{
"name": "CPE_Type",
"valueType": "ALPHANUMERIC",
"value": "Switch"
}
],
"resourceSpecification": {
"id": "DSL_CPE",
"href": "http://hostname:port/InventoryRSOpenAPI/specification/DSL_CPE",
"name": "DSL_CPE",
"version": "1",
"entityType": "LogicalDevice",
"startDate": "2019-11-25T00:00:01.000Z",
"endDate": "2038-01-19T08:44:07.000Z"
},
"networkLocation": {
"id": "HYD",
"href": "http://hostname:port/InventoryRSOpenAPI/place/HYD",
"name": "HYD",
"@referredType": "PropertyLocation"
},
"serviceLocation": {
"id": "HYD",
"href": "http://hostname:port/InventoryRSOpenAPI/place/HYD",
"name": "HYD",
"@referredType": "PropertyLocation"
},
"deviceIdentifier": "HYDDISwitch"
}