將數(shù)據(jù)緩存從一個(gè)地域拷貝到另一個(gè)地域。
接口說明
數(shù)據(jù)緩存不支持直接跨地域使用，通過本接口可以將數(shù)據(jù)緩存從一個(gè)地域拷貝到另一個(gè)地域。該接口適用于以下場景：
- 需要在多個(gè)地域使用數(shù)據(jù)緩存，在 A 地域已有數(shù)據(jù)緩存的情況，可以通過本接口快速拷貝到 B 地域。
- 對(duì)于中國內(nèi)地地域的用戶，創(chuàng)建數(shù)據(jù)緩存時(shí)如果直接拉取國外地址的數(shù)據(jù)，可能會(huì)因?yàn)榫W(wǎng)絡(luò)限制導(dǎo)致數(shù)據(jù)拉取過慢，此時(shí)可以先在非中國內(nèi)地的地域（例如中國香港）創(chuàng)建數(shù)據(jù)緩存，然后通過本接口拷貝到中國內(nèi)地地域。
注意 拷貝數(shù)據(jù)緩存的過程相當(dāng)于復(fù)制快照，費(fèi)用涉及復(fù)制過程產(chǎn)生的流量費(fèi)用以及最終生成的數(shù)據(jù)緩存的存儲(chǔ)費(fèi)用。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| eci:CopyDataCache | create | *DataCache acs:eci:{#regionId}:{#accountId}:datacache/{#datacacheId} |
| 無 |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 已有數(shù)據(jù)緩存所在地域。 | cn-beijing |
| Bucket | string | 否 | 數(shù)據(jù)緩存 Bucket。 | default |
| Path | string | 否 | 數(shù)據(jù)緩存路徑 | /bucket-test |
| Name | string | 否 | 數(shù)據(jù)緩存名稱。 | test |
| RetentionDays | integer | 否 | 數(shù)據(jù)緩存保留天數(shù)。 | 7 |
| Tag | array<object> | 否 | 數(shù)據(jù)緩存標(biāo)簽列表。 | |
| object | 否 | 數(shù)據(jù)緩存標(biāo)簽列表。 | ||
| Key | string | 否 | 標(biāo)簽鍵。 | testkey |
| Value | string | 否 | 標(biāo)簽值。 | testvalue |
| ResourceGroupId | string | 否 | 數(shù)據(jù)緩存所屬資源組 。 | rg-2df3isufhi38**** |
| ClientToken | string | 否 | 保證請(qǐng)求冪等性。從您的客戶端生成一個(gè)參數(shù)值，確保不同請(qǐng)求間該參數(shù)值唯一。只支持 ASCII 字符，且不能超過 64 個(gè)字符。更多信息，請(qǐng)參見如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
| DataCacheId | string | 是 | 數(shù)據(jù)緩存 ID。 | edc-bp15l4vvys94oo****** |
| DestinationRegionId | string | 是 | 要拷貝到的目的地域。 | cn-hangzhou |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "58EE0CB3-C864-5395-A4F7-24F425074839",
"DataCacheId": "edc-bp1423y6d7v7l6ua****"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | Account.Arrearage | Your account has an outstanding payment. | 賬號(hào)已經(jīng)欠費(fèi)。 |
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | 此次DryRun預(yù)檢請(qǐng)求合格。 |
| 400 | InvalidParameter.CPU.Memory | The specified cpu and memory are not allowed | - |
| 400 | IncorrectStatus | %s | 指定的實(shí)例狀態(tài)不正確。 |
| 400 | ServiceNotEnabled | %s | 該次請(qǐng)求所依賴的服務(wù)沒有開通，請(qǐng)開通后再試。 |
| 400 | DiskVolume.NotSupport | The disk volume is not supported. | 云盤卷暫不支持，如有需要請(qǐng)聯(lián)系我們。 |
| 400 | RamRole.NotSupport | The RAM role is not supported. | ram實(shí)例角色不支持。 |
| 400 | ImageCache.IncorrectStatus | %s | 鏡像緩存當(dāng)前的狀態(tài)不對(duì)。 |
| 400 | ImageCacheNotSupport | Image cache is not available for all users. If you want to enable this function, contact us. | 鏡像緩存功能還未全網(wǎng)開放，如果有需要請(qǐng)聯(lián)系我們。 |
| 400 | EipAddressPoolIpNotEnough | The ip address of specified PublicIpAddressPool is not enough. | 指定的eip公網(wǎng)地址池地址資源不足。 |
| 403 | OperationDenied.VswZoneMisMatch | The specified VSwitchId is not in the specified Zone. | - |
| 403 | QuotaExceeded | %s quota exceeded. | 用戶允許創(chuàng)建的實(shí)例已經(jīng)超過限制。 |
| 403 | Zone.NotOnSale | The specified zone is not available for purchase. | 創(chuàng)建實(shí)例的可用區(qū)已經(jīng)關(guān)閉售賣，請(qǐng)更換其他可用區(qū)。或者無法在該可用區(qū)使用指定 VPC 的虛擬交換機(jī)。 |
| 403 | Forbidden.RiskControl | This operation has been identified as an abnormal operation and cannot be processed. | 此操作已被確定為一個(gè)操作異常，無法處理。 |
| 403 | Forbidden.SubUser | The specified action is not available for you. | 當(dāng)前用戶無法執(zhí)行該操作。 |
| 403 | Forbidden.OnlyForInvitedTest | Eci create action is only open to invited users during public beta. | Eci公測階段只對(duì)受邀的用戶開放。 |
| 403 | OperationDenied.SecurityGroupMisMatch | The specified VSwitchId and SecurityGroupId are not in the same VPC. | 指定的交換機(jī)和安全組不在同一個(gè)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. | 用戶處于欠費(fèi)狀態(tài)不允許創(chuàng)建，請(qǐng)充值后再嘗試。 |
| 403 | Forbidden.UserNotRealNameAuthentication | This operation is not allowed, because you have not passed the real-name verification. | 操作被禁止，因?yàn)橛脩暨€未進(jìn)行實(shí)名認(rèn)證。 |
| 403 | InvalidUser.PassRoleForbidden | The RAM user is not authorized to assume a RAM role. | 子賬號(hào)用戶沒有權(quán)限使用RAM實(shí)例角色。 |
| 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 http://bestwisewords.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. | 我們檢測到您的默認(rèn)信用卡或借記卡存在安全風(fēng)險(xiǎn)。請(qǐng)通過電子郵件中的鏈接進(jìn)行驗(yàn)證。 |
| 403 | CreateServiceLinkedRole.Denied | Please make sure the account has ram:CreateServiceLinkedRole permission. | 請(qǐng)確保賬號(hào)擁有ram:CreateServiceLinkedRole權(quán)限。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|
暫無變更歷史