文档

CopyDataCache - 拷贝数据缓存

更新时间:

将数据缓存从一个地域拷贝到另一个地域。

接口说明

数据缓存不支持直接跨地域使用,通过本接口可以将数据缓存从一个地域拷贝到另一个地域。该接口适用于以下场景:

  • 需要在多个地域使用数据缓存,在 A 地域已有数据缓存的情况,可以通过本接口快速拷贝到 B 地域。
  • 对于中国内地地域的用户,创建数据缓存时如果直接拉取国外地址的数据,可能会因为网络限制导致数据拉取过慢,此时可以先在非中国内地的地域(例如中国香港)创建数据缓存,然后通过本接口拷贝到中国内地地域。

注意 拷贝数据缓存的过程相当于复制快照,费用涉及复制过程产生的流量费用以及最终生成的数据缓存的存储费用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
eci:CopyDataCachecreate
  • DataCache
    acs:eci:{#regionId}:{#accountId}:datacache/{#datacacheId}
  • eci:tag

请求参数

名称类型必填描述示例值
RegionIdstring

已有数据缓存所在地域。

cn-beijing
Bucketstring

数据缓存 Bucket。

default
Pathstring

数据缓存路径

/bucket-test
Namestring

数据缓存名称。

test
RetentionDaysinteger

数据缓存保留天数。

7
Tagarray<object>

数据缓存标签列表。

object

数据缓存标签列表。

Keystring

标签键。

testkey
Valuestring

标签值。

testvalue
ResourceGroupIdstring

数据缓存所属资源组 。

rg-2df3isufhi38****
ClientTokenstring

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持 ASCII 字符,且不能超过 64 个字符。更多信息,请参见如何保证幂等性

123e4567-e89b-12d3-a456-426655440000
DataCacheIdstring

数据缓存 ID。

edc-bp15l4vvys94oo******
DestinationRegionIdstring

要拷贝到的目的地域。

cn-hangzhou

返回参数

名称类型描述示例值
object

返回参数列表。

RequestIdstring

请求 ID。

58EE0CB3-C864-5395-A4F7-24F425074839
DataCacheIdstring

拷贝到新的地域后,生成的数据缓存 ID。

edc-bp1423y6d7v7l6ua****

示例

正常返回示例

JSON格式

{
  "RequestId": "58EE0CB3-C864-5395-A4F7-24F425074839",
  "DataCacheId": "edc-bp1423y6d7v7l6ua****"
}

错误码

HTTP status code错误码错误信息描述
400Account.ArrearageYour account has an outstanding payment.账号已经欠费。
400DryRunOperationRequest validation has been passed with DryRun flag set.此次DryRun预检请求合格。
400InvalidParameter.CPU.MemoryThe specified cpu and memory are not allowed-
400IncorrectStatus%s指定的实例状态不正确。
400ServiceNotEnabled%s该次请求所依赖的服务没有开通,请开通后再试。
400DiskVolume.NotSupportThe disk volume is not supported.云盘卷暂不支持,如有需要请联系我们。
400RamRole.NotSupportThe RAM role is not supported.ram实例角色不支持。
400ImageCache.IncorrectStatus%s镜像缓存当前的状态不对。
400ImageCacheNotSupportImage cache is not available for all users. If you want to enable this function, contact us.镜像缓存功能还未全网开放,如果有需要请联系我们。
400EipAddressPoolIpNotEnoughThe ip address of specified PublicIpAddressPool is not enough.指定的eip公网地址池地址资源不足。
403OperationDenied.VswZoneMisMatchThe specified VSwitchId is not in the specified Zone.-
403QuotaExceeded%s quota exceeded.用户允许创建的实例已经超过限制。
403Zone.NotOnSaleThe specified zone is not available for purchase.创建实例的可用区已经关闭售卖,请更换其他可用区。或者无法在该可用区使用指定 VPC 的虚拟交换机。
403Forbidden.RiskControlThis operation has been identified as an abnormal operation and cannot be processed.此操作已被确定为一个操作异常,无法处理。
403Forbidden.SubUserThe specified action is not available for you.当前用户无法执行该操作。
403Forbidden.OnlyForInvitedTestEci create action is only open to invited users during public beta.Eci公测阶段只对受邀的用户开放。
403OperationDenied.SecurityGroupMisMatchThe specified VSwitchId and SecurityGroupId are not in the same VPC.指定的交换机和安全组不在同一个VPC下。
403InvalidVSwitchId.IpNotEnoughThe specified VSwitch does not have enough IP addresses.-
403Forbidden.UserBussinessStatusThis operation is not allowed, because you have overdue bills. Pay the overdue bill and try again.用户处于欠费状态不允许创建,请充值后再尝试。
403Forbidden.UserNotRealNameAuthenticationThis operation is not allowed, because you have not passed the real-name verification.操作被禁止,因为用户还未进行实名认证。
403InvalidUser.PassRoleForbiddenThe RAM user is not authorized to assume a RAM role.子账号用户没有权限使用RAM实例角色。
403OperationDenied.NoStockSales 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-
403NoPermissionThe RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again.-
403SecurityRisk.3DVerificationWe have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.我们检测到您的默认信用卡或借记卡存在安全风险。请通过电子邮件中的链接进行验证。
403CreateServiceLinkedRole.DeniedPlease make sure the account has ram:CreateServiceLinkedRole permission.请确保账号拥有ram:CreateServiceLinkedRole权限。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史