You need to enable JavaScript to run this app.
导航

请求结构

最近更新时间2023.03.15 15:51:31

首次发布时间2021.11.15 16:07:16

本文介绍缓存数据库 Redis 版的 API 请求结构信息。

服务地址

缓存数据库 Redis 版已开通服务的地域如下表。

开通地域RegionId服务接入地址
华北 2(北京)cn-beijingredis.volcengineapi.com
华南 1(广州)cn-guangzhouredis.volcengineapi.com
华东 2(上海)cn-shanghairedis.volcengineapi.com

通信协议

支持通过 HTTP 或 HTTPS 两种方式进行请求通信,推荐使用安全性更高的 HTTPS 方式来发送请求。

请求方法

支持 HTTP POST 请求方法,其中 POST 请求支持的 Content-Type 类型为 application/JSON(推荐)。

说明

请求必须使用火山签名机制

请求 URL

您可以通过发送 HTTPS POST 请求来调用 Redis 的 API 服务。HTTPS 请求 URL 的格式如下:

POST {URI-scheme}://{Endpoint}/?Action={Action}&Version={Version} HTTP/1.1

其中:

  • URI-scheme:表示用于传输请求的协议,当前所有 API 均采用 HTTPS 协议。
  • Endpoint:指定承载服务端点的服务器域名或 IP,即服务地址。缓存数据库 Redis 版的服务地址为 redis.volcengineapi.com。更多详情,请参见服务地址
  • Action:要执行的操作,此处请填写要调用的 API 接口名称。缓存数据库 Redis 版支持的 API 接口详情,请参见 API 概览
  • Version:API 版本号,格式为 YYYY-MM-DD 格式。缓存数据库 Redis 版的 API 版本号是 2020-12-07

以创建 Redis 实例为例,未编码的 HTTPS 请求 URL 如下。

https://redis.volcengineapi.com/?Action=CreateDBInstance&Version=2020-12-07

请求参数

每个 API 请求都包含如下两类参数:

  • 公共请求参数:每个 API 接口都需要使用的参数为公共请求参数。关于公共参数的更多详情,请参见公共参数
  • 接口请求参数:每个 API 接口特有的参数为接口请求。关于各个接口的请求参数,请参见 API 概览中各接口的详细描述。

字符编码

均使用 UTF-8 编码。