상태 확인

이 페이지에서는 Service Infrastructure를 사용하여 관리형 서비스, 서비스 제작자, 서비스 소비자, API 키의 상태를 확인하는 방법을 설명합니다.

서비스 제작자가 서비스 소비자에게 서비스를 제공할 때는 다음과 같은 다양한 전제조건이 충족되었는지 확인해야 합니다.

  • 서비스 소비자가 삭제되었는지 여부
  • 서비스 소비자가 서비스를 사용 설정했는지 여부
  • API 키가 유효한지 여부

Service Control API는 이러한 전제조건을 확인하는 간단한 services.check 메서드를 제공합니다. 관리형 서비스는 전제조건이 충족되었는지 확인하기 위해 이 메서드를 정기적으로 호출해야 합니다. 서비스 제작자와 서비스 소비자 간의 활동은 Operation으로 표현됩니다. services.check 메서드는 작업에 대해 다음 검사를 수행합니다.

  • 서비스 제작자가 라이브이고 정상 상태인지 여부
  • 서비스 소비자 프로젝트가 라이브이고 정상 상태인지 여부
  • 관리형 서비스가 서비스 소비자 프로젝트에서 사용 설정되었는지 여부
  • API 키가 유효한지 여부
  • API 키 사용이 API 키와 연관된 제한사항(IP 또는 HTTP 리퍼러 제한사항 등)을 충족하는지 여부

services.check 메서드는 일반적으로 서비스를 실제로 구현하는 서버에서 호출됩니다. 보안 및 개인정보 보호를 위해 Service Control API는 Identity and Access Management를 사용하여 호출자가 메서드를 호출할 수 있는 적절한 권한이 있는지 확인합니다. 자세한 내용은 Service Control API 액세스 제어를 참조하세요.

상태 확인

관리형 서비스를 출시한 후에는 추가 구성 없이 서비스에서 services.check 메서드를 호출할 수 있습니다. 자세한 내용은 services.check 참조를 확인하세요.

메서드를 빠르게 실험해보려면 gcurl 명령어를 사용하여 services.check 메서드를 호출할하면 됩니다. 초기 설정 단계는 Service Control API 시작하기를 참조하세요.

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

check 메서드의 응답은 모든 확인이 성공적으로 진행되었는지 아니면 일부 확인이 실패했는지를 나타냅니다. checkErrors 필드가 없으면 성공한 것입니다. 실패한 확인이 있는 경우에는 checkErrors 필드에 나열됩니다.