Create a Groom activity
/groom
Optionally, the project can be auto submitted by sending a query parameter 'submit=true'
Request
-
submit: boolean
To submit the groom project post creation.
- application/json
object
-
activity: object
GroomActivity
Groom activity is used to change the design of Connectivity or Pipe even if the trails are riding on it. It will move a rider from source bearers to target bearers.
-
description: string
A free-text description for the project.
-
href: string
(uri)
Read Only:
true
The URI for the GroomProject class. -
id: string
Read Only:
true
The ID of the project. -
projectName: string
The name of the project.
-
status: string
Allowed Values:
[ "CREATED", "COMPLETED", "IN_PROGRESS" ]
The list of valid values for Project State.
object
-
activityItems: array
activityItems
-
activityName: string
The name of the activity.
-
id: string
The ID of the Activity.
-
impactedItems: array
impactedItems
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State.
array
-
Array of:
object GroomActivityItem
Groom activity item captures the details of the connectivity or pipe to be groomed.
array
-
Array of:
object ImpactedItem
Details of rehomed or groomed connectivity/pipe and trails (Connectivity/Pipe) impacted by the rehome or groom.
object
-
changedEntity:
changedEntity
Connectivity or Pipe to be groomed.
-
comments: string
Comments related to failure of groom activity item, if any.
-
source: array
source
The source connectivity/pipe on which the connectivity/pipe to be groomed is currently riding.
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State. -
target: array
target
The target connectivity/pipe on which the connectivity/pipe to be groomed needs to ride.
array
array
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
object
LogicalResource-allOf[1]
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
object
-
aendTerminationPoint: string
(uri)
The URI for aterminationPoint of the pipe.
-
allowSecondaryEnablement: boolean
To allow SecondaryEnablement for a pipe or not.
-
capacityConsumedRef: object
CapacityConsumed
Consumed capacity of pipe.
-
capacityProvidedRef: object
CapacityProvided
A capacity provided.
-
capacityRequiredRef: object
CapacityRequired
Required capacity of pipe.
-
channelSpacing: string
The channelSpacing of pipe.
-
gridType: string
Allowed Values:
[ "FIXED", "FLEX_GRID", "NONE" ]
The GridType of the pipe. Valid values are NONE, FIXED, FLEX_GRID. -
isVersioned: boolean
To denote whether pipe is versioned or not.
-
medium: string
Allowed Values:
[ "WIRELESS", "METALLIC", "FIBER", "SOFTWARE", "UNKNOWN", "NONE" ]
The Medium of the pipe. Valid values are NONE, WIRELESS, METALLIC, FIBER, SOFTWARE, UNKNOWN. -
parentPipeRef:
schema
A pipe resource.
-
pipeDirectionalityRef: array
pipeDirectionalityRef
The list of pipe directionalities.
-
primaryPathEnabled: object
PipeEnablement
Segment details that are enabling current Connectivity.
-
roles: array
roles
The list of pipe inventory roles.
-
secondaryPathEnabled: object
PipeEnablement
Segment details that are enabling current Connectivity.
-
totalConsumedCapacity: string
The total consumed capacity.
-
transmissionSignalType: string
Allowed Values:
[ "ELECTRICAL", "ELECTROMAGNETIC", "OPTICAL", "UNKNOWN", "NONE" ]
The TransmissionSignalType of the pipe. Valid values are NONE, ELECTRICAL, ELECTROMAGNETIC, OPTICAL, UNKNOWN. -
zendTerminationPoint: string
(uri)
The URI for zterminationPoint of the pipe.
object
-
capacityConsumed: string
Capacity consumed.
-
id: string
The id of the CapacityConsumed.
-
name: string
The name of the CapacityConsumed.
-
percentConsumed: string
Consumed capacity percentage.
object
-
capacityType: string
Capacity type of capacity provided.
-
consumablePercentage: string
Percentage of capacity that can be consumable.
-
totalAmount: string
Total amount of capacity provided.
-
unitOfMeasure: string
Unit of measure valid are Gbps,Kbps,Mbps,bps.
object
-
capacityType: string
Capacity type of required capacity.
-
quantity: integer
Percentage of capacity that can be consumable.
-
requiredAmount: string
Required amount of capacity.
-
unitOfMeasure: string
Unit of measure valid are Gbps,Kbps,Mbps,bps.
array
-
Array of:
object PipeDirectionality
A Pipe Directionality .
object
-
originatingTerminationPoint: string
The id of the originatingTerminationPoint.
-
pipeSegmentRef: array
pipeSegmentRef
The list of pipe segments.
-
terminatingTerminationPoint: string
The id of the terminatingTerminationPoint.
array
-
Array of:
object Role
A role.
object
-
directionalityType: string
Allowed Values:
[ "ROUTING", "SIGNAL" ]
The directionalityType of the pipe. -
pipeDirection: string
Allowed Values:
[ "BI_DIRECTIONAL", "UNI_DIRECTIONAL", "UNKNOWN" ]
The direction of the pipe. -
terminationDirectType1: string
Allowed Values:
[ "SINK", "SOURCE", "UNKNOWN" ]
The DirectType of the termination1. Valid values are SINK, SOURCE, UNKNOWN. -
terminationDirectType2: string
Allowed Values:
[ "SINK", "SOURCE", "UNKNOWN" ]
The DirectType of the termination2. Valid values are SINK, SOURCE, UNKNOWN. -
terminationId1: string
The ID of the termination1.
-
terminationId2: string
The ID of the termination2.
-
terminationName1: string
The name of the termination1.
-
terminationName2: string
The name of the termination2.
array
-
Array of:
object Segment
Segment details that are enabling current Connectivity.
object
-
aendLocation: string
A side Location.
-
asideInterface: object
LogicalResource
The base class for logical resources.
-
asidePhysicalPort: object
LogicalResource
The base class for logical resources.
-
asideTerminationPoint: string
The id of Termination point.
-
flowIdentifiers: array
flowIdentifiers
-
gapAccepted: boolean
Use this attribute to accept gap. Default Reason for accepting gap is auto-generated as "GAP OK"
-
interconnectionType: string
Allowed Values:
[ "CROSS_CONNECT", "PHYSICAL_JUMPER" ]
The list of valid values for InterConnectionType. -
isGap: boolean
Identifies if it is a gap or not.
-
lifeCycleBinding: string
Allowed Values:
[ "INTERFACE_BOUND", "TRAIL_BOUND", "HARDWIRED" ]
The list of valid values for InterConnectionLifeCycleBinding. -
segmentNumber: string
Segment number.
-
segmentRef:
segmentRef
-
zendLocation: string
Z side Location.
-
zsideInterface: object
LogicalResource
The base class for logical resources.
-
zsidePhysicalPort: object
LogicalResource
The base class for logical resources.
-
zsideTerminationPoint: string
The id of Termination point.
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
domain:
schema
A network address domain.
-
identifier: integer
The ID of the flow identifier.
-
identifierPrefix: string
Prefix for the Identifier.
-
lowerIdentifierValue: integer
The Lower ID of the flow identifier Range.
-
resourcePoolName: string
The Resource Pool Name of flow Identifier.
-
stackingLevel: integer
The stacking level of the flow identifier.
-
upperIdentifierValue: integer
The Upper ID of the flow identifier Range.
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
managedBy: object
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
-
name: string
The name of the network address domain. It also indicates the ID of the domain.
-
networkAddressType: string
The type of network address, either IP Subnet or flow identifier.
-
ownedBy: object
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
object
-
@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.
object
-
roleName: string
The name of the role.
-
roleType: string
Allowed Values:
[ "NONE", "TECHNOLOGY", "FUNCTION", "TOPOLOGY", "TARGET" ]
The type of role.
object
-
ALocation: object
schema
A place to associate with the resource/service.
-
assignedToService: string
(uri)
The service (if any) to which the connectivity is assigned.
-
bitRate: string
The bit rate is based on the rate code applied to the connectivity.
-
capacityAvailable: string
Percentage of capacity that can be consumed.
-
connectivityDesign: object
ConnectivityDesign
Gives the details of latest connectivity design version.
-
connectivityIdentifier: string
A unique identifier of Connectivity.
-
consumablePercent: integer
Percentage of capacity that can be consumed.
-
function: string
The function that applies to connectivity. Functions apply only to connectivities that have rate codes that define them as facilities.
-
functionDisplayName: string
Read Only:
true
The display name of the function. -
identificationFormat: string
Allowed Values:
[ "LOCATION_BASED", "SERVICE_BASED", "CUSTOM_IDENTIFICATION" ]
The list of valid values for Connectivity identifier format. -
isAssignContiguousSerialNumber: boolean
Should be true if multiple Connectivity entities are created and want their serial numbers to be in a continuous block.
-
quantity: integer
The number of Connectivity entities to be created.
-
rateCode: string
The rate code that applies to connectivity.
-
serialNumber: integer
A number that uniquely identifies the connectivity within the context of other facilities that share the same A Network/Entity Location, Z Network/Entity Location, Rate Code, and Technology values.
-
technology: string
The technology that applies to connectivity.
-
ZLocation: object
schema
A place to associate with the resource/service.
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
-
aendLocation: object
schema
A place to associate with the resource/service.
-
asideFlowIdentifiers: array
asideFlowIdentifiers
-
asideInterface: object
LogicalResource
The base class for logical resources.
-
asideTerminationPointId: string
The id of Termination point on A side.
-
connectivityDesignVersion: integer
The version number of connectivity design.
-
paths: array
paths
-
startDate: string
(date-time)
The starting date and time when the connectivity design becomes effective.
-
status: string
Allowed Values:
[ "IN_PROGRESS", "DESIGNED", "ISSUED", "COMPLETED", "PENDING_CANCEL", "CANCELLED" ]
The list of valid values for configuration state. -
terminateAtFlowInterfaceOnAside: boolean
This should be true if A side needs to be terminated at Flow Interface.
-
terminateAtFlowInterfaceOnZside: boolean
This should be true if Z side needs to be terminated at Flow Interface.
-
zendLocation: object
schema
A place to associate with the resource/service.
-
zsideFlowIdentifiers: array
zsideFlowIdentifiers
-
zsideInterface: object
LogicalResource
The base class for logical resources.
-
zsideTerminationPointId: string
The id of Termination point on Z side.
array
-
Array of:
object ConnectivityPath
Paths that are enabling current Connectivity.
object
-
label: string
Path label like Path1, Path2.
-
segments: array
segments
array
-
Array of:
object Segment
Segment details that are enabling current Connectivity.
object
-
action: string
If impacted connectivity/pipe design does not have any gap, then the action is VIEW DESIGN. If impacted connectivity/pipe design is not completed due to gap, then the action is RESOLVE GAP. If impacted item is service then the action is VIEW SERVICE.
-
changedEntity:
changedEntity
Impacted Connectivity or Pipe after rehome or groom.
-
parentChangeItem: string
Parent activity item due to which this item got imapacted.
-
serviceChangeEntity: object
schema
Service Class.
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State.
object
-
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).
-
object
allOf
PhysicalResource
The base class for physical resources.
-
object
type
object
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
object
PhysicalResource-allOf[1]
object
-
serialNumber: string
The serial number for the physical resource.
object
-
category: string
Read Only:
true
The category, or grouping, of equipment built from this specification. The valid values are RACK, SHELF, and CARD. -
modelNumber: string
Read Only:
true
The manufacturer-allocated number used to identify the general type and/or category of the hardware. This, in combination with the part number, identifies different types of hardware. -
networkLocation: object
schema
A place to associate with the resource/service.
-
partNumber: string
Read Only:
true
The manufacturer-allocated part number assigned by the organization that manufactures the hardware. This, in combination with model number, identifies different types of hardware. -
physicalConnectors: string
(uri)
Read Only:
true
The URI for the list of physical connector instances provided by the equipment instance. -
physicalPorts: string
(uri)
Read Only:
true
The URI for the physical port instances provided by the equipment instance. -
roles: array
roles
The list of equipment inventory roles.
-
vendorName: string
Read Only:
true
The name of the equipment manufacturer.
array
-
Array of:
object Role
A role.
object
-
id: string
The id of Business Interaction
-
state: string
The state of Business Interaction
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.
array
-
Array of:
PlaceServiceRef
The place reference on a service.
array
-
Array of:
ServiceCharacteristic
The service characteristic details.
array
-
Array of:
object RelatedServiceOrderItem
The service order item which triggered service creation/change/termination.
array
-
Array of:
object ServiceRelationship
Describes links with services of the same category (useful for bundled services).
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.
array
-
Array of:
ResourceServiceRef
The resource reference on a service.
array
-
Array of:
object schema
Service Class.
-
object
schema
A place to associate with the resource/service.
-
object
PlaceServiceRef-allOf[1]
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'.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
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
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
-
object
RelatedPartyServiceRef-allOf[1]
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.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
-
object
Characteristic
A characteristic of an object or entity represented by a name-value pair.
-
object
ServiceCharacteristic-allOf[1]
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.
object
-
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.
object
-
relationshipType(required): string
The type of relationship (e.g. depends on, enables)
-
service(required): object
schema
Service Class.
-
serviceRelationshipCharacteristic: array
serviceRelationshipCharacteristic
array
-
Array of:
ServiceCharacteristic
The service characteristic details.
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.
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.
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.
Response
- application/json
201 Response
object
-
activity: object
GroomActivity
Groom activity is used to change the design of Connectivity or Pipe even if the trails are riding on it. It will move a rider from source bearers to target bearers.
-
description: string
A free-text description for the project.
-
href: string
(uri)
Read Only:
true
The URI for the GroomProject class. -
id: string
Read Only:
true
The ID of the project. -
projectName: string
The name of the project.
-
status: string
Allowed Values:
[ "CREATED", "COMPLETED", "IN_PROGRESS" ]
The list of valid values for Project State.
object
-
activityItems: array
activityItems
-
activityName: string
The name of the activity.
-
id: string
The ID of the Activity.
-
impactedItems: array
impactedItems
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State.
array
-
Array of:
object GroomActivityItem
Groom activity item captures the details of the connectivity or pipe to be groomed.
array
-
Array of:
object ImpactedItem
Details of rehomed or groomed connectivity/pipe and trails (Connectivity/Pipe) impacted by the rehome or groom.
object
-
changedEntity:
changedEntity
Connectivity or Pipe to be groomed.
-
comments: string
Comments related to failure of groom activity item, if any.
-
source: array
source
The source connectivity/pipe on which the connectivity/pipe to be groomed is currently riding.
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State. -
target: array
target
The target connectivity/pipe on which the connectivity/pipe to be groomed needs to ride.
array
array
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
object
LogicalResource-allOf[1]
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
object
-
aendTerminationPoint: string
(uri)
The URI for aterminationPoint of the pipe.
-
allowSecondaryEnablement: boolean
To allow SecondaryEnablement for a pipe or not.
-
capacityConsumedRef: object
CapacityConsumed
Consumed capacity of pipe.
-
capacityProvidedRef: object
CapacityProvided
A capacity provided.
-
capacityRequiredRef: object
CapacityRequired
Required capacity of pipe.
-
channelSpacing: string
The channelSpacing of pipe.
-
gridType: string
Allowed Values:
[ "FIXED", "FLEX_GRID", "NONE" ]
The GridType of the pipe. Valid values are NONE, FIXED, FLEX_GRID. -
isVersioned: boolean
To denote whether pipe is versioned or not.
-
medium: string
Allowed Values:
[ "WIRELESS", "METALLIC", "FIBER", "SOFTWARE", "UNKNOWN", "NONE" ]
The Medium of the pipe. Valid values are NONE, WIRELESS, METALLIC, FIBER, SOFTWARE, UNKNOWN. -
parentPipeRef:
schema
A pipe resource.
-
pipeDirectionalityRef: array
pipeDirectionalityRef
The list of pipe directionalities.
-
primaryPathEnabled: object
PipeEnablement
Segment details that are enabling current Connectivity.
-
roles: array
roles
The list of pipe inventory roles.
-
secondaryPathEnabled: object
PipeEnablement
Segment details that are enabling current Connectivity.
-
totalConsumedCapacity: string
The total consumed capacity.
-
transmissionSignalType: string
Allowed Values:
[ "ELECTRICAL", "ELECTROMAGNETIC", "OPTICAL", "UNKNOWN", "NONE" ]
The TransmissionSignalType of the pipe. Valid values are NONE, ELECTRICAL, ELECTROMAGNETIC, OPTICAL, UNKNOWN. -
zendTerminationPoint: string
(uri)
The URI for zterminationPoint of the pipe.
object
-
capacityConsumed: string
Capacity consumed.
-
id: string
The id of the CapacityConsumed.
-
name: string
The name of the CapacityConsumed.
-
percentConsumed: string
Consumed capacity percentage.
object
-
capacityType: string
Capacity type of capacity provided.
-
consumablePercentage: string
Percentage of capacity that can be consumable.
-
totalAmount: string
Total amount of capacity provided.
-
unitOfMeasure: string
Unit of measure valid are Gbps,Kbps,Mbps,bps.
object
-
capacityType: string
Capacity type of required capacity.
-
quantity: integer
Percentage of capacity that can be consumable.
-
requiredAmount: string
Required amount of capacity.
-
unitOfMeasure: string
Unit of measure valid are Gbps,Kbps,Mbps,bps.
array
-
Array of:
object PipeDirectionality
A Pipe Directionality .
object
-
originatingTerminationPoint: string
The id of the originatingTerminationPoint.
-
pipeSegmentRef: array
pipeSegmentRef
The list of pipe segments.
-
terminatingTerminationPoint: string
The id of the terminatingTerminationPoint.
array
-
Array of:
object Role
A role.
object
-
directionalityType: string
Allowed Values:
[ "ROUTING", "SIGNAL" ]
The directionalityType of the pipe. -
pipeDirection: string
Allowed Values:
[ "BI_DIRECTIONAL", "UNI_DIRECTIONAL", "UNKNOWN" ]
The direction of the pipe. -
terminationDirectType1: string
Allowed Values:
[ "SINK", "SOURCE", "UNKNOWN" ]
The DirectType of the termination1. Valid values are SINK, SOURCE, UNKNOWN. -
terminationDirectType2: string
Allowed Values:
[ "SINK", "SOURCE", "UNKNOWN" ]
The DirectType of the termination2. Valid values are SINK, SOURCE, UNKNOWN. -
terminationId1: string
The ID of the termination1.
-
terminationId2: string
The ID of the termination2.
-
terminationName1: string
The name of the termination1.
-
terminationName2: string
The name of the termination2.
array
-
Array of:
object Segment
Segment details that are enabling current Connectivity.
object
-
aendLocation: string
A side Location.
-
asideInterface: object
LogicalResource
The base class for logical resources.
-
asidePhysicalPort: object
LogicalResource
The base class for logical resources.
-
asideTerminationPoint: string
The id of Termination point.
-
flowIdentifiers: array
flowIdentifiers
-
gapAccepted: boolean
Use this attribute to accept gap. Default Reason for accepting gap is auto-generated as "GAP OK"
-
interconnectionType: string
Allowed Values:
[ "CROSS_CONNECT", "PHYSICAL_JUMPER" ]
The list of valid values for InterConnectionType. -
isGap: boolean
Identifies if it is a gap or not.
-
lifeCycleBinding: string
Allowed Values:
[ "INTERFACE_BOUND", "TRAIL_BOUND", "HARDWIRED" ]
The list of valid values for InterConnectionLifeCycleBinding. -
segmentNumber: string
Segment number.
-
segmentRef:
segmentRef
-
zendLocation: string
Z side Location.
-
zsideInterface: object
LogicalResource
The base class for logical resources.
-
zsidePhysicalPort: object
LogicalResource
The base class for logical resources.
-
zsideTerminationPoint: string
The id of Termination point.
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
domain:
schema
A network address domain.
-
identifier: integer
The ID of the flow identifier.
-
identifierPrefix: string
Prefix for the Identifier.
-
lowerIdentifierValue: integer
The Lower ID of the flow identifier Range.
-
resourcePoolName: string
The Resource Pool Name of flow Identifier.
-
stackingLevel: integer
The stacking level of the flow identifier.
-
upperIdentifierValue: integer
The Upper ID of the flow identifier Range.
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
managedBy: object
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
-
name: string
The name of the network address domain. It also indicates the ID of the domain.
-
networkAddressType: string
The type of network address, either IP Subnet or flow identifier.
-
ownedBy: object
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
object
-
@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.
object
-
roleName: string
The name of the role.
-
roleType: string
Allowed Values:
[ "NONE", "TECHNOLOGY", "FUNCTION", "TOPOLOGY", "TARGET" ]
The type of role.
object
-
ALocation: object
schema
A place to associate with the resource/service.
-
assignedToService: string
(uri)
The service (if any) to which the connectivity is assigned.
-
bitRate: string
The bit rate is based on the rate code applied to the connectivity.
-
capacityAvailable: string
Percentage of capacity that can be consumed.
-
connectivityDesign: object
ConnectivityDesign
Gives the details of latest connectivity design version.
-
connectivityIdentifier: string
A unique identifier of Connectivity.
-
consumablePercent: integer
Percentage of capacity that can be consumed.
-
function: string
The function that applies to connectivity. Functions apply only to connectivities that have rate codes that define them as facilities.
-
functionDisplayName: string
Read Only:
true
The display name of the function. -
identificationFormat: string
Allowed Values:
[ "LOCATION_BASED", "SERVICE_BASED", "CUSTOM_IDENTIFICATION" ]
The list of valid values for Connectivity identifier format. -
isAssignContiguousSerialNumber: boolean
Should be true if multiple Connectivity entities are created and want their serial numbers to be in a continuous block.
-
quantity: integer
The number of Connectivity entities to be created.
-
rateCode: string
The rate code that applies to connectivity.
-
serialNumber: integer
A number that uniquely identifies the connectivity within the context of other facilities that share the same A Network/Entity Location, Z Network/Entity Location, Rate Code, and Technology values.
-
technology: string
The technology that applies to connectivity.
-
ZLocation: object
schema
A place to associate with the resource/service.
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
-
aendLocation: object
schema
A place to associate with the resource/service.
-
asideFlowIdentifiers: array
asideFlowIdentifiers
-
asideInterface: object
LogicalResource
The base class for logical resources.
-
asideTerminationPointId: string
The id of Termination point on A side.
-
connectivityDesignVersion: integer
The version number of connectivity design.
-
paths: array
paths
-
startDate: string
(date-time)
The starting date and time when the connectivity design becomes effective.
-
status: string
Allowed Values:
[ "IN_PROGRESS", "DESIGNED", "ISSUED", "COMPLETED", "PENDING_CANCEL", "CANCELLED" ]
The list of valid values for configuration state. -
terminateAtFlowInterfaceOnAside: boolean
This should be true if A side needs to be terminated at Flow Interface.
-
terminateAtFlowInterfaceOnZside: boolean
This should be true if Z side needs to be terminated at Flow Interface.
-
zendLocation: object
schema
A place to associate with the resource/service.
-
zsideFlowIdentifiers: array
zsideFlowIdentifiers
-
zsideInterface: object
LogicalResource
The base class for logical resources.
-
zsideTerminationPointId: string
The id of Termination point on Z side.
array
-
Array of:
object ConnectivityPath
Paths that are enabling current Connectivity.
object
-
label: string
Path label like Path1, Path2.
-
segments: array
segments
array
-
Array of:
object Segment
Segment details that are enabling current Connectivity.
object
-
action: string
If impacted connectivity/pipe design does not have any gap, then the action is VIEW DESIGN. If impacted connectivity/pipe design is not completed due to gap, then the action is RESOLVE GAP. If impacted item is service then the action is VIEW SERVICE.
-
changedEntity:
changedEntity
Impacted Connectivity or Pipe after rehome or groom.
-
parentChangeItem: string
Parent activity item due to which this item got imapacted.
-
serviceChangeEntity: object
schema
Service Class.
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State.
object
-
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).
-
object
allOf
PhysicalResource
The base class for physical resources.
-
object
type
object
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
object
PhysicalResource-allOf[1]
object
-
serialNumber: string
The serial number for the physical resource.
object
-
category: string
Read Only:
true
The category, or grouping, of equipment built from this specification. The valid values are RACK, SHELF, and CARD. -
modelNumber: string
Read Only:
true
The manufacturer-allocated number used to identify the general type and/or category of the hardware. This, in combination with the part number, identifies different types of hardware. -
networkLocation: object
schema
A place to associate with the resource/service.
-
partNumber: string
Read Only:
true
The manufacturer-allocated part number assigned by the organization that manufactures the hardware. This, in combination with model number, identifies different types of hardware. -
physicalConnectors: string
(uri)
Read Only:
true
The URI for the list of physical connector instances provided by the equipment instance. -
physicalPorts: string
(uri)
Read Only:
true
The URI for the physical port instances provided by the equipment instance. -
roles: array
roles
The list of equipment inventory roles.
-
vendorName: string
Read Only:
true
The name of the equipment manufacturer.
array
-
Array of:
object Role
A role.
object
-
id: string
The id of Business Interaction
-
state: string
The state of Business Interaction
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.
array
-
Array of:
PlaceServiceRef
The place reference on a service.
array
-
Array of:
ServiceCharacteristic
The service characteristic details.
array
-
Array of:
object RelatedServiceOrderItem
The service order item which triggered service creation/change/termination.
array
-
Array of:
object ServiceRelationship
Describes links with services of the same category (useful for bundled services).
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.
array
-
Array of:
ResourceServiceRef
The resource reference on a service.
array
-
Array of:
object schema
Service Class.
-
object
schema
A place to associate with the resource/service.
-
object
PlaceServiceRef-allOf[1]
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'.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
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
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
-
object
RelatedPartyServiceRef-allOf[1]
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.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
-
object
Characteristic
A characteristic of an object or entity represented by a name-value pair.
-
object
ServiceCharacteristic-allOf[1]
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.
object
-
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.
object
-
relationshipType(required): string
The type of relationship (e.g. depends on, enables)
-
service(required): object
schema
Service Class.
-
serviceRelationshipCharacteristic: array
serviceRelationshipCharacteristic
array
-
Array of:
ServiceCharacteristic
The service characteristic details.
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.
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.
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.
202 Response
object
-
activity: object
GroomActivity
Groom activity is used to change the design of Connectivity or Pipe even if the trails are riding on it. It will move a rider from source bearers to target bearers.
-
description: string
A free-text description for the project.
-
href: string
(uri)
Read Only:
true
The URI for the GroomProject class. -
id: string
Read Only:
true
The ID of the project. -
projectName: string
The name of the project.
-
status: string
Allowed Values:
[ "CREATED", "COMPLETED", "IN_PROGRESS" ]
The list of valid values for Project State.
object
-
activityItems: array
activityItems
-
activityName: string
The name of the activity.
-
id: string
The ID of the Activity.
-
impactedItems: array
impactedItems
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State.
array
-
Array of:
object GroomActivityItem
Groom activity item captures the details of the connectivity or pipe to be groomed.
array
-
Array of:
object ImpactedItem
Details of rehomed or groomed connectivity/pipe and trails (Connectivity/Pipe) impacted by the rehome or groom.
object
-
changedEntity:
changedEntity
Connectivity or Pipe to be groomed.
-
comments: string
Comments related to failure of groom activity item, if any.
-
source: array
source
The source connectivity/pipe on which the connectivity/pipe to be groomed is currently riding.
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State. -
target: array
target
The target connectivity/pipe on which the connectivity/pipe to be groomed needs to ride.
array
array
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
object
LogicalResource-allOf[1]
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
object
-
aendTerminationPoint: string
(uri)
The URI for aterminationPoint of the pipe.
-
allowSecondaryEnablement: boolean
To allow SecondaryEnablement for a pipe or not.
-
capacityConsumedRef: object
CapacityConsumed
Consumed capacity of pipe.
-
capacityProvidedRef: object
CapacityProvided
A capacity provided.
-
capacityRequiredRef: object
CapacityRequired
Required capacity of pipe.
-
channelSpacing: string
The channelSpacing of pipe.
-
gridType: string
Allowed Values:
[ "FIXED", "FLEX_GRID", "NONE" ]
The GridType of the pipe. Valid values are NONE, FIXED, FLEX_GRID. -
isVersioned: boolean
To denote whether pipe is versioned or not.
-
medium: string
Allowed Values:
[ "WIRELESS", "METALLIC", "FIBER", "SOFTWARE", "UNKNOWN", "NONE" ]
The Medium of the pipe. Valid values are NONE, WIRELESS, METALLIC, FIBER, SOFTWARE, UNKNOWN. -
parentPipeRef:
schema
A pipe resource.
-
pipeDirectionalityRef: array
pipeDirectionalityRef
The list of pipe directionalities.
-
primaryPathEnabled: object
PipeEnablement
Segment details that are enabling current Connectivity.
-
roles: array
roles
The list of pipe inventory roles.
-
secondaryPathEnabled: object
PipeEnablement
Segment details that are enabling current Connectivity.
-
totalConsumedCapacity: string
The total consumed capacity.
-
transmissionSignalType: string
Allowed Values:
[ "ELECTRICAL", "ELECTROMAGNETIC", "OPTICAL", "UNKNOWN", "NONE" ]
The TransmissionSignalType of the pipe. Valid values are NONE, ELECTRICAL, ELECTROMAGNETIC, OPTICAL, UNKNOWN. -
zendTerminationPoint: string
(uri)
The URI for zterminationPoint of the pipe.
object
-
capacityConsumed: string
Capacity consumed.
-
id: string
The id of the CapacityConsumed.
-
name: string
The name of the CapacityConsumed.
-
percentConsumed: string
Consumed capacity percentage.
object
-
capacityType: string
Capacity type of capacity provided.
-
consumablePercentage: string
Percentage of capacity that can be consumable.
-
totalAmount: string
Total amount of capacity provided.
-
unitOfMeasure: string
Unit of measure valid are Gbps,Kbps,Mbps,bps.
object
-
capacityType: string
Capacity type of required capacity.
-
quantity: integer
Percentage of capacity that can be consumable.
-
requiredAmount: string
Required amount of capacity.
-
unitOfMeasure: string
Unit of measure valid are Gbps,Kbps,Mbps,bps.
array
-
Array of:
object PipeDirectionality
A Pipe Directionality .
object
-
originatingTerminationPoint: string
The id of the originatingTerminationPoint.
-
pipeSegmentRef: array
pipeSegmentRef
The list of pipe segments.
-
terminatingTerminationPoint: string
The id of the terminatingTerminationPoint.
array
-
Array of:
object Role
A role.
object
-
directionalityType: string
Allowed Values:
[ "ROUTING", "SIGNAL" ]
The directionalityType of the pipe. -
pipeDirection: string
Allowed Values:
[ "BI_DIRECTIONAL", "UNI_DIRECTIONAL", "UNKNOWN" ]
The direction of the pipe. -
terminationDirectType1: string
Allowed Values:
[ "SINK", "SOURCE", "UNKNOWN" ]
The DirectType of the termination1. Valid values are SINK, SOURCE, UNKNOWN. -
terminationDirectType2: string
Allowed Values:
[ "SINK", "SOURCE", "UNKNOWN" ]
The DirectType of the termination2. Valid values are SINK, SOURCE, UNKNOWN. -
terminationId1: string
The ID of the termination1.
-
terminationId2: string
The ID of the termination2.
-
terminationName1: string
The name of the termination1.
-
terminationName2: string
The name of the termination2.
array
-
Array of:
object Segment
Segment details that are enabling current Connectivity.
object
-
aendLocation: string
A side Location.
-
asideInterface: object
LogicalResource
The base class for logical resources.
-
asidePhysicalPort: object
LogicalResource
The base class for logical resources.
-
asideTerminationPoint: string
The id of Termination point.
-
flowIdentifiers: array
flowIdentifiers
-
gapAccepted: boolean
Use this attribute to accept gap. Default Reason for accepting gap is auto-generated as "GAP OK"
-
interconnectionType: string
Allowed Values:
[ "CROSS_CONNECT", "PHYSICAL_JUMPER" ]
The list of valid values for InterConnectionType. -
isGap: boolean
Identifies if it is a gap or not.
-
lifeCycleBinding: string
Allowed Values:
[ "INTERFACE_BOUND", "TRAIL_BOUND", "HARDWIRED" ]
The list of valid values for InterConnectionLifeCycleBinding. -
segmentNumber: string
Segment number.
-
segmentRef:
segmentRef
-
zendLocation: string
Z side Location.
-
zsideInterface: object
LogicalResource
The base class for logical resources.
-
zsidePhysicalPort: object
LogicalResource
The base class for logical resources.
-
zsideTerminationPoint: string
The id of Termination point.
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
domain:
schema
A network address domain.
-
identifier: integer
The ID of the flow identifier.
-
identifierPrefix: string
Prefix for the Identifier.
-
lowerIdentifierValue: integer
The Lower ID of the flow identifier Range.
-
resourcePoolName: string
The Resource Pool Name of flow Identifier.
-
stackingLevel: integer
The stacking level of the flow identifier.
-
upperIdentifierValue: integer
The Upper ID of the flow identifier Range.
-
object
allOf
LogicalResource
The base class for logical resources.
-
object
type
object
-
managedBy: object
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
-
name: string
The name of the network address domain. It also indicates the ID of the domain.
-
networkAddressType: string
The type of network address, either IP Subnet or flow identifier.
-
ownedBy: object
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
object
-
@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.
object
-
roleName: string
The name of the role.
-
roleType: string
Allowed Values:
[ "NONE", "TECHNOLOGY", "FUNCTION", "TOPOLOGY", "TARGET" ]
The type of role.
object
-
ALocation: object
schema
A place to associate with the resource/service.
-
assignedToService: string
(uri)
The service (if any) to which the connectivity is assigned.
-
bitRate: string
The bit rate is based on the rate code applied to the connectivity.
-
capacityAvailable: string
Percentage of capacity that can be consumed.
-
connectivityDesign: object
ConnectivityDesign
Gives the details of latest connectivity design version.
-
connectivityIdentifier: string
A unique identifier of Connectivity.
-
consumablePercent: integer
Percentage of capacity that can be consumed.
-
function: string
The function that applies to connectivity. Functions apply only to connectivities that have rate codes that define them as facilities.
-
functionDisplayName: string
Read Only:
true
The display name of the function. -
identificationFormat: string
Allowed Values:
[ "LOCATION_BASED", "SERVICE_BASED", "CUSTOM_IDENTIFICATION" ]
The list of valid values for Connectivity identifier format. -
isAssignContiguousSerialNumber: boolean
Should be true if multiple Connectivity entities are created and want their serial numbers to be in a continuous block.
-
quantity: integer
The number of Connectivity entities to be created.
-
rateCode: string
The rate code that applies to connectivity.
-
serialNumber: integer
A number that uniquely identifies the connectivity within the context of other facilities that share the same A Network/Entity Location, Z Network/Entity Location, Rate Code, and Technology values.
-
technology: string
The technology that applies to connectivity.
-
ZLocation: object
schema
A place to associate with the resource/service.
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
-
aendLocation: object
schema
A place to associate with the resource/service.
-
asideFlowIdentifiers: array
asideFlowIdentifiers
-
asideInterface: object
LogicalResource
The base class for logical resources.
-
asideTerminationPointId: string
The id of Termination point on A side.
-
connectivityDesignVersion: integer
The version number of connectivity design.
-
paths: array
paths
-
startDate: string
(date-time)
The starting date and time when the connectivity design becomes effective.
-
status: string
Allowed Values:
[ "IN_PROGRESS", "DESIGNED", "ISSUED", "COMPLETED", "PENDING_CANCEL", "CANCELLED" ]
The list of valid values for configuration state. -
terminateAtFlowInterfaceOnAside: boolean
This should be true if A side needs to be terminated at Flow Interface.
-
terminateAtFlowInterfaceOnZside: boolean
This should be true if Z side needs to be terminated at Flow Interface.
-
zendLocation: object
schema
A place to associate with the resource/service.
-
zsideFlowIdentifiers: array
zsideFlowIdentifiers
-
zsideInterface: object
LogicalResource
The base class for logical resources.
-
zsideTerminationPointId: string
The id of Termination point on Z side.
array
-
Array of:
object ConnectivityPath
Paths that are enabling current Connectivity.
object
-
label: string
Path label like Path1, Path2.
-
segments: array
segments
array
-
Array of:
object Segment
Segment details that are enabling current Connectivity.
object
-
action: string
If impacted connectivity/pipe design does not have any gap, then the action is VIEW DESIGN. If impacted connectivity/pipe design is not completed due to gap, then the action is RESOLVE GAP. If impacted item is service then the action is VIEW SERVICE.
-
changedEntity:
changedEntity
Impacted Connectivity or Pipe after rehome or groom.
-
parentChangeItem: string
Parent activity item due to which this item got imapacted.
-
serviceChangeEntity: object
schema
Service Class.
-
status: string
Allowed Values:
[ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
The list of valid values for Activity State.
object
-
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).
-
object
allOf
PhysicalResource
The base class for physical resources.
-
object
type
object
-
object
Discriminator: @type
Discriminator:
{ "propertyName":"@type" }
A base resource Class. -
object
PhysicalResource-allOf[1]
object
-
serialNumber: string
The serial number for the physical resource.
object
-
category: string
Read Only:
true
The category, or grouping, of equipment built from this specification. The valid values are RACK, SHELF, and CARD. -
modelNumber: string
Read Only:
true
The manufacturer-allocated number used to identify the general type and/or category of the hardware. This, in combination with the part number, identifies different types of hardware. -
networkLocation: object
schema
A place to associate with the resource/service.
-
partNumber: string
Read Only:
true
The manufacturer-allocated part number assigned by the organization that manufactures the hardware. This, in combination with model number, identifies different types of hardware. -
physicalConnectors: string
(uri)
Read Only:
true
The URI for the list of physical connector instances provided by the equipment instance. -
physicalPorts: string
(uri)
Read Only:
true
The URI for the physical port instances provided by the equipment instance. -
roles: array
roles
The list of equipment inventory roles.
-
vendorName: string
Read Only:
true
The name of the equipment manufacturer.
array
-
Array of:
object Role
A role.
object
-
id: string
The id of Business Interaction
-
state: string
The state of Business Interaction
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.
array
-
Array of:
PlaceServiceRef
The place reference on a service.
array
-
Array of:
ServiceCharacteristic
The service characteristic details.
array
-
Array of:
object RelatedServiceOrderItem
The service order item which triggered service creation/change/termination.
array
-
Array of:
object ServiceRelationship
Describes links with services of the same category (useful for bundled services).
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.
array
-
Array of:
ResourceServiceRef
The resource reference on a service.
array
-
Array of:
object schema
Service Class.
-
object
schema
A place to associate with the resource/service.
-
object
PlaceServiceRef-allOf[1]
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'.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
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
RelatedPartyRef
A related party, which defines a party or party role linked to a specific entity.
-
object
RelatedPartyServiceRef-allOf[1]
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.
array
-
Array of:
object Characteristic
A characteristic of an object or entity represented by a name-value pair.
-
object
Characteristic
A characteristic of an object or entity represented by a name-value pair.
-
object
ServiceCharacteristic-allOf[1]
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.
object
-
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.
object
-
relationshipType(required): string
The type of relationship (e.g. depends on, enables)
-
service(required): object
schema
Service Class.
-
serviceRelationshipCharacteristic: array
serviceRelationshipCharacteristic
array
-
Array of:
ServiceCharacteristic
The service characteristic details.
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.
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.
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.
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 groom project for a given project name and activity name 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/groom -H 'content-type: application/json' -H credentials -d @groomcreate.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".
- groomcreate.json is the JSON file that specifies the groom entities to create.
Example of Request Body
This shows an example of the contents of the groomcreate.json file sent as the request body.{
"activity": {
"activityItems": [
{
"changedEntity": {
"@type": "Connectivity",
"id": "31-HYD_BBB.001 / SEC_BBB.001 / OM1 / OM1 / 1"
},
"source": [{
"@type": "Pipe",
"id": "30-hyd-sec-dwdm-fiber_BBB-01"
}
],
"target": [{
"@type": "Pipe",
"id": "30-hyd-sec-dwdm-fiber_BBB-02"}
]
}
]
}
}
Note:
If the project and activity names are not provided, the project and activity are created with the default names. Optionally, a single POST request can be sent for groom project creation and submission by adding a query parameter submit=true.
Example of Response Body
This example shows the contents of the response body in JSON format. The projectname and activityname values are auto-generated if not provided in the request body. The response code 201 is generated upon successful creation.
{
"id": "35-project75026",
"href": "http://localhost:7365/InventoryRSOpenAPI/resourceInventoryManagement/v3/groom/35-project75026/33-activity75026",
"projectName": "project75026",
"status": "CREATED",
"activity": {
"id": "33-activity75026",
"activityName": "activity75026",
"status": "READY",
"activityItems": [
{
"changedEntity": {
"id": "31-300222",
"href": "http://localhost:7365/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/31-300222",
"@type": "Connectivity",
"connectivityIdentifier": "LOC1_GRTC.001 / LOC4_GRTC.001 / 300M / E300 / 1"
},
"source": [
{
"id": "31-300206",
"href": "http://localhost:7365/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/31-300204",
"@type": "Connectivity",
"connectivityIdentifier": "LOC1_GRTC.001 / LOC2_GRTC.001 / STM4 / SM04 / 1 / 1-0-0-0"
},
{
"id": "31-300207",
"href": "http://localhost:7365/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/31-300204",
"@type": "Connectivity",
"connectivityIdentifier": "LOC1_GRTC.001 / LOC2_GRTC.001 / STM4 / SM04 / 1 / 2-0-0-0"
}
],
"target": [
{
"id": "31-300208",
"href": "http://localhost:7365/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/31-300204",
"@type": "Connectivity",
"connectivityIdentifier": "LOC1_GRTC.001 / LOC2_GRTC.001 / STM4 / SM04 / 1 / 3-0-0-0"
},
{
"id": "31-300209",
"href": "http://localhost:7365/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/31-300204",
"@type": "Connectivity",
"connectivityIdentifier": "LOC1_GRTC.001 / LOC2_GRTC.001 / STM4 / SM04 / 1 / 4-0-0-0"
}
],
"status": "READY",
"comments": ""
}
],
"impactedItems": []
}
}