Create a Replace Card activity

post

/replacecard

Creates a Project with Replace Card activity having specified replace card activity items.
Optionally, the project can be auto submitted by sending a query parameter 'submit=true'

Request

Query Parameters
Supported Media Types
Request Body - application/json ()
The replace card project to be created
Root Schema : schema
Type: object
ReplaceCard Project Class.
Show Source
Nested Schema : ReplaceCardActivity
Type: object
ReplaceCard Activity is used to replace an card equipment with other card equipment along with its consumers including Pipe, Connectivity and Service.
Show Source
Nested Schema : activityItems
Type: array
Show Source
Nested Schema : impactedItems
Type: array
Show Source
Nested Schema : schema
An equipment resource.
Match All
Show Source
Nested Schema : ReplaceCardActivityItem
Type: object
A replace card activity item captures details of Equipment being replaced and the port consumers(Connectivity/Pipe/Service) being rehomed.
Show Source
  • changedEntity
    The Shelf where the source card is being replaced. Connectivity/Pipe consumers of the port of the source card.
  • Comments related to failure of replace card activity items if any.
  • schema
    Service Class.
  • source
    Source Port on which connectivity or pipe or service are currently terminated. Source Card which is being replaced from the Shelf.
  • 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
    Target Port on which connectivity or pipe or service has to be rehomed. Target Card which is replacing the source card.
Nested Schema : changedEntity
The Shelf where the source card is being replaced. Connectivity/Pipe consumers of the port of the source card.
Match One Schema
Show Source
Nested Schema : schema
Type: object
Service Class.
Show Source
Nested Schema : source
Source Port on which connectivity or pipe or service are currently terminated. Source Card which is being replaced from the Shelf.
Match One Schema
Show Source
Nested Schema : target
Target Port on which connectivity or pipe or service has to be rehomed. Target Card which is replacing the source card.
Match One Schema
Show Source
Nested Schema : schema
A pipe resource.
Match All
Show Source
Nested Schema : schema
A Connectivity resource.
Match All
Show Source
Nested Schema : LogicalResource
Type: object
The base class for logical resources.
Match All
Show Source
Nested Schema : Discriminator: @type
Type: object
A base resource Class.
Show Source
Nested Schema : LogicalResource-allOf[1]
Type: object
Nested Schema : type
Type: object
Show Source
Nested Schema : CapacityConsumed
Type: object
Consumed capacity of pipe.
Show Source
Nested Schema : CapacityProvided
Type: object
A capacity provided.
Show Source
Nested Schema : CapacityRequired
Type: object
Required capacity of pipe.
Show Source
Nested Schema : pipeDirectionalityRef
Type: array
The list of pipe directionalities.
Show Source
Nested Schema : PipeEnablement
Type: object
Segment details that are enabling current Connectivity.
Show Source
Nested Schema : roles
Type: array
The list of pipe inventory roles.
Show Source
Nested Schema : PipeDirectionality
Type: object
A Pipe Directionality .
Show Source
Nested Schema : pipeSegmentRef
Type: array
The list of pipe segments.
Show Source
Nested Schema : Segment
Type: object
Segment details that are enabling current Connectivity.
Show Source
Nested Schema : flowIdentifiers
Type: array
Show Source
Nested Schema : segmentRef
Match One Schema
Show Source
Nested Schema : schema
A flow identifier.
Match All
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : schema
A network address domain.
Match All
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : RelatedPartyRef
Type: object
A related party, which defines a party or party role linked to a specific entity.
Show Source
Nested Schema : Role
Type: object
A role.
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : PlaceRef
Type: object
A place to associate with the resource/service.
Show Source
Nested Schema : ConnectivityDesign
Type: object
Gives the details of latest connectivity design version.
Show Source
Nested Schema : asideFlowIdentifiers
Type: array
Show Source
Nested Schema : paths
Type: array
Show Source
Nested Schema : zsideFlowIdentifiers
Type: array
Show Source
Nested Schema : ConnectivityPath
Type: object
Paths that are enabling current Connectivity.
Show Source
Nested Schema : segments
Type: array
Show Source
Nested Schema : BusinessInteractionRef
Type: object
Show Source
Nested Schema : ExternalIdentity
Type: object
An external identity.
Show Source
Nested Schema : place
Type: array
The list of associated geographic places, list of assigned/referenced geographic places, list of associated places on supported resources.
Show Source
Nested Schema : relatedParty
Type: array
A list of related party references (RelatedParty [1..*]). A related party defines party or party role linked to a specific entity.
Show Source
Nested Schema : serviceCharacteristic
Type: array
A list of characteristics that characterize this service (ServiceCharacteristic [*])
Show Source
Nested Schema : serviceOrderItem
Type: array
A list of related service order items (RelatedServiceOrderItem [*]). A list of service order items related to this service.
Show Source
Nested Schema : serviceRelationship
Type: array
A list of service relationships (ServiceRelationship [*]). Describes links with other service(s) in the inventory (useful for describing relies-on, relies-from between CFS for example).
Show Source
Nested Schema : Specification
Type: object
A specification.
Show Source
  • Details about the specification.
  • The date and time when the specification ends.
  • Allowed Values: [ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicLocation", "GeographicSite", "GeographicAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
    The list of valid values for an entity class.
  • The URI for the specification.
  • The ID of the specification, which is the same as the name of the specification.
  • The name of the specification.
  • The date and time when the specification starts.
  • The version of the specification, which is always 1.
Nested Schema : supportingResource
Type: array
A list of supporting resources (SupportingResource [*]).For CFS list includes all the supporting resources of RFS.
Show Source
Nested Schema : supportingService
Type: array
A list of supporting services (SupportingService [*]). A collection of services that support this service (bundling, link CFS to RFS).
Show Source
Nested Schema : PlaceServiceRef
The place reference on a service.
Match All
Show Source
Nested Schema : PlaceServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : placeCharacteristic
Type: array
The list of characteristics for the place.
Show Source
Nested Schema : Characteristic
Type: object
A characteristic of an object or entity represented by a name-value pair.
Show Source
Nested Schema : value
Type: object
The value of the characteristic.
Nested Schema : RelatedPartyServiceRef
The party reference on a service.
Match All
Show Source
Nested Schema : RelatedPartyServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : partyCharacteristic
Type: array
The list of characteristics for the party.
Show Source
Nested Schema : ServiceCharacteristic
The service characteristic details.
Match All
Show Source
Nested Schema : ServiceCharacteristic-allOf[1]
Type: object
Show Source
Nested Schema : RelatedServiceOrderItem
Type: object
The service order item which triggered service creation/change/termination.
Show Source
Nested Schema : ServiceRelationship
Type: object
Describes links with services of the same category (useful for bundled services).
Show Source
Nested Schema : serviceRelationshipCharacteristic
Type: array
Show Source
Nested Schema : ResourceServiceRef
The resource reference on a service.
Match All
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
  • Allowed Values: [ "DeviceInterface", "Equipment", "EquipmentHolder", "LogicalDevice", "LogicalDeviceAccount", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPNetwork", "IPSubnet", "NetworkAddressDomain", "FlowIdentifier", "CustomObject", "CustomNetworkAddress", "Pipe" ]
    The list of valid values for the resource type.
  • Read Only: true
    Reference of the supporting resource.
  • Unique identifier of the supporting resource.
  • Name of the resource supporting the service.
Nested Schema : ResourceServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : schema
A physical port.
Match All
Show Source
Nested Schema : PhysicalResource
Type: object
The base class for physical resources.
Match All
Show Source
Nested Schema : PhysicalResource-allOf[1]
Type: object
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : schema
A physical device resource.
Match All
Show Source
Nested Schema : roles
Type: array
The list of physical port inventory roles.
Show Source
Nested Schema : type
Type: object
Show Source
  • PlaceRef
    A place to associate with the resource/service.
  • The physical address of the device, such as a MAC address. This may correlate to the physical address of a media interface on the device. If the device has more than one physical address, this is considered the primary physical address.
  • Read Only: true
    The URI for the list of physical connector instances provided by the physical device instance.
  • The physical location of a resource. This value is a common and agreed upon location identification between the OSS (Operational Support System) and the NMS (Network Management System) or EMS (Element Management System).
  • Read Only: true
    The URI for the list of physical ports provided by the physical device instance.
  • roles
    The list of physical device inventory roles.
Nested Schema : roles
Type: array
The list of physical device inventory roles.
Show Source
Nested Schema : ImpactedItem
Type: object
Details of rehomed or groomed connectivity/pipe and trails (Connectivity/Pipe) impacted by the rehome or groom.
Show Source
  • 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
    Impacted Connectivity or Pipe after rehome or groom.
  • Parent activity item due to which this item got imapacted.
  • schema
    Service Class.
  • Allowed Values: [ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
    The list of valid values for Activity State.
Nested Schema : changedEntity
Impacted Connectivity or Pipe after rehome or groom.
Match One Schema
Show Source
Nested Schema : type
Type: object
Show Source
  • Read Only: true
    The category, or grouping, of equipment built from this specification. The valid values are RACK, SHELF, and CARD.
  • 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.
  • PlaceRef
    A place to associate with the resource/service.
  • 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.
  • Read Only: true
    The URI for the list of physical connector instances provided by the equipment instance.
  • Read Only: true
    The URI for the physical port instances provided by the equipment instance.
  • roles
    The list of equipment inventory roles.
  • Read Only: true
    The name of the equipment manufacturer.
Nested Schema : roles
Type: array
The list of equipment inventory roles.
Show Source
Back to Top

Response

Supported Media Types

201 Response

The replace card project was created successfully.
Body ()
Root Schema : schema
Type: object
ReplaceCard Project Class.
Show Source
Nested Schema : ReplaceCardActivity
Type: object
ReplaceCard Activity is used to replace an card equipment with other card equipment along with its consumers including Pipe, Connectivity and Service.
Show Source
Nested Schema : activityItems
Type: array
Show Source
Nested Schema : impactedItems
Type: array
Show Source
Nested Schema : schema
An equipment resource.
Match All
Show Source
Nested Schema : ReplaceCardActivityItem
Type: object
A replace card activity item captures details of Equipment being replaced and the port consumers(Connectivity/Pipe/Service) being rehomed.
Show Source
  • changedEntity
    The Shelf where the source card is being replaced. Connectivity/Pipe consumers of the port of the source card.
  • Comments related to failure of replace card activity items if any.
  • schema
    Service Class.
  • source
    Source Port on which connectivity or pipe or service are currently terminated. Source Card which is being replaced from the Shelf.
  • 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
    Target Port on which connectivity or pipe or service has to be rehomed. Target Card which is replacing the source card.
Nested Schema : changedEntity
The Shelf where the source card is being replaced. Connectivity/Pipe consumers of the port of the source card.
Match One Schema
Show Source
Nested Schema : schema
Type: object
Service Class.
Show Source
Nested Schema : source
Source Port on which connectivity or pipe or service are currently terminated. Source Card which is being replaced from the Shelf.
Match One Schema
Show Source
Nested Schema : target
Target Port on which connectivity or pipe or service has to be rehomed. Target Card which is replacing the source card.
Match One Schema
Show Source
Nested Schema : schema
A pipe resource.
Match All
Show Source
Nested Schema : schema
A Connectivity resource.
Match All
Show Source
Nested Schema : LogicalResource
Type: object
The base class for logical resources.
Match All
Show Source
Nested Schema : Discriminator: @type
Type: object
A base resource Class.
Show Source
Nested Schema : LogicalResource-allOf[1]
Type: object
Nested Schema : type
Type: object
Show Source
Nested Schema : CapacityConsumed
Type: object
Consumed capacity of pipe.
Show Source
Nested Schema : CapacityProvided
Type: object
A capacity provided.
Show Source
Nested Schema : CapacityRequired
Type: object
Required capacity of pipe.
Show Source
Nested Schema : pipeDirectionalityRef
Type: array
The list of pipe directionalities.
Show Source
Nested Schema : PipeEnablement
Type: object
Segment details that are enabling current Connectivity.
Show Source
Nested Schema : roles
Type: array
The list of pipe inventory roles.
Show Source
Nested Schema : PipeDirectionality
Type: object
A Pipe Directionality .
Show Source
Nested Schema : pipeSegmentRef
Type: array
The list of pipe segments.
Show Source
Nested Schema : Segment
Type: object
Segment details that are enabling current Connectivity.
Show Source
Nested Schema : flowIdentifiers
Type: array
Show Source
Nested Schema : segmentRef
Match One Schema
Show Source
Nested Schema : schema
A flow identifier.
Match All
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : schema
A network address domain.
Match All
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : RelatedPartyRef
Type: object
A related party, which defines a party or party role linked to a specific entity.
Show Source
Nested Schema : Role
Type: object
A role.
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : PlaceRef
Type: object
A place to associate with the resource/service.
Show Source
Nested Schema : ConnectivityDesign
Type: object
Gives the details of latest connectivity design version.
Show Source
Nested Schema : asideFlowIdentifiers
Type: array
Show Source
Nested Schema : paths
Type: array
Show Source
Nested Schema : zsideFlowIdentifiers
Type: array
Show Source
Nested Schema : ConnectivityPath
Type: object
Paths that are enabling current Connectivity.
Show Source
Nested Schema : segments
Type: array
Show Source
Nested Schema : BusinessInteractionRef
Type: object
Show Source
Nested Schema : ExternalIdentity
Type: object
An external identity.
Show Source
Nested Schema : place
Type: array
The list of associated geographic places, list of assigned/referenced geographic places, list of associated places on supported resources.
Show Source
Nested Schema : relatedParty
Type: array
A list of related party references (RelatedParty [1..*]). A related party defines party or party role linked to a specific entity.
Show Source
Nested Schema : serviceCharacteristic
Type: array
A list of characteristics that characterize this service (ServiceCharacteristic [*])
Show Source
Nested Schema : serviceOrderItem
Type: array
A list of related service order items (RelatedServiceOrderItem [*]). A list of service order items related to this service.
Show Source
Nested Schema : serviceRelationship
Type: array
A list of service relationships (ServiceRelationship [*]). Describes links with other service(s) in the inventory (useful for describing relies-on, relies-from between CFS for example).
Show Source
Nested Schema : Specification
Type: object
A specification.
Show Source
  • Details about the specification.
  • The date and time when the specification ends.
  • Allowed Values: [ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicLocation", "GeographicSite", "GeographicAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
    The list of valid values for an entity class.
  • The URI for the specification.
  • The ID of the specification, which is the same as the name of the specification.
  • The name of the specification.
  • The date and time when the specification starts.
  • The version of the specification, which is always 1.
Nested Schema : supportingResource
Type: array
A list of supporting resources (SupportingResource [*]).For CFS list includes all the supporting resources of RFS.
Show Source
Nested Schema : supportingService
Type: array
A list of supporting services (SupportingService [*]). A collection of services that support this service (bundling, link CFS to RFS).
Show Source
Nested Schema : PlaceServiceRef
The place reference on a service.
Match All
Show Source
Nested Schema : PlaceServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : placeCharacteristic
Type: array
The list of characteristics for the place.
Show Source
Nested Schema : Characteristic
Type: object
A characteristic of an object or entity represented by a name-value pair.
Show Source
Nested Schema : value
Type: object
The value of the characteristic.
Nested Schema : RelatedPartyServiceRef
The party reference on a service.
Match All
Show Source
Nested Schema : RelatedPartyServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : partyCharacteristic
Type: array
The list of characteristics for the party.
Show Source
Nested Schema : ServiceCharacteristic
The service characteristic details.
Match All
Show Source
Nested Schema : ServiceCharacteristic-allOf[1]
Type: object
Show Source
Nested Schema : RelatedServiceOrderItem
Type: object
The service order item which triggered service creation/change/termination.
Show Source
Nested Schema : ServiceRelationship
Type: object
Describes links with services of the same category (useful for bundled services).
Show Source
Nested Schema : serviceRelationshipCharacteristic
Type: array
Show Source
Nested Schema : ResourceServiceRef
The resource reference on a service.
Match All
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
  • Allowed Values: [ "DeviceInterface", "Equipment", "EquipmentHolder", "LogicalDevice", "LogicalDeviceAccount", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPNetwork", "IPSubnet", "NetworkAddressDomain", "FlowIdentifier", "CustomObject", "CustomNetworkAddress", "Pipe" ]
    The list of valid values for the resource type.
  • Read Only: true
    Reference of the supporting resource.
  • Unique identifier of the supporting resource.
  • Name of the resource supporting the service.
Nested Schema : ResourceServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : schema
A physical port.
Match All
Show Source
Nested Schema : PhysicalResource
Type: object
The base class for physical resources.
Match All
Show Source
Nested Schema : PhysicalResource-allOf[1]
Type: object
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : schema
A physical device resource.
Match All
Show Source
Nested Schema : roles
Type: array
The list of physical port inventory roles.
Show Source
Nested Schema : type
Type: object
Show Source
  • PlaceRef
    A place to associate with the resource/service.
  • The physical address of the device, such as a MAC address. This may correlate to the physical address of a media interface on the device. If the device has more than one physical address, this is considered the primary physical address.
  • Read Only: true
    The URI for the list of physical connector instances provided by the physical device instance.
  • The physical location of a resource. This value is a common and agreed upon location identification between the OSS (Operational Support System) and the NMS (Network Management System) or EMS (Element Management System).
  • Read Only: true
    The URI for the list of physical ports provided by the physical device instance.
  • roles
    The list of physical device inventory roles.
Nested Schema : roles
Type: array
The list of physical device inventory roles.
Show Source
Nested Schema : ImpactedItem
Type: object
Details of rehomed or groomed connectivity/pipe and trails (Connectivity/Pipe) impacted by the rehome or groom.
Show Source
  • 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
    Impacted Connectivity or Pipe after rehome or groom.
  • Parent activity item due to which this item got imapacted.
  • schema
    Service Class.
  • Allowed Values: [ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
    The list of valid values for Activity State.
Nested Schema : changedEntity
Impacted Connectivity or Pipe after rehome or groom.
Match One Schema
Show Source
Nested Schema : type
Type: object
Show Source
  • Read Only: true
    The category, or grouping, of equipment built from this specification. The valid values are RACK, SHELF, and CARD.
  • 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.
  • PlaceRef
    A place to associate with the resource/service.
  • 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.
  • Read Only: true
    The URI for the list of physical connector instances provided by the equipment instance.
  • Read Only: true
    The URI for the physical port instances provided by the equipment instance.
  • roles
    The list of equipment inventory roles.
  • Read Only: true
    The name of the equipment manufacturer.
Nested Schema : roles
Type: array
The list of equipment inventory roles.
Show Source

202 Response

The replace card project was created successfully and is auto submitted. Activity will be processed asynchronously.
Body ()
Root Schema : schema
Type: object
ReplaceCard Project Class.
Show Source
Nested Schema : ReplaceCardActivity
Type: object
ReplaceCard Activity is used to replace an card equipment with other card equipment along with its consumers including Pipe, Connectivity and Service.
Show Source
Nested Schema : activityItems
Type: array
Show Source
Nested Schema : impactedItems
Type: array
Show Source
Nested Schema : schema
An equipment resource.
Match All
Show Source
Nested Schema : ReplaceCardActivityItem
Type: object
A replace card activity item captures details of Equipment being replaced and the port consumers(Connectivity/Pipe/Service) being rehomed.
Show Source
  • changedEntity
    The Shelf where the source card is being replaced. Connectivity/Pipe consumers of the port of the source card.
  • Comments related to failure of replace card activity items if any.
  • schema
    Service Class.
  • source
    Source Port on which connectivity or pipe or service are currently terminated. Source Card which is being replaced from the Shelf.
  • 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
    Target Port on which connectivity or pipe or service has to be rehomed. Target Card which is replacing the source card.
Nested Schema : changedEntity
The Shelf where the source card is being replaced. Connectivity/Pipe consumers of the port of the source card.
Match One Schema
Show Source
Nested Schema : schema
Type: object
Service Class.
Show Source
Nested Schema : source
Source Port on which connectivity or pipe or service are currently terminated. Source Card which is being replaced from the Shelf.
Match One Schema
Show Source
Nested Schema : target
Target Port on which connectivity or pipe or service has to be rehomed. Target Card which is replacing the source card.
Match One Schema
Show Source
Nested Schema : schema
A pipe resource.
Match All
Show Source
Nested Schema : schema
A Connectivity resource.
Match All
Show Source
Nested Schema : LogicalResource
Type: object
The base class for logical resources.
Match All
Show Source
Nested Schema : Discriminator: @type
Type: object
A base resource Class.
Show Source
Nested Schema : LogicalResource-allOf[1]
Type: object
Nested Schema : type
Type: object
Show Source
Nested Schema : CapacityConsumed
Type: object
Consumed capacity of pipe.
Show Source
Nested Schema : CapacityProvided
Type: object
A capacity provided.
Show Source
Nested Schema : CapacityRequired
Type: object
Required capacity of pipe.
Show Source
Nested Schema : pipeDirectionalityRef
Type: array
The list of pipe directionalities.
Show Source
Nested Schema : PipeEnablement
Type: object
Segment details that are enabling current Connectivity.
Show Source
Nested Schema : roles
Type: array
The list of pipe inventory roles.
Show Source
Nested Schema : PipeDirectionality
Type: object
A Pipe Directionality .
Show Source
Nested Schema : pipeSegmentRef
Type: array
The list of pipe segments.
Show Source
Nested Schema : Segment
Type: object
Segment details that are enabling current Connectivity.
Show Source
Nested Schema : flowIdentifiers
Type: array
Show Source
Nested Schema : segmentRef
Match One Schema
Show Source
Nested Schema : schema
A flow identifier.
Match All
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : schema
A network address domain.
Match All
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : RelatedPartyRef
Type: object
A related party, which defines a party or party role linked to a specific entity.
Show Source
Nested Schema : Role
Type: object
A role.
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : PlaceRef
Type: object
A place to associate with the resource/service.
Show Source
Nested Schema : ConnectivityDesign
Type: object
Gives the details of latest connectivity design version.
Show Source
Nested Schema : asideFlowIdentifiers
Type: array
Show Source
Nested Schema : paths
Type: array
Show Source
Nested Schema : zsideFlowIdentifiers
Type: array
Show Source
Nested Schema : ConnectivityPath
Type: object
Paths that are enabling current Connectivity.
Show Source
Nested Schema : segments
Type: array
Show Source
Nested Schema : BusinessInteractionRef
Type: object
Show Source
Nested Schema : ExternalIdentity
Type: object
An external identity.
Show Source
Nested Schema : place
Type: array
The list of associated geographic places, list of assigned/referenced geographic places, list of associated places on supported resources.
Show Source
Nested Schema : relatedParty
Type: array
A list of related party references (RelatedParty [1..*]). A related party defines party or party role linked to a specific entity.
Show Source
Nested Schema : serviceCharacteristic
Type: array
A list of characteristics that characterize this service (ServiceCharacteristic [*])
Show Source
Nested Schema : serviceOrderItem
Type: array
A list of related service order items (RelatedServiceOrderItem [*]). A list of service order items related to this service.
Show Source
Nested Schema : serviceRelationship
Type: array
A list of service relationships (ServiceRelationship [*]). Describes links with other service(s) in the inventory (useful for describing relies-on, relies-from between CFS for example).
Show Source
Nested Schema : Specification
Type: object
A specification.
Show Source
  • Details about the specification.
  • The date and time when the specification ends.
  • Allowed Values: [ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicLocation", "GeographicSite", "GeographicAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
    The list of valid values for an entity class.
  • The URI for the specification.
  • The ID of the specification, which is the same as the name of the specification.
  • The name of the specification.
  • The date and time when the specification starts.
  • The version of the specification, which is always 1.
Nested Schema : supportingResource
Type: array
A list of supporting resources (SupportingResource [*]).For CFS list includes all the supporting resources of RFS.
Show Source
Nested Schema : supportingService
Type: array
A list of supporting services (SupportingService [*]). A collection of services that support this service (bundling, link CFS to RFS).
Show Source
Nested Schema : PlaceServiceRef
The place reference on a service.
Match All
Show Source
Nested Schema : PlaceServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : placeCharacteristic
Type: array
The list of characteristics for the place.
Show Source
Nested Schema : Characteristic
Type: object
A characteristic of an object or entity represented by a name-value pair.
Show Source
Nested Schema : value
Type: object
The value of the characteristic.
Nested Schema : RelatedPartyServiceRef
The party reference on a service.
Match All
Show Source
Nested Schema : RelatedPartyServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : partyCharacteristic
Type: array
The list of characteristics for the party.
Show Source
Nested Schema : ServiceCharacteristic
The service characteristic details.
Match All
Show Source
Nested Schema : ServiceCharacteristic-allOf[1]
Type: object
Show Source
Nested Schema : RelatedServiceOrderItem
Type: object
The service order item which triggered service creation/change/termination.
Show Source
Nested Schema : ServiceRelationship
Type: object
Describes links with services of the same category (useful for bundled services).
Show Source
Nested Schema : serviceRelationshipCharacteristic
Type: array
Show Source
Nested Schema : ResourceServiceRef
The resource reference on a service.
Match All
Show Source
Nested Schema : ResourceRef
Type: object
Show Source
  • Allowed Values: [ "DeviceInterface", "Equipment", "EquipmentHolder", "LogicalDevice", "LogicalDeviceAccount", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPNetwork", "IPSubnet", "NetworkAddressDomain", "FlowIdentifier", "CustomObject", "CustomNetworkAddress", "Pipe" ]
    The list of valid values for the resource type.
  • Read Only: true
    Reference of the supporting resource.
  • Unique identifier of the supporting resource.
  • Name of the resource supporting the service.
Nested Schema : ResourceServiceRef-allOf[1]
Type: object
Show Source
Nested Schema : schema
A physical port.
Match All
Show Source
Nested Schema : PhysicalResource
Type: object
The base class for physical resources.
Match All
Show Source
Nested Schema : PhysicalResource-allOf[1]
Type: object
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : schema
A physical device resource.
Match All
Show Source
Nested Schema : roles
Type: array
The list of physical port inventory roles.
Show Source
Nested Schema : type
Type: object
Show Source
  • PlaceRef
    A place to associate with the resource/service.
  • The physical address of the device, such as a MAC address. This may correlate to the physical address of a media interface on the device. If the device has more than one physical address, this is considered the primary physical address.
  • Read Only: true
    The URI for the list of physical connector instances provided by the physical device instance.
  • The physical location of a resource. This value is a common and agreed upon location identification between the OSS (Operational Support System) and the NMS (Network Management System) or EMS (Element Management System).
  • Read Only: true
    The URI for the list of physical ports provided by the physical device instance.
  • roles
    The list of physical device inventory roles.
Nested Schema : roles
Type: array
The list of physical device inventory roles.
Show Source
Nested Schema : ImpactedItem
Type: object
Details of rehomed or groomed connectivity/pipe and trails (Connectivity/Pipe) impacted by the rehome or groom.
Show Source
  • 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
    Impacted Connectivity or Pipe after rehome or groom.
  • Parent activity item due to which this item got imapacted.
  • schema
    Service Class.
  • Allowed Values: [ "PENDING", "READY", "IN_PROGRESS", "ABORTED", "ERROR", "FAILED", "PENDING_COMPLETE", "COMPLETED", "PENDING_PROCESS", "PENDING_ABORT" ]
    The list of valid values for Activity State.
Nested Schema : changedEntity
Impacted Connectivity or Pipe after rehome or groom.
Match One Schema
Show Source
Nested Schema : type
Type: object
Show Source
  • Read Only: true
    The category, or grouping, of equipment built from this specification. The valid values are RACK, SHELF, and CARD.
  • 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.
  • PlaceRef
    A place to associate with the resource/service.
  • 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.
  • Read Only: true
    The URI for the list of physical connector instances provided by the equipment instance.
  • Read Only: true
    The URI for the physical port instances provided by the equipment instance.
  • roles
    The list of equipment inventory roles.
  • Read Only: true
    The name of the equipment manufacturer.
Nested Schema : roles
Type: array
The list of equipment inventory roles.
Show Source

400 Response

The request isn't valid.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
  • The error code.
  • Allowed Values: [ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicLocation", "GeographicSite", "GeographicAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
    The list of valid values for an entity class.
  • message
    The text that provides more details about the error as well as corrective actions.
  • The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
  • The URL pointing to the documentation that describes the error.
  • The HTTP error code extension, such as 400-2.
Nested Schema : message
Type: array
The text that provides more details about the error as well as corrective actions.
Show Source

401 Response

You aren't authorized to make this request.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
  • The error code.
  • Allowed Values: [ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicLocation", "GeographicSite", "GeographicAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
    The list of valid values for an entity class.
  • message
    The text that provides more details about the error as well as corrective actions.
  • The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
  • The URL pointing to the documentation that describes the error.
  • The HTTP error code extension, such as 400-2.
Nested Schema : message
Type: array
The text that provides more details about the error as well as corrective actions.
Show Source

403 Response

The request is forbidden.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
  • The error code.
  • Allowed Values: [ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicLocation", "GeographicSite", "GeographicAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
    The list of valid values for an entity class.
  • message
    The text that provides more details about the error as well as corrective actions.
  • The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
  • The URL pointing to the documentation that describes the error.
  • The HTTP error code extension, such as 400-2.
Nested Schema : message
Type: array
The text that provides more details about the error as well as corrective actions.
Show Source

500 Response

An internal server error occurred.
Body ()
Root Schema : Error
Type: object
Used when an API throws an error. This is typically used with HTTP error response codes (3xx, 4xx, 5xx).
Show Source
  • The error code.
  • Allowed Values: [ "CustomObject", "CustomNetworkAddress", "DeviceInterface", "Equipment", "EquipmentHolder", "FlowIdentifier", "GeographicLocation", "GeographicSite", "GeographicAddress", "PropertyLocation", "LogicalDevice", "LogicalDeviceAccount", "MediaStream", "Network", "PhysicalConnector", "PhysicalDevice", "PhysicalPort", "Pipe", "Service", "TelephoneNumber", "IPV4Address", "IPV6Address", "IPSubnet", "NetworkAddressDomain", "Connectivity", "Party" ]
    The list of valid values for an entity class.
  • message
    The text that provides more details about the error as well as corrective actions.
  • The short, user-friendly summary of the problem, which does not change for subsequent occurrences of the problem.
  • The URL pointing to the documentation that describes the error.
  • The HTTP error code extension, such as 400-2.
Nested Schema : message
Type: array
The text that provides more details about the error as well as corrective actions.
Show Source
Back to Top

Examples

This example shows how to create a replace card 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/replacecard -H 'content-type: application/json' -H credentials -d @replacecardcreate.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".
  • replacecardcreate.json is the JSON file that specifies the replace card entities to create.

Example of Request Body

This shows an example of the contents of the replacecardcreate.json file sent as the request body.
{
    "projectName": "ReplaceCardRESTProject_29",
    "activity": {
        "activityName": "ReplaceCardRESTActivity_29",
        "autoMap": true,
        "sourceCard": {
            "id": "8-525014",
            "@type": "Equipment"
        },
        "targetCard": {
            "id": "8-EqRC_New_A04",
            "@type": "Equipment"
        }
    }
}
{
    "projectName": "ReplaceCardRESTProject_30",
    "activity": {
        "activityName": "ReplaceCardRESTActivity_30",
        "autoMap": false,
        "sourceCard": {
            "id": "8-525024",
            "@type": "Equipment"
        },
        "targetCard": {
            "id": "8-EqRC_New_A09",
            "@type": "Equipment"
        }
        "activityItems": [
            {
                "source": {
                    "id": "10-525024-525170",
                    "@type": "PhysicalPort"
                },
                "target": {
                    "id": "10-EqRC_New_A09-525177",
                    "@type": "PhysicalPort"
                }
            },
            {
                "changedEntity": {
                    "id": "AAA / BBB / OTU3 / OTU3 / 22",
                    "@type": "Connectivity"
                },
                "source": {
                    "id": "10-525005-525033",
                    "@type": "PhysicalPort"
                },
                "target": {
                    "id": "10-EqRC_New_F27-525039",
                    "@type": "PhysicalPort"
                }
            },
            {
                "serviceChangeEntity": {
                    "id": "ServiceRC_A_A99"
                },
                "source": {
                    "id": "10-525005-525032",
                    "@type": "PhysicalPort"
                },
                "target": {
                    "id": "10-EqRC_New_F27-525040",
                    "@type": "PhysicalPort"
                }
            }
        ]
    }
}

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 rehome project creation and submission by adding a query parameter submit=true.

If autoMap is true, all the consumers from physical ports of source card are rehomed to physical ports of the target cards. Therefore, for autoMap = true, the target card should have equal or more number of physical ports than the source card.

If autoMap is false, the activity items are created to address each and every consumer of the source card's physical ports. The activity items are created as follows:

  • If only source and target are mentioned with no information on the consumers, all the consumers on the source port are rehomed to the target port.
  • For connectivity or pipe, changedEntity is passed with the activity, along with the corresponding source and target. For changedEntity, the id and type properties are provided.
  • For service, serviceChangedEntity is passed with the activity, along with the corresponding source and target. For serviceChangedEntity, only the id property is provided.

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": "36-ReplaceCardProject1_RCMT15",
    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/replacecard/36-ReplaceCardProject1_RCMT15/33-RC_1_RCMT15",
    "projectName": "ReplaceCardProject1_RCMT15",
    "status": "CREATED",
    "activity": {
        "id": "33-RC_1_RCMT15",
        "activityName": "RC_1_RCMT15",
        "status": "READY",
        "activityItems": [
            {
                "changedEntity": {
                    "id": "8-EQ.AAA.F1_RCMT15",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/8-EQ.AAA.F1_RCMT15",
                    "@type": "Equipment"
                },
                "source": {
                    "id": "8-2100002",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/8-2100002",
                    "@type": "Equipment"
                },
                "target": {
                    "id": "8-EQ.PAR.AAA.New_RCMT15",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/8-EQ.PAR.AAA.New_RCMT15",
                    "@type": "Equipment"
                },
                "status": "READY",
                "comments": ""
            },
            {
                "serviceChangedEntity": {
                    "id": "ServiceRC_A_RCMT15",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/serviceInventoryManagement/v3/service/ServiceRC_A_RCMT15"
                },
                "source": {
                    "id": "10-2100002-2100005",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/10-2100002-2100005",
                    "@type": "PhysicalPort"
                },
                "target": {
                    "id": "10-EQ.PAR.AAA.New_RCMT15-2100045",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/10-EQ.PAR.AAA.New_RCMT15-2100045",
                    "@type": "PhysicalPort"
                },
                "status": "READY",
                "comments": ""
            },
            {
                "changedEntity": {
                    "id": "31-1650003",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/31-1650003",
                    "@type": "Connectivity",
                    "connectivityIdentifier": "AAA_RCMT15 / BBB_RCMT15 / STM4 / SM04 / 1"
                },
                "source": {
                    "id": "10-EQ.SUB.AAA.F1_RCMT15-2100025",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/10-EQ.SUB.AAA.F1_RCMT15-2100025",
                    "@type": "PhysicalPort"
                },
                "target": {
                    "id": "10-EQ.SUB.AAA.New_RCMT15-2100040",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/10-EQ.SUB.AAA.New_RCMT15-2100040",
                    "@type": "PhysicalPort"
                },
                "status": "READY",
                "comments": ""
            },
            {
                "changedEntity": {
                    "id": "31-1650001",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/31-1650001",
                    "@type": "Connectivity",
                    "connectivityIdentifier": "AAA_RCMT15 / CCC_RCMT15 / 300M / E300 / 1"
                },
                "source": {
                    "id": "10-EQ.SUB.AAA.F1_RCMT15-2100025",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/10-EQ.SUB.AAA.F1_RCMT15-2100025",
                    "@type": "PhysicalPort"
                },
                "target": {
                    "id": "10-EQ.SUB.AAA.New_RCMT15-2100040",
                    "href": "http://localhost:7222/InventoryRSOpenAPI/resourceInventoryManagement/v3/resource/10-EQ.SUB.AAA.New_RCMT15-2100040",
                    "@type": "PhysicalPort"
                },
                "status": "READY",
                "comments": ""
            }
        ],
        "impactedItems": []
    }
}

Note:

The first activity item is always to replace a source card with a target card from its parent equipment.

Back to Top