Enumera servicios

En este documento, se describe cómo enumerar las APIs y los servicios que están habilitados o disponibles en un Google Cloud proyecto. La lista de APIs y servicios disponibles o habilitados puede incluir tanto los servicios públicos como Pub/Sub, así como cualquier API y servicio que se te haya compartido de forma privada, como los servicios creados con Cloud Endpoints.Google Cloud Para obtener más información acerca de las diferencias entre las APIs y los servicios públicos y privados, consulta Servicios públicos y privados.

  • Para obtener o supervisar los servicios habilitados para una organización, consulta Enumera los servicios habilitados en una organización.
  • Para enumerar los servicios en un proyecto, te recomendamos que uses la Google Cloud consola o Google Cloud CLI. En este documento, se describe cómo usar ambas interfaces.
  • Para programar soluciones basadas en la API de Service Usage, usa una de nuestras bibliotecas cliente .
  • Para experimentar con la API, te recomendamos que uses el comando curl. No es necesario que configures un entorno de aplicación completo. Sin embargo, hay algunos requisitos de configuración.

Antes de comenzar

Para mostrar la lista de las APIs y los servicios habilitados y disponibles, necesitas los elementos siguientes:

  • Un Google Cloud proyecto. Para obtener información sobre cómo crear un Google Cloud proyecto, consulta Crea y administra proyectos.
  • Los permisos de la administración de identidades y accesos correctos. Si quieres obtener información sobre los requisitos de IAM para Service Usage, consulta Control de acceso.
  • Para instalar Google Cloud CLI.
  • Si quieres usar los curl ejemplos que aparecen en esta guía, asegúrate de seguir las instrucciones para completar la configuración inicial que se indican en Cómo comenzar. En estos pasos, se incluye la definición de gcurl, que es un alias autenticado para el comando curl estándar, y la de la variable de entorno PROJECT_NUMBER.

Enumera los servicios habilitados en una organización

Para enumerar qué servicios están habilitados en una organización, usa Cloud Asset Inventory, que permite exportar el estado de todos los proyectos bajo el control de una organización en una sola llamada RPC. Cloud Asset Inventory también se puede usar para supervisar los cambios de estado. Para exportar todos los servicios habilitados para una organización en particular, sigue los documentos de Cloud Asset Inventory para enumerar recursos.

Para enumerar las APIs habilitadas para una organización, ejecuta el siguiente comando después de configurar los IDs de la organización y del proyecto de facturación:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--organization='ORGANIZATION_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

La ejecución del comando anterior permite que un usuario con los privilegios suficientes enumere el conjunto de servicios habilitados para todos los proyectos de una organización.

Para experimentar con los comandos de Cloud Asset Inventory, aplica estos comandos a un proyecto específico. Por ejemplo, el siguiente comando enumera todos los servicios habilitados para un proyecto en particular:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--project='PROJECT_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

Enumera los servicios habilitados en un proyecto

La enumeración de los servicios habilitados usa cuota de la métrica de cuota serviceusage.googleapis.com/list_enabled_requests. La cuota disponible predeterminada es de 10 consultas por segundo (QPS).

Console

Para mostrar las APIs y los servicios habilitados en un proyecto, sigue estos pasos:

  1. Ve a la página Panel de APIs de la consola de Cloud. Ir a la página Panel de APIs Google Cloud

  2. Selecciona tu Google Cloud proyecto con uno de los siguientes métodos:

    • Haz clic en un Google Cloud proyecto en Seleccionar un proyecto reciente.

    • Para usar el Google Cloud navegador de proyectos, sigue estos pasos:

      1. Haz clic en Seleccionar proyecto para abrir el Google Cloud navegador de proyectos.
      2. Busca tu proyecto y, luego, haz clic en el Google Cloud nombre del proyecto.
      3. Haz clic en Abrir para abrir el proyecto.

    Aparecerá la página APIs y servicios. Puedes encontrar la lista de APIs habilitadas en tu Google Cloud proyecto en la tabla de esta página.

gcloud

Para mostrar la lista de las APIs y los servicios habilitados en tu proyecto actual, ejecuta el siguiente comando:

gcloud services list

El comando muestra un resultado similar al siguiente:

NAME                                              TITLE
pubsub.googleapis.com             Google Cloud Pub/Sub API
bigquery.googleapis.com           BigQuery API
cloudtrace.googleapis.com         Stackdriver Trace API
servicemanagement.googleapis.com  Google Service Management API
monitoring.googleapis.com         Stackdriver Monitoring API
storage-api.googleapis.com        Google Cloud Storage JSON API
logging.googleapis.com            Stackdriver Logging API
clouddebugger.googleapis.com      Stackdriver Debugger API
...

curl

Para enumerar los servicios habilitados, llama al services.list método con el state:ENABLED filtro.

Para mostrar la lista de las APIs y los servicios habilitados en tu proyecto, ejecuta el siguiente comando:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"

Enumera los servicios disponibles en un proyecto

La enumeración de todos los servicios disponibles usa cuota de la cuota serviceusage.googleapis.com/list_available_requests. La cuota disponible predeterminada es de 1 QPS. El conjunto de servicios disponibles rara vez cambia y se puede almacenar en caché durante períodos prolongados.

Console

Para mostrar las APIs y los servicios que tienes a tu disposición en un proyecto, sigue estos pasos:

  1. Ve a la página Google Cloud Biblioteca de APIs de la consola.
    Ir a la página Biblioteca de APIs

  2. Selecciona tu Google Cloud proyecto con uno de los siguientes métodos:

    • Haz clic en un Google Cloud proyecto en Seleccionar un proyecto reciente.

    • Para usar el Google Cloud navegador de proyectos, sigue estos pasos:

      1. Haz clic en Seleccionar proyecto para abrir el Google Cloud navegador de proyectos.
      2. Busca tu proyecto y, luego, haz clic en el Google Cloud nombre del proyecto.
      3. Haz clic en Abrir para abrir el proyecto.

    Aparecerá la pantalla Biblioteca de APIs. Puedes buscar o desplazarte por las API disponibles desde esta pantalla.

gcloud

Ejecuta el siguiente comando para mostrar la lista de las APIs y los servicios que tienes a tu disposición en tu proyecto actual:

gcloud services list --available

Los resultados incluyen todos los servicios que ya se hayan habilitado, como también los servicios que están disponibles para la habilitación en el proyecto actual. El comando muestra un resultado similar al siguiente:

NAME                                              TITLE
places-backend.googleapis.com                  Google Places API Web Service
clouderrorreporting.googleapis.com             Stackdriver Error Reporting API
analyticsreporting.googleapis.com              Google Analytics Reporting API
youtube.googleapis.com                         YouTube Data API v3
adsense.googleapis.com                         AdSense Management API
sqladmin.googleapis.com                        Google Cloud SQL API
genomics.googleapis.com                        Genomics API
adexchangebuyer.googleapis.com                 Ad Exchange Buyer API II
...

curl

Para enumerar los servicios disponibles, llama al services.list método.

Ejecuta el siguiente comando para mostrar la lista de las APIs y los servicios disponibles en tu proyecto:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"

El resultado incluye todos los servicios públicos, todos los servicios para los cuales el usuario emisor tiene el permiso servicemanagement.services.bind y todos los servicios que ya se han habilitado en el proyecto.

Es posible excluir los servicios que están activos en el proyecto si se pasa filter=state:DISABLED a la llamada anterior.

Próximos pasos

Para obtener información sobre cómo habilitar o inhabilitar servicios en tu Google Cloud proyecto, consulta Habilita e inhabilita servicios.