云服务器内容精选

  • 约束限制 最多支持配置8个Key/Value值。 配置的Key值不能跟nginx原生字段重复。 Value值可以自定义一个字符串,也可以配置为以$开头的变量。以$开头的变量仅支持配置如下字段: $time_local $request_id $connection_requests $tenant_id $project_id $remote_addr $remote_port $scheme $request_method $http_host $origin_uri $request_length $ssl_server_name $ssl_protocol $ssl_curves $ssl_session_reused
  • 响应示例 状态码: 201 Created { "id" : "0a515af69f4e4dcca84fbf85f68c0e27", "url_domain" : "www.example.com", "status" : 3, "min_ssl_version" : "TLSv1.2", "is_http_redirect_to_https" : false, "verified_client_certificate_enabled" : false } 状态码: 400 Bad Request { "error_code" : "APIG.3474", "error_msg" : "The API group ID in the URL does not match the API group to which the URL domain has been bound" } 状态码: 401 Unauthorized { "error_code" : "APIG.1002", "error_msg" : "Incorrect token or token resolution failed" } 状态码: 403 Forbidden { "error_code" : "APIG.1005", "error_msg" : "No permissions to request this method" } 状态码: 404 Not Found { "error_code" : "APIG.3020", "error_msg" : "The URL domain does not exist" } 状态码: 500 Internal Server Error { "error_code" : "APIG.9999", "error_msg" : "System error" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 min_ssl_version 是 String 最小ssl协议版本号。支持TLSv1.1或TLSv1.2 is_http_redirect_to_https 否 Boolean 是否开启http到https的重定向,false为关闭,true为开启,默认为false verified_client_certificate_enabled 否 Boolean 是否开启客户端证书校验。只有绑定证书时,该参数才生效。当绑定证书存在trusted_root_ca时,默认开启;当绑定证书不存在trusted_root_ca时,默认关闭。 ingress_http_port 否 Integer 访问该 域名 绑定的http协议入方向端口,-1表示无端口且协议不支持,可使用80默认端口,其他有效端口允许的取值范围为1024~49151,需为实例已开放的HTTP协议的自定义入方向端口。 当创建域名时,该参数未填表示用默认80端口;如果填写该参数,则必须同时填写https_port;如果要http_port和https_port同时使用默认端口,则两个参数都不填。 当修改域名时,该参数未填表示不修改该端口。 ingress_https_port 否 Integer 访问该域名绑定的https协议入方向端口,-1表示无端口且协议不支持,可使用443默认端口,其他有效端口允许的取值范围为1024~49151,需为实例已开放的HTTPS协议的自定义入方向端口。 当创建域名时,该参数未填表示用默认443端口;如果填写该参数,则必须同时填写http_port;如果要http_port和https_port同时使用默认端口,则两个参数都不填。 当修改域名时,该参数未填表示不修改该端口。
  • 响应参数 状态码: 201 表4 响应Body参数 参数 参数类型 描述 url_domain String 自定义域名 id String 自定义域名的编号 status Integer CNAME解析状态 1: 未解析 2: 解析中 3: 解析成功 4: 解析失败 min_ssl_version String 支持的最小SSL版本 is_http_redirect_to_https Boolean 是否开启http到https的重定向,false为关闭,true为开启,默认为false verified_client_certificate_enabled Boolean 是否开启客户端证书校验。只有绑定证书时,该参数才生效。当绑定证书存在trusted_root_ca时,默认开启;当绑定证书不存在trusted_root_ca时,默认关闭。 ingress_http_port Integer 访问该域名绑定的http协议入方向端口,-1表示无端口且协议不支持,可使用80默认端口,其他有效端口允许的取值范围为1024~49151,需为实例已开放的HTTP协议的自定义入方向端口。 当创建域名时,该参数未填表示用默认80端口;如果填写该参数,则必须同时填写https_port;如果要http_port和https_port同时使用默认端口,则两个参数都不填。 当修改域名时,该参数未填表示不修改该端口。 ingress_https_port Integer 访问该域名绑定的https协议入方向端口,-1表示无端口且协议不支持,可使用443默认端口,其他有效端口允许的取值范围为1024~49151,需为实例已开放的HTTPS协议的自定义入方向端口。 当创建域名时,该参数未填表示用默认443端口;如果填写该参数,则必须同时填写http_port;如果要http_port和https_port同时使用默认端口,则两个参数都不填。 当修改域名时,该参数未填表示不修改该端口。 状态码: 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述
  • URI PUT /v2/{project_id}/apigw/instances/{instance_id}/api-groups/{group_id}/domains/{domain_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方式请参见获取项目ID。 instance_id 是 String 实例ID,在API网关控制台的“实例信息”中获取。 group_id 是 String 分组的编号 domain_id 是 String 域名的编号
  • 邮箱域名配置 1. 进入域名管理,点击添加域名,输入邮箱域名,前往域名管理后台,配置DNS。 1)选项一(推荐选择):选择“配置收发解析值”选项,成功配置域名解析后,即可正常使用邮箱所有功能。前往所在的域名管理后台(具体可参考DNS设置)配置MX、TXT、CNAME解析值。如无需继续使用原邮箱服务(如原来使用阿里、腾讯、网易等邮箱服务,需要搬家至华为云 企业邮箱 )或首次使用企业推荐直接配置收发解析值。具体配置信息如下所示: 华为云域名配置参考:点击进入 其他平台域名配置参考:点击进入 成功配置完成后,域名即为启用状态,可正常使用邮箱所有功能,如下所示: 2)选项二:仅验证域名归属。使用邮箱搬家期间,期望原邮箱服务能正常使用。可先选择“仅验证域名归属”,添加“TXT”解析,如下所示。验证邮箱归属您后,即可开通邮箱,体验邮箱基本功能(因未配置收发解析,仅限组织内收发且不支持客户端绑定登录使用)。配置域名解析后,即可体验邮件功能,进行邮箱开通、搬家操作(如需)。 2. 待 “仅验证域名归属”验证通过后,即可前往邮箱开通。 待完成开通,搬家(如需)操作后,原邮箱无需使用,需在本平台使用,则需点击“继续验证”,配置收发解析。成功配置收发解析后,方可正常收发。 父主题: 域名管理
  • 操作步骤 登录 视频直播 控制台。 在左侧导航栏中,选择“域名管理”,进入域名管理页面。 请根据实际需求选择以下操作。 查看域名信息 在域名列表中,可查看已添加域名的CNAME值、域名类型、状态及创建时间等信息。 图1 域名管理 单击右侧操作列的“管理”,可查看目标域名的详细基本信息。 图2 域名信息 停用域名 若您需要停用某个域名,可以在需要停用的域名行单击“停用”。当“状态”变为“停用”时,表示域名停用成功。 启用域名 若您需要将某个已停用的直播域名重新启用,可以在需要启用的域名行单击“启用”。当“状态”变为“正常”时,表示域名启用成功。 删除域名 注意:仅在“停用”状态下的域名才能删除。因此,您需要先停用不需要的域名,再在需要删除的域名行单击“删除”即可。 解除域名关联 若您需要解除某个已关联的域名,可以在需要解除关联的播放域名行单击“管理”。在“推流信息”区域,单击即可。 图3 推流信息
  • 停止共享 资源所有者如果不再需要某个共享时,可以随时将其删除,删除共享不会删除共享的资源。共享删除后,共享资源指定的使用者将无法继续使用该共享中的资源,详细内容请参见删除共享。 资源使用者如果不再需要访问共享给您的资源,可以随时退出共享。退出共享后,将失去对共享资源的访问权限。 只有当共享资源的指定使用者是华为云账号而不是组织内共享时,才可以退出此共享。如果共享资源的指定使用者是组织,而资源使用者的账号由组织管理,则无法退出此共享,详细内容请参见退出共享。
  • 共享内网域名简介 基于 资源访问管理 (Resource Access Manager,简称 RAM )服务,云解析服务可以实现跨账号共享内网域名,资源所有者将内网域名同时共享给多个其他账号使用,资源使用者接受共享邀请后就可以访问和使用共享的内网域名。资源所有者可以依据最小权限原则和不同的使用诉求,选择不同的共享权限,资源使用者只能对资源进行权限内的访问,保证共享资源在满足资源使用者业务诉求的同时,提升资源管理的安全性。关于RAM服务的更多信息请参见什么是资源访问管理。 当您的账号由华为云组织管理时,您还可以利用此优势更轻松地共享资源。如果您的账号在组织中,则您可以与单个账号共享,也可以与组织或OU中的所有账号共享,而不必枚举每个账号,具体请参见启用与组织共享资源。
  • 查看共享详情 进入内网域名列表页面。 进入“共享给我”页面,查看由其他账号共享的内网域名。 如果您是共享内网域名的所有者,您可以通过共享名称,在RAM管理控制台,找到对应的共享,查看共享内的资源情况、资源的权限以及资源的使用者,具体操作请参见查看共享。 如果您是共享内网域名的使用者,您可以通过共享名称,在RAM管理控制台,找到对应的共享,查看共享内的资源情况、资源的权限以及资源的所有者,具体操作请参见查看共享给您的资源。
  • 操作步骤 获取域名对应的CNAME值。 登录 视频点播 控制台。 在左侧导航树中,选择“域名管理”。 在所需域名行,获取对应的CNAME 。 图1 获取CNAME值 登录云解析服务控制台。 在左侧导航树中,选择“公网域名”。 在需要配置解析的域名行,单击域名名称,如图2所示。 图2 域名列表 单击页面右上角的“添加记录集”。 图3 添加记录集 根据界面提示填写参数配置,参数信息如表1所示。 表1 参数说明 参数名 描述 记录类型 记录集的类型,此处为CNAME类型。 选择“CNAME-将域名指向另外一个域名”。 主机记录 输入域名的二级域名(后缀无需用户手动填写)。 以播放域名“play-test.example.com”为例,此处输入“play-test”。 线路类型 用于DNS服务器在解析域名时,根据访问者的来源,返回对应的服务器IP地址,具体请参见解析线路。 仅支持为公网域名的记录集配置此参数。 选择“全网默认”。 TTL (秒) 解析记录在本地DNS服务器的缓存时间,以秒为单位。 数值越小,修改记录各地生效时间越快。 默认为300秒,若无特殊需求,可直接保持默认选择。 记录值 需指向的域名,即当前章节步骤1中获取的CNAME。 以播放域名“play-test.example.com”为例,此处输入“play-test.example.com.c.cdnhwc3.com”。 别名 用于是否将此记录集关联至云服务资源实例。 开启:为此记录集关联云服务资源实例,详细说明请参见设置记录集别名。 关闭:不为此记录集关联云服务资源实例。 设置为关闭。 权重 可选参数,返回解析记录的权重比例。默认值为1,取值范围:0~1000。 仅支持为公网域名的记录集配置此参数。 当域名在同一解析线路中有多条相同类型的解析记录时,可以通过“权重”设置解析记录的响应比例。详细内容请参见配置权重解析。 配置为“1”。 标签 可选参数,记录集的标识,包括键和值,每个记录集可以创建10个标签。键和值的命名规则,详见添加CNAME类型记录集。 取值示例如下: example_key1 example_value1 描述 可选参数,对域名的描述,主要起到提示作用。 长度不超过255个字符。 单击“确定”,完成添加。 您可以在域名对应的记录集列表中查看添加的记录集。当记录集的状态显示为“正常”时,表示记录集添加成功。
  • 操作步骤 下面以播放域名为例,推流域名的CNAME配置步骤相同。 获取域名对应的CNAME值。 登录视频直播控制台,在左侧导航树中选择“域名管理 ”,进入域名管理页面。 在所需域名行获取对应的CNAME。 图1 获取CNAME值 登录云解析服务控制台。 在左侧导航树中,选择“公网域名”。 在需要配置解析的域名行,单击域名名称,如图2所示。 图2 域名列表 单击页面右上角的“添加记录集”。 图3 添加记录集 根据界面提示填写参数配置,参数信息如表1所示。 表1 参数说明 参数名 描述 记录类型 记录集的类型,此处为CNAME类型。 选择“CNAME-将域名指向另外一个域名”。 主机记录 输入域名的二级域名(后缀无需用户手动填写)。 以播放域名“play-test.example.com”为例,此处输入“play-test”。 线路类型 用于DNS服务器在解析域名时,根据访问者的来源,返回对应的服务器IP地址,具体请参见解析线路。 仅支持为公网域名的记录集配置此参数。 选择“全网默认”。 TTL (秒) 解析记录在本地DNS服务器的缓存时间,以秒为单位。 数值越小,修改记录各地生效时间越快。 默认为300秒,若无特殊需求,可直接保持默认选择。 记录值 需指向的域名,即当前章节步骤1中获取的CNAME。 以播放域名“play-test.example.com”为例,此处输入“play-test.example.com.c.cdnhwc3.com”。 别名 用于是否将此记录集关联至云服务资源实例。 开启:为此记录集关联云服务资源实例,详细说明请参见设置记录集别名。 关闭:不为此记录集关联云服务资源实例。 设置为关闭。 权重 可选参数,返回解析记录的权重比例。默认值为1,取值范围:0~1000。 仅支持为公网域名的记录集配置此参数。 当域名在同一解析线路中有多条相同类型的解析记录时,可以通过“权重”设置解析记录的响应比例。详细内容请参见配置权重解析。 配置为“1”。 标签 可选参数,记录集的标识,包括键和值,每个记录集可以创建10个标签。键和值的命名规则,详见添加CNAME类型记录集。 取值示例如下: example_key1 example_value1 描述 可选参数,对域名的描述,主要起到提示作用。 长度不超过255个字符。 单击“确定”,完成添加。 您可以在域名对应的记录集列表中查看添加的记录集。当记录集的状态显示为“正常”时,表示记录集添加成功。 执行步骤1-步骤6,完成对推流域名的CNAME配置。
  • 操作步骤 下面以播放域名为例,推流域名的CNAME配置步骤相同。 获取域名对应的CNAME值。 登录视频直播控制台。 在左侧导航树中,选择“域名管理 ”。 在所需域名行,获取对应的CNAME。 图1 获取CNAME值 登录云解析服务控制台。 在左侧导航树中,选择“公网域名”。 在需要配置解析的域名行,单击域名名称,如图2所示。 图2 域名列表 单击页面右上角的“添加记录集”。 图3 添加记录集 根据界面提示填写参数配置,参数信息如表1所示。 表1 参数说明 参数名 描述 记录类型 记录集的类型,此处为CNAME类型。 选择“CNAME-将域名指向另外一个域名”。 主机记录 输入域名的二级域名(后缀无需用户手动填写)。 以播放域名“play-test.example.com”为例,此处输入“play-test”。 线路类型 用于DNS服务器在解析域名时,根据访问者的来源,返回对应的服务器IP地址,具体请参见解析线路。 仅支持为公网域名的记录集配置此参数。 选择“全网默认”。 TTL (秒) 解析记录在本地DNS服务器的缓存时间,以秒为单位。 数值越小,修改记录各地生效时间越快。 默认为300秒,若无特殊需求,可直接保持默认选择。 记录值 需指向的域名,即当前章节步骤1中获取的CNAME。 以播放域名“play-test.example.com”为例,此处输入“play-test.example.com.c.cdnhwc3.com”。 别名 用于是否将此记录集关联至云服务资源实例。 开启:为此记录集关联云服务资源实例,详细说明请参见设置记录集别名。 关闭:不为此记录集关联云服务资源实例。 设置为关闭。 权重 可选参数,返回解析记录的权重比例。默认值为1,取值范围:0~1000。 仅支持为公网域名的记录集配置此参数。 当域名在同一解析线路中有多条相同类型的解析记录时,可以通过“权重”设置解析记录的响应比例。详细内容请参见配置权重解析。 配置为“1”。 标签 可选参数,记录集的标识,包括键和值,每个记录集可以创建10个标签。键和值的命名规则,详见添加CNAME类型记录集。 取值示例如下: example_key1 example_value1 描述 可选参数,对域名的描述,主要起到提示作用。 长度不超过255个字符。 单击“确定”,完成添加。 您可以在域名对应的记录集列表中查看添加的记录集。当记录集的状态显示为“正常”时,表示记录集添加成功。 执行步骤1-步骤6,完成对推流域名的CNAME配置。
  • 操作步骤 登录视频直播控制台。 在左侧导航树中选择“域名管理”,进入域名管理页面。 单击“添加域名”。在右侧弹出的“添加域名”页面,输入已申请的播放域名或推流域名。 PUSH类型的频道,需同时新增一个推流域名和一个播放域名;PULL类型的频道,仅需新增一个播放域名。 注意:若您的域名未备案,将添加失败,并提示“添加域名失败:ICP编号不存在”。 图2 添加媒体直播播放域名 图3 添加媒体直播推流域名 表1 参数说明 参数 说明 域名 输入二级推流域名或播放域名。示例:“test-push.example.com”。 说明: 域名长度限制为64个字符,暂不支持大写的域名。 推流域名与播放域名不能相同,不支持添加泛域名。 默认每个账号下最多可创建64个域名。如需增加域名,请提交工单处理。 企业项目 将域名加入到企业项目中统一管理。 在企业项目页面创建企业项目,默认为default企业项目,然后将用户组添加到该企业项目。这时用户组内用户将获得用户组授权的该企业项目下的域名的相关操作权限。 说明: 仅企业账号能够配置企业项目。 域名类型 若“域名”中输入的是推流域名则选择推流域名,否则,选择播放域名。域名类型配置后不可更改。 子服务类型 直播服务的子服务类型。 包括如下选项: 云直播:流式直播服务,提供灵活易用,功能丰富的直播加速能力,适用娱乐、电商、教育等场景。 媒体直播:广播级直播服务,支持频道管理、内容加密等特性,适用于媒资,广电等场景。 请选择“媒体直播”。 直播源站 直播源站所在地域,可参考如何选择直播源站和加速区域?选择。直播源站配置后不可更改,建议您选择业务就近的源站。 目前支持如下区域: 中国站北京四入口,支持区域:华北-北京四。 国际站新加坡入口,支持区域:亚太-新加坡、中东-利雅得、中国-香港、非洲-约翰内斯堡。 中东-利雅得、中国-香港、非洲-约翰内斯堡区域默认不开放,如需使用,请提交工单与华为云技术客服联系。 加速区域 播放域名可执行加速的地域,可参考如何选择直播源站和加速区域?选择。仅对播放域名有效,推流域名不支持设置。设置完成后,不支持修改。 如果在所选加速区域之外播放,将无法保证功能和质量,请您根据实际业务,选择有效的加速区域。 包含如下选项: 中国大陆 当观众在中国大陆时,应选择此项。 域名需要在工信部备案,推荐您在华为云备案中心备案。 中国大陆境外 当观众在海外、中国香港、中国澳门、中国台湾时,应选择此项。 全球加速 当观众在中国大陆、中国香港、中国澳门、中国台湾或其他国家和地区时,应选择此项。 域名需要在工信部备案,推荐您在华为云备案中心备案。 推流协议 如果添加的是媒体直播的推流域名,才会展示当前配置项。 媒体直播的推流协议。 包含如下选项: RTMP:RTMP_PUSH类型的频道需要配置RTMP协议的推流域名。 SRT:SRT_PUSH类型的频道需要配置SRT协议的推流域名。 单击“确定”。 在“域名管理”页面的列表中会新增一条“状态”为“配置中”的域名记录。大概3-5分钟时间,当“状态”为“正常”时,域名添加成功。 域名添加完成后,您需要在播放域名和推流域名的DNS服务商处配置CNAME,将您的域名指向CDN配置的CNAME地址。 具体操作请见配置CNAME,配置完成后,对应的域名会自动启用直播加速服务。
  • 前提条件 已 注册华为账号 并开通华为云,完成实名认证。 具备用于媒体直播的域名,且域名已完成备案。PUSH类型的频道需要一个推流域名和一个播放域名,且两个域名不能相同。PULL类型的频道,不需要推流域名。 若您需要购买自有域名,您可以在华为云的域名注册中购买。您也可以在其它域名服务商处购买。 若您已有域名,但还未根据国家工信部规定完成备案,您可以在华为云的备案中心完成备案。 新增IAM用户首次使用媒体直播服务时,需要配置创建域名的权限。