Elastic Container Instance:Create and manage a data cache

Configuration description

When you create a data cache, you must configure the following parameters:

• Basic properties

  API	Console	Description
  RegionId	Region	The region to which the data cache belongs.
  Bucket	Cache Bucket	The bucket in which the data is stored. By default, the bucket named default is used. You can use a custom bucket to group business and prevent path conflicts. The bucket named eci-system is reserved to store common caches of Elastic Container Instance and cannot be used as a value of this parameter.
  Path	Cache Directory	The storage path of the data.
  Name	Cache Name	The name of the data cache.
  Size	Cache Size	The size of the data cache. Unit: GiB. Default value: 20. Evaluate the required size based on the actual data volume.
  RetentionDays	Retention Period (Days)	The number of days for which the data cache is retained. When the retention days elapse, the data cache is deleted. By default, data caches do not expire.

• Data source parameters

  API	Console	Description
  DataSource.Type	Type	The type of the data source.
  DataSource.Options	Parameters	The parameters of the data source. This value is a JSON object. Different types of data sources require different parameters.

  The following table describes various types of data sources and their parameters.

  Important

  If you create a data cache by calling an API operation, you must add the length of the parameter name before each parameter under the DataSource.Options parameter. For example, you must write url as #3#url, repoId as #6#repoId, and repoSource as #10#repoSource. If you create a data cache by using an SDK, this is not required.

  type	Description	options
  URL	Hyperlink addresses	url: the URL from which data is downloaded. accessToken: the token that is used for authentication before you pull private data.
  	HuggingFace or ModelScope	repoSource: pulls a model or dataset from the ModelScope or HuggingFace community. Valid values: ModelScope/Model, ModelScope/DataSet, HuggingFace/Model, and HuggingFace/DataSet. repoId: the ID of the model or dataset. revision: the version. Default value: main or master. accessToken: the token that is used for authentication before you pull private data.
  NAS	Apsara File Storage NAS (NAS) file systems	server: the mount point of the NAS file system. path: the sub-directory of the NAS file system. For extreme NAS file systems, prefix /share to the path. Example: /share/path. vers: the version number of the NFS (Network File System) protocol based on which the NAS file system is mounted. We recommend that you use NFS v3. Extreme NAS only supports NFS v3. options: the parameters that are used when you set the type parameter to NAS. We recommend that you use the recommended parameters in the NAS service. Example: nolock,tcp,noresvport.
  OSS	Object Storage Service (OSS) buckets	bucket: the name of the OSS bucket. url: the endpoint of the OSS bucket. path: the sub-directory of the OSS bucket. The path is relative to the root directory of the OSS bucket. Default value: /. otherOpts: The custom options that are specified to mount the OSS bucket. Format: -o *** -o ***. Example: -o max_stat_cache_size=0 -o allow_other. ramRole: the RAM role that is used to grant permissions. Specify this parameter if you use a RAM role to grant permissions. akId: the AccessKey ID that is used if you use AccessKey pairs to grant permissions to access OSS. akSecret: the AccessKey secret that is used if you use AccessKey pairs to grant permissions to access OSS.
  SNAPSHOT	Snapshots	snapshotId: the ID of the snapshot.

• Network parameters

  If you want to pull data over the Internet, you can associate an elastic IP address (EIP) with the elastic container instance if the connected vSwitch is not configured with SNAT entries.

  API	Console	Description
  EipInstanceId	Use Existing	Associates an existing EIP with the elastic container instance.
  Parameters under the EipCreateParam parameter.	Auto Create	Automatically creates an EIP and associates the EIP with the elastic container instance.

• Other parameters

  In addition to the preceding parameters, you must also configure parameters that are used to create temporary resources when you create a data cache, such as the parameters of a virtual private cloud (VPC), a vSwitch, and a security group.

Query a data cache

After you create a data cache, you can query the information about the data cache, such as the status, bucket, and storage path in the bucket. If the data cache is in the Available state, the data cache can be used.

You can use one of the following methods to query a data cache:

• API: You can call the DescribeDataCaches operation to query the information about a data cache.

• Console: On the Data Cache page, you can view all data caches in the selected region. You can click the ID of a data cache to view the information about the data cache.

Update a data cache

For a data cache in the Available or UpdateFailed state, you can update the bucket, data source, retention period, and size.

You can use one of the following methods to update a data cache:

• API: You can call the UpdateDataCache operation to update a data cache.

• Console: Not supported.

Copy a data cache

A data cache cannot be shared across regions. When you use a data cache to create an elastic container instance, if the elastic container instance that you want to create is not in the same region as the data cache, you can copy the data cache from the source region to the destination region.

You can use one of the following methods to copy a data cache to a different region:

• API: You can call the CopyDataCache operation to copy a data cache.

• Console: On the Data Cache page, find the data cache that you want to copy and click Copy in the Actions column.

Delete a data cache

You can use one of the following methods to delete a data cache:

• API: You can call the DeleteDataCache API operation to delete a data cache.

• Console: On the Data Cache page, find the data cache that you want to delete and click Delete in the Actions column.