调用 DescribeVodVerifyContent
接口获取归属权校验内容。
您首次通过 CreateDomain 接口添加加速域名时,需要进行域名归属权校验,以确保域名只被其真正的拥有者添加,避免域名冲突和安全隐患。视频点播支持 DNS 解析验证和文件验证两种方式。您可以任选其一完成域名归属权校验。归属权校验的具体步骤如下:
DescribeDomainVerifyContent
获取归属权校验内容。说明
详细信息请见校验域名归属权。
请求地址:https://vod.volcengineapi.com?Action=DescribeDomainVerifyContent&Version=2023-07-01
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDomainVerifyContent | 接口名称。当前 API 的名称为 DescribeDomainVerifyContent 。 |
Version | String | 是 | 2023-07-01 | 接口版本。当前 API 的版本为 2023-07-01 。 |
Domain | String | 是 | example.com | 待校验的域名。仅支持单域名校验。 |
下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
NeedVerify | Boolean | true | 域名是否需要归属权校验:
|
DNSVerifyInfo | Object | - | DNS 解析校验信息,仅当 NeedVerify 为 true 时返回。 |
Host | String | volcvodauth | 主机记录。 |
RecordType | String | TXT | 记录类型。 |
RecordValue | String | vod_800f1eee36864b29baa465a30b55e7af | 记录值。 |
FileVerifyInfo | Object | - | 文件校验信息,仅当 NeedVerify 为 true 时返回。 |
VerifyDomains | String[] | example.com | 文件校验域名列表,可通过返回的任意一个域名完成校验。 |
VerifyFileName | String | verification.html | 校验文件名称。需以该文件名命名校验文件。 |
VerifyFileContent | String | vod_800f1eee36864b29baa465a30b55e7af | 校验文件内容。需将该内容写入校验文件并上传到指定校验域名根目录下。 |
https://vod.volcengineapi.com?Action=DescribeDomainVerifyContent&Version=2023-07-01&Domain=example.com
{ "Result": { "NeedVerify": true, "DNSVerifyInfo": { "Host": "volcvodauth", "RecordType": "TXT", "RecordValue": "vod_800f1eee36864b29baa465a30b55e7af" }, "FileVerifyInfo": { "VerifyDomains": [ "example.com" ], "VerifyFileName": "verification.html", "VerifyFileContent": "vod_800f1eee36864b29baa465a30b55e7af" } }, "ResponseMetadata": { "Action": "DescribeDomainVerifyContent", "Region": "cn-north-1", "Service": "vod", "Version": "2023-07-01", "RequestId": "20230604110420****100232280022D31" } }
本接口无特有的错误码。更多信息请见公共错误码。