Download an asset using HTTP GET

Use HTTP GET to download assets with web services.

Procedure

To download assets:

  1. Perform a HTTP GET request using the following URL https://host:port/ram.web.ws.was/RAMSecure/RAMAssetAccess.jsp?assetid={asset_id}&version=version_number, where host is the host name of the server, port is the port number, com.web.ws.was is the web services web application, asset_id is the id of the asset, and version_number is the version number of the asset. For example: https://www.example.com:9080/ram.web.ws.was/RAMSecure/RAMAssetAccess.jsp?assetid={BF4B7485-562F-F166-1F3F-CADB33668D8D}&version=1. Provide your user name and password using basic authentication.

    If you want to submit or update an asset anonymously, remove RAMSecure and use the following URL: http://host:port/ram.web.ws.was/RAMAssetAccess.jsp?assetid={asset_id}&version=version_number

  2. A .RAS file is returned in the download stream. The .RAS format contains the serialized manifest file and the asset artifacts.

Results

The following HTTP error codes are thrown when there are problems downloading assets:
  • 403 FORBIDDEN: Caller does not have required permissions download an asset
  • 500 INTERNAL_SERVER_ERROR: Problems or exceptions trying to submit or update the asset
  • 410 GONE: Asset not found in the repository

Any error message from the server is returned as the value of header com.ibm.ram.error.


Feedback