1. REST API for Unified Inventory Management
  2. Tasks
  3. Service
  4. Bundle

Create/Update a Bundle Service

post

/bundle

Create or Update a Bundle Service based on id provided in the input. Create a bundle service when id is not provided in the input, otherwise it will update the existing bundle service. If designOnly flag is true, then bundle service will be in designed state otherwise it moves to completed state.

Create a bundle service with the given details incase of bundle id is not provided in input. The following fields are mandatory fields in each of the bundle service items for successful creation:

  • name
  • serviceSpecification
  • state

Updation of bundle service can be performed when bundle id provided in the input. Kindly note that id,description,name,supportingResource,relatedParty,serviceCharacteristic,place,externalIdentity are the only attributes to be passed under each of the items during updation of bundle service.

Attribute selection is enabled for all first-level attributes.

Optionally, use the expand parameter to specify any service relationships that you want to see details for. By default, you'll just see links for these.

Optionally, use the depth parameter to expand the level of referenced entities. If depth=0, all referenced entities in RootEntity objects will contain only the ID, HREF, and @type. If depth=N, it expands reference objects of related entities recursively, and the last level contains only the references. The default is depth=0.

Request

Query Parameters
  • This flag is used to control activation flow. When it is 'true', changes applied but not activated. When it is 'false', changes applied and sequentially Approve/Issue/Activate requests executed to activate changes.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Bundle Service.
Show Source
Nested Schema : items
Type: array
A list of items (Service [*]).
Show Source
Nested Schema : schema
Type: object
Service Class.
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
The place reference on a service.
The place reference on a service.
Show Source
Nested Schema : PlaceRef
Type: object
A place to associate with the resource/service.
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
The party reference on a service.
The party reference on a service.
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 : 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
The service characteristic details.
The service characteristic details.
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
The resource reference on a service.
The resource reference on a service.
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 : Discriminator: @type
Type: object
A base resource Class.
Show Source
Nested Schema : externalIdentity
Type: object
Read Only: true
The external identity details for the federated resource.
Match All
The external identity details for the federated resource.
Show Source
Nested Schema : place
Type: array
The list of associated geographic places.
Show Source
Nested Schema : resourceCharacteristic
Type: array
The list of characteristics for the resource.
Show Source
Nested Schema : resourceRelationship
Type: array
The list of all resources referenced with the current resource. For example, parent resource, associated resource, etc.
Show Source
Nested Schema : ResourceRelationship
Type: object
A relationship to a resource.
Show Source
Back to Top

Response

Supported Media Types

201 Response

The bundle service was created successfully.
Body ()
Root Schema : schema
Type: object
Bundle Service.
Show Source
Nested Schema : items
Type: array
A list of items (Service [*]).
Show Source
Nested Schema : schema
Type: object
Service Class.
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
The place reference on a service.
The place reference on a service.
Show Source
Nested Schema : PlaceRef
Type: object
A place to associate with the resource/service.
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
The party reference on a service.
The party reference on a service.
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 : 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
The service characteristic details.
The service characteristic details.
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
The resource reference on a service.
The resource reference on a service.
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 : Discriminator: @type
Type: object
A base resource Class.
Show Source
Nested Schema : externalIdentity
Type: object
Read Only: true
The external identity details for the federated resource.
Match All
The external identity details for the federated resource.
Show Source
Nested Schema : place
Type: array
The list of associated geographic places.
Show Source
Nested Schema : resourceCharacteristic
Type: array
The list of characteristics for the resource.
Show Source
Nested Schema : resourceRelationship
Type: array
The list of all resources referenced with the current resource. For example, parent resource, associated resource, etc.
Show Source
Nested Schema : ResourceRelationship
Type: object
A relationship to a resource.
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

404 Response

The resources wasn't found.
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

Example for Creating a Bundle Service

This example shows how to create a bundle service with the given specification by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Install and Use cURL".

cURL Command

curl -X POST "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/bundle" -H 'content-type: application/json' -H credentials -d @bundleservicecreate.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".
  • bundleservicecreate.json is the JSON file that specifies the bundle service to create.

Example of Request Body

This shows an example of the contents of the bundleservicecreate.json file sent as the request body.

Note:

In ServiceCharacteristic, the serviceSpecName value is a mandatory input for service and ServiceConfiguration characteristics. The serviceSpecName parameter is used to distinguish to which service and serviceConfiguration do the characteristics belong. The configItemPath parameter is a mandatory input to denote ServiceConfigurationItem level properties or characteristics.

For place and relatedParty, the null value for configItemName indicates that place or relatedParty is for associating the service. For any other value, it can be an assignment or a reference on ServiceConfigItem. 

{
"items" : [
{
   "name": "BroadbandCFS1",
   "supportingResource": [
      {
         "id": "1-1",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      },
      {
         "id": "1-75001",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      }
   ],
   "relatedParty": [
      {
         "id": "225002",
         "referenceType": "Association",
         "consumerName": "BroadbandCFS1",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      },
      {
         "id": "225003",
         "referenceType": "Reference",
         "consumerName": "DOCSISRFS",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      }
   ],
   "serviceCharacteristic": [
      {
         "name": "serviceRelType1",
         "valueType": "ALPHANUMERIC",
         "value": "relies-on",
         "serviceName": "BroadbandCFS1",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
      },
      {
         "name": "serviceRel1",
         "valueType": "ALPHANUMERIC",
         "value": "EmaiLCFS",
         "serviceName": "BroadbandCFS1",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
      },
      {
         "name": "Config_Profile_ID",
         "valueType": "ALPHANUMERIC",
         "value": "Motorola",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"

      },
      {
         "name": "CPE_Enabled",
         "valueType": "BOOLEAN",
         "value": "true",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"
      },
      {
         "name": "MaxUpstream",
         "valueType": "ALPHANUMERIC",
         "value": "20 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"
      },
      {
         "name": "MaxDownstream",
         "valueType": "ALPHANUMERIC",
         "value": "150 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"
      }
   ],
   "serviceRelationship": [
      {
         "relationshipType": "relies-on",
         "service": {
            "id": "450005"
         }
      }
   ],
   "serviceSpecification": {
        "id": "Broadband_Internet_Access_CFS",
        "name": "Broadband_Internet_Access_CFS",
        "entityType": "Service"
    },
   "state": "designed"
},
{
   "name": "BroadbandCFS2",
   "supportingResource": [
      {
         "id": "1-2",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      },
      {
         "id": "1-75002",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      }
   ],
   "relatedParty": [
      {
         "id": "225002",
         "referenceType": "Association",
         "consumerName": "BroadbandCFS2",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      },
      {
         "id": "225003",
         "referenceType": "Reference",
         "consumerName": "DOCSISRFS",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      }
   ],
   "serviceCharacteristic": [
      {
         "name": "serviceRelType1",
         "valueType": "ALPHANUMERIC",
         "value": "relies-on",
         "serviceName": "BroadbandCFS2",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"

      },
      {
         "name": "serviceRel1",
         "valueType": "ALPHANUMERIC",
         "value": "EmaiLCFS",
         "serviceName": "BroadbandCFS2",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"

      },
      {
         "name": "Config_Profile_ID",
         "valueType": "ALPHANUMERIC",
         "value": "Motorola",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"

      },
      {
         "name": "CPE_Enabled",
         "valueType": "BOOLEAN",
         "value": "true",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"

      },
      {
         "name": "MaxUpstream",
         "valueType": "ALPHANUMERIC",
         "value": "30 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"

      },
      {
         "name": "MaxDownstream",
         "valueType": "ALPHANUMERIC",
         "value": "160 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS"

      }
   ],
   "serviceRelationship": [
      {
         "relationshipType": "relies-on",
         "service": {
            "id": "450005",
         }
      }
   ],
   "serviceSpecification": {
        "id": "Broadband_Internet_Access_CFS",
        "name": "Broadband_Internet_Access_CFS",
        "entityType": "Service"
   },
   "state": "designed"
}
]
}

Example of Response Body

This example shows the contents of the response body in JSON format. The ID is auto-generated and included in the response, because the input specification indicates auto-generation. 

{
    "id": "600006",
    "state": "CREATED",
    "href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/600006",
    "items": [
        {
			"id": "825007",
			"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/825007",
			"businessInteraction": {
				"id": "600007",
				"state": "IN_PROGRESS"
			},
			"category": "CFS",
			"hasStarted": false,
			"isServiceEnabled": false,
			"name": "BroadbandCFS1",
			"serviceDate": "2022-05-12T13:56:30.161Z",
			"startDate": "2022-05-12T13:56:25.070Z",
			"relatedParty": [
			{
				 "id": "225002",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225002",
				 "name": "Snow White",
				 "role": "Customer",
				 "referenceType": "Association",
				 "consumerName": "BroadbandCFS1"
		    },
		    {
				 "id": "225003",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225003",
				 "name": "Warehouse_1",
				 "referenceType": "Reference",
				 "consumerName": "DOCSISRFS",
				 "referenceState": "PENDING_REFERENCE"
			  }
			],
			"serviceCharacteristic": [
			  {
				 "name": "serviceRelType1",
				 "valueType": "ALPHANUMERIC",
				 "value": "relies-on",
				 "serviceName": "BroadbandCFS1",
				 "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
			  },			  
			  {
				 "name": "serviceRel1",
				 "valueType": "ALPHANUMERIC",
				 "value": "EmaiLCFS",
				 "serviceName": "BroadbandCFS",
				 "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
			  },
			  {
				 "name": "Config_Profile_ID",
				 "valueType": "ALPHANUMERIC",
				 "value": "Motorola",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 
			  },
			  {
				 "name": "CPE_Enabled",
				 "valueType": "BOOLEAN",
				 "value": "true",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 
			  },
			  {
				 "name": "MaxUpstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "20 Mbps",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 
			  },
			  {
				 "name": "MaxDownstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "150 Mbps",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 
			  }
			],
			"serviceRelationship": [
			  {
				 "relationshipType": "relies-on",
				 "service": {
					"id": "450005",
					"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/450005"
				 }
			  }
			],
			"serviceType": "Broadband Internet CFS Service",
			"serviceSpecification": {
				"id": "Broadband_Internet_Access_CFS",
				"href": "http://hostname:port/InventoryRSOpenAPI/specification/Broadband_Internet_Access_CFS",
				"name": "Broadband_Internet_Access_CFS",
				"version": "1",
				"entityType": "Service",
				"startDate": "2022-04-07T00:00:01.000Z",
				"endDate": "2038-01-19T08:44:07.000Z"
			},
			"state": "designed",
			"effectiveDate": "2022-05-12T13:56:25.070Z"
        },
		{
            "id": "825006",
            "href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/825006",
            "businessInteraction": {
                "id": "600008",
                "state": "IN_PROGRESS"
            },
            "category": "CFS",
            "hasStarted": false,
            "isServiceEnabled": false,
            "name": "BroadbandCFS2",
            "serviceDate": "2022-05-12T13:56:26.952Z",
            "startDate": "2022-05-12T13:56:25.300Z",
            "relatedParty": [
			{
				 "id": "225002",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225002",
				 "name": "Snow White",
				 "role": "Customer",
				 "referenceType": "Association",
				 "consumerName": "BroadbandCFS2"
		    },
		    {
				 "id": "225003",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225003",
				 "name": "Warehouse_1",
				 "referenceType": "Reference",
				 "consumerName": "DOCSISRFS",
				 "referenceState": "PENDING_REFERENCE"
			  }
			],
			"serviceCharacteristic": [
			  {
				 "name": "serviceRelType1",
				 "valueType": "ALPHANUMERIC",
				 "value": "relies-on",
				 "serviceName": "BroadbandCFS2",
				 "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
			  },	  

			  {
				 "name": "serviceRel1",
				 "valueType": "ALPHANUMERIC",
				 "value": "EmaiLCFS",
				 "serviceName": "BroadbandCFS2",
				 "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
			  },
			  {
				 "name": "Config_Profile_ID",
				 "valueType": "ALPHANUMERIC",
				 "value": "Motorola",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "CPE_Enabled",
				 "valueType": "BOOLEAN",
				 "value": "true",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "MaxUpstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "30 Mbps",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "MaxDownstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "160 Mbps",
				 "serviceName": "DOCSISRFS",
                           "serviceSpecName": "DOCS_RFS" 

			  }
			],
			"serviceRelationship": [
			  {
				 "relationshipType": "relies-on",
				 "service": {
					"id": "450005",
					"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/450005"
				 }
			  }
			],
            "serviceType": "Broadband Internet CFS Service",
            "serviceSpecification": {
                "id": "Broadband_Internet_Access_CFS",
                "href": "http://hostname:port/InventoryRSOpenAPI/specification/Broadband_Internet_Access_CFS",
                "name": "Broadband_Internet_Access_CFS",
                "version": "1",
                "entityType": "Service",
                "startDate": "2022-04-07T00:00:01.000Z",
                "endDate": "2038-01-19T08:44:07.000Z"
            },
            "state": "designed",
            "effectiveDate": "2022-05-12T13:56:25.300Z"
        }
    ]
}

Example for Updating a Bundle Service

This example shows how to update a bundle service with the given specification by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Install and Use cURL".

cURL Command

curl -X POST "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/bundle" -H 'content-type: application/json' -H credentials -d @bundleservicepatch.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".
  • bundleservicepatch.json is the JSON file that specifies the bundle service to create.

    Note:

    designOnly mentions whether the bundle service has to be in designed or in a completed state.

Example of Request Body

This shows an example of the contents of the bundleservicepatch.json file sent as the request body.

Note:

The bundle service update requests should not have any service specification attributes in the requests as they cannot be updated.

In ServiceCharacteristic, the serviceSpecName value is a mandatory input for service and ServiceConfiguration characteristics. The serviceSpecName parameter is used to distinguish to which service and serviceConfiguration do the characteristics belong. The configItemPath parameter is a mandatory input to denote ServiceConfigurationItem level properties or characteristics.

For place and relatedParty, the null value for configItemName indicates that place or relatedParty is for associating the service. For any other value, it can be an assignment or a reference on ServiceConfigItem. 

{
"id":600006,
"items" : [
{
   "id": "825007",
   "name": "BroadbandCFS1Updated",
   "supportingResource": [
      {
         "id": "1-2",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      },
      {
         "id": "1-75002",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      }
   ],
   "relatedParty": [
      {
         "id": "225003",
         "referenceType": "Association",
         "consumerName": "BroadbandCFS1Updated",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      },
      {
         "id": "225004",
         "referenceType": "Reference",
         "consumerName": "DOCSISRFS",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      }
   ],
   "serviceCharacteristic": [
      {
         "name": "serviceRelType1",
         "valueType": "ALPHANUMERIC",
         "value": "relies-on",
         "serviceName": "BroadbandCFS1Updated",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"

      },
      {
         "name": "serviceRel1",
         "valueType": "ALPHANUMERIC",
         "value": "EmaiLCFS",
         "serviceName": "BroadbandCFS1Updated",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"

      },
      {
         "name": "Config_Profile_ID",
         "valueType": "ALPHANUMERIC",
         "value": "Motorola",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 
      },
      {
         "name": "CPE_Enabled",
         "valueType": "BOOLEAN",
         "value": "true",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 
      },
      {
         "name": "MaxUpstream",
         "valueType": "ALPHANUMERIC",
         "value": "30 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 
      },
      {
         "name": "MaxDownstream",
         "valueType": "ALPHANUMERIC",
         "value": "160 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 
      }
   ],
   "serviceRelationship": [
      {
         "relationshipType": "relies-on",
         "service": {
            "id": "450005"
         }
      }
   ],
   "state": "designed"
},
{
   "id": "825007",
   "name": "BroadbandCFS2Updated",
   "supportingResource": [
      {
         "id": "1-3",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      },
      {
         "id": "1-75003",
         "@referredType": "LogicalDevice",
         "consumerName": "DOCSISRFS"
      }
   ],
   "relatedParty": [
      {
         "id": "225003",
         "referenceType": "Association",
         "consumerName": "BroadbandCFS2Updated",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      },
      {
         "id": "225004",
         "referenceType": "Reference",
         "consumerName": "DOCSISRFS",
		 "partySpecification":{
              "id":"BATPartySpec"
          }
      }
   ],
   "serviceCharacteristic": [
      {
         "name": "serviceRelType1",
         "valueType": "ALPHANUMERIC",
         "value": "relies-on",
         "serviceName": "BroadbandCFS2Updated",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"

      },
      {
         "name": "serviceRel1",
         "valueType": "ALPHANUMERIC",
         "value": "EmaiLCFS",
         "serviceName": "BroadbandCFS2Updated",
  "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"

      },
      {
         "name": "Config_Profile_ID",
         "valueType": "ALPHANUMERIC",
         "value": "Motorola",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 

      },
      {
         "name": "CPE_Enabled",
         "valueType": "BOOLEAN",
         "value": "true",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 

      },
      {
         "name": "MaxUpstream",
         "valueType": "ALPHANUMERIC",
         "value": "20 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 

      },
      {
         "name": "MaxDownstream",
         "valueType": "ALPHANUMERIC",
         "value": "150 Mbps",
         "serviceName": "DOCSISRFS",
         "serviceSpecName": "DOCS_RFS" 

      }
   ],
   "state": "designed"
}
]
}

Example of Response Body

This example shows the contents of the response body in JSON format. The ID is auto-generated and included in the response, because the input specification indicates auto-generation. 

{
    "id": "600006",
    "state": "CREATED",
    "href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/600006",
    "items": [
        {
			"id": "825007",
			"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/825007",
			"businessInteraction": {
				"id": "600007",
				"state": "IN_PROGRESS"
			},
			"category": "CFS",
			"hasStarted": false,
			"isServiceEnabled": false,
			"name": "BroadbandCFS1Updated",
			"serviceDate": "2022-05-12T13:56:30.161Z",
			"startDate": "2022-05-12T13:56:25.070Z",
			"relatedParty": [
			{
				 "id": "225004",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225004",
				 "name": "Snow White",
				 "role": "Customer",
				 "referenceType": "Association",
				 "consumerName": "BroadbandCFS1Updated"
		    },
		    {
				 "id": "225005",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225005",
				 "name": "Warehouse_1",
				 "referenceType": "Reference",
				 "consumerName": "DOCSISRFS",
				 "referenceState": "PENDING_REFERENCE"
			  }
			],
			"serviceCharacteristic": [
			  {
				 "name": "serviceRelType1",
				 "valueType": "ALPHANUMERIC",
				 "value": "relies-on",
				 "serviceName": "BroadbandCFS1Updated",
				 "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
			  },			  
			  {
				 "name": "serviceRel1",
				 "valueType": "ALPHANUMERIC",
				 "value": "EmaiLCFS",
				 "serviceName": "BroadbandCFS1Updated",
				 "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
			  },
			  {
				 "name": "Config_Profile_ID",
				 "valueType": "ALPHANUMERIC",
				 "value": "Motorola",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "CPE_Enabled",
				 "valueType": "BOOLEAN",
				 "value": "true",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 
			  },
			  {
				 "name": "MaxUpstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "30 Mbps",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "MaxDownstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "160 Mbps",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 
			  }
			],
			"serviceRelationship": [
			  {
				 "relationshipType": "relies-on",
				 "service": {
					"id": "450005",
					"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/450005"
				 }
			  }
			],
			"serviceType": "Broadband Internet CFS Service",
                    "supportingService": [
                    {
    	                      "id": "450002",				                      "href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/service/450002",
     		  "name": "DOCSISRFS"
  	 }
        ], 

			"serviceSpecification": {
				"id": "Broadband_Internet_Access_CFS",
				"href": "http://hostname:port/InventoryRSOpenAPI/specification/Broadband_Internet_Access_CFS",
				"name": "Broadband_Internet_Access_CFS",
				"version": "1",
				"entityType": "Service",
				"startDate": "2022-04-07T00:00:01.000Z",
				"endDate": "2038-01-19T08:44:07.000Z"
			},
			"state": "designed",
			"effectiveDate": "2022-05-12T13:56:25.070Z"
        },
		{
            "id": "825006",
            "href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/825006",
            "businessInteraction": {
                "id": "600008",
                "state": "IN_PROGRESS"
            },
            "category": "CFS",
            "hasStarted": false,
            "isServiceEnabled": false,
            "name": "BroadbandCFS2Updated",
            "serviceDate": "2022-05-12T13:56:26.952Z",
            "startDate": "2022-05-12T13:56:25.300Z",
            "relatedParty": [
			{
				 "id": "225003",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225002",
				 "name": "Snow White",
				 "role": "Customer",
				 "referenceType": "Association",
				 "consumerName": "BroadbandCFS2Updated"
		    },
		    {
				 "id": "225004",
				 "href": "http://hostname:port/InventoryRSOpenAPI/party/225003",
				 "name": "Warehouse_1",
				 "referenceType": "Reference",
				 "consumerName": "DOCSISRFS",
				 "referenceState": "PENDING_REFERENCE"
			  }
			],
			"serviceCharacteristic": [
			  {
				 "name": "serviceRelType1",
				 "valueType": "ALPHANUMERIC",
				 "value": "relies-on",
				 "serviceName": "BroadbandCFS2Updated",
				 "serviceSpecName": "Broadband_Internet_REST_Junit_CFS"
			  },			 
			  {
				 "name": "serviceRel1",
				 "valueType": "ALPHANUMERIC",
				 "value": "EmaiLCFS",
				 "serviceName": "BroadbandCFS2Updated",
				 "serviceSpecName": "Broadband_Internet_JUnit_CFS"
			  },
			  {
				 "name": "Config_Profile_ID",
				 "valueType": "ALPHANUMERIC",
				 "value": "Motorola",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "CPE_Enabled",
				 "valueType": "BOOLEAN",
				 "value": "true",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "MaxUpstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "20 Mbps",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 

			  },
			  {
				 "name": "MaxDownstream",
				 "valueType": "ALPHANUMERIC",
				 "value": "150 Mbps",
				 "serviceName": "DOCSISRFS",
                            "serviceSpecName": "DOCS_RFS" 

			  }
			],
			"serviceRelationship": [
			  {
				 "relationshipType": "relies-on",
				 "service": {
					"id": "450005",
					"href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/v3/bundle/450005"
				 }
			  }
			],
            "serviceType": "Broadband Internet CFS Service",
	     "supportingService": [
            {
    	         "id": "450002",				         "href": "http://hostname:port/InventoryRSOpenAPI/serviceInventoryManagement/version/service/450002",
     		  "name": "DOCSISRFS"
  	     }
            ], 

            "serviceSpecification": {
                "id": "Broadband_Internet_Access_CFS",
                "href": "http://hostname:port/InventoryRSOpenAPI/specification/Broadband_Internet_Access_CFS",
                "name": "Broadband_Internet_Access_CFS",
                "version": "1",
                "entityType": "Service",
                "startDate": "2022-04-07T00:00:01.000Z",
                "endDate": "2038-01-19T08:44:07.000Z"
            },
            "state": "designed",
            "effectiveDate": "2022-05-12T13:56:25.300Z"
        }
    ]
}
Back to Top