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>httpsspecifies the communications protocol.r-kvstore.aliyuncs.comspecifies the endpoint of the ApsaraDB for Redis API.Action=CreateInstancespecifies the operation you want to perform.RegionId,InstanceClassandInstanceNameare 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.