Download REST API Data From Oracle ILOM to Local Client

Use a GET request to download REST API data from Oracle ILOM to a local client.

HTTP Request Format

GET /rest/v<version>/SP/<content_resource_path> HTTP/1.1
Accept: <media type>

Where:

  • <content_resource_path> specifies the resource path of the content to be downloaded. For example, to download the banner message that appears when connecting to Oracle ILOM, the content resource path would look like this: /rest/v1/SP/preferences/banner/connect/content

  • <media type> represents the media type that is associated with the resource content to be downloaded. For a list of download 'content' resources and their associated media types, see the following table.

    Download Resource Media Type

    /SP/preferences/banner/connect/content

    text/plain

    /SP/preferences/banner/login/content

    text/plain

    /SP/config/content

    text/xml

    /SP/services/snmp/mibs/content

    application/zip

    /System/bios/config/content

    text/xml

    /HOST/console/history/content

    application/octet-stream

Request Header Fields Required:

The required request header fields are as follows: Authorization, Accept, and Host.

Note:

The request Accept header must specify the media type expected from the target resource.

For a description of these required header fields, see Common Request Header Fields.

Response: Status Codes

  • Success: HTTP Status = 200 OK, <media type> response body

  • Failure: HTTP Status = 4xx, 5xx, JSON formatted error response body

  • Note:

    The response media types are specified in the Swagger model.

cURL Request Example

Using cURL, a request to download the connect banner to a binary file (sp_config.xml) would look like this:

curl -k -v -u "root:changeme" -H 
"Accept:text/xml" 
https://<IPaddress>:443/rest/v1/SP/config/content -o sp_config.xml