region

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

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

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

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

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

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

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

	// 域名解析器，如果不配置则使用默认的域名解析器
	Resolver resolver.Resolver

	// 域名选择器，如果不配置则使用默认的域名选择器
	Chooser chooser.Chooser

	// 退避器，如果不配置则使用默认的退避器
	Backoff backoff.Backoff

	// 签名前回调函数
	BeforeSign func(*http.Request)

	// 签名后回调函数
	AfterSign func(*http.Request)

	// 签名错误回调函数
	SignError func(*http.Request, error)

	// 域名解析前回调函数
	BeforeResolve func(*http.Request)

	// 域名解析后回调函数
	AfterResolve func(*http.Request, []net.IP)

	// 域名解析错误回调函数
	ResolveError func(*http.Request, error)

	// 退避前回调函数
	BeforeBackoff func(*http.Request, *retrier.RetrierOptions, time.Duration)

	// 退避后回调函数
	AfterBackoff func(*http.Request, *retrier.RetrierOptions, time.Duration)

	// 请求前回调函数
	BeforeRequest func(*http.Request, *retrier.RetrierOptions)

	// 请求后回调函数
	AfterResponse func(*http.Response, *retrier.RetrierOptions, error)
}

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

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

	// 是否加速上传
	AccelerateUploading 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

	// 域名解析器，如果不配置则使用默认的域名解析器
	Resolver resolver.Resolver

	// 域名选择器，如果不配置则使用默认的域名选择器
	Chooser chooser.Chooser

	// 退避器，如果不配置则使用默认的退避器
	Backoff backoff.Backoff

	// 域名解析前回调函数
	BeforeResolve func(*http.Request)

	// 域名解析后回调函数
	AfterResolve func(*http.Request, []net.IP)

	// 域名解析错误回调函数
	ResolveError func(*http.Request, error)

	// 退避前回调函数
	BeforeBackoff func(*http.Request, *retrier.RetrierOptions, time.Duration)

	// 退避后回调函数
	AfterBackoff func(*http.Request, *retrier.RetrierOptions, time.Duration)

	// 请求前回调函数
	BeforeRequest func(*http.Request, *retrier.RetrierOptions)

	// 请求后回调函数
	AfterResponse func(*http.Response, *retrier.RetrierOptions, error)
}

type Endpoints struct {
	Preferred   []string `json:"preferred,omitempty"`   // 首选服务地址
	Alternative []string `json:"alternative,omitempty"` // 备选服务地址
	Accelerated []string `json:"accelerated,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"`    // Io 源站服务域名
	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