HTTP GET zum Herunterladen von Assets mit Web-Services verwenden
Vorgehensweise
Gehen Sie wie folgt vor, um Assets herunterzuladen:
- Führen
Sie eine Anforderung HTTP GET mithilfe der folgenden URL aus:
https://Host:Port/ram.web.ws.was/RAMSecure/RAMAssetAccess.jsp?assetid={Asset-ID}&version=Versionsnummer.
Dabei gilt: Host ist der Hostname des Servers, Port ist die Portnummer,
ram.web.ws.was ist die Web-Service-Anwendung, Asset-ID ist die ID des
Assets und Versionsnummer ist die Versionsnummer des Assets. Beispiel:
https://www.example.com:9080/ram.web.ws.was/RAMSecure/RAMAssetAccess.jsp?assetid={BF4B7485-562F-F166-1F3F-CADB33668D8D}&version=1.
Stellen Sie Ihren Benutzernamen und Ihr Kennwort über Basisauthentifizierung bereit.
Wenn Sie ein Asset anonym übergeben oder aktualisieren wollen, entfernen Sie
RAMSecure und verwenden Sie die folgende URL:
http://Host:Port/ram.web.ws.was/RAMAssetAccess.jsp?assetid={Asset-ID}&version=Versionsnummer.
- Eine .RAS-Datei wird im Downloaddatenstrom zurückgegeben. Das .RAS-Format enthält die serialisierte Manifestdatei und die Assetartefakte.
Ergebnisse
Die folgenden HTTP-Fehlercodes werden ausgegeben, wenn beim Download
von Assets Probleme auftreten:
- 403 FORBIDDEN: Der Aufrufende verfügt nicht über die erforderlichen
Berechtigungen zum Herunterladen eines Assets.
- 500 INTERNAL_SERVER_ERROR: Fehler oder Ausnahmebedingungen beim Versuch,
das Asset zu übergeben oder zu aktualisieren.
- 410 GONE: Asset nicht im Repository gefunden.
Jede Fehlernachricht
vom Server wird als Wert des Headers com.ibm.ram.error
zurückgegeben.