API Overview--Torch Object Storage-Volcengine

Docs

Torch Object Storage

API Reference

API Overview

This article introduces the API interfaces and functional descriptions provided by Object Storage TOS.

Bucket

Category	API name	Function
Basic Operations	CreateBucket	Create a bucket.
	DeleteBucket	Delete a bucket.
	HeadBucket	Check if the bucket metadata exists.
	ListBuckets	List all buckets.
	ListObjects	List objects in the bucket.
	ListObjectsV2	List objects in the bucket V2 version.
	ListObjectVersions	List all version information of objects in the bucket.
	PutBucketStorageClass	Set the default storage class for the bucket.
	GetBucketLocation	Query the region information of the current bucket.
	GetBucketInfo	Query the bucket configuration information.
Lifecycle rules	PutBucketLifecycle	Set lifecycle rules.
	GetBucketLifecycle	Query the lifecycle rules.
	DeleteBucketLifecycle	Delete lifecycle rules.
Access monitor	PutBucketAccessMonitor	Set access monitor.
Access monitor	GetBucketAccessMonitor	Get access monitor information.
Bucket ACL	PutBucketACL	Set the bucket’s ACL permissions.
Bucket ACL	GetBucketACL	Access the specified bucket's ACL permissions.
Cross-domain access rules	PutBucketCORS	Set cross-domain access rules.
	GetBucketCORS	Query cross-domain access rules.。
	DeleteBucketCORS	Delete cross-domain access rules.
Bucket inventory	PutBucketInventory	Create bucket inventory.
	GetBucketInventory	View bucket inventory.
	ListBucketInventory	Batch retrieve all bucket inventories.
	DeleteBucketInventory	Delete the specified bucket inventory.
Bucket policy	PutBucketPolicy	Set bucket policy.
	GetBucketPolicy	Query bucket policy.
	DeleteBucketPolicy	Delete bucket policy.
Back-to-origin rules	PutBucketMirrorBack	Set back-to-origin rules.
	GetBucketMirrorBack	Query back-to-origin rules.
	DeleteBucketMirrorBack	Delete back-to-origin rules.
Bucket Replication	PutBucketReplication	Set cross-region and same-region replication rules.
	GetBucketReplication	Query cross-region and same-region replication rules.
	DeleteBucketReplication	Delete cross-region and same-region replication rules.
Versioning	PutBucketVersioning	Set versioning.
Versioning	GetBucketVersioning	Retrieve Versioning Status.
Static Website	PutBucketWebsite	Set up static website rules.
	GetBucketWebsite	Query static website rules.
	DeleteBucketWebsite	Delete static website rules.
Event notification	PutBucketNotification	Set event notification rules.
	GetBucketNotification	Query notification rules.
	PutBucketNotificationV2	Set event notification rules.
	GetBucketNotificationV2	Query notification rules.
Custom Domain	PutBucketCustomDomain	Set custom domain.
	GetBucketCustomDomain	Query Custom Domain.
	DeleteBucketCustomDomain	Delete Custom Domain.
Server-side Encryption	PutBucketEncryption	Set up server-side encryption.
	GetBucketEncryption	Retrieve server-side encryption configuration.
	DeleteBucketEncryption	Delete server-side encryption configuration.
Bucket tag	PutBucketTagging	Set Bucket Tags.
	GetBucketTagging	Retrieve the tag information of the specified bucket.
	DeleteBucketTagging	Delete the tag information of the specified bucket.
Rename	PutBucketRename	Enable the RenameObject feature.
	GetBucketRename	Check if the RenameObject feature is enabled.
	DeleteBucketRename	Disable the RenameObject feature.
Transfer acceleration	PutBucketTransferAcceleration	Enable or disable transfer acceleration.
Transfer acceleration	GetBucketTransferAcceleration	Retrieve transfer acceleration configuration.
Data processing	Pm3u8	Obtain download authorization for a private m3u8.
Log storage	PutBucketTransferAcceleration	Enable or disable transfer acceleration.
Log storage	GetBucketLogging	configuration information of log storage.
AIGC	TextToImage

Combine the image processing capabilities of object storage with Databricks' text-to-image model.|
|^^| | |
| |ImageToImage |Combine the image processing capabilities of object storage with Databricks' image-to-image model. |

Object

Category	API name	Function
Basic Operations	CopyObject	Copy object.
	DeleteObject	Delete object.
	DeleteMultiObjects	Delete multiple objects.
	GetObject	Retrieve object.
	HeadObject	Check if the object exists.
	AppendObject	Append to object.
	PutObject	Upload an object.
	PostObject	Upload objects using a form
	SetObjectMeta	Update the metadata of objects already uploaded in the bucket.
	RestoreObject	Restore objects in standard archive, cold archive, and deep cold archive.
	RenameObject	Rename objects.
Access Control	PutObjectACL	Set object access control permissions.
Access Control	GetObjectACL	Obtain the access control permissions for the specified object
Object Tagging	PutObjectTagging	Set object tags.
	GetObjectTagging	View object tag information.
	DeleteObjectTagging	Delete object tag.
Retrieve object	FetchObject	Fetch resources from the specified URL and store them in the designated bucket.
	PutFetchTask	Create an asynchronous task to fetch resources from the specified URL and store them in the designated bucket.
	GetFetchTask	Query details of the asynchronous task.
Soft link	PutSymlink	Create a soft link for an existing target file in TOS.
Soft link	GetSymlink	Get soft link object information.

Multipart upload

API Name	Function
CreateMultipartUpload	Initialize multipart upload task.
UploadPart	Upload file fragment data.
CompleteMultipartUpload	Merge the uploaded fragment data of the entire object.
AbortMultipartUpload	Cancel multipart upload tasks.
UploadPartCopy	Upload objects by copying parts.
ListMultipartUploads	List multipart upload tasks.
ListParts	List uploaded parts.

Last updated: 2025.06.30 17:27:07

Torch Object Storage

Bucket #

Object #

Multipart upload #

Bucket

Object

Multipart upload