Use HTTP GET to download assets with web services.
Procedure
To download assets:
- 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
- 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.