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. Die Apigee-Monetarisierung wird für Apigee- und Apigee Hybrid-Umgebungen unterstützt.

Apigee-Monetarisierung erwerben

Wenn Sie die Apigee-Monetarisierung für Aboorganisationen erwerben möchten, wenden Sie sich an den Apigee-Vertrieb und aktivieren Sie dann die Apigee-Monetarisierung in Ihrer Organisation.

Die Monetarisierung von Apigee ist nicht für „Pay as you go“-Organisationen verfügbar.

Apigee-Evaluierungsorganisationen enthalten automatisch eine Apigee-Monetarisierungs-Testversion für den Testzeitraum. Sie müssen sich nicht an Apigee Sales wenden, um die Monetarisierung hinzuzufügen. Fahren Sie mit Apigee-Monetarisierung in Ihrer Organisation aktivieren fort.

Apigee-Monetarisierung 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_NAME:setAddons

Beispiel:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME: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 Umgebungsvariablen, die Sie verwenden können, 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_NAME/operations/1ae3ed56-b38f-4cc1-ba33-e7d89557075d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/ORG_NAME",
    "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_NAME" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Das folgende Beispiel zeigt eine Antwort mit aktivierter Monetarisierung. 

{
    "name": ORG_NAME,
    ...
    "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_NAME:setAddons

Beispiel:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME: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_NAME/operations/06274ffb-8940-41da-836d-781cba190437",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.apigee.v1.OperationMetadata",
    "operationType": "UPDATE",
    "targetResourceName": "organizations/ORG_NAME",
    "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_NAME" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

Das folgende Beispiel zeigt eine Antwort mit aktivierter Monetarisierung. 

{
    "name": ORG_NAME,
    ...
    "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"
  }
}