/api/space/software-management/packages/{id}

The following operations are supported on this resource:

  • GET - Get software package details by it's ID
  • PUT - Update software package of a Device Image
  • DELETE - Delete Device Image
GET /packages/{id}Version 1

This API retrieves software package details from Junos Space with a particular ID.

Sample Usage

GET /packages/{id}


  • Parameters:
    NameTypeURI TypeDescriptionRequired
    software-package-idintPathSoftware package ID for the package to get from Junos Space Y
  • Sample Output XML:
    <package uri="/api/space/software-management/packages/1835128" key="1835128">
      <fileName>junos-srxsme-10.3R2.11-domestic.tgz</fileName>
      <type>junos</type>
      <fileMD5>acee52b0f981e0c7dc7d10a73695939e</fileMD5>
      <version>10.3R2.11</version>
      <size>210458199</size>
      <decodeStatus>DECODE_SUCCESS</decodeStatus>
      <uploadStatus>UPLOAD_SUCCESS</uploadStatus>
      <allowDelete>true</allowDelete>
      <uploadTime>2011-03-18 18:02:20.0</uploadTime>
      <supportedPlatforms>
        <platform>SRX5600</platform>
        <platform>SRX5800</platform>
      </supportedPlatforms>
      <supportedSeries>
        <series>SRX5600</series>
        <series>SRX5800</series>
      </supportedSeries>
      <platformType>SRX5000</platformType>
      <method href="/api/space/software-management/packages/1835128/exec-stage"
        rel="stage software package" />
      <method href="/api/space/software-management/packages/1835128/exec-deploy"
        rel="deploy software package" />
      <method href="/api/space/software-management/packages/1835128/exec-verify"
        rel="verify software package" />
      <method href="/api/space/software-management/packages/1835128/exec-undeploy"
        rel="undeploy software package" />
      <associated-devices href="/api/space/software-management/packages/1835128/associated-devices"
        rel="associated devices" />
    </package>

  • Sample Output JSON:
    {"package":
      {
      "@uri":"/api/space/software-management/packages/1835128",
      "@key":"1835128",
      "fileName":"junos-srxsme-10.3R2.11-domestic.tgz",
      "type":"junos",
      "fileMD5":"acee52b0f981e0c7dc7d10a73695939e",
      "version":"10.3R2.11",
      "size":210458199,
      "decodeStatus":"DECODE_SUCCESS",
      "uploadStatus":"UPLOAD_SUCCESS",
      "allowDelete":true,
      "uploadTime":"2011-03-18 18:02:20.0",
      "supportedPlatforms":
        {
        "platform":
          ["SRX5600","SRX5800"]
        },
      "supportedSeries":
        {
        "series":
          ["SRX5600","SRX5800"]
        },
      "platformType":"SRX5000",
      "method":
        [
        {"@href": "/api/space/software-management/packages/1835128/exec-stage",
        "@rel":"stage software package"
        },
        {"@href": "/api/space/software-management/packages/1835128/exec-deploy",
        "@rel":"deploy software package"
        },
        {"@href": "/api/space/software-management/packages/1835128/exec-verify",
        "@rel":"verify software package"
        },
        {"@href": "/api/space/software-management/packages/1835128/exec-undeploy",
        "@rel":"undeploy software package"
        },
        {"@href": "/api/space/software-management/packages/1835128/associated-devices",
        "@rel":"associated devices"
        }
        ]
      }
    }

  • Access Control

    The following capabilities are required to access this API: ViewImagesCap

    PUT /packages/{id}Version 1

    This API updates the platform type of an existing software package file on the platform.

    Sample Usage

    PUT /packages/{id}


    • Parameters:
      NameTypeURI TypeDescriptionRequired
      software-package-idintPathThe software package ID for the package to be updated. Y
  • Sample Input XML:
    <package>
      <deviceSeries>SRXSME</deviceSeries>
    </package>

  • Sample Output XML:
    <package key="5210112">
      <fileName>junos-srxsme-10.2R2.11-domestic.tgz</fileName>
      <fileMD5>896ec81c9e24d638ae569f0a8bba0de7</fileMD5>
      <version>10.4R1.9</version>
      <size>43593469</size>
      <allowDelete>true</allowDelete>
      <uploadTime>2011-04-04 09:28:20.32</uploadTime>
      <deviceSeries>SRXSME</deviceSeries>
      <method href= "/api/space/software-management/packages/5210112/exec-stage" />
      <method href= "/api/space/software-management/packages/5210112/exec-deploy" />
      <method href= "/api/space/software-management/packages/5210112/exec-verify" />
      <method href= "/api/space/software-management/packages/5210112/exec-remove" />
      <method href= "/api/space/software-management/packages/5210112/exec-undeploy" />
      <associated-devices href= "/api/space/software-management/packages/5210112/associated-devices" />
    </package>

  • Sample Input JSON:
    {"package":
      {
      "deviceSeries":"SRXSME"
      }
    }

  • Sample Output JSON:
    {"package":
      {
      "@key":"5210112",
      "fileName":"junos-srxsme-10.2R2.11-domestic.tgz",
      "fileMD5":"896ec81c9e24d638ae569f0a8bba0de7",
      "version":"10.4R1.9",
      "size":43593469,
      "allowDelete":true,
      "uploadTime":"2011-04-04 09:28:20.32",
      "deviceSeries":"SRXSME",
      "method" : [
        {
          "href" : "/api/space/software-management/packages/5210112/exec-stage"
        },
        {
          "href" : "/api/space/software-management/packages/5210112/exec-deploy"
        },
        {
          "href" : "/api/space/software-management/packages/5210112/exec-verify"
        },
        {
          "href" : "/api/space/software-management/packages/5210112/exec-remove"
        },
        {
          "href" : "/api/space/software-management/packages/5210112/exec-undeploy"
        }
      ],
      "associated-devices" :
        { "href" : "/api/space/software-management/packages/5210112/associated-devices"
        }
      }
    }

  • Access Control

    The following capabilities are required to access this API: ModifyImageCap

    Data Notification

    This API supports data notification.

    DELETE /packages/{id}Version 1

    This API is used to delete an existing software package file on the platform.

    Sample Usage

    DELETE /packages/{id}


    • Parameters:
      NameTypeURI TypeDescriptionRequired
      software-package-idintPathA valid software ID. Y

    Access Control

    The following capabilities are required to access this API: DeleteImageCap

    Data Notification

    This API supports data notification.