Mostrar una lista de servicios
En este documento, se describe cómo enumerar las APIs y los servicios que están habilitados o disponibles en un proyecto de Google Cloud. La lista de API y servicios disponibles o habilitados puede incluir tanto los servicios públicos de Google Cloud como Pub/Sub, así como cualquier API y servicio que se te haya compartido de forma privada, como los servicios creados con Cloud Endpoints. Para obtener más información acerca de las diferencias entre las API y los servicios públicos y privados, consulta Servicios públicos y privados.
- Para obtener o supervisar los servicios habilitados de una organización, consulta Crea una lista de los servicios habilitados en una organización.
- Para enumerar los servicios en un proyecto, te recomendamos usar el la consola de Google Cloud o Google Cloud CLI. En este documento, se describe cómo usar ambas interfaces.
- Para programar en la API de Service Usage, usa uno de los bibliotecas cliente.
- Para experimentar con la API, te recomendamos que uses el comando
curl
. No necesitas configurar un entorno de aplicaciones completo; Sin embargo, hay se requiere cierta configuración.
Antes de comenzar
Para mostrar la lista de las API y los servicios habilitados y disponibles, necesitas los elementos siguientes:
- Un proyecto de Google Cloud, Para aprender a crear un proyecto de Google Cloud, 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, sigue estos pasos:
- Si quieres usar los ejemplos de
curl
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 degcurl
, que es un alias autenticado para el comando estándarcurl
, y la de la variable de entornoPROJECT_NUMBER
.
Enumerar los servicios habilitados en una organización
Para ver 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 RPC llamada. Cloud Asset Inventory también se puede usar para supervisar los cambios de estado. Si quieres exportar todos los servicios habilitados para una organización en particular, sigue los documentos de Cloud Asset Inventory para Enumerar recursos.
Para ver una lista de las APIs habilitadas para una organización, ejecuta el siguiente comando luego de configura los IDs del proyecto de facturación y de la organizació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'
Ejecutar el comando anterior permite que un usuario con 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, aplícalos 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'
Enumerar los servicios habilitados de un proyecto
La publicación de servicios habilitados usa la 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 API y los servicios habilitados en un proyecto, sigue estos pasos:
- Ir a la consola de Google Cloud
Panel de API
.
Ir a la página Panel de API Realiza una de las siguientes acciones para seleccionar tu proyecto de Google Cloud:
Haz clic en un proyecto de Google Cloud en Selecciona un proyecto reciente.
Para usar el navegador de proyectos de Google Cloud, sigue estos pasos: pasos:
- Haz clic en Seleccionar proyecto para abrir el navegador del proyecto de Google Cloud.
- Busca tu proyecto y haz clic en el nombre del proyecto de Google Cloud.
- Haz clic en Abrir para abrir el proyecto.
Aparecerá la página API y servicios. Puedes encontrar la lista de APIs habilitadas en tu proyecto de Google Cloud en la tabla de esta página.
gcloud
Para ver una lista de las APIs y los servicios habilitados en tu proyecto actual, ejecuta el siguiente comando: 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 método services.list
con el filtro state:ENABLED
.
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"
Obtén una lista de los servicios disponibles de un proyecto
La enumeración de todos los servicios disponibles usa la cuota de la cuota de serviceusage.googleapis.com/list_available_requests
. Predeterminado
la cuota disponible es de 1 QPS. El conjunto de servicios disponibles rara vez cambia y
se pueden almacenar en caché
durante períodos prolongados.
Console
Para mostrar las API y los servicios que tienes a tu disposición en un proyecto, sigue estos pasos:
- Ir a la consola de Google Cloud
Biblioteca de APIs
.
Ir a la página Biblioteca de API Realiza una de las siguientes acciones para seleccionar tu proyecto de Google Cloud:
Haz clic en un proyecto de Google Cloud en Selecciona un proyecto reciente.
Para usar el navegador de proyectos de Google Cloud, sigue estos pasos: pasos:
- Haz clic en Seleccionar proyecto para abrir el navegador del proyecto de Google Cloud.
- Busca tu proyecto y haz clic en el nombre del proyecto de Google Cloud.
- Haz clic en Abrir para abrir el proyecto.
Aparecerá la pantalla Biblioteca de API. Puedes buscar o desplazarte por las API disponibles desde esta pantalla.
gcloud
Para mostrar la lista de las APIs y los servicios que tienes a tu disposición en tu proyecto actual, ejecuta el siguiente comando:
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 método services.list
.
Para ver una lista de las APIs y los servicios disponibles en tu proyecto, ejecuta el siguiente comando:
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 actualmente en la
proyecto pasando filter=state:DISABLED
a la llamada anterior.
Próximos pasos
Para obtener información sobre cómo habilitar o inhabilitar servicios en tu proyecto de Google Cloud, consulta Inhabilitación y habilitación de servicios.