Um die REST-API für watsonx.governance als Service auf AWS zu nutzen, müssen Sie der API Zugriff auf Ihren Service gewähren.

Bevor Sie beginnen, vergewissern Sie sich, dass Sie in der IBM SaaS Console über die Rollen Account Viewer, Subscription Viewer und Service Admin verfügen.

Um der REST-API Zugriff auf Ihren Dienst zu gewähren, führen Sie die folgenden Schritte aus:

1. Erzeugen Sie eine Service-ID und einen API-Schlüssel für die Instanz, auf die Sie Zugriff gewähren möchten. Bewahren Sie den API-Schlüssel zur späteren Verwendung auf. Weitere Informationen finden Sie unter Gewähren von Zugriff über Service-IDs und API-Schlüssel von der IBM SaaS aus.

2. Gehen Sie in der IBM SaaS Console auf die Registerkarte Instanzen und rufen Sie die ID der gewünschten Serviceinstanz ab.

3. Verwenden Sie eine HTTP-Anfrage, um ein Zugriffstoken zu erzeugen. Sie können zum Beispiel den folgenden cURL verwenden:

   curl -X POST -H "Accept: application/json" -H "Content-Type: application/json" \
   -d '{ "apikey" : "<APIkey>" }' \
   https://account-iam.platform.saas.ibm.com/api/2.0/services/<instanceID>/apikeys/token
   

   Dabei steht <APIkey> für den API-Schlüssel, den Sie generiert haben, und <instanceID> für die ID der Dienstinstanz, die Sie verwenden möchten.

4. Greifen Sie auf die REST-API-Endpunkte zu, indem Sie das Zugriffstoken verwenden. Sie können zum Beispiel den folgenden cURL verwenden:

   curl -L -H "Authorization: Bearer <access_token>" --header "Accept: application/json" \
   "<applicationURL>/opgrc/api/v2/types"
   

   Dabei steht <access_token> für das von Ihnen erstellte Zugriffstoken und <applicationURL> für die feste URL der Governance-Konsole.

   Weitere Informationen darüber, wie Sie die feste URL erhalten, finden Sie unter Gemeinsame Nutzung der URL der Governance-Konsole.

Eine Liste der REST-API-Endpunkte, die Sie verwenden können, finden Sie unter IBM OpenPages REST API V2 für OpenPages as a Service.

Übergeordnetes Thema: Verwaltung Ihrer watsonx.governance auf AWS (laufende Wartung)