En esta página se describe cómo usar Service Infrastructure para comprobar el estado de los servicios gestionados, los productores de servicios, los consumidores de servicios y las claves de API.
Cuando un productor de servicios ofrece un servicio a sus consumidores, debe asegurarse de que se cumplen varias condiciones previas, como las siguientes:
- Se ha eliminado un consumidor de servicios.
- El consumidor del servicio ha habilitado el servicio.
- Una clave de API es válida.
La API Service Control proporciona un método sencillo
services.check
para comprobar estas condiciones previas. Un servicio gestionado debe llamar a este método de forma periódica para asegurarse de que se cumplen las condiciones previas. La actividad entre el productor y el consumidor del servicio se representa mediante un Operation.
El método services.check realiza las siguientes comprobaciones en la operación:
- El proyecto del productor de servicios está activo y en buen estado.
- El proyecto del consumidor del servicio está activo y en buen estado.
- El servicio gestionado está habilitado en el proyecto del consumidor del servicio.
- La clave de API es válida.
- El uso de la clave de API cumple las restricciones asociadas a la clave de API, como las restricciones de IP o de URL referente HTTP.
El método services.check se suele invocar desde los servidores que implementan el servicio. Por motivos de seguridad y privacidad, la API Service Control usa Identity and Access Management para verificar que la persona que llama tiene el permiso adecuado para llamar al método. Para obtener más información, consulta Control de acceso a la API Service Control.
Comprobando estado
Después de implementar un servicio gestionado, puedes llamar al método services.check del servicio sin necesidad de realizar ninguna configuración adicional. Consulta más información en la referencia de services.check.
Para experimentar rápidamente con el método, puedes usar el comando gcurl para llamar al método services.check. Consulta los primeros pasos con la API Service Control para ver los pasos de configuración inicial.
gcurl -d '{
"operation": {
"operationId": "123e4567-e89b-12d3-a456-426655440000",
"consumerId": "project:endpointsapis-consumer",
"startTime":"2016-07-31T05:20:00Z",
"operationName":"google.example.hello.v1.HelloService.GetHello"
}
}' https://servicecontrol.googleapis.com/v1/services/endpointsapis.appspot.com:check
{
"operationId": "123e4567-e89b-12d3-a456-426655440000"
}
La respuesta del método de comprobación indica si todas las comprobaciones se han realizado correctamente o si se han producido errores en algunas. El éxito se indica con la ausencia del campo checkErrors. De lo contrario, el campo checkErrors muestra las comprobaciones que no se han superado.