自定义域名

最后更新时间:2020-03-11 17:39:39

    简介

    本文档提供关于自定义域名的 API 概览以及 SDK 示例代码。

    API 操作名 操作描述
    PUT Bucket domain 设置自定义域名 设置存储桶的自定义域名信息
    GET Bucket domain 查询自定义域名 查询存储桶的自定义域名信息

    设置自定义域名

    功能说明

    PUT Bucket domain 用于为存储桶配置自定义域名。

    方法原型

    func (s *BucketService) PutDomain(ctx context.Context, opt *BucketPutDomainOptions) (*Response, error)

    请求示例

    opt := &cos.BucketPutDomainOptions{
        Status:            "ENABLED",
        Name:              "www.example.com",
        Type:              "REST",
        ForcedReplacement: "CNAME",
    }   
    resp, err := c.Bucket.PutDomain(context.Background(), opt)

    参数说明

    type BucketPutDomainOptions struct {
        XMLName           xml.Name
        Status            string   
        Name              string   
        Type              string   
        ForcedReplacement string   
    }
    参数名称 描述 类型
    BucketPutDomainOptions 自定义域名配置 Struct
    Status 域名上线/下线状态,有效值 ENABLED/DISABLED String
    Name 用户的自定义域名,有效值:字母、数字、点 String
    Type 绑定的源站类型,有效值 REST/WEBSITE String
    ForcedReplacement 替换已存在的配置,有效值 CNAME/TXT。填写则强制校验域名所有权后,再下发配置 String

    返回错误码说明

    该请求可能会发生的一些常见的特殊错误如下:

    状态码 说明
    HTTP 409 Conflict 该域名记录已存在,且请求中没有设置强制覆盖。或者该域名记录不存在,且请求中设置了强制覆盖
    HTTP 451 Unavailable For Legal Reasons 该域名是中国境内域名,并且没有备案

    查询自定义域名

    功能说明

    GET Bucket domain 用于查询存储桶的自定义域名信息。

    方法原型

    func (s *BucketService) GetDomain(ctx context.Context) (*BucketGetDomainResult, *Response, error)

    请求示例

    v, resp, err := c.Bucket.GetDomain(context.Background())

    返回结果说明

    type BucketGetDomainResult BucketPutDomainOptions
    参数名称 描述 类型
    BucketGetDomainResult 自定义域名配置 Struct
    Status 域名上线/下线状态,有效值 ENABLED/DISABLED String
    Name 用户的自定义域名,有效值:字母、数字、点 String
    Type 绑定的源站类型,有效值 REST/WEBSITE String
    ForcedReplacement 替换已存在的配置,有效值 CNAME/TXT。填写则强制校验域名所有权后,再下发配置 String

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助