REST Resources

/api/space/device-management/devices/{device-id}/activate-modeled-device

The following operations are supported on this resource:

  • POST - Activate modeled device
  • POST - Activate modeled device
POST /devices/{device-id}/activate-modeled-deviceVersion 1

Sample Usage

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

POST /devices/{device-id}/activate-modeled-device?queue=<queue>&schedule=<schedule>


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


  • Parameters:
    NameTypeURI TypeDescriptionRequired
    device-idIntegerPath   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:
    <activate-modeled-device-device-init-request>
         <connection-profile href="/api/space/device-management/modeled-device-management/connection-profiles/1015816">
               <name>Connection_Profile</name>
         </connection-profile>
         <static-ip>192.168.1.1</static-ip>
         <subnet-id>24</subnet-id>
         <gateway>192.168.1.10</gateway>
         <serial-number-validation>true</serial-number-validation>
         <user-name>root</user-name>
         <password>********</password>
         <key-based>false</key-based>
         <serial-number>aa4313df57ad</serial-number>
         <Configuration-update-type>AUTOMATIC</Configuration-update-type>
    </activate-modeled-device-device-init-request>

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

  • Sample Input JSON:
    {
       "activate-modeled-device-device-init-request" : {
         "connection-profile" : {
           "@href" : "/api/space/device-management/modeled-device-management/connection-profiles/1015816" ,
           "name" : "Connection_Profile"
         } ,
         "static-ip" : "192.168.1.1" ,
         "subnet-id" : "24" ,
         "gateway" : "192.168.1.10" ,
         "serial-number-validation" : "true" ,
         "user-name" : "root" ,
         "password" : "*********" ,
         "key-based" : "false" ,
         "serial-number" : "aa4313df57ad" ,
         "Configuration-update-type" : "AUTOMATIC"
       }
    }

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

  • Access Control

    The following capabilities are required to access this API: ManageActivation

    POST /devices/{device-id}/activate-modeled-deviceVersion 1

    Sample Usage

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

    POST /devices/{device-id}/activate-modeled-device?queue=<queue>&schedule=<schedule>


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


    • Parameters:
      NameTypeURI TypeDescriptionRequired
      device-idIntegerPath   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:
    <activate-modeled-device-space-init-request>
         <host>test</host>
         <user-name>root</user-name>
         <password>********</password>
         <key-based>false</key-based>
         <use-nat>false</use-nat>
         <create-new-user>true</create-new-user>
         <new-user-name>User1</new-user-name>
         <new-user-password>********</new-user-password>
         <new-user-key-based>false</new-user-key-based>
         <serial-number-validation>true</serial-number-validation>
         <serial-number>aa4313df57ad</serial-number>
         <configuration-update-type>AUTOMATIC</configuration-update-type>
    </activate-modeled-device-space-init-request>

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

  • Sample Input JSON:
    {
       "activate-modeled-device-space-init-request" : {
         "host" : "test" ,
         "user-name" : "root" ,
         "password" : "********" ,
         "key-based" : "false" ,
         "use-nat" : "false" ,
         "create-new-user" : "true" ,
         "new-user-name" : "User1" ,
         "new-user-password" : "********" ,
         "new-user-key-based" : "false" ,
         "serial-number-validation" : "true" ,
         "serial-number" : "aa4313df57ad" ,
         "configuration-update-type" : "AUTOMATIC"
       }
    }

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

  • Access Control

    The following capabilities are required to access this API: ManageActivation