ApsaraDB for Redis allows you to send URL-based requests by using the HTTP or HTTPS GET method. You need to add parameters to a request based on the operation description. Then, ApsaraDB for Redis returns the result.

Sample request

The following sample request calls CreateInstance.

https://r-kvstore.aliyuncs.com/
? Action=CreateInstance
&RegionId=cn-hongkong
&InstanceClass=redis.master.2xlarge.default
&InstanceName=apitest
&<Common request parameters>
  • https specifies the communications protocol.
  • r-kvstore.aliyuncs.com specifies the endpoint of the ApsaraDB for Redis API.
  • Action=CreateInstance specifies the operation you want to perform.
  • RegionId, InstanceClass and InstanceName are the parameters that you need to specify to call the CreateInstance operation.
  • <Common request parameters> contains parameters required by all requests. For more information, see Common parameters.

Endpoints

The following table lists the endpoints of the ApsaraDB for Redis API.

Region Endpoint
Default r-kvstore.aliyuncs.com
China (Zhangjiakou) r-kvstore.cn-zhangjiakou.aliyuncs.com
China (Hohhot) r-kvstore.cn-huhehaote.aliyuncs.com
China (Chengdu) r-kvstore.cn-chengdu.aliyuncs.com
Japan (Tokyo) r-kvstore.ap-northeast-1.aliyuncs.com
Australia (Sydney) r-kvstore.ap-southeast-2.aliyuncs.com
Malaysia (Kuala Lumpur) r-kvstore.ap-southeast-3.aliyuncs.com
Indonesia (Jakarta) r-kvstore.ap-southeast-5.aliyuncs.com
India (Mumbai) r-kvstore.ap-south-1.aliyuncs.com
UAE (Dubai) r-kvstore.me-east-1.aliyuncs.com
Germany (Frankfurt) r-kvstore.eu-central-1.aliyuncs.com
UK (London) r-kvstore.eu-west-1.aliyuncs.com

Protocols

You can send requests through HTTP or HTTPS. We recommend that you use HTTPS for enhanced security.

Method

The HTTP GET method can be used to send requests. Request parameters must be included in the request URL.

Request parameters

For each request, you must specify the Action parameter (such as CreateInstance), common request parameters, and parameters specific to the operation.

Encoding

Requests and responses are encoded based on the UTF-8 character set.