Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Dell Unity™ Family Unisphere® Management REST API Programmer's Guide

PDF

Uploading upgrade candidates and language packs

You can upload upgrade candidates (software or firmware) and language packs to the storage system to make them available to install. To install an uploaded file, create a new candidateSoftwareVersion instance.

NOTE When you upload an upgrade candidate file onto the storage system, it replaces the previous version. There can only be one upgrade candidate on the system at a time.

For information about the candidateSoftwareVersion resource type, see the Unisphere Management REST API Reference Guide.

Syntax

To upload a system software upgrade candidate or language pack file, use the following components:

Headers
Accept: application/json
Content-Type: application/json
X-EMC-REST-CLIENT: true
EMC-CSRF-TOKEN: <token>
Operation
POST
URI pattern
/upload/files/types/candidateSoftwareVersion
Body
Empty.
Usage
You must post the upgrade file using a multipart/form-data format as if from a simple web page form, like that shown in the following example:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
 <body>
   <form enctype="multipart/form-data" method="post"
     action="https://<IP_address>/upload/file/types/candidateSoftwareVersion">
     <input type="file" name="filename>"/> 
      <input type="submit"/> 
    </form>
 </body>
</html>

A successful upload request returns 200 OK HTTP status code. If the request does not succeed, the server returns a 4nn or 5nn HTTP status code in the response header and a message entity in the response body.

Example

The following example uploads the upgrade candidate file update1.gpg from the local host to the storage server:

Header
Accept: application/json
Content-Type: application/json
X-EMC-REST-CLIENT: true
EMC-CSRF-TOKEN: <token>
Request
<html>
  <body>
    <form enctype="multipart/form-data" method="post" action="https://10.108.253.216/upload/files/types/candidateSoftwareVersion
        <input type="file" name="filename"/>
        <input type="submit"/>
    </form>
  </body>

filename="update1.gpg"
Request body
Empty.
Response body (raw) for a successful response
Empty.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\