应用示例

场景描述

您可以根据业务需要，通过API方式创建相应计算能力和存储空间的Redis实例。

下面介绍如何调用创建缓存实例API创建分布式缓存实例，API调用方法请参考如何调用API。

前提条件

• 获取IAM的Endpoint，具体请参见地区和终端节点。
• 获取DCS的Endpoint，具体请参见地区和终端节点。
• 获取项目ID，具体请参见获取项目ID。

创建Redis实例

如下示例是创建分布式缓存实例最简单的配置。

{
	"name": "dcs-demo",
	"engine": "Redis",
	"engine_version": "4.0",
	"capacity": 2,
	"no_password_access": true,
	"vpc_id": "c71d9731-9b0c-43e9-ab2a-716af9d9fd55",
	"subnet_id": "1aa8068b-6846-4dae-bc27-bb923ab9b39c",
	"product_id": "00301-31101-0--0",
	"available_zones":["d573142f24894ef3bd3664de068b44b0"],
	}

这个示例中创建了一个容量为2G、缓存版本为Redis 4.0的缓存实例，可免密访问该实例。

• name：缓存实例的名称，由您自行定义。
• engine：缓存引擎Redis。
• engine_version：缓存版本，例如取值为4.0、5.0或6.0。
• capacity：缓存容量（G Byte），分布式缓存实例的容量，可在查询产品规格列表中查询获取。
• no_password_access：表示是否允许免密码访问缓存实例。false：表示该实例必须通过密码认证才能访问，true：表示该实例不需要密码即可访问。
• vpc_id：缓存服务所在的VPC（虚拟私有云）的ID。您可以在虚拟私有云控制台中查询，也可以通过虚拟私有云服务的查询VPC列表API查询。
• subnet_id：VPC内子网的网络ID。您可以在虚拟私有云控制台中查询，也可以通过查询子网列表API查询。
• product_id：需要订购的缓存实例的产品标识。具体查询方法，请参考查询产品规格列表。
• available_zones：创建缓存节点到指定且有资源的可用区ID。具体查询方法，请参考查询可用区信息。

创建配置备份策略的Redis实例

您可以创建设置了备份策略的主备和集群实例，需要在请求消息体中增加instance_backup_policy参数，包括备份策略和备份计划。示例如下：

{
	"name": "dcs-demo003",
	"engine": "Redis",
	"engine_version": "4.0",
	"capacity": 2,
	"no_password_access": true,
	"vpc_id": "c71d9731-9b0c-43e9-ab2a-716af9d9fd55",
	"subnet_id": "1aa8068b-6846-4dae-bc27-bb923ab9b39c",
	"product_id": "00301-31101-0--0",
	"available_zones": ["d573142f24894ef3bd3664de068b44b0"],
	"instance_backup_policy": {
	"save_days": 1,
	"backup_type": "auto",
	"periodical_backup_plan": {
		"begin_at": "16:00-17:00",
		"period_type": "weekly",
		"backup_at": ["1",
		"2",
		"3",
		"4",
		"5",
		"6",
		"7"],
		"timezone_offset": "+0800"
	}
}
}

• save_days：备份数据保留天数。
• backup_type：备份类型，取值类型为：auto，表示自动备份；manual，表示手动备份。
• periodical_backup_plan：备份计划。备份参数描述，请参考创建缓存实例中参数描述。