All Products
Search

This Product

    Object Storage Service:What do I do if the NeedVerifyDomainOwnership error code is returned when I map a custom domain name to a bucket?

    Document Center

    Object Storage Service:What do I do if the NeedVerifyDomainOwnership error code is returned when I map a custom domain name to a bucket?

    Last Updated:Oct 08, 2026

    This topic describes the cause of and the solution to the NeedVerifyDomainOwnership: Please verify domain ownership by CreateCnameToken and try again. error when you map a custom domain name.

    Cause: The ownership of your domain name is not verified.

    Solution: Verify the ownership of your domain name by performing the following steps.

    1. Call CreateCnameToken to create the CNAME token required for domain name ownership verification. When you create a token for a wildcard base domain name on an Agentic Bucket, specify wildcard=true.

    2. Add a TXT record at your domain name service provider.

      For example, to add a TXT record for the custom domain name example.com, set the record type to TXT, the host record to _dnsauth.example, and the record value to the CNAME token returned by Step 1. Keep the default settings for the other parameters. For more information, see Manually add a CNAME record.

      Note

      The TXT record that you add takes several minutes to take effect.

    3. Call PutCname to map the custom domain name.