CreateDataCache_弹性容器实例_API文档-阿里云OpenAPI开发者门户

接口说明

创建镜像缓存涉及资源计费。建议您提前了解相关计费信息。更多信息，请参见数据缓存计费。
创建镜像缓存前，您需要评估待缓存数据的大小，如果数据大小超过设置的缓存大小，将会创建失败。
创建数据缓存时，系统将自动创建一个 ECI 实例和一块 ESSD 云盘用于中转创建数据缓存。创建过程中请勿删除 ECI 实例和云盘，否则数据缓存将创建失败。
创建数据缓存将生成对应的快照。请勿删除快照，否则数据缓存将会失效。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

eci:CreateDataCache	Create	DataCache acs:eci:{#regionId}:{#accountId}:datacache/*	eci:tag	无

请求参数

字段名称	字段详情
RegionIdstring	地域 ID。示例值:cn-hangzhou参考取值来源: DescribeRegions
SecurityGroupIdstring	创建数据缓存过程中生成的 ECI 实例所属的安全组 ID。示例值:sg-2ze81zoc3yl7a3we****参考取值来源: DescribeContainerGroups
VSwitchIdstring	创建数据缓存过程中生成的 ECI 实例所属的交换机 ID。示例值:vsw-bp1jrgfqqy54kg5hc****
Bucketstring	数据的存储空间。默认为 default。支持自定义，以便进行业务分组和避免路径冲突。展开详情示例值:default
Pathstring	数据存储的路径。示例值:/model/test
Namestring	数据缓存名称。示例值:test
Sizeinteger<int32>	数据缓存大小。单位为 GiB，默认为 20 GiB。请根据实际数据量评估所需大小。示例值:30
DataSourceobject	数据源。
RetentionDaysinteger<int32>	保留天数。过期会被清理。默认不过期。示例值:7
Tagarray<object>	数据缓存绑定的标签列表。子级条数 <= 21
ResourceGroupIdstring	资源组 ID。示例值:rg-2df3isufhi38****参考取值来源: DescribeContainerGroups
ClientTokenstring	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。只支持 ASCII 字符，且不能超过 64 个字符。更多信息，请参见如何保证幂等性。示例值:123e4567-**-12d3-**-426655440000
EipInstanceIdstring	绑定已有的弹性公网 IP（EIP）。展开详情示例值:eip-uf66jeqopgqa9hdn****
EipCreateParamobject	创建一个弹性公网 IP（EIP）并绑定。展开详情

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:D81A4A13-6DCC-4579-AC62-90A6C3EC7BBC
DataCacheIdstring	数据缓存 ID。示例值:edc-bp15l4vvys94oo******

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	Account.Arrearage	Your account has an outstanding payment.	诊断
400	DryRunOperation	Request validation has been passed with DryRun flag set.	诊断
400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed	诊断
400	IncorrectStatus	%s	诊断
400	ServiceNotEnabled	%s	诊断
400	DiskVolume.NotSupport	The disk volume is not supported.	诊断
400	RamRole.NotSupport	The RAM role is not supported.	诊断
400	ImageCache.IncorrectStatus	%s	诊断
400	ImageCacheNotSupport	Image cache is not available for all users. If you want to enable this function, contact us.	诊断
400	EipAddressPoolIpNotEnough	The ip address of specified PublicIpAddressPool is not enough.	诊断
400	DryRun.Success	This request is a dryrun request with successful result.	诊断
403	OperationDenied.VswZoneMisMatch	The specified VSwitchId is not in the specified Zone.	诊断
403	QuotaExceeded	%s quota exceeded.	诊断
403	Zone.NotOnSale	The specified zone is not available for purchase.	诊断
403	Forbidden.RiskControl	This operation has been identified as an abnormal operation and cannot be processed.	诊断
403	Forbidden.SubUser	The specified action is not available for you.	诊断
403	Forbidden.OnlyForInvitedTest	Eci create action is only open to invited users during public beta.	诊断
403	OperationDenied.SecurityGroupMisMatch	The specified VSwitchId and SecurityGroupId are not in the same VPC.	诊断
403	InvalidVSwitchId.IpNotEnough	The specified VSwitch does not have enough IP addresses.	诊断
403	Forbidden.UserBussinessStatus	This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again.	诊断
403	Forbidden.UserNotRealNameAuthentication	This operation is not allowed, because you have not passed the real-name verification.	诊断
403	InvalidUser.PassRoleForbidden	The RAM user is not authorized to assume a RAM role.	诊断
403	OperationDenied.NoStock	Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see https://help.aliyun.com/document_detail/157290.html	诊断
403	NoPermission	The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again.	诊断
403	SecurityRisk.3DVerification	We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.	诊断
403	CreateServiceLinkedRole.Denied	Please make sure the account has ram:CreateServiceLinkedRole permission.	诊断

变更历史

	变更时间	变更内容概要	操作
	2023-07-24	新增请求参数Path

CreateDataCache_弹性容器实例_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例