En esta página se describe cómo utilizar Service Infrastructure para verificar el estado de los servicios administrados, los productores de servicios, los consumidores de servicios, y las claves de API.
Cuando un productor de servicios ofrece un servicio a sus consumidores de servicios, debe asegurarse de que se cumplan varias condiciones previas, como las que se mencionan a continuación:
- Se borró un consumidor de servicios.
- El consumidor de servicios habilitó el servicio.
- Una clave de API es válida.
La API de Service Control proporciona un método services.check simple para verificar tales condiciones previas. Un servicio administrado debe llamar a este método periódicamente para garantizar que se cumplan las condiciones previas. La actividad entre el productor de servicios y el consumidor de servicios se representa mediante una Operation.
El método services.check realiza las siguientes verificaciones en la operación:
- El proyecto del productor de servicios está activo y se encuentra en buen estado.
- El proyecto del consumidor de servicios está activo y se encuentra en buen estado.
- El servicio administrado está habilitado en el proyecto del consumidor de servicios.
- La clave de API es válida.
- El uso de la clave de API satisface las restricciones asociadas con la clave de API como, por ejemplo, restricciones de referente HTTP o IP.
Por lo general, el método services.check se llama desde los servidores que implementan realmente el servicio. Por razones de seguridad y privacidad, la API de Service Control usa la administración de identidades y accesos para verificar que el emisor tenga el permiso adecuado a fin de llamar al método. Para obtener más información, consulta Control de acceso de la API de Service Control.
Comprueba el estado
Después de lanzar un servicio administrado, puedes llamar al método services.check en el servicio sin configuración adicional. Consulta la referencia de services.check para obtener detalles.
Para experimentar rápidamente con el método, puede usar el comando de gcurl para llamar al método services.check. Consulta Comienza a usar la API de Service Control para conocer los pasos de configuración iniciales.
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 verificación indica si todas las verificaciones se realizaron de manera correcta o si algunas tuvieron errores. Si se realiza de forma correcta, esto se indica por la ausencia del campo checkErrors. De lo contrario, en el campo checkErrors se muestran las verificaciones con errores.