Administra recursos de API con espacios de Apigee

Consulta la documentación de Apigee Edge.

En este tema, se describe cómo crear y administrar recursos de API en un espacio. Puedes crear proxies de API, flujos compartidos y productos de API en un espacio. Los recursos creados en el espacio heredan los mismos permisos que el espacio.

Crear recursos en un espacio es lo mismo que crear recursos en una organización de Apigee, excepto que puedes seleccionar un espacio cuando creas el recurso. Para la versión de DG privada, puedes crear recursos de API desde la línea de comandos con las APIs de Apigee o con Apigee en la consola de Cloud.

En esta guía, se describen los pasos necesarios para hacer lo siguiente:

Para obtener una descripción general de los espacios de Apigee, consulta Espacios de Apigee.

Para obtener más información sobre los tipos de recursos de la API de Apigee, consulta los siguientes artículos:

Antes de comenzar

Antes de comenzar a crear recursos de API en espacios de Apigee, asegúrate de haber completado las siguientes tareas:

Roles y permisos requeridos

Con la introducción de los espacios de Apigee, cambió la forma en que IAM verifica los permisos necesarios para realizar algunas operaciones en los recursos de la API. Si el recurso de la API existe en un espacio, IAM buscará los permisos adecuados a nivel del espacio para el miembro del espacio que realiza la operación. A continuación, se describen los permisos necesarios para estas operaciones en las que los recursos de la API se encuentran en un espacio:

Operación Se requiere permiso Alcance
Implementa un proxy de API
apigee.deployments.create
Y
apigee.proxyrevisions.deploy
Entorno
 
proxy de API
Enumera todas las implementaciones de un proxy de API apigee.proxies.get proxy de API
Enumera todas las implementaciones de una revisión del proxy de API apigee.proxyrevisions.get Revisión del proxy de API
Enumera todas las implementaciones de un proxy de API en un entorno
apigee.deployments.list
O
apigee.proxies.get
Entorno
 
proxy de API
Obtén la implementación de una revisión del proxy de API
apigee.deployments.get
O
apigee.proxyrevisions.get
Revisión del proxy de API
 
Entorno
Borra una revisión de proxy de API apigee.deployments.delete Revisión del proxy de API Y entorno
Implementa un flujo compartido
apigee.deployments.create
Y
apigee.sharedflows.deploy
Entorno
 
Flujo compartido
Cómo enumerar todas las implementaciones de un flujo compartido apigee.sharedflows.get Flujo compartido
Cómo enumerar todas las implementaciones de una revisión de flujo compartido apigee.sharedflowrevisions.get Revisión de flujo compartido
Cómo enumerar todas las implementaciones de un flujo compartido en un entorno
apigee.deployments.list
O
apigee.sharedflows.get
Entorno
 
Flujo compartido
Obtén la implementación de una revisión de flujo compartido
apigee.deployments.get
O
apigee.sharedflowrevisions.get
Revisión del proxy de API
 
Flujo compartido
Borra un flujo compartido apigee.deployments.delete Flujo compartido Y entorno
Cómo crear una sesión de depuración para una revisión de proxy de API apigee.tracesessions.create Revisión del proxy de API Y entorno
Cómo recuperar una sesión de depuración apigee.tracesessions.get Proxy de API Y entorno
Borra datos de una sesión de depuración apigee.tracesessions.delete Proxy de API Y entorno
Enumera las sesiones de depuración activas en la revisión del proxy de API apigee.tracesessions.list Revisión del entorno O del proxy de API
Obtén los datos de depuración de una transacción apigee.tracesessions.get Revisión del entorno Y del proxy de API
Enumera los IDs de transacción de una sesión de depuración apigee.tracesessions.get Revisión del entorno Y del proxy de API

Asigna roles y permisos a los miembros del espacio

Los diversos permisos descritos se incluyen en el rol apigee.apiAdminV2 o en el rol apigee.environmentAdmin. Para obtener más información, consulta los roles de Apigee.

Para asignar estos roles y sus permisos a un miembro de un espacio, puedes hacer lo siguiente:

  • Agrega el rol roles/apiAdminV2 al espacio con la API y agrega el rol roles/environmentAdmin al entorno de destino con la API.
  • Agrega los roles al proyecto con la interfaz de usuario de IAM.

Verifica los roles

  1. En la consola de Google Cloud, ve a la página IAM.

    Ir a IAM
  2. Selecciona el proyecto.

  3. En la columna Principal, busca todas las filas que te identifiquen a ti o a un grupo en el que se te incluya. Para saber en qué grupos estás incluido, comunícate con tu administrador.

  4. Para todas las filas en las que se te especifique o se te incluya, verifica la columna Rol para ver si la lista de roles incluye los roles necesarios.

Otorga los roles

  1. En la consola de Google Cloud, ve a la página IAM.

    Ir a IAM
  2. Selecciona el proyecto.
  3. Haz clic en Grant access.

  4. En el campo Principales nuevas, ingresa tu identificador de usuario. Esta suele ser la dirección de correo electrónico de una Cuenta de Google.

  5. En la lista Seleccionar un rol, elige un rol.
  6. Para otorgar funciones adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.
  7. Haz clic en Guardar.

Rol necesario para acceder a los recursos de la API en la consola de Google Cloud

Para acceder a la IU de Apigee en la consola de Cloud como miembro del equipo de Space, los usuarios deben tener el rol ApigeeSpaceUser. Para obtener más información, consulta Roles y permisos de IAM.

Administra proxies de API en un espacio

Los miembros de la organización de Apigee asignados a un espacio pueden crear, implementar y anular la implementación de proxies de API como recursos del espacio. Los miembros asignados solo a otros espacios no podrán acceder a estos proxies ni administrarlos.

Crea un proxy de API como recurso de espacio

Crea un proxy de API como recurso de espacio con Apigee en la consola de Cloud o la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para crear un proxy de API como recurso de espacio con Apigee en la consola de Cloud, haz lo siguiente:

  1. Sigue los pasos que se describen en Cómo crear un proxy de API.
  2. En el Paso 5, verás un campo adicional en Detalles del proxy en el que puedes seleccionar un Espacio para el proxy de API. Selecciona un espacio del cuadro de lista. Si no deseas asignar el proxy de API a un espacio, puedes omitir este campo.
  3. Haz clic en Siguiente para continuar con el paso de implementación opcional de la creación de proxy o haz clic en Crear para crear el proxy sin implementarlo.

API de Apigee

Para crear un proxy de API como recurso de espacio con las APIs de Apigee, usa el siguiente comando: 

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"

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • PROXY_NAME es el nombre del proxy de API que estás creando. El nombre debe ser único a nivel global y no solo dentro del espacio.
  • SPACE_NAME es el nombre del espacio en el que creas el proxy de API.
  • PROXY_BUNDLE es el nombre del archivo del paquete de proxy de API.

Por ejemplo, con el siguiente comando, un miembro del equipo red crea un proxy de API llamado proxy-1 como el recurso de espacio red en la organización acme con el archivo proxy-bundle.zip:

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"

En el siguiente ejemplo, se muestra la respuesta al comando:

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

Implementa un proxy de API como recurso de espacio

Implementa un proxy de API como un recurso de Space con Apigee en la consola de Cloud o la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para implementar un proxy de API como recurso de espacio con la consola de Apigee en Cloud, sigue los pasos que se describen en Cómo implementar un proxy de API. No se requieren pasos ni campos adicionales.

API de Apigee

Para implementar un proxy de API como recurso de Space con las APIs de Apigee, usa el siguiente comando: 

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"

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • ENV_NAME es el nombre del entorno en el que implementas el proxy de API.
  • PROXY_NAME es el nombre del proxy de API que estás implementando.
  • REVISION_NUMBER es el número de revisión del proxy de API que estás implementando.

Por ejemplo, con el siguiente comando, un miembro del equipo rojo implementa el proxy de API proxy-1, revisión 1, en la organización acme en el entorno de producción: 

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"

En el siguiente ejemplo, se muestra la respuesta al comando: 

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

Anula la implementación de un proxy de API asociado con un espacio

Anula la implementación de un proxy de API asociado con un espacio mediante Apigee en la consola de Cloud o la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para anular la implementación de un proxy de API asociado con un espacio mediante la consola de Apigee en Cloud, sigue los pasos que se describen en Cómo anular la implementación de un proxy de API. No se requieren pasos ni campos adicionales.

API de Apigee

Para anular la implementación de un proxy de API asociado con un espacio con las APIs de Apigee, usa el siguiente comando: 

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"

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • ENV_NAME es el nombre del entorno en el que desincorporarás el proxy de API.
  • PROXY_NAME es el nombre del proxy de API cuya implementación quieres anular.
  • REVISION_NUMBER es el número de revisión del proxy de API que anulas.

Por ejemplo, con el siguiente comando, un miembro del equipo rojo anula la implementación del proxy de API proxy-1, revisión 1, en la organización acme del entorno de producción: 

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"

Administra flujos compartidos como recursos de espacio

Los miembros asignados a un espacio también pueden crear, implementar y desimplementar flujos compartidos como recursos del espacio. Los miembros de otros espacios no podrán acceder a estos flujos compartidos ni administrarlos.

Crea un flujo compartido como recurso de espacio

Crea un flujo compartido como recurso de espacio con la consola de Apigee en Cloud o la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para crear un flujo compartido como recurso de espacio con Apigee en la consola de Cloud, sigue estos pasos:
  1. Sigue los pasos que se describen en Cómo crear un flujo compartido en la IU de Apigee para crear un flujo compartido nuevo desde cero o subir un paquete de flujo existente.
  2. En el Paso 4, verás un campo adicional en el diálogo Create a shared flow en el que puedes seleccionar un espacio para el proxy de API. Selecciona un espacio del cuadro de lista. Si no deseas asignar el proxy de API a un espacio, puedes omitir este campo.
  3. Haz clic en Crear para crear el flujo compartido.

API de Apigee

Para crear un flujo compartido como recurso de espacio con las APIs de Apigee, usa el siguiente comando: 

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"

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • FLOW_NAME es el nombre del flujo compartido que estás creando. El nombre debe ser único a nivel global y no solo dentro del espacio.
  • SPACE_NAME es el nombre del espacio en el que creas el flujo compartido.
  • SHARED_FLOW_BUNDLE es el nombre del archivo del paquete de flujo compartido.

Por ejemplo, con el siguiente comando, un miembro del equipo red crea un flujo compartido llamado flow-1 asociado con el espacio red de la organización acme: 

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"

En el siguiente ejemplo, se muestra la respuesta al comando: 

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

Implementa un flujo compartido como recurso de espacio

Implementa un flujo compartido como un recurso de espacio con la API o la consola de Apigee en Cloud, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para implementar un flujo compartido como recurso de espacio con la consola de Apigee en Cloud, haz lo siguiente:

  1. Accede a la IU de Apigee en la consola de Cloud.
  2. Selecciona la organización que contiene tu flujo compartido. Consulta Cambia entre tus organizaciones.
  3. Selecciona Desarrollo de proxy > Flujos compartidos en la barra de navegación izquierda.
  4. En la página de descripción general Flujos compartidos, haz clic en el nombre del flujo compartido que deseas implementar. Se mostrará la página de detalles del flujo compartido.
  5. Haz clic en Implementar para abrir el cuadro de diálogo de implementación.
  6. Ingresa el siguiente comando:
    • Revisión: Es el número de revisión del flujo compartido que deseas implementar.
    • Entorno: Es el entorno en el que deseas implementar el flujo compartido.
    • Cuenta de servicio (opcional): Es una cuenta de servicio para el flujo compartido.
  7. Haz clic en Implementar.

API de Apigee

Para implementar un flujo compartido como recurso de espacio con las APIs de Apigee, usa el siguiente comando: 

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"

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • ENV_NAME es el nombre del entorno en el que implementas el flujo compartido.
  • FLOW_NAME es el nombre del flujo compartido que implementarás.
  • REVISION_NUMBER es el número de revisión del flujo compartido que estás implementando.

Por ejemplo, con el siguiente comando, un miembro del equipo red implementa el flujo compartido flow-1, número de revisión 1, en la organización acme en el entorno prod: 

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"

En el siguiente ejemplo, se muestra la respuesta al comando: 

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

Anula la implementación de un flujo compartido asociado con un espacio

Anula la implementación de un flujo compartido asociado con un espacio mediante la consola de Apigee en Cloud o la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para anular la implementación de un flujo compartido asociado con un espacio en la consola de Apigee en Cloud, haz lo siguiente:

  1. Accede a la IU de Apigee en la consola de Cloud.
  2. Selecciona la organización que contiene tu flujo compartido. Consulta Cambia entre tus organizaciones.
  3. Selecciona Desarrollo de proxy > Flujos compartidos en la barra de navegación izquierda.
  4. En la página de descripción general Flujos compartidos, haz clic en el nombre del flujo compartido cuya implementación deseas anular. Se mostrará la página de detalles del flujo compartido.
  5. En Implementaciones, haz clic en Anular la implementación.

API de Apigee

Para anular la implementación de un flujo compartido asociado con un espacio con las APIs de Apigee, usa el siguiente comando: 

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"

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • ENV_NAME es el nombre del entorno en el que anulas la implementación del flujo compartido.
  • FLOW_NAME es el nombre del flujo compartido cuya implementación anulas.
  • REVISION_NUMBER es el número de revisión del flujo compartido cuya implementación anulas.

Administra un producto de API como recurso de espacio

Los miembros asignados a un espacio pueden crear un producto de API para agrupar sus proxies de API. Cuando se crean productos de API, los miembros del espacio pueden seleccionar cualquier proxy de API al que tengan acceso, incluidos los proxies creados directamente en la organización y los proxies de API creados como recursos en los espacios en los que tienen membresía. Los miembros de otros espacios no podrán acceder a estos productos de la API ni administrarlos.

Crea un producto de API como recurso de espacio con Apigee en la consola de Cloud o la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para crear un producto de API como recurso de espacio con Apigee en la consola de Cloud, haz lo siguiente:

  1. Sigue los pasos que se indican en Cómo crear un producto de API.
  2. En el Paso 4, verás un campo adicional en la página Detalles del producto en el que puedes seleccionar un Espacio para el producto de la API. Selecciona un espacio del cuadro de lista. Si no deseas asignar el producto de la API a un espacio, puedes omitir este campo.
  3. Completa la información de configuración restante y, luego, haz clic en Guardar.

API de Apigee

Para crear un producto de API como recurso de espacio, usa el siguiente comando: 

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

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • PRODUCT_NAME es el nombre del producto de API que estás creando. El nombre debe ser único a nivel global y no solo dentro del espacio.
  • DISPLAY_NAME es el nombre del producto de API que estás creando, como se muestra en la IU.
  • PRODUCT_DESCRIPTION es la descripción del producto de API que estás creando.
  • SPACE_NAME es el nombre del espacio en el que creas el producto de API.
  • PROXY_NAME es el nombre del proxy de API que agregas al producto de API.

Por ejemplo, con el siguiente comando, un miembro del equipo red crea un producto de API llamado product-1 asociado con el espacio red de la organización acme: 

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

En el siguiente ejemplo, se muestra la respuesta al comando: 

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

Enumera todos los recursos de API asociados con un espacio

Para todas las operaciones de enumeración, incluidas ListApiProxies, ListSharedFlows y ListApiProducts, puedes especificar un nombre de espacio a fin de enumerar todos los recursos asociados con ese espacio. Si no especificas un nombre de espacio, la operación de lista mostrará todos los recursos de la organización a los que tienes permiso para acceder, sin importar si están asociados con el espacio o no.

Para realizar esta tarea, debes tener el permiso apigee.apiResources.list. Este permiso se incluye en el rol Apigee > Apigee Organization Admin.

Enumera los recursos de API asociados con un espacio específico

Enumera todos los recursos de API asociados con un espacio específico en la consola de Apigee en Cloud o con la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para enumerar todos los recursos de API asociados con un espacio específico en la consola de Apigee en Cloud, abre la página general del tipo de recurso relevante (proxies de API, flujos compartidos o productos de API). En el cuadro Filtro, selecciona la opción Espacio de la lista y, luego, ingresa el nombre del espacio. Se muestra la lista de recursos asignados a ese espacio. Ten en cuenta que solo se muestran los recursos asociados con un espacio del que el usuario es miembro.

API de Apigee

Para enumerar todos los recursos de API asociados con un espacio especificado, usa el siguiente comando: 

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

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • RESOURCE_TYPE es el nombre del recurso que deseas incluir en la lista. Estos son algunos de los valores válidos:
    • apis
    • sharedFlows
    • apiProducts
  • SPACE_NAME es el nombre del espacio en el que enumeras el recurso.

Por ejemplo, con el siguiente comando, un miembro del equipo red enumera todos los proxies de API asociados con el espacio red de la organización acme: 

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

En el siguiente ejemplo, se muestra la respuesta al comando: 

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

Cómo enumerar recursos de API sin especificar un espacio

Enumera todos los recursos de API sin especificar un espacio en la consola de Apigee en Cloud o con la API, como se describe en las siguientes secciones.

Apigee en la consola de Cloud

Para ver una lista de todos los recursos de API de un tipo determinado en la consola de Apigee en Cloud, independientemente de la asociación con el espacio, abre la página de descripción general del tipo de recurso relevante (proxies de API, flujos compartidos o productos de API). Aparecerá una lista de todos los recursos disponibles. Ten en cuenta que solo se muestran los recursos que el usuario tiene permiso para ver. Esto incluye los recursos asociados con un espacio o espacios de los que el usuario es miembro, o bien recursos no asociados con un espacio.

API de Apigee

También puedes enumerar recursos de API sin especificar un espacio con el siguiente comando: 

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

Aquí:

  • ORG_NAME es el nombre de tu organización de Apigee.
  • RESOURCE_TYPE es el nombre del recurso que deseas incluir en la lista. Estos son algunos de los valores válidos:
    • apis
    • sharedFlows
    • apiProducts

Por ejemplo, un usuario con acceso Organization Admin a todos los recursos de la organización puede usar el siguiente comando para enumerar todos los proxies de API de la organización acme: 

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

Si la organización acme tiene tres proxies, el comando mostrará detalles de los tres proxies. Por ejemplo: 

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

Si otro usuario que solo tiene acceso apiAdmin a los recursos en el espacio red usa el mismo comando, este solo mostrará detalles sobre proxy-1. La respuesta se vería de la siguiente manera: 

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

¿Qué sigue?