method

GetSession

acme.user.v2.SessionService.GetSession

Read a session by its identifier, without side effects.

HTTP example

For a deployment at https://api.example.com:

curl --request GET \
  'https://api.example.com/v2/sessions/session-example-001'

The HTTP annotation binds {id} to the request field. The method is marked NO_SIDE_EFFECTS; authentication and error responses are not specified here.

RPC on SessionService

rpc GetSession(acme.user.v2.GetSessionRequest) returns (acme.user.v2.GetSessionResponse);

NO_SIDE_EFFECTS

Options

idempotency_level
idempotency_level = NO_SIDE_EFFECTS
HTTP — GET /v2/sessions/{id}
GET
(google.api.http) = { get: "/v2/sessions/{id}" }

Request

acme.user.v2.GetSessionRequest

FieldNumberTypeCardinalityValidationDescription
id1stringimplicit——
Details
  • JSON name: id
  • Presence: IMPLICIT
  • Annotations: REQUIRED
(google.api.field_behavior) = [
  REQUIRED
]

Response

acme.user.v2.GetSessionResponse

FieldNumberTypeCardinalityValidationDescription
session1acme.user.v2.Sessionoptional——
Details
  • JSON name: session
  • Presence: EXPLICIT