Ressourcen verwalten

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Hinweis: In Umgebungen, die für Archivbereitstellungen aktiviert sind, können Sie Ressourcen nicht über die Apigee-Benutzeroberfläche, API oder gcloud verwalten. Informationen zum Verwalten von Ressourcen für Archivbereitstellungen mit Apigee in VS Code finden Sie unter Ressourcen verwalten.

Ressourcen können Sie wie in den folgenden Abschnitten beschrieben verwalten.

Informationen zu Ressourcen

Viele Richtlinientypen beruhen auf Ressourcen. Ressourcen sind Dateien, die den Code oder die Konfiguration implementieren, der bzw. die von einer Richtlinie ausgeführt werden soll, wenn sie an einen API-Proxy angehängt wird. In einigen Fällen, etwa bei JavaScript und JavaCallout, definiert eine Richtlinie einfach einen Punkt zum Anhängen in einem API-Proxy, in dem Code ausgeführt werden soll. Die JavaScript- oder JavaCallout-Richtlinie stellt einen Verweis auf eine Ressource dar.

Ressourcentypen

In der folgenden Tabelle sind die Ressourcentypen zusammenfassend dargestellt:

Ressourcentyp	Beschreibung
GraphQL (graphql)	GraphQL-Schemadatei, auf die in GraphQL-Richtlinien verwiesen wird.
JAR (java)	Java-Klassen in einer JAR-Datei, auf die in JavaCallout-Richtlinien verwiesen wird.
JavaScript (js)	JavaScript-Code, auf den in JavaScript-Richtlinien verwiesen wird.
JavaScript (jsc)	Kompilierung von JavaScript, auf das in JavaScript-Richtlinien verwiesen wird.
OpenAPI Specification (oas)	OpenAPI-Spezifikation zum Validieren von Anfrage- und Antwortnachrichten des Typs JSON oder YAML.
Property Set (properties)	Sammlung von Schlüssel/Wert-Paaren, auf die in Attributsätzen des API-Proxys verwiesen werden kann.
Python (py)	Python-Skripts, auf die in PythonScript-Richtlinien verwiesen wird. Ressourcen müssen in "reinem Python" eingebunden werden (nur in der Sprache Python).
Security policy (securityPolicy)	Benutzerdefinierte Sicherheitsrichtlinie, auf die in JavaCallout-Richtlinien verwiesen wird.
WSDL (wsdl)	WSDL-Dateien, auf die in den SOAPMessageValidation-Richtlinien verwiesen wird.
XSD (xsd)	XML-Schemas, auf die in den SOAPMessageValidation-Richtlinien verwiesen wird.
XSL Transformations (xsl)	XP-Transformationen, auf die von XSLTransform-Richtlinien verwiesen wird.

Speicherort der Ressourcen

Sie können Ressourcen an den unten aufgeführten Speicherorten speichern. Sie können Ressourcendateien nicht in einer Organisation speichern.

• API-Proxy-Überarbeitung: Ressourcen sind nur für API-Proxy-Überarbeitungen verfügbar, in denen die Ressourcen enthalten sind. Sie können zum Beispiel bei der ersten Überarbeitung eines API-Proxys eine JavaScript-Ressource einfügen und dann die Implementierung so ändern, dass bei der zweiten Überarbeitung des Proxys ein Python-Skript verwendet wird. Bei der ersten Überarbeitung besteht nur Zugriff auf die JavaScript-Ressource und bei der zweiten Überarbeitung nur Zugriff auf die Python-Ressource.
  Hinweis: In der UI werden Ressourcen, die einer API-Proxy-Überarbeitung zugeordnet sind, im Bereich "Ressourcen" des Navigationsbereichs aufgelistet, unabhängig davon, ob Sie sie mit der UI hinzugefügt haben oder mit der
  API.
• Umgebung: Wenn Ressourcen in einer Umgebung (z. B. test oder prod) gespeichert werden, sind sie für jeden API-Proxy verfügbar, der in derselben Umgebung bereitgestellt wird.

Das Umgebungs-Repository ist unter dem folgenden URI verfügbar, wie in der List Resource Files API und später unter Ressourcen mit der API verwalten beschrieben: /organizations/$ORG/environments/$ENV/resourcefiles

Hinweis: Sie können das Ressourcen-Repository der API-Proxy-Überarbeitung nicht mit der API aufrufen.

In der folgenden Tabelle sind die Methoden aufgeführt, die Sie nutzen können, um Ressourcen für jedes Repository zu erstellen, zu aktualisieren und zu löschen:

Repository	Create		View		Update		Löschen
	API	UI	API	UI	API	UI	API	UI
API-Proxy-Überarbeitung
Umgebung

Beispielsweise werden alle JavaScript-Dateien, die in der test-Umgebung verfügbar sind, im folgenden Repository gespeichert und sind für jeden in der test-Umgebung ausgeführten API-Proxy verfügbar:

/organizations/$ORG/environments/test/resourcefiles/jsc

Ressourcennamen auflösen

Ressourcennamen vom spezifischsten bis zum allgemeinsten Bereich auflösen. Ressourcennamen werden "entlang der Kette" von der API-Proxy-Überarbeitungsebene bis zur Umgebungsebene aufgelöst.

Angenommen, Sie haben dieselbe Ressource in zwei verschiedenen Repositories eingefügt: die API-Proxy-Überarbeitung und die prod-Umgebung.

Mit der folgenden Richtlinie wird ein API-Proxy konfiguriert:

<Javascript name='PathSetterPolicy' timeLimit='200'>
    <ResourceURL>jsc://pathSetter.js</ResourceURL>
</Javascript>

Der Richtlinienverweis kann nicht explizit in einem Repository aufgelöst werden. Die erste Ressource auf der detailliertesten Ebene, deren Name mit dem Ressourcennamen in der Richtlinie übereinstimmt, wird aufgelöst.

Wenn der API-Proxy also in der prod-Umgebung bereitgestellt wird, wird die Richtlinie in die umgebungsbezogene Ressource pathSetter.js aufgelöst.

Beim Bereitstellen in der test-Umgebung wird die Richtlinie in eine überarbeitungsbezogene Ressource des API-Proxys aufgelöst, da sich die umgebungsbezogene Ressource in der prod-Umgebung und nicht in der test-Umgebung befindet.

Richtlinien für Java-Ressourcen

Sie können kompilierte Java-Ressourcen als JAR-Dateien mit verschiedenen Optionen in curl hinzufügen, z. B. mit der Option -T, --data-binary oder -F, nicht aber mit der Option -d. Beispiel:

curl "http://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles?name={jar_file}&type=java" \  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @{jar_file}

curl "http://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles?name={jar_file}&type=java" \  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/octet-stream" \
  -T "{jar_file}"

curl "http://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles?name={jar_file}&type=java" \  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/octet-stream" \
  -F "file=@{jar_file}"

Hinweis:Paketnamen: Verwenden Sie in Java-Callouts nicht io.apigee oder com.apigee als Paketnamen. Diese sind für die Verwendung durch andere Apigee-Module reserviert.

Weitere Informationen

• Best Practices für Java: Best Practices für Design und Entwicklung von API-Proxys
• Beispiel für ein Java-Cookbook: XSL-Transformationsrichtlinie

Ressourcen über die UI verwalten

Verwalten Sie die Ressourcen für eine API-Proxy-Überarbeitung über die UI, wie in den folgenden Abschnitten beschrieben.

Hinweis: Sie können Ressourcen, die der Organisation oder der Umgebung zugeordnet sind, nicht über die UI verwalten. Sie müssen stattdessen die API verwenden.

Ressourcen mit der UI aufrufen

Hinweis: Apigee wird zukünftig eine neue Version des Proxy-Editors bereitstellen, die die Verwaltung von Proxys vereinfachen wird.

In den Anleitungen auf den ersten beiden Tabs unten wird erläutert, wie Sie entweder den neuen Proxy-Editor oder den klassischen Proxy-Editor verwenden.

Neuer Proxy-Editor

So zeigen Sie Ressourcen mit dem neuen Proxy-Editor an:

1. Wenn Sie die Apigee-UI in der Cloud Console verwenden: Wählen Sie Proxy-Entwicklung > API-Proxys aus.

   Wenn Sie das klassische Apigee-Benutzeroberfläche verwenden: Wählen Sie aus Entwickeln > API-Proxys und in der Bereich Proxys wählen Sie die Umgebung für den Proxy aus, dessen Ressourcen Sie ansehen möchten.

2. Wählen Sie den API-Proxy aus, dessen Ressourcen Sie anzeigen möchten. Dadurch wird die Ansicht Übersicht des Proxy-Editors angezeigt.

3. Klicken Sie auf den Tab Entwickeln.
4. Scrollen Sie im linken Bereich nach unten zu Ressourcen. Die aktuellen Ressourcen werden darunter angezeigt.

Klassischer Proxy-Editor

So rufen Sie die Ressourcen, die einer API-Proxy-Überarbeitung zugeordnet sind, mit dem klassischen Proxy-Editor auf:

1. Melden Sie sich bei der Apigee-UI an.
2. Wählen Sie in der linken Navigationsleiste Develop > API Proxies aus.
3. Wählen Sie in der Liste den API-Proxy aus, für den Sie eine Ressource erstellen möchten.
   Anschließend wird der API-Proxy-Editor geöffnet und standardmäßig der Tab Übersicht angezeigt.
4. Klicken Sie auf den Tab Entwickeln.
5. Wählen Sie ggf. im Drop-down-Menü Überarbeitung die Überarbeitung aus.

   Die Ressourcen, die der API-Proxy-Überarbeitung zugeordnet sind, sind in der Navigationsansicht im Bereich Ressourcen aufgelistet.

Ressource über die UI erstellen

Hinweis: Apigee wird zukünftig eine neue Version des Proxy-Editors bereitstellen, die die Verwaltung von Proxys vereinfachen wird.

In den Anleitungen auf den ersten beiden Tabs unten wird erläutert, wie Sie entweder den neuen Proxy-Editor oder den klassischen Proxy-Editor verwenden.

Neuer Proxy-Editor

So erstellen Sie eine Ressource mit dem neuen Proxy-Editor:

1. Wenn Sie die Apigee-UI in der Cloud Console verwenden: Wählen Sie Proxy-Entwicklung > API-Proxys aus.

   Wenn Sie das klassische Apigee-Benutzeroberfläche verwenden: Wählen Sie aus Entwickeln > API-Proxys und in der Bereich Proxys wählen Sie die Umgebung für den Proxy aus, dessen Ressourcen Sie ansehen möchten.

2. Wählen Sie den API-Proxy aus, dessen Ressourcen Sie anzeigen möchten. Dadurch wird die Ansicht Übersicht des Proxy-Editors angezeigt.

3. Klicken Sie auf den Tab Entwickeln.
4. Scrollen Sie im linken Bereich nach unten zu Ressourcen und klicken Sie rechts daneben auf die Schaltfläche +.
5. Geben Sie im Dialogfeld Ressource hinzufügen Folgendes ein:
   • Ressourcentyp: Wählen Sie den Dateityp für die Ressource aus.
   • Wählen Sie unter Quelle entweder Neue Datei erstellen oder Datei importieren aus. Wenn Sie Datei importieren auswählen, wählen Sie auch eine zu importierende Datei im Feld Datei aus.
   • Ressourcenname: Geben Sie einen Namen für die Ressource ein.
6. Klicken Sie auf Add (Hinzufügen).

Klassisches Apigee

So erstellen Sie über die klassische Apigee-Benutzeroberfläche Ressourcen, die einer API-Proxy-Überarbeitung zugeordnet sind:

1. Sehen Sie sich die Ressourcen an, die der API-Proxy-Überarbeitung zugeordnet sind.
2. Klicken Sie in der Navigationsansicht im Bereich "Ressourcen" auf +, um das Dialogfeld "Neue Ressource" zu öffnen.
3. Passende Sucheingabe

   Feld	Beschreibung
   Quelle	Wählen Sie aus, ob Sie eine neue Datei erstellen oder eine Datei importieren möchten.
   Dateityp	Wählen Sie einen Ressourcentyp aus der Drop-down-Liste aus.
   Dateiname	Name der Datei. Die Dateinamenerweiterung muss für den ausgewählten Dateityp gültig sein.

Ressource über die UI aktualisieren

Aktualisieren Sie eine Ressource, die einer API-Proxy-Überarbeitung zugeordnet ist, nur dann, wenn die Überarbeitung noch nicht bereitgestellt wurde. Nachdem eine API-Proxy-Version bereitgestellt wurde, ist sie unveränderlich.

So aktualisieren Sie über die UI eine Ressource, die einer API-Proxy-Überarbeitung zugeordnet ist:

1. Sehen Sie sich die Ressourcen an, die der API-Proxy-Überarbeitung zugeordnet sind.
2. Klicken Sie in der Navigationsansicht unter Resourcen auf die Ressource, die Sie aktualisieren möchten.
   Hinweis: Bei JAR-Dateien bewegen Sie den Mauszeiger auf die Ressource, die Sie bearbeiten möchten, und klicken dann auf .
3. Aktualisieren Sie die Ressource nach Bedarf.
   Hinweis: Klicken Sie nach dem Hochladen einer neuen JAR-Datei auf Aktualisieren.

Ressourcen über die UI löschen

Löschen Sie eine Ressource, die einer API-Proxy-Überarbeitung zugeordnet ist, nur dann, wenn die Überarbeitung noch nicht bereitgestellt wurde. Nachdem eine API-Proxy-Version bereitgestellt wurde, ist sie unveränderlich.

So aktualisieren Sie über die UI eine Ressource, die einer API-Proxy-Überarbeitung zugeordnet ist:

1. Sehen Sie sich die Ressourcen an, die der API-Proxy-Überarbeitung zugeordnet sind.
2. Bewegen Sie den Mauszeiger in der Navigationsansicht unter "Ressourcen" auf die Ressource, die Sie löschen möchten, um das Aktionsmenü einzublenden.
3. Klicken Sie auf .
4. Klicken Sie auf Löschen, um die Aktion zu bestätigen.

Ressourcen mit der API verwalten

Sie können Ressourcen mithilfe der API wie in den folgenden Abschnitten beschrieben verwalten.

Ressourcen mit der API erstellen

Erstellen Sie Ressourcen, die einer API-Proxy-Überarbeitung oder einer Umgebung zugeordnet sind, wie in den folgenden Abschnitten beschrieben.

Mit der API Ressourcen erstellen, die einer API-Proxy-Überarbeitung zugeordnet sind

Erstellen Sie mit der API Ressourcen, die einer API-Proxy-Überarbeitung zugeordnet sind, wie in den folgenden Abschnitten beschrieben.

Hinweis: Sie können eine Ressource, die einer vorhandenen API-Proxy-Überarbeitung zugeordnet ist, nur dann erstellen, wenn die Überarbeitung noch nicht bereitgestellt wurde. Nachdem die API-Proxy-Revision bereitgestellt wurde, ist sie unveränderlich.

So erstellen Sie mit der API eine Ressource, die einer API-Proxy-Überarbeitung zugeordnet ist:

1. Erstellen Sie die Ressourcendatei.
2. Fügen Sie die Ressourcendatei einem API-Proxy-Konfigurationsset hinzu.
3. Laden Sie das Set mit einer der folgenden APIs hoch:
   • Erstellen Sie den API-Proxy.
   • API-Proxy-Überarbeitung aktualisieren

Mit der API Ressourcen erstellen, die einer Umgebung zugeordnet sind

Erstellen Sie mithilfe der API Ressourcen, die einer Umgebung zugeordnet sind. Senden Sie dazu eine POST-Anfrage an die folgende Ressource: /organizations/$ORG/environments/$ENV/resourcefiles

Übergeben Sie mit der Anfrage die folgenden Informationen:

• Legen Sie für den Abfrageparameter name den Namen der Ressource fest.
• Legen Sie für den Abfrageparameter type den erforderlichen Ressourcentyp fest.
• Übergeben Sie den Inhalt der Ressourcendatei als application/octet-stream oder multipart/form-data.

Hinweis: Beim Importieren einer Ressourcendatei mithilfe der API müssen Sie die Dateiberechtigungen möglicherweise mit chmod anpassen, damit sie Ihr Entwicklungstool (z. B. curl) hochladen kann.

Das folgende Beispiel zeigt, wie eine JavaScript-Ressource erstellt wird, indem der Inhalt in den Anfragetext übertragen wird.

curl -X POST https://apigee.googleapis.com/v1/organizations/myorg/environments/test/resourcefiles?name=pathSetter.js&type=jsc
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type:application/octet-stream" \
  -d 'request.headers["RequestPath"] = context.getVariable("proxy.basepath");'

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 findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Das folgende Beispiel zeigt, wie Sie die Ressource als Datei von Ihrem lokalen Computer hochladen. Für den binären Upload in curl muss unbedingt -F verwendet werden, damit die JavaScript-Dateien für die Umgebung oder die Organisation auf die JavaScript-Richtlinie zugreifen können.

curl -X POST https://apigee.googleapis.com/v1/organizations/myorg/environments/test/resourcefiles?name=pathSetter.js&type=jsc
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type:multipart/form-data" \
  -F file=@pathSetter.js

Im Folgenden finden Sie ein Beispiel für die Antwort:

{
  "name" : "pathSetter.js",
  "type" : "jsc"
}

Hinweis: Gehen Sie bei Verwendung eines REST-Clients wie Postman so vor:

• Legen Sie den Wert Content-Type auf multipart/form-data fest.
• Hängen Sie das Skript als Datei an.

Ressourcen mit der API aufrufen

In den folgenden Abschnitten wird beschrieben, wie Sie sich Ressourcen mit der API anzeigen lassen.

Alle Ressourcen mit der API ansehen

Mit der API können Sie sich wie im folgenden Abschnitt beschrieben alle Ressourcen anzeigen lassen, die einer Umgebung zugeordnet sind.

Mit der API können Sie sich nur Ressourcen anzeigen lassen, die einer Umgebung zugeordnet sind.

Senden Sie eine GET-Anfrage an die folgende Ressource, um sich mit der API alle Ressourcen in einer Umgebung anzeigen zu lassen: https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles

Im folgenden Beispiel werden alle Ressourcen in der test-Umgebung aufgelistet:

curl -X GET https://apigee.googleapis.com/v1/organizations/myorg/environments/test/resourcefiles
  -H "Authorization: Bearer $TOKEN"

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.

Weitere Informationen finden Sie unter API-Dateien für Umgebungsressourcen auflisten.

Im Folgenden finden Sie ein Beispiel für die Antwort:

{
  "resourceFile": [
{
  "name" : "pathSetter.js",
  "type" : "jsc"
}
  ]
}

Inhalt einer Ressource mit der API ansehen

Senden Sie eine GET-Anfrage an die folgende Ressource, um sich den Inhalt einer Ressource in einer Umgebung mit der API anzeigen zu lassen: /organizations/$ORG/environments/$ENV/resourcefiles/$TYPE/$NAME

Im folgenden Beispiel wird der Inhalt der JavaScript-Datei pathSetter.js (jsc) in der test-Umgebung aufgelistet:

curl -X GET https://apigee.googleapis.com/v1/organizations/myorg/environments/test/resourcefiles/jsc/pathSetter.js
  -H "Authorization: Bearer $TOKEN"

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 findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Im Folgenden finden Sie ein Beispiel für die Antwort:

request.headers["RequestPath"] = context.getVariable("proxy.basepath");

Ressourcen mit der API aktualisieren

Aktualisieren Sie Ressourcen, die einer API-Proxy-Überarbeitung oder einer Umgebung zugeordnet sind, wie in den folgenden Abschnitten beschrieben.

Mit der API Ressourcen aktualisieren, die einer API-Proxy-Überarbeitung zugeordnet sind

Hinweis: Sie können eine Ressource, die einer vorhandenen API-Proxy-Überarbeitung zugeordnet ist, nur dann aktualisieren, wenn die Überarbeitung noch nicht bereitgestellt wurde. Nachdem die API-Proxy-Revision bereitgestellt wurde, ist sie unveränderlich.

So aktualisieren Sie mit der API eine Ressource, die einer API-Proxy-Überarbeitung zugeordnet ist:

1. Laden Sie das API-Proxykonfigurationsset mithilfe der API-Proxy-Revision-API mit den folgenden Optionen herunter:
   • Setzen Sie den Abfrageparameter format auf bundle.
   • Setzen Sie den Accept-Header auf application/zip.
2. Aktualisieren Sie die Ressourcendatei im API-Proxy-Konfigurationsset.
3. Laden Sie das API-Proxykonfigurationsset mit der Update API-Proxy-Überarbeitungs-API hoch.

Mit der API Ressourcen aktualisieren, die einer Umgebung zugeordnet sind

Aktualisieren Sie mit der API eine Ressource, die einer Umgebung zugeordnet ist. Senden Sie dazu eine PUT-Anfrage an die folgende Ressource: /organizations/$ORG/environments/$ENV/resourcefiles/$TYPE/$NAME

Übergeben Sie den Inhalt der Ressourcendatei als application/octet-stream oder multipart/form-data.

Hinweis: Beim Importieren einer Ressourcendatei mithilfe der API müssen Sie die Dateiberechtigungen möglicherweise mit chmod anpassen, damit sie Ihr Entwicklungstool (z. B. curl) hochladen kann.

Das folgende Beispiel zeigt, wie eine JavaScript-Ressource aktualisiert wird, indem der Inhalt in den Anfragetext übertragen wird.

curl -X PUT https://apigee.googleapis.com/v1/organizations/myorg/environments/test/resourcefiles/jsc/pathSetter.js
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type:application/octet-stream" \
  -d 'request.headers["RequestPath"] = context.getVariable("proxy.basepath");'

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 findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.

Das folgende Beispiel zeigt, wie die Ressourcendatei mithilfe einer Datei von Ihrem lokalen Computer aktualisiert wird. Für den binären Upload in curl muss unbedingt -F verwendet werden, damit die JavaScript-Dateien für die Umgebung oder die Organisation auf die JavaScript-Richtlinie zugreifen können.

curl -X PUT https://apigee.googleapis.com/v1/organizations/myorg/environments/test/resourcefiles/jsc/pathSetter.js
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type:multipart/form-data" \
  -F file=@pathSetter.js

Im Folgenden finden Sie ein Beispiel für die Antwort:

{
  "name" : "pathSetter.js",
  "type" : "jsc"
}

Ressourcen mit der API löschen

Löschen die Ressource, die einer API-Proxy-Überarbeitung oder einer Umgebung zugeordnet ist, wie in den folgenden Abschnitten beschrieben.

Mit der API Ressourcen löschen, die einer API-Proxy-Überarbeitung zugeordnet sind

Hinweis: Sie können eine Ressource, die einer API-Proxy-Überarbeitung zugeordnet ist, nur dann löschen, wenn sie noch nicht bereitgestellt wurde. Nachdem die API-Proxy-Revision bereitgestellt wurde, ist sie unveränderlich.

Mit einem Hybridanbieter und der API lässt sich eine Ressource, die einem API-Proxy zugeordnet ist, so löschen:

1. Laden Sie das API-Proxykonfigurationsset mithilfe der API-Proxy-Revision-API mit den folgenden Optionen herunter:
   • Setzen Sie den Abfrageparameter format auf bundle.
   • Setzen Sie den Accept-Header auf application/zip.
2. Löschen Sie die Ressourcendatei aus dem API-Proxy-Konfigurationsset.
3. Laden Sie das API-Proxykonfigurationsset mit der Update API-Proxy-Überarbeitungs-API hoch.

Mit der API eine Ressource löschen, die einer Umgebung zugeordnet ist

Löschen Sie mit der API eine Ressource, die einer Umgebung zugeordnet ist, wie in den folgenden Abschnitten beschrieben.

Senden Sie eine DELETE-Anfrage an die folgende Ressource, um mit der API eine Ressource zu löschen, die einer Umgebung zugeordnet ist: https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/resourcefiles/$TYPE/$NAME

Im folgenden Beispiel wird die JavaScript-Ressourcendatei pathSetter.js aus der test-Umgebung gelöscht:

curl -X DELETE https://apigee.googleapis.com/v1/organizations/my-organization/environments/test/resourcefiles/jsc/pathSetter.js \
  -H "Authorization: Bearer $TOKEN"
  

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.

Weitere Informationen finden Sie unter Ressourcendatei-API löschen.

Im Folgenden finden Sie ein Beispiel für die Antwort:

{
  "name" : "pathSetter.js",
  "type" : "jsc"
}

Auf die Ressource zugreifen

Wie Sie auf die Ressource zugreifen, hängt vom Ressourcentyp ab. Weitere Informationen finden Sie in der Übersicht über die Richtlinien.

In den Beispielen in diesem Abschnitt wird gezeigt, wie Sie eine JavaScript-Ressource mit dem Namen pathSetter.js erstellen und verwalten, damit Richtlinien des Typs JavaScript auf sie verweisen können.

Erstellen Sie eine Richtlinie mit dem Namen PathSetterPolicy.xml, die auf die Datei pathSetter.js verweist, um das JavaScript an den PostFlow der Anfrage anzuhängen:

<Javascript name='PathSetterPolicy' timeLimit='200'>
    <ResourceURL>jsc://pathSetter.js</ResourceURL>
</Javascript>

Erstellen Sie dann in der Endpunktkonfiguration einen Verweis auf die Richtlinie:

<PostFlow>
  <Request>
    <Step><Name>PathSetterPolicy</Name></Step>
  </Request>
<PostFlow>

Weitere Informationen finden Sie unter JavaScript-Richtlinie.