API-Ressourcen mit Apigee Spaces verwalten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Apigee in der Cloud Console

So erstellen Sie einen API-Proxy als Space-Ressource mit Apigee in der Cloud Console:

1. Folgen Sie der Anleitung unter API-Proxy erstellen.
2. In Schritt 5 sehen Sie unter Proxy-Details ein zusätzliches Feld, in dem Sie einen Space für den API-Proxy auswählen können. Wählen Sie im Listenfeld einen Space aus. Wenn Sie den API-Proxy keinem Space zuweisen möchten, können Sie dieses Feld überspringen.
3. Klicken Sie auf Weiter, um mit dem optionalen Bereitstellungsschritt der Proxyerstellung fortzufahren, oder auf Erstellen, um den Proxy zu erstellen, ohne ihn bereitzustellen.

Apigee API

Verwenden Sie den folgenden Befehl, um mit den Apigee APIs einen API-Proxy als Space-Ressource zu erstellen:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/apis?name=PROXY_NAME&space=SPACE_NAME&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data" \
    -F "file=@PROXY_BUNDLE"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• PROXY_NAME ist der Name des API-Proxys, den Sie erstellen. Der Name muss global eindeutig sein, nicht nur innerhalb des Spaces eindeutig.
• SPACE_NAME ist der Name des Space, in dem Sie den API-Proxy erstellen.
• PROXY_BUNDLE ist der Name der API-Proxy-Bundle-Datei.

Beispiel: Mit dem folgenden Befehl erstellt ein rotes Teammitglied einen API-Proxy mit dem Namen proxy-1 als rote Space-Ressource in der acme-Organisation mit der proxy-bundle.zip-Datei:

curl "https://apigee.googleapis.com/v1/organizations/acme/apis?name=proxy-1&space=red&action=import" \
    -X POST -H "Authorization: Bearer $TOKEN" \
    -H "Content-type: multipart/form-data \
    -F "file=@proxy-bundle.zip"

Das folgende Beispiel zeigt die Antwort auf den Befehl:

{
  "basepaths": ["/proxy-1"],
  "revision": 1,
  "apiProxyId": "proxy-1",
  "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
  "space": "red",
  "createTime": ...,
  "updateTime": ...
}

Apigee in der Cloud Console

Wenn Sie einen API-Proxy als Space-Ressource mit Apigee in der Cloud Console bereitstellen möchten, folgen Sie der Anleitung unter API-Proxy bereitstellen. Es sind keine zusätzlichen Schritte oder Felder erforderlich.

Apigee API

Verwenden Sie den folgenden Befehl, um einen API-Proxy mithilfe der Apigee APIs als Space-Ressource bereitzustellen:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/apis/PROXY_NAME/revisions/REVISION_NUMBER/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• ENV_NAME ist der Name der Umgebung, in der Sie den API-Proxy bereitstellen.
• PROXY_NAME ist der Name des API-Proxys, den Sie bereitstellen.
• REVISION_NUMBER ist die Versionsnummer des API-Proxys, den Sie bereitstellen.

Mit dem folgenden Befehl stellt ein rotes Teammitglied beispielsweise den API-Proxy proxy-1, Version 1, in der acme-Organisation für die prod-Umgebung bereit:

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/apis/proxy-1/revisions/1/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Das folgende Beispiel zeigt die Antwort auf den Befehl:

      {
        "environment": "prod",
        "revision": "1",
        "apiProxy": "proxy-1",
        ...
      }
      

Apigee in der Cloud Console

Wenn Sie die Bereitstellung eines API-Proxys aufheben möchten, der mit einem Space verknüpft ist, und Apigee in der Cloud Console verwenden, folgen Sie der Anleitung unter Bereitstellung eines API-Proxys aufheben. Es sind keine weiteren Schritte oder Felder erforderlich.

Apigee API

Verwenden Sie den folgenden Befehl, um über die Apigee APIs die Bereitstellung eines API-Proxys aufzuheben, der mit einem Space verknüpft ist:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/apis/PROXY_NAME/revisions/REVISION_NUMBER/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• ENV_NAME ist der Name der Umgebung, in der Sie die Bereitstellung des API-Proxys aufheben.
• PROXY_NAME ist der Name des API-Proxys, dessen Bereitstellung Sie aufheben.
• REVISION_NUMBER ist die Versionsnummer des API-Proxys, dessen Bereitstellung Sie rückgängig machen.

Mit dem folgenden Befehl hebt ein rotes Teammitglied beispielsweise die Bereitstellung des API-Proxys proxy-1, Version 1, in der acme-Organisation aus der prod-Umgebung auf:

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/apis/proxy-1/revisions/1/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Apigee in der Cloud Console

1. Folgen Sie der Anleitung unter Freigegebenen Ablauf in der Apigee-Benutzeroberfläche erstellen, um einen freigegebenen Ablauf von Grund auf neu zu erstellen oder ein vorhandenes Ablauf-Bundle hochzuladen.
2. In Schritt 4 sehen Sie im Dialogfeld Freigegebenen Ablauf erstellen ein zusätzliches Feld, in dem Sie einen Space für den API-Proxy auswählen können. Wählen Sie im Listenfeld einen Space aus. Wenn Sie den API-Proxy keinem Space zuweisen möchten, können Sie dieses Feld überspringen.
3. Klicken Sie auf Erstellen, um den freigegebenen Ablauf zu erstellen.

Apigee API

Verwenden Sie den folgenden Befehl, um mit den Apigee APIs einen freigegebenen Ablauf als Space-Ressource zu erstellen:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/sharedflows?name=FLOW_NAME&space=SPACE_NAME&action=import" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: multipart/form-data" \
          -F "file=@SHARED_FLOW_BUNDLE"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• FLOW_NAME ist der Name des freigegebenen Ablaufs, den Sie erstellen. Der Name muss global eindeutig sein, nicht nur innerhalb des Spaces eindeutig.
• SPACE_NAME ist der Name des Spaces, in dem Sie den freigegebenen Ablauf erstellen.
• SHARED_FLOW_BUNDLE ist der Name der Bundle-Datei des freigegebenen Ablaufs.

Mit dem folgenden Befehl erstellt ein Mitglied des roten Teams beispielsweise einen freigegebenen Ablauf namens flow-1, der mit dem roten Space in der Organisation acme verknüpft ist:

curl "https://apigee.googleapis.com/v1/organizations/acme/sharedflows?name=flow-1&space=red&action=import" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: multipart/form-data" \
          -F "file=@sharedflow-bundle.zip"

Das folgende Beispiel zeigt die Antwort auf den Befehl:

      {
        "name": "organizations/acme/sharedflows/flow-1",
        "revision": 1,
        "sharedFlowId": "flow-1",
        "space": "red",
        "createTime": ...,
        "updateTime": ...
      }
      

Apigee in der Cloud Console

So stellen Sie mit Apigee in der Cloud Console einen freigegebenen Ablauf als Space-Ressource bereit:

1. Melden Sie sich in der Apigee-UI in der Cloud Console an.
2. Wählen Sie die Organisation aus, die den freigegebenen Ablauf enthält. Weitere Informationen finden Sie unter Zwischen Organisationen wechseln.
3. Wählen Sie in der linken Navigationsleiste Proxy-Entwicklung > Freigegebene Abläufe aus.
4. Klicken Sie auf der Übersichtsseite Freigegebene Abläufe auf den Namen des freigegebenen Ablaufs, den Sie bereitstellen möchten. Die Detailseite für den freigegebenen Ablauf wird angezeigt.
5. Klicken Sie auf Bereitstellen, um das Dialogfeld für die Bereitstellung zu öffnen.
6. Geben Sie Folgendes ein:
   • Version: Die Versionsnummer des freigegebenen Ablaufs, den Sie bereitstellen möchten.
   • Umgebung: Die Umgebung, in der Sie den freigegebenen Ablauf bereitstellen möchten.
   • Dienstkonto (optional): Ein Dienstkonto für den freigegebenen Ablauf.
7. Klicken Sie auf Bereitstellen.

Apigee API

Verwenden Sie den folgenden Befehl, um mithilfe der Apigee APIs einen freigegebenen Ablauf als Space-Ressource bereitzustellen:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/sharedflows/FLOW_NAME/revisions/REVISION_NUMBER/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• ENV_NAME ist der Name der Umgebung, in der Sie den freigegebenen Ablauf bereitstellen.
• FLOW_NAME ist der Name des freigegebenen Ablaufs, den Sie bereitstellen.
• REVISION_NUMBER ist die Versionsnummer des freigegebenen Ablaufs, den Sie bereitstellen.

Mit dem folgenden Befehl stellt ein Mitglied des roten Teams beispielsweise den freigegebenen Ablauf flow-1, Version 1, in der Organisation acme in der Umgebung prod bereit:

curl "https://apigee.googleapis.com/v1/organizations/acme/environments/prod/sharedflows/flow-1/revisions/1/deployments" \
          -X POST -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Das folgende Beispiel zeigt die Antwort auf den Befehl:

      {
        "environment": "prod",
        "revision": "1",
        "sharedFlow": "flow-1",
        ...
      }
      

Apigee in der Cloud Console

So heben Sie mit Apigee in der Cloud Consoledie Bereitstellung eines freigegebenen Ablaufs auf, der mit einem Space verknüpft ist:

1. Melden Sie sich in der Apigee-UI in der Cloud Console an.
2. Wählen Sie die Organisation aus, die den freigegebenen Ablauf enthält. Weitere Informationen finden Sie unter Zwischen Organisationen wechseln.
3. Wählen Sie in der linken Navigationsleiste Proxy-Entwicklung > Freigegebene Abläufe aus.
4. Klicken Sie auf der Übersichtsseite Freigegebene Abläufe auf den Namen des freigegebenen Ablaufs, dessen Bereitstellung Sie aufheben möchten. Die Detailseite für den freigegebenen Ablauf wird angezeigt.
5. Klicken Sie unter Bereitstellungen auf Bereitstellung aufheben.

Apigee API

Verwenden Sie den folgenden Befehl, um die Bereitstellung eines freigegebenen Ablaufs aufzuheben, der mit einem Space verknüpft ist:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME/sharedflows/FLOW_NAME/revisions/REVISION_NUMBER/deployments" \
          -X DELETE -H "Authorization: Bearer $TOKEN" \
          -H "Content-type: application/json"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• ENV_NAME ist der Name der Umgebung, in der Sie die Bereitstellung des freigegebenen Ablaufs aufheben.
• FLOW_NAME ist der Name des freigegebenen Ablaufs, den Sie nicht mehr bereitstellen möchten.
• REVISION_NUMBER ist die Versionsnummer des freigegebenen Ablaufs, den Sie zurückziehen.

Apigee in der Cloud Console

So erstellen Sie ein API-Produkt als Space-Ressource mit Apigee in der Cloud Console:

1. Folgen Sie der Anleitung unter API-Produkt erstellen.
2. In Schritt 4 sehen Sie auf der Seite Produktdetails ein zusätzliches Feld, in dem Sie einen Space für das API-Produkt auswählen können. Wählen Sie im Listenfeld einen Space aus. Wenn Sie das API-Produkt keinem Space zuweisen möchten, können Sie dieses Feld überspringen.
3. Geben Sie die restlichen Konfigurationsinformationen ein und klicken Sie auf Speichern.

Apigee API

Verwenden Sie den folgenden Befehl, um ein API-Produkt als Space-Ressource zu erstellen:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/apiproducts" \
            -X POST -H "Authorization: Bearer $TOKEN" \
            -H "Content-type: application/json" \
            -d  \
              `{
                "name": "PRODUCT_NAME",
                "displayName": "DISPLAY_NAME",
                "description": "PRODUCT_DESCRIPTION",
                "approvalType": "auto",
                "apiResources": [
                  {
                    "apiproduct": "PRODUCT_NAME",
                    "apiResource": "PROXY_NAME",
                    "operations": [
                      {
                        "method": "GET",
                        "path": "/"
                      }
                    ]
                  }
                ],
                "space": "SPACE_NAME"
              }`

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• PRODUCT_NAME ist der Name des API-Produkts, das Sie erstellen. Der Name muss global eindeutig sein, nicht nur innerhalb des Spaces eindeutig.
• DISPLAY_NAME ist der Name des API-Produkts, das Sie erstellen, wie er in der Benutzeroberfläche angezeigt wird.
• PRODUCT_DESCRIPTION ist die Beschreibung des API-Produkts, das Sie erstellen.
• SPACE_NAME ist der Name des Spaces, in dem Sie das API-Produkt erstellen.
• PROXY_NAME ist der Name des API-Proxys, den Sie dem API-Produkt hinzufügen.

Beispiel: Mit dem folgenden Befehl erstellt ein rotes Teammitglied ein API-Produkt namens product-1, das mit dem roten Space in der acme-Organisation verknüpft ist:

curl "https://apigee.googleapis.com/v1/organizations/acme/apiproducts?name=product-1&space=red&action=import" \
            -X POST -H "Authorization: Bearer $TOKEN" \
            -X "Content-type: application/json" \
            -d  \
              `{
                "name": "product-1",
                "displayName": "product-1",
                "description": "Product 1",
                "apiResources": [
                  {
                    "apiproduct": "product-1",
                    "apiResource": "proxy-1",
                    "operations": [
                      {
                        "method": "GET",
                        "path": "/"
                      }
                    ]
                  }
                ],
                "space": "red"
              }`

Das folgende Beispiel zeigt die Antwort auf den Befehl:

        {
          "name": "organizations/acme/apiproducts/product-1",
          "displayName": "product-1",
          "description": "Product 1",
          "apiResources": [
            {
              "apiproduct": "product-1",
              "apiResource": "proxy-1",
              "operations": [
                {
                  "method": "GET",
                  "path": "/"
                }
              ]
            }
          ],
          "space": "red",
          "createTime": ...,
          "updateTime": ...
        }

Apigee in der Cloud Console

Wenn Sie in Apigee in der Cloud Console alle API-Ressourcen auflisten möchten, die mit einem bestimmten Space verknüpft sind, öffnen Sie die Übersichtsseite für den entsprechenden Ressourcentyp (API-Proxys, freigegebene Abläufe oder API-Produkte). Wählen Sie im Feld Filter die Option Space aus der Liste aus und geben Sie dann den Namen des Space ein. Die Liste der diesem Space zugewiesenen Ressourcen wird angezeigt. Es werden nur Ressourcen angezeigt, die mit einem Space verknüpft sind, in dem der Nutzer Mitglied ist.

Apigee API

Mit dem folgenden Befehl können Sie alle API-Ressourcen auflisten, die mit einem bestimmten Space verknüpft sind:

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE?space=SPACE_NAME"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• RESOURCE_TYPE ist der Typ der Ressource, die Sie auflisten. Gültige Werte sind:
  • apis
  • sharedFlows
  • apiProducts
• SPACE_NAME ist der Name des Space, in dem Sie die Ressource auflisten.

Mit dem folgenden Befehl listet ein Mitglied des roten Teams beispielsweise alle API-Proxys auf, die mit dem roten Space in der Organisation acme verknüpft sind:

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis?space=red"

Das folgende Beispiel zeigt die Antwort auf den Befehl:

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          }
        ]
      }

Apigee in der Cloud Console

Wenn Sie in Apigee in der Cloud Console eine Liste aller API-Ressourcen eines bestimmten Typs unabhängig von der Space-Verknüpfung aufrufen möchten, öffnen Sie die Übersichtsseite für den entsprechenden Ressourcentyp (API-Proxys, freigegebene Abläufe oder API-Produkte). Eine Liste aller verfügbaren Ressourcen wird angezeigt. Es werden nur Ressourcen angezeigt, für die der Nutzer die Berechtigung zum Ansehen hat. Dazu gehören mit einem oder mehreren Spaces verknüpfte Ressourcen, in denen der Nutzer Mitglied ist, oder Ressourcen, die nicht mit einem Space verknüpft sind.

Apigee API

Mit dem folgenden Befehl können Sie API-Ressourcen auch auflisten, ohne einen Space anzugeben:

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/ORG_NAME/RESOURCE_TYPE"

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• RESOURCE_TYPE ist der Typ der Ressource, die Sie auflisten. Gültige Werte sind:
  • apis
  • sharedFlows
  • apiProducts

Ein Nutzer mit Organization Admin-Zugriff auf alle Organisationsressourcen kann beispielsweise mit dem folgenden Befehl alle API-Proxys in der Organisation acme auflisten:

curl -H  "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations/acme/apis"

Wenn die Organisation acme drei Proxys hat, gibt der Befehl Details zu allen drei Proxys zurück. Beispiel:

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          },
          {
            "basepaths": "/proxy-2",
            "revision": "1",
            "apiProxyId": "proxy-2",
            "resourceName": "organizations/acme/apis/proxy-2/revisions/1",
            "space": "blue",
            "createTime": ...,
            ....
          },
          {
            "basepaths": "/proxy-3",
            "revision": "1",
            "apiProxyId": "proxy-3",
            "resourceName": "organizations/acme/apis/proxy-3/revisions/1",
            "space": "green",
            "createTime": ...,
            ....
          }
        ]
      }

Wenn ein anderer Nutzer, der nur apiAdmin-Zugriff hat, auf Ressourcen im roten Space denselben Befehl verwendet, werden nur Details zu proxy-1 zurückgegeben. Die Antwort würde so aussehen:

      {
        "proxies": [
          {
            "basepaths": "/proxy-1",
            "revision": "1",
            "apiProxyId": "proxy-1",
            "resourceName": "organizations/acme/apis/proxy-1/revisions/1",
            "space": "red",
            "createTime": ...,
            ....
          }
        ]
      }