region

type BucketRegionsQuery interface {
	Query(accessKey, bucketName string) RegionsProvider
}

type BucketRegionsQueryOptions struct {
	// 使用 HTTP 协议
	UseInsecureProtocol bool

	// 压缩周期（默认：60s）
	CompactInterval time.Duration

	// 持久化路径（默认：$TMPDIR/qiniu-golang-sdk/query_v4_01.cache.json）
	PersistentFilePath string

	// 持久化周期（默认：60s）
	PersistentDuration time.Duration

	// 单域名重试次数（默认：2）
	RetryMax int

	// 主备域名冻结时间（默认：600s），当一个域名请求失败（单个域名会被重试 RetryMax 次），会被冻结一段时间，使用备用域名进行重试，在冻结时间内，域名不能被使用，当一个操作中所有域名竣备冻结操作不在进行重试，返回最后一次操作的错误。
	HostFreezeDuration time.Duration

	// HTTP 客户端，如果不配置则使用默认的 HTTP 客户端
	Client clientv2.Client
}

type Endpoints struct {
	Preferred   []string `json:"preferred,omitempty"`
	Alternative []string `json:"alternative,omitempty"`
}

type EndpointsIter struct {
	// contains filtered or unexported fields
}

type EndpointsProvider interface {
	GetEndpoints(context.Context) (Endpoints, error)
}

type Region struct {
	RegionID string    `json:"region_id,omitempty"` // 区域 ID
	Up       Endpoints `json:"up,omitempty"`        // Up 服务域名
	Io       Endpoints `json:"io,omitempty"`        // Io 服务域名
	IoSrc    Endpoints `json:"io_src,omitempty"`    // IoSrc 服务域名
	Rs       Endpoints `json:"rs,omitempty"`        // Rs 服务域名
	Rsf      Endpoints `json:"rsf,omitempty"`       // Rsf 服务域名
	Api      Endpoints `json:"api,omitempty"`       // Api 服务域名
	Bucket   Endpoints `json:"bucket,omitempty"`    // Bucket 服务域名
}

type RegionsProvider interface {
	GetRegions(context.Context) ([]*Region, error)
}

type ServiceName string