Method: projects.locations.endpoints.queryAccount

지원 중단됨: 대신 endpoints.queryData 메서드를 사용하세요. 네트워크의 계정에 저장된 모든 정보를 쿼리합니다. 엔드포인트가 네트워크 및 리전 내의 다른 검사자에게 요청을 라우팅할 수 있고 검사자가 특정 시점에 동일한 라운드 ID에 있지 않을 수 있으므로 반환되는 계정 세부정보는 호출마다 다를 수 있습니다.

HTTP 요청


GET https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:queryAccount

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
endpoint

string

필수 항목입니다. 요청을 처리할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

쿼리 파라미터

파라미터
accountId

string

필수 항목입니다. 정보를 가져올 계정 ID입니다. 값은 60자(영문 기준)로 제한됩니다.

roundId

string (int64 format)

선택사항입니다. 데이터를 요청할 실행 라운드의 ID입니다(블록 '높이'와 유사). 반환된 계정 정보는 이 실행 라운드의 월드 상태에 대해 정확합니다. 지정하지 않으면 서빙 검사자가 알고 있는 가장 최근에 완료된 라운드를 사용합니다. 특정 라운드 ID의 상태는 항상 일관되고 표준적입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

endpoints.queryAccount의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "account": {
    object (Account)
  }
}
필드
account

object (Account)

계정 정보 및 계정 정보를 가져온 높이입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

endpoint 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • universalledger.endpoints.readNetwork

자세한 내용은 IAM 문서를 참조하세요.