Apigee-Monetarisierung aktivieren

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Bevor Sie die Apigee-Monetarisierung verwenden können, müssen Sie sie in Ihrer Organisation erwerben und aktivieren.

Apigee-Monetarisierung erwerben

So erwerben Sie die Apigee-Monetarisierung für abobasierte Organisationen:

  1. Prüfen Sie, ob die Apigee-Monetarisierung in Ihrem Apigee-Abo enthalten ist. Weitere Informationen finden Sie unter Apigee-Berechtigungen.
  2. Wenden Sie sich bei Bedarf an Apigee Sales, um die Apigee-Monetarisierung zu erwerben.

Monetarisierung von Apigee in Ihrer Organisation aktivieren

Um die Apigee-Monetarisierung in einer vorhandenen Organisation zu aktivieren, senden Sie eine POST-Anfrage an die folgende API und übergeben Sie die Add-on-Konfiguration im Anfragetext:

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

Beispiel: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "true"
      }
      <Include existing add-on configuration>
    }
  }'

Dabei ist $TOKEN auf Ihr OAuth 2.0-Zugriffstoken festgelegt. Weitere Informationen hierzu finden Sie unter OAuth 2.0-Zugriffstoken abrufen. Informationen zu den in diesem Beispiel verwendeten curl-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen finden Sie unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Das folgende Beispiel enthält eine Antwort, die zeigt, dass der Vorgang läuft: 

{
  "name": "organizations/$ORG/operations/1ae3ed56-b38f-4cc1-ba33-e7d89557075d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/$ORG",
    "state": "IN_PROGRESS"
  }
}

Weitere Informationen finden Sie unter Organization Add-ons API konfigurieren.

Rufen Sie das Organisationsprofil auf, um zu prüfen, ob die Monetarisierung aktiviert wurde. Beispiel: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Das folgende Beispiel zeigt eine Antwort mit aktivierter Monetarisierung. 

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": true
    }
  }
}

Apigee-Monetarisierung in Ihrer Organisation deaktivieren

Um die Apigee-Monetarisierung in Ihrer Organisation zu deaktivieren, senden Sie eine POST-Anfrage an die folgende API und übergeben Sie die Add-on-Konfiguration im Anfragetext:

https://apigee.googleapis.com/v1/organizations/$ORG:setAddons

Beispiel: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG:setAddons" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: application/json" \
  -d '{
    "addonsConfig": {
      "monetizationConfig": {
          "enabled": "false"
      }
     <Include existing add-on configuration>
    }
  }'

Das folgende Beispiel enthält eine Antwort, die zeigt, dass der Vorgang läuft: 

{
  "name": "organizations/$ORG/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/$ORG",
    "state": "IN_PROGRESS"
  }
}

Weitere Informationen finden Sie unter Organization Add-ons API konfigurieren.

Rufen Sie das Organisationsprofil auf, um zu bestätigen, dass die Monetarisierung deaktiviert wurde. Beispiel: 

curl "https://apigee.googleapis.com/v1/organizations/$ORG" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Das folgende Beispiel zeigt eine Antwort mit aktivierter Monetarisierung. 

{
    "name": $ORG,
    ...
    "addonsConfig": {
    "monetizationConfig": {
      "enabled": false
    }
  }
}

Fehler beim Aktivieren der Apigee-Monetarisierung beheben

Wenn Sie die Apigee-Monetarisierung nicht erworben haben und versuchen, sie zu aktivieren, wird der folgende Fehler zurückgegeben:

{
  "error": {
    "code": 400,
    "message": "failed to validate addons config: [Apigee Monetization] addon(s) are not entitled to the subscription",
    "status": "FAILED_PRECONDITION"
  }
}