Pay as you go-Umgebungstypen aktualisieren

Diese Seite gilt für Apigee, aber nicht für Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Die „Pay as you go“-Preisattribute von Apigee basieren zum Teil auf den Umgebungstypen, die Sie an Ihre Apigee-Instanz anhängen. Sie können Ihren „Pay as you go“-Umgebungen Basis-, Zwischen- oder Umfassende Umgebungen jederzeit hinzufügen und dabei das Preismodell an Ihre Feature- und Kapazitätsanforderungen anpassen. In diesem Thema wird erläutert, wie Sie den Typ einer vorhandenen Umgebung aktualisieren oder oder ein Downgrade durchführen, um Funktionalitäten von Funktionen hinzuzufügen oder zu entfernen und Ihre Apigee-„Pay as you go“-Abrechnung und die Ressourcennutzung zu verwalten.

Erforderliche Rollen und Berechtigungen

Um die Berechtigungen zu erhalten, die Sie zum Aktualisieren eines „Pay as you go“-Umgebungstyps benötigen, bitten Sie Ihren Administrator, Ihnen die folgende IAM-Rollen für das Projekt zu erteilen:

Apigee-Organisationsadministrator (apigee.organization.admin)
Administrator der Apigee-Umgebung (apigee.environment.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Umgebungstyp aktualisieren

Sie können den Typ einer vorhandenen „Pay as you go“-Umgebung mithilfe der Apigee-UI in der Google Cloud Console aktualisieren oder die API verwenden, wie in den folgenden Abschnitten beschrieben.

Apigee in der Cloud Console

So aktualisieren Sie den Typ einer vorhandenen „Pay as you go“-Umgebung mithilfe der Apigee-UI in der Google Cloud Console:

Öffnen Sie in der Console die Seite Apigee.
Zu „Apigee“
Wählen Sie das Projekt mit der „Pay as you go“-Organisation und den Umgebungen aus, die Sie aktualisieren möchten.
Wählen Sie Verwaltung > Umgebungen aus, um die Listenseite Umgebungen zu öffnen.
Klicken Sie in der Zeile für die Umgebung, die Sie bearbeiten möchten, auf Aktionen und wählen Sie Bearbeiten aus.
Wählen Sie im Dialogfeld Umgebung bearbeiten eine Option unter Umgebungstyp auswählen aus.
Klicken Sie auf Update (Aktualisieren), um die Änderungen zu speichern.
Aktualisieren Sie die Seite mit der Liste Umgebungen, um die Änderung des Umgebungstyps zu bestätigen.

Apigee API

Um den Typ einer vorhandenen „Pay as you go“-Umgebung mithilfe der Apigee API zu aktualisieren, verwenden Sie den folgenden Befehl:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"ENV_TYPE"}'

Wobei:

ORG_NAME ist der Name der „Pay as you go“-Organisation von Apigee.
ENV_NAME ist der Name der zu aktualisierenden Apigee-Umgebung.
ENV_TYPE ist der aktualisierte Umgebungstyp. Optionen sind BASE, INTERMEDIATE oder COMPREHENSIVE.

Verwenden Sie beispielsweise den folgenden Befehl, um ein Upgrade von einer Basisumgebung mit dem Namen test-env auf eine umfassende Umgebung durchzuführen:

curl "https://apigee.googleapis.com/v1/organizations/my-org/environments/test-env?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"COMPREHENSIVE"}'

Bestätigen Sie nach Abschluss des Vorgangs die Änderung des Umgebungstyps mit dem folgenden Befehl:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME" -H "Authorization: Bearer $token"

Dieser Befehl gibt die Umgebung Ressourcenobjekt zurück, die den ausgewählten Umgebungstyp enthält.

Fehlerreferenz

Beim Upgrade oder Downgrade des Umgebungstyps schlägt der Vorgang fehl, wenn die vorhandene Umgebung Ressourcen enthält, die mit dem neu ausgewählten Umgebungstyp nicht kompatibel sind. Weitere Informationen zu den verfügbaren Funktionen und den Einschränkungen nach Umgebungstyp finden Sie unter Vergleich der Umgebungstypen.

Wenn der Vorgang fehlschlägt, wird ein Fehler mit folgendem Format angezeigt:

  {
    "error": {
      "code": "FAILED_PRECONDITION",
      "message": "environment type update invalid: ...<detailed message here >... :failed precondition",
      "status": "FAILED_PRECONDITION"
      }
  }

In der folgenden Tabelle sind mögliche Fehlermeldungen und Schritte zur Behebung des Problems und zum Upgrade oder Downgrade des Umgebungstyps zusammengefasst:

Fehlerbedingung	Fehlermeldung	Schritte zur Fehlerbehebung
Maximale Anzahl von Umgebungen pro Organisation überschritten	`cannot transfer active environments to INTERMEDIATE, will exceed limit` `cannot transfer active environments to BASE, will exceed limit`	Löschen Sie eine oder mehrere Umgebungen aus Ihrer Organisation.
In der Umgebung bereitgestellter erweiterbarer Proxy	`existing environment has an extensible API`	Bereitstellung des erweiterbaren Proxys in der Umgebung aufheben
In der Umgebung bereitgestellter freigegebener Ablauf	`existing environment has a shared flow`	Bereitstellung des freigegebenen Ablaufs in der Umgebung aufheben.
Maximale Anzahl von Proxy-Bereitstellungseinheiten pro Umgebung und Region	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	Heben Sie die Bereitstellung von freigegebenen Abläufen oder Proxys in der Umgebung auf und löschen Sie diese.
In der Umgebung aktivierte Add-ons	`Existing environment has an addon enabled`	Deaktivieren Sie die Add-ons in der Umgebung.
Multiregionale Unterstützung in der Umgebung aktiviert	`instance attachment count, 2, cannot exceed 1 for BASE environment` `instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment`	Löschen Sie den zweiten Instanzanhang für die Umgebung.