/api/space/device-management/modeled-device-management/modeled-instances/{id}/add-more-devices

The following operation is supported on this resource:

  • POST - Add more device units to the modeled instance
POST /modeled-device-management/modeled-instances/{id}/add-more-devicesVersion 1

Add more device units to the modeled instance.

Sample Usage

This API makes an asynchronous method call; so, you can optionally specify queue and schedule parameters:

POST /modeled-device-management/modeled-instances/{id}/add-more-devices?queue=<queue>&schedule=<schedule>


Note: The queue URL denoted by <queue> must have been created already.


  • Parameters:
    NameTypeURI TypeDescriptionRequired
    instanceidIntegerPathInstanceid Y
    queueQueue URLQueryA fully qualified queue URL, where job progress notifications will be sent (See Asynchronous API Usage)N
    schedulecron-like-expressionQuerySchedule this API in the future, by specifying a cron-like-expression (See Job Scheduling)N
  • Sample Input XML:
    <add-more-devices-request>
         <tag-name>Modeled</tag-name>
         <device-count>1</device-count>
         <devices total="1">
               <device>
                   <device-name>ACX_Device</device-name>
                   <platform>ACX1100</platform>
                   <os-version>15.1R1.8</os-version>
                   <serial-number>ee0208144601</serial-number>
               </device>
         </devices>
    </add-more-devices-request>

  • Sample Output XML:
    <task href="/api/space/job-management/jobs/1212438">
      <id>1212438</id>
    </task>

  • Sample Input JSON:
    {
       "add-more-devices-request" : {
         "tag-name" : "Modeled" ,
         "device-count" : "1" ,
         "devices" : {
           "@total" : "1" ,
           "device" : [
             {
               "device-name" : "ACX_Device" ,
               "platform" : "ACX1100" ,
               "os-version" : "15.1R1.8" ,
               "serial-number" : "ee0208144601"
             }
           ]
         }
       }
    }

  • Sample Output JSON:
    {
      "task":{
        "@href":"/api/space/job-management/jobs/1212438",
        "id":1212438
      }
    }

  • Access Control

    The following capabilities are required to access this API: AddMoreDeviceInstance