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

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aktualisieren eines „Pay as you go“-Umgebungstyps benötigen:

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

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

Umgebungstyp mithilfe der API aktualisieren

Verwenden Sie den folgenden Befehl, um den Typ einer vorhandenen „Pay as you go“-Umgebung zu aktualisieren:

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"}'

Verwenden Sie nach Abschluss des Vorgangs den folgenden Befehl, um die Änderung des Umgebungstyps zu bestätigen:

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

Dieser Befehl gibt das Umgebungsressourcenobjekt zurück, das 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 verfügbaren Features und Einschränkungen nach Umgebungstyp finden Sie unter Vergleich der Umgebungstypen.

Wenn der Vorgang fehlschlägt, wird ein Fehler im folgenden 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 mögliche Schritte zusammengefasst, mit denen Sie das Problem beheben und ein Upgrade oder Downgrade des Umgebungstyps ausführen können:

Fehlerbedingung	Fehlermeldung	Schritte zur Fehlerbehebung
Maximale Anzahl 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
Freigegebener Ablauf in der Umgebung	`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.
Unterstützung für mehrere Regionen 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.