All Products
Search
Document Center

Key Management Service:Make API requests

Last Updated:Mar 31, 2026

Dedicated KMS uses HTTP over Transport Layer Security (TLS) for all API communication. Send requests as HTTP POST to the Dedicated KMS endpoint. Both request and response use Protocol Buffers encoding.

Protocol Buffers

Protocol Buffers is a language-neutral, platform-neutral format for serializing structured data. It produces smaller payloads and parses faster than XML. For details, see Protocol Buffers.

Request flow

Each API call goes through four stages:

  1. The client encodes the request message into Protocol Buffers format based on the request message definition.

  2. The client sends the encoded request data and signature to the Dedicated KMS endpoint.

  3. Dedicated KMS verifies the signature and responds to the request.

  4. The client decodes the Protocol Buffers response data based on the response message definition to get the response message.