全部產品
Search

搜尋本產品

    Elastic Container Instance：CreateDataCache - 建立資料緩衝

    文件中心

    Elastic Container Instance：CreateDataCache - 建立資料緩衝

    更新時間：Oct 17, 2025

    建立一個資料緩衝。

    介面說明

    • 建立鏡像緩衝涉及資源計費。建議您提前瞭解相關計費資訊。更多資訊，請參見資料緩衝計費。

    • 建立鏡像緩衝前，您需要評估待快取資料的大小，如果資料大小超過設定的緩衝大小，將會建立失敗。

    • 建立資料緩衝時，系統將自動建立一個 ECI 執行個體和一塊 ESSD 雲端硬碟用於中轉建立資料緩衝。建立過程中請勿刪除 ECI 執行個體和雲端硬碟，否則資料緩衝將建立失敗。

    • 建立資料緩衝將產生對應的快照。請勿刪除快照，否則資料緩衝將會失效。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    eci:CreateDataCache

    create

    *DataCache

    acs:eci:{#regionId}:{#accountId}:datacache/*
    • eci:tag
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID。

    cn-hangzhou
    RegionId

    string

    是

    地區 ID。

    cn-hangzhou
    SecurityGroupId

    string

    否

    建立資料緩衝過程中產生的 ECI 執行個體所屬的安全性群組 ID。

    sg-2ze81zoc3yl7a3we****
    VSwitchId

    string

    否

    建立資料緩衝過程中產生的 ECI 執行個體所屬的交換器 ID。

    vsw-bp1jrgfqqy54kg5hc****
    Bucket

    string

    否

    資料的儲存空間。預設為 default。支援自訂，以便進行業務分組和避免路徑衝突。

    說明

    eci-system 為 ECI 保留空間，不可使用。

    default
    Path

    string

    否

    資料存放區的路徑。

    /model/test
    Name

    string

    否

    資料緩衝名稱。

    test
    Size

    integer

    否

    資料緩衝大小。單位為 GiB，預設為 20 GiB。請根據實際資料量評估所需大小。

    30
    DataSource

    object

    否

    資料來源。

    Type

    string

    否

    資料來源類型。取值範圍：

    • URL

    • NAS

    • OSS

    • SNAPSHOT

    枚舉值：

    • NAS :

      NAS

    • SNAPSHOT :

      SNAPSHOT

    • URL :

      URL

    • OSS :

      OSS

    URL
    Options

    object

    否

    資料來源的配置參數。

    string

    否

    資料來源的配置參數。不同類型資料來源要傳入的參數不同。各類型資料來源及其配置參數說明，請參見建立資料緩衝。

    { "#10#repoSource": "HuggingFace/Model", "#6#repoId": "stabilityai/stable-diffusion-2-1" }
    RetentionDays

    integer

    否

    保留天數。到期會被清理。預設不到期。

    7
    Tag

    array<object>

    否

    資料緩衝綁定的標籤列表。

    object

    否

    資料緩衝綁定的標籤列表。

    Key

    string

    否

    標籤鍵。

    testkey
    Value

    string

    否

    標籤值。

    testvalue
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-2df3isufhi38****
    ClientToken

    string

    否

    保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證等冪性。

    123e4567-****-12d3-****-426655440000
    EipInstanceId

    string

    否

    綁定已有的彈性公網 IP（EIP）。 如果 VPC 沒有配置 NAT Gateway，可以綁定 EIP，以便拉取公網資料。

    eip-uf66jeqopgqa9hdn****
    EipCreateParam

    object

    否

    建立一個彈性公網 IP（EIP）並綁定。 如果 VPC 沒有配置 NAT Gateway，可以綁定 EIP，以便拉取公網資料。

    Bandwidth

    integer

    否

    EIP 頻寬。單位為 Mbps。預設為 5 Mbps。

    10
    CommonBandwidthPackage

    string

    否

    綁定已有的共用頻寬包。

    cbwp-2zeukbj916scmj51m****
    InternetChargeType

    string

    否

    EIP 的計量方式。取值範圍：

    • PayByBandwidth：按頻寬計費

    • PayByTraffic：按流量計費

    PayByTraffic
    PublicIpAddressPoolId

    string

    否

    IP 位址集區 ID。 EIP 將從該 IP 位址集區中分配。 IP 位址集區功能預設不開放。如需使用，請在配額中心申請 IP 位址集區功能權益配額。

    pippool-2vc4xdtjhwl4t0go5****
    ISP

    string

    否

    EIP 的線路類型。取值範圍：

    • BGP（預設值）：BGP（多線）線路

    • BGP_PRO：BGP（多線）精品線路

    BGP

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    D81A4A13-6DCC-4579-AC62-90A6C3EC7BBC
    DataCacheId

    string

    資料緩衝 ID。

    edc-bp15l4vvys94oo******

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "D81A4A13-6DCC-4579-AC62-90A6C3EC7BBC",
  "DataCacheId": "edc-bp15l4vvys94oo******"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Account.Arrearage Your account has an outstanding payment. 帳號已經欠費。
    400 DryRunOperation Request validation has been passed with DryRun flag set. 此次DryRun預檢請求合格。
    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. ram執行個體角色不支援。
    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. 指定的eip公網位址集區地址資源不足。
    400 DryRun.Success This request is a dryrun request with successful result. 該dryrun請求校正已經通過。
    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. 建立執行個體的可用性區域已經關閉售賣，請更換其他可用性區域。或者無法在該可用性區域使用指定 VPC 的虛擬交換器。
    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. 子帳號使用者沒有許可權使用RAM執行個體角色。
    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://www.alibabacloud.com/help/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. 請確保帳號擁有ram:CreateServiceLinkedRole許可權。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。