开发者社区 问答 正文

如何绑定自定义域名?



描述


给指定分组绑定自定义域名

  • 此功能面向API提供者
  • 独立域名在阿里云系统备案成功,请求才能到达您的后端服务,备案和接入流程
  • 独立域名要CNAME解析到该分组的二级域名上,后操作绑定。先解析,后绑定,否则绑定操作会报错。
  • 若您需要将其他分组的独立域名变更到当前分组,需要先变更解析,才能成功绑定
  • 若为https协议,则需要同时绑定SSL证书,要求同时传递 CertificateName、CertificateBody、PrivateKey三个入参
  • 可后续再SSL证书,请参照《SetDomainCertificate》


请求参数


名称类型是否必须描述
ActionString接口名称,系统规定参数,取值:SetDomain
GroupIdStringAPI分组 ID,系统生成,全局唯一
DomainNameString自定义域名
CertificateNameStringSSL证书名称
CertificateBodyString证书内容
PrivateKeyString证书私钥


返回参数


名称类型描述
RequestIdString请求唯一标识
GroupIDStringAPI分组 ID,系统生成,全局唯一
DomainNameString自定义域名
SubDomainString系统给分组绑定的二级域名,用于测试API调用
DomainBindingStatusString自定义域名绑定状态
  • BINDING:正常
  • BOUND:未生效
DomainLegalStatusString域名合法状态,取值:
  • NORMAL:正常
  • ABNORMAL:异常,该状态会影响API调用,需尽快解决
DomainRemarkString域名相关备注,如描述域名异常状态原因


示例



请求示例

  1. [backcolor=transparent]https[backcolor=transparent]:[backcolor=transparent]//apigateway.cn-hangzhou.aliyuncs.com/?Action=SetDomain
  2. [backcolor=transparent]&[backcolor=transparent]GroupId[backcolor=transparent]=[backcolor=transparent]927d50c0f2e54b359919923d908bb015
  3. [backcolor=transparent]&[backcolor=transparent]DomainName[backcolor=transparent]=[backcolor=transparent]api[backcolor=transparent].[backcolor=transparent]demo[backcolor=transparent].[backcolor=transparent]com
  4. [backcolor=transparent]&<公共请求参数>


返回示例


XML格式

展开
收起
轩墨 2017-10-26 13:48:15 2116 分享 版权
阿里云 AI 助理回答

要给指定分组绑定自定义域名,请遵循以下步骤和注意事项:

  1. 确保备案成功

    • 确认您的独立域名已在阿里云系统完成备案,这是请求能够到达您后端服务的前提。
  2. CNAME解析设置

    • 将您的独立域名通过CNAME记录解析到该分组的二级域名上。此步骤需在绑定操作之前完成,遵循“先解析,后绑定”的原则,以避免绑定操作失败。
  3. 准备SSL证书(如使用HTTPS协议)

    • 如果您的API使用HTTPS协议,需要准备SSL证书,并在绑定时提供以下信息:
      • CertificateName:SSL证书名称
      • CertificateBody:证书内容
      • PrivateKey:证书私钥
    • 注意,SSL证书绑定可以后续进行,参考《SetDomainCertificate》文档操作。
  4. 发起绑定请求

    • 通过调用API接口SetDomainGroupId来执行绑定操作,需要提供以下参数:
      • Action: 固定值SetDomain
      • GroupId: API分组ID,阿里云系统生成,全局唯一
      • DomainName: 您要绑定的自定义域名
      • (可选)SSL证书相关参数:CertificateNameCertificateBodyPrivateKey
  5. 预期返回结果

    • 成功响应将包含以下信息:
      • RequestId: 请求的唯一标识。
      • GroupId: API分组ID。
      • DomainName: 自定义绑定的域名。
      • SubDomain: 分组自动分配的二级域名,用于测试API调用。
      • DomainBindingStatus: 绑定状态,可能为BINDING(正常)或BOUND(未生效)。
      • DomainLegalStatus: 域名合法性状态,如NORMAL(正常)或ABNORMAL(异常)。
      • DomainRemark: 域名相关的备注信息,有助于了解异常状态原因。

重要提醒: - 在变更其他分组的独立域名到当前分组前,必须先变更DNS解析设置。 - 域名合法状态异常会影响API调用,应及时根据DomainRemark解决异常问题。

请按照上述指导操作,确保每个环节正确无误,以顺利完成自定义域名的绑定过程。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答