batch_ops

Documentation

Overview

批量操作意指在单一请求中执行多次（最大限制1000次） 查询元信息、修改元信息、移动、复制、删除、修改状态、修改存储类型、修改生命周期和解冻操作，极大提高对象管理效率。其中，解冻操作仅针对归档存储文件有效

Index

• type Data
  • func (j *Data) MarshalJSON() ([]byte, error)
  • func (j *Data) UnmarshalJSON(data []byte) error
• type OperationResponse
  • func (j *OperationResponse) MarshalJSON() ([]byte, error)
  • func (j *OperationResponse) UnmarshalJSON(data []byte) error
• type OperationResponseData
• type OperationResponses
• type PartSizes
• type Request
• type Response
  • func (j *Response) MarshalJSON() ([]byte, error)
  • func (j *Response) UnmarshalJSON(data []byte) error

Types

type Data

type Data struct {
	Error                       string            // 管理指令的错误信息，仅在发生错误时才返回
	Size                        int64             // 对象大小，单位为字节，仅对 stat 指令才有效
	Hash                        string            // 对象哈希值，仅对 stat 指令才有效
	MimeType                    string            // 对象 MIME 类型，仅对 stat 指令才有效
	Type                        int64             // 对象存储类型，`0` 表示普通存储，`1` 表示低频存储，`2` 表示归档存储，仅对 stat 指令才有效
	PutTime                     int64             // 文件上传时间，UNIX 时间戳格式，单位为 100 纳秒，仅对 stat 指令才有效
	EndUser                     string            // 资源内容的唯一属主标识
	RestoringStatus             int64             // 归档存储文件的解冻状态，`2` 表示解冻完成，`1` 表示解冻中；归档文件冻结时，不返回该字段，仅对 stat 指令才有效
	Status                      int64             // 文件状态。`1` 表示禁用；只有禁用状态的文件才会返回该字段，仅对 stat 指令才有效
	Md5                         string            // 对象 MD5 值，只有通过直传文件和追加文件 API 上传的文件，服务端确保有该字段返回，仅对 stat 指令才有效
	ExpirationTime              int64             // 文件过期删除日期，UNIX 时间戳格式，文件在设置过期时间后才会返回该字段，仅对 stat 指令才有效
	TransitionToIaTime          int64             // 文件生命周期中转为低频存储的日期，UNIX 时间戳格式，文件在设置转低频后才会返回该字段，仅对 stat 指令才有效
	TransitionToArchiveTime     int64             // 文件生命周期中转为归档存储的日期，UNIX 时间戳格式，文件在设置转归档后才会返回该字段，仅对 stat 指令才有效
	TransitionToDeepArchiveTime int64             // 文件生命周期中转为深度归档存储的日期，UNIX 时间戳格式，文件在设置转归档后才会返回该字段，仅对 stat 指令才有效
	TransitionToArchiveIrTime   int64             // 文件生命周期中转为归档直读存储的日期，UNIX 时间戳格式，文件在设置转归档直读后才会返回该字段，仅对 stat 指令才有效
	Metadata                    map[string]string // 对象存储元信息
	Parts                       PartSizes         // 每个分片的大小，如没有指定 need_parts 参数则不返回
}

响应数据

func (*Data) MarshalJSON

func (j *Data) MarshalJSON() ([]byte, error)

func (*Data) UnmarshalJSON

func (j *Data) UnmarshalJSON(data []byte) error

type OperationResponse

type OperationResponse struct {
	Code int64                 // 响应状态码
	Data OperationResponseData // 响应数据
}

每个管理指令的响应信息

func (*OperationResponse) MarshalJSON

func (j *OperationResponse) MarshalJSON() ([]byte, error)

func (*OperationResponse) UnmarshalJSON

func (j *OperationResponse) UnmarshalJSON(data []byte) error

type OperationResponseData

type OperationResponseData = Data

管理指令的响应数据

type OperationResponses

type OperationResponses []OperationResponse

所有管理指令的响应信息

type PartSizes

type PartSizes = []int64

每个分片的大小

type Request

type Request struct {
	Credentials credentials.CredentialsProvider // 鉴权参数，用于生成鉴权凭证，如果为空，则使用 HTTPClientOptions 中的 CredentialsProvider
	Operations  []string                        // 单一对象管理指令
}

调用 API 所用的请求

type Response

type Response struct {
	OperationResponses OperationResponses // 所有管理指令的响应信息
}

获取 API 所用的响应

func (*Response) MarshalJSON

func (j *Response) MarshalJSON() ([]byte, error)

func (*Response) UnmarshalJSON

func (j *Response) UnmarshalJSON(data []byte) error