DNS Services CLI 参考
请按照以下说明使用 IBM Cloud® DNS Services 命令行界面 (CLI)。
准备工作
完成以下步骤以使用 DNS Services CLI,该 CLI 是作为 IBM Cloud CLI 插件实现的。 该插件为您提供了通过命令行用户界面管理服务实例及其相关资源的方法。
-
安装 IBM Cloud CLI。
-
将
cloud-dns-services
插件安装或更新到 IBM Cloud CLI。要安装插件,请输入以下命令。
ibmcloud plugin install cloud-dns-services
更新该插件:
ibmcloud plugin update cloud-dns-services
查看已安装的插件和版本
ibmcloud plugin list
实例数
使用以下 instance
命令来管理 DNS Services 实例。
ibmcloud dns instances
列出所有 DNS 服务实例。
ibmcloud dns instances [--output FORMAT]
命令选项
--output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns instance-target
设置要运行的上下文服务实例。
ibmcloud dns instance-target [INSTANCE] [--unset]
命令选项
- 实例
- DNS Services 实例的名称或标识。 如果存在,则将上下文实例设置为
operate
;如果不存在,则显示当前上下文实例。 - --unset
- 取消设置上下文实例。
ibmcloud dns instance-create
创建 DNS Services实例。
在创建 DNS Services实例之前,使用 ibmcloud target -g RESOURCE_GROUP
设置目标资源组。 使用 ibmcloud resource groups
来查看可用资源组的列表。
ibmcloud dns instance-create INSTANCE_NAME PLAN [-g, --resource-group RESOURCE_GROUP] [--output FORMAT]
命令选项
- instance_name
- DNS Services实例的名称。
- 套餐
- 服务计划的名称或 ID。
- -g, --resource-group
- 资源组的名称或 ID。
- --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns instance-update
更新 DNS Services实例。
ibmcloud dns instance-update INSTANCE [--name NAME] [--plan PLAN] [--output FORMAT]
命令选项
- 实例
- DNS Services 实例的名称或标识。
- --name
- DNS Services 实例名称。
- --plan
- DNS Services 套餐的名称或标识。 使用
ibmcloud dns plans
可获取可用套餐。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns instance-delete
删除 DNS Services实例。
ibmcloud dns instance-delete INSTANCE [--force]
命令选项
- 实例
- DNS Services 实例的名称或标识。
- --force
- 删除实例时不提示确认。
ibmcloud dns instance
显示 DNS Services 实例的详细信息。
ibmcloud dns instance INSTANCE [--output FORMAT]
命令选项
- 实例
- DNS Services 实例的名称或标识。
- --output
- 指定输出格式,仅支持 JSON。
ibmcloud dns plans
列出所有 DNS 服务实例。
ibmcloud dns plans
专区
使用以下 zone
命令来管理 DNS 区域。
ibmcloud dns zone-create
创建 DNS 区域。
ibmcloud dns zone-create ZONE_NAME [-d, --description DESC] [-l, --label LABEL] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- ZONE_NAME
- DNS 区域的名称。
- -d, --description
- 描述 DNS 区域用途的文字。
- -l, --label
- DNS 区域的标签。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns zone
获取 DNS 区域详细信息。
ibmcloud dns zone ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- DNS 区域的 ID。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。ibmcloud dns zone-update
更新 DNS 区域的描述和标签。
ibmcloud dns zone-update ZONE_ID [-d, --description DESC] [-l, --label LABEL] [--instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- DNS 区域的 ID。
- -d, --description
- 描述 DNS 区域用途的文字。
- -l, --label
- DNS 区域的标签。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns zone-delete
删除 DNS 区域。
ibmcloud dns zone-delete ZONE_ID [-i, --instance INSTANCE] [-f,--force]
命令选项
- Zone_ID
- DNS 区域的 ID。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - -f, --force
- 删除区域时不提示确认。
ibmcloud dns zones
列出服务实例的所有 DNS 区域。
ibmcloud dns zones [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。
允许的网络
使用以下 permitted-network
命令来管理允许的网络。
ibmcloud dns permitted-network-add
为 DNS 区域添加允许的网络。
ibmcloud dns permitted-network-add ZONE_ID --vpc-crn VPC_CRN [--type TYPE] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- DNS 区域的 ID。
- --type
- 允许的网络类型。 有效值:
vpc
。 - --vpc-crn
- VPC 实例的 CRN。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns permitted-network
获取允许的网络详细信息。
ibmcloud dns permitted-network ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- DNS 区域的 ID。
- PERMITTED_NETWORK_ID
- 允许网络的 ID。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns permitted-network-remove
除去允许的网络。
ibmcloud dns permitted-network-remove ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [-f,--force]
命令选项
- Zone_ID
- DNS 区域的 ID。
- PERMITTED_NETWORK_ID
- 允许网络的 ID。
- --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - -f, --force
- 删除允许的网络,无需提示确认。
ibmcloud dns permitted-networks
列出区域允许使用的网络。
ibmcloud dns permitted-networks ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- DNS 区域的 ID。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。
资源记录
使用以下 resource-record
命令管理资源记录的执行方式。
ibmcloud dns resource-record-create
为 DNS 区域创建资源记录。
ibmcloud dns resource-record-create DNS_ZONE_ID (-r, --record-content @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns resource-record-create DNS_ZONE_ID --type A --name NAME --ipv4 IP_ADDRESS [--ttl TTL]
ibmcloud dns resource-record-create DNS_ZONE_ID --type AAAA --name NAME --ipv6 IP_ADDRESS [--ttl TTL]
ibmcloud dns resource-record-create DNS_ZONE_ID --type CNAME --name NAME --cname CNAME [--ttl TTL]
ibmcloud dns resource-record-create DNS_ZONE_ID --type PTR --name NAME --ptrdname PTRDNAME [--ttl TTL]
ibmcloud dns resource-record-create DNS_ZONE_ID --type TXT --name NAME --text TEXT [--ttl TTL]
ibmcloud dns resource-record-create DNS_ZONE_ID --type MX --name NAME --exchange EXCHANGE --preference PREFERENCE [--ttl TTL]
ibmcloud dns resource-record-create DNS_ZONE_ID --type SRV --name NAME --service SERVICE --protocol PROTOCOL --priority PRIORITY --weight WEIGHT --port PORT --target TARGET [--ttl TTL]
命令选项
- Zone_ID
- DNS 区域的 ID。
- --name
- 资源记录名称。
- --type
- 资源记录类型。
- --ipv4
- IPv4 地址。
- --ipv6
- IPv6 地址。
- --cname
- 规范名称。
- --ptrdname
- 相关 A 或 AAAA 记录的主机名。
- --text
- 人类可读文本。
- --exchange
- Exchange Server 的主机名。
- --preference
- MX 记录的首选项。
- --service
- 所需服务的符号名称,以下划线
_
开头。 - --protocol
- 所需协议的符号名称。
- --port
- 目标服务器的端口号。
- --weight
- 在多个目标服务器之间分发查询的权重。
- --priority
- SRV 记录的优先级。
- --target
- 目标服务器的主机名。
- --ttl
- 生存时间,以秒为单位。 缺省值为 900。 有效值: 60,120,300,600,900,1800,3600,7200,18000,43200。
- -r, --record-content
- 用于描述 DNS 资源记录的 JSON 文件或 JSON 字符串。 请参阅
-r --record-content
的必填字段 以获取更多详细信息。 - -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
-r --record-content
的必填字段
JSON 数据中的必填字段为 type
。
资源记录类型。 有效值: A
,AAAA
,CNAME
,PTR
,TXT
,MX
和 SRV
。
- 对于类型 A,AAAA: 额外的必填字段为
name
,rdata
。name
: 资源记录名称。rdata
: 资源记录的内容。ip
: IPv4/IPv6 地址
- 额外的可选字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testA",
"type": "A",
"rdata": {
"ip": "1.2.3.4"
}
}
{
"name": "testAAAA",
"type": "AAAA",
"rdata": {
"ip": "2001:0db8:0012:0001:3c5e:7354:0000:5db1"
}
}
- 对于类型 CNAME: 额外的必填字段为
name
,rdata
。name
: 资源记录名称。rdata
:type-CNAME 资源记录的内容。cname
: 规范名称。
- 额外的可选字段为
ttl
。ttl
: 秒中的生存时间。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testCNAME",
"type": "CNAME",
"rdata": {
"cname": "example.com"
}
}
- 对于类型 PTR: 额外的必填字段为
name
,rdata
。name
: 资源记录名称。rdata
:type-PTR 资源记录的内容。ptrdname
: 相关 A 或 AAAA 记录的主机名。
- 额外选项字段为
ttl
。ttl
: 秒中的生存时间。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "1.2.3.4",
"type": "PTR",
"rdata": {
"ptrdname": "testA.example.com"
}
}
- 对于类型 TXT: 额外的必填字段为
name
和rdata
。name
: 资源记录名称。rdata
: 类型为 TXT 资源记录的内容。text
: 人类可读文本。
- 额外的可选字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testTXT",
"type":"TXT",
"rdata": {
"text": "text information"
}
}
- 对于类型 MX: 额外的必填字段为
name
,rdata
。name
: 资源记录名称。rdata
:type-MX 资源记录的内容。exchange
: Exchange Server 的主机名。preference
:MX 记录的首选项
- 额外的可选字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testMX",
"type": "MX",
"rdata": {
"preference": 10,
"exchange": "mailserver.example.com"
}
}
- 对于类型 SRV: 额外的必填字段为
name
,rdata
,service
和protocol
。name
: 资源记录名称。rdata
: 类型为 SRV 的资源记录的内容。priority
: SRV 记录的优先级。weight
: 在多个目标服务器之间分发查询的权重。port
:目标服务器的端口号。target
: 目标服务器的主机名。
service
:所需服务的符号名称,以下划线开头_
。protocol
:所需协议的符号名称。
- 额外选项字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"type": "SRV",
"name": "testSRV",
"rdata": {
"priority": 100,
"weight": 100,
"port": 8000,
"target": "siphost.com"
},
"service": "_sip",
"protocol": "udp"
}
ibmcloud dns resource-record-update
更新 DNS 区域的资源记录。
dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID (-r, --record-content @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID --name NAME --ipv4 IP_ADDRESS [--ttl TTL]
ibmcloud dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID --name NAME --ipv6 IP_ADDRESS [--ttl TTL]
ibmcloud dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID --name NAME --cname CNAME [--ttl TTL]
ibmcloud dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID [--ttl TTL]
ibmcloud dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID --name NAME --text TEXT [--ttl TTL]
ibmcloud dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID --name NAME --exchange EXCHANGE --preference PREFERENCE [--ttl TTL]
ibmcloud dns resource-record-update DNS_ZONE_ID RESOURCE_RECORD_ID --name NAME --priority PRIORITY --weight WEIGHT --port PORT --target TARGET [--service SERVICE] [--protocol PROTOCOL] [--ttl TTL]
命令选项
- Zone_ID
- DNS 区域的 ID。
- RECORD_ID
- 记录的标识。
- --name
- 资源记录名称。
- --type
- 资源记录类型。
- --ipv4
- IPv4 地址。
- --ipv6
- IPv6 地址。
- --cname
- 规范名称。
- --ptrdname
- 相关 A 或 AAAA 记录的主机名。
- --text
- 人类可读文本。
- --exchange
- Exchange Server 的主机名。
- --preference
- MX 记录的首选项。
- --service
- 所需服务的符号名称,以下划线
_
开头。 - --protocol
- 所需协议的符号名称。
- --port
- 目标服务器的端口号。
- --weight
- 在多个目标服务器之间分发查询的权重。
- --priority
- SRV 记录的优先级。
- --target
- 目标服务器的主机名。
- --ttl
- 生存时间,以秒为单位。 默认值为
900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。 - -r, --record-content
- 用于描述 DNS 资源记录的 JSON 文件或 JSON 字符串。 有关详细信息,请参阅 -r, --record-content 的必填字段。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置名称,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式,仅支持 JSON。
-r, --record-content 的必填字段
JSON 数据中的必填字段为 name
。 资源记录名称。
PTR 记录 不 需要此字段。
- 对于类型 A,AAAA: 额外的必填字段为
rdata
。rdata
: 资源记录的内容。ip
: IPv4/IPv6 地址
- 额外选项字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testA",
"rdata": {
"ip": "1.2.3.4"
}
}
{
"name": "testAAAA",
"rdata": {
"ip": "2001:0db8:0012:0001:3c5e:7354:0000:5db1"
}
}
- 对于类型 CNAME: 额外的必填字段为
rdata
。rdata
:type-PTR 资源记录的内容。cname
: 规范名称
- 额外选项字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testCNAME",
"rdata": {
"cname": "example.com"
}
}
- 对于类型 PTR: 额外选项字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"ttl": 360,
}
- 对于类型 TXT: 额外的必填字段为
rdata
。rdata
: 类型为 TXT 资源记录的内容。text
: 人类可读文本。
- 额外的可选字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testTXT",
"rdata": {
"text": "text information"
}
}
- 对于类型 MX: 额外的必填字段为
rdata
。rdata
:type-MX 资源记录的内容。exchange
: Exchange Server 的主机名。preference
:MX 记录的首选项
- 额外的可选字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testMX",
"content": "smtp.example.com",
"priority": 10
}
- 对于类型 SRV: 额外的必填字段为
rdata
,service
和protocol
。rdata
: 类型为 SRV 的资源记录的内容。priority
: SRV 记录的优先级weight
: 在多个目标服务器之间分发查询的权重。port
:目标服务器的端口号。target
: 目标服务器的主机名。
service
:所需服务的符号名称,以下划线开头_
。protocol
:所需协议的符号名称。
- 额外选项字段为
ttl
。ttl
: 生存时间 (以秒计)。 默认值为900
。 有效值:60
,120
,300
,600
,900
,1800
,3600
,7200
,18000
和43200
。
样本 JSON 数据:
{
"name": "testSRV"
"rdata": {
"priority": 100,
"weight": 100,
"port": 8000,
"target": "siphost.com"
},
"service": "_sip",
"protocol": "udp"
}
ibmcloud dns resource-record
获取 DNS 区域的资源记录详细信息。
ibmcloud dns resource-record ZONE_ID RECORD_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- DNS 区域的 ID。
- RECORD_ID
- 资源记录的标识。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置名称,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output FORMAT
- 指定输出格式。 目前,
json
是唯一受支持的格式。
ibmcloud dns resource-record-delete
删除 DNS 区域的资源记录。
ibmcloud dns resource-record-delete ZONE_ID RECORD_ID [-i, --instance INSTANCE] [-f,--force]
命令选项
Zone_ID : DNS 区域的 ID。
- RECORD_ID
- 资源记录的标识。
- -i, --instance INSTANCE
- 实例名称或标识。 如果未设置名称,则使用
ibmcloud dns instance-target
指定的上下文实例。 - -f, --force
- 删除资源记录而不提示确认。
ibmcloud dns resource-records
列出 DNS 区域的所有资源记录。
ibmcloud dns resource-records ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- DNS 区域的 ID。
- --page
- 分页结果的页码(默认为 1)。
- --per-page
- 每页的资源记录数。 最小值: 50。 最大:1000(默认 200)。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
ibmcloud instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
命令示例
列出具有分页的资源记录:
ibmcloud dns resource-records ZONE_ID --per-page 1000 --page 1
用于列出具有分页的资源记录的示例命令
ibmcloud dns resource-records ZONE_ID --per-page 1000 --page 1
ibmcloud dns resource-records-import
从 BIND 区域文件导入资源记录。
ibmcloud dns resource-records-import DNS_ZONE_ID (--file FILE) [-i, --instance INSTANCE_NAME | INSTANCE_ID] [--output FORMAT]
命令选项
- DNS_ZONE_ID
- DNS 区域的 ID。
- --file
- 要导入的 BIND 区域文件。 支持类型 :A,AAAA,CNAME,MX,PTR,SRV 和 TXT。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
从区域 f1d596fc-7e86-4b99-b912-9508167e9e56
中的 BIND 区域文件 dns_records.cfg
导入实例 dns-demo
的资源记录。
ibmcloud dns resource-records-import f1d596fc-7e86-4b99-b912-9508167e9e56 --file dns_records.cfg -i "dns-demo"
ibmcloud dns resource-records-export
将资源记录导出到 BIND 区域文件。
ibmcloud dns resource-records-export DNS_ZONE_ID [--file FILE] [-i, --instance INSTANCE_NAME | INSTANCE_ID] [--output FORMAT]
命令选项
- DNS_ZONE_ID
- DNS 区域的 ID。
- --file
- 用于保存导出的资源记录的 BIND 区域文件。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
将区域 f1d596fc-7e86-4b99-b912-9508167e9e56
中的资源记录导出到实例 dns-demo
的区域文件 dns_records.cfg
。
ibmcloud dns resource-records-export f1d596fc-7e86-4b99-b912-9508167e9e56 --file dns_records.cfg -i "dns-demo"
全局负载均衡器
使用以下 glb
命令来管理全局负载均衡器。
ibmcloud dns glb-create
在区域中创建全局负载均衡器。
ibmcloud dns glb-create DNS_ZONE_ID --name NAME --default-pools POOL_LIST --fallback-pool POOL_ID [--description DESCRIPTION] [--enabled true|false] [--ttl TTL] [--az-pools AZPOOLS1 --az-pools AZPOOLS2] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-create DNS_ZONE_ID (-j, --json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- DNS_DOMAIN_ID
-
DNS 区域的 ID。 必需。
- --json
-
用于描述全局负载平衡器的 JSON 文件或 JSON 字符串。 必需。
- JSON 数据中的必填字段为
name
,fallback_pool
和default_pools
:name
:要与负载平衡器关联的 DNS 主机名。fallback_pool
:检测到所有其他池为不健康时使用的池 ID。default_pools
:按故障转移优先级排序的池 ID 列表。
- 可选字段为
description
,ttl
,az_pools
和enabled
:description
: 负载均衡器的描述性文本。ttl
:此负载平衡器返回的 IP 地址的 DNS 条目的存活时间 (TTL)。az_pools
:区域和国家代码与区域内池 ID 列表(按故障转移优先级排序)的映射。enabled
:确定是否启用负载平衡器池。 有效值:true
、false
。on
和off
已被弃用。
样本 JSON 数据:
{ "name": "glb01", "description": "Global load balancer 01", "enabled": false, "ttl": 300, "default_pools": ["cc1deb57-0eb4-45cb-94ce-a3c71c189d12"], "fallback_pool": "cc1deb57-0eb4-45cb-94ce-a3c71c189d12", "az_pools": [ { "availability_zone": "us-south-1", "pools": [ "0fc0bb7c-2fab-476e-8b9b-40fa14bf8e3d" ] }, { "availability_zone": "us-south-2", "pools": [ "f46eba57-f08e-4e38-a76c-f3370d457bd2" ] } ] }
- JSON 数据中的必填字段为
- --name
-
与负载均衡器相关联的 DNS 主机名。
- --fallback-pool
-
检测到其他所有池均为不正常运行时要使用的池标识。
- --default-pools
-
按照故障转移优先级对池标识列表进行排序。
- --description
-
负载均衡器的描述性文本。
- --ttl
-
由该负载均衡器返回的 IP 地址的 DNS 条目的生存时间 (TTL)。
- --az-pools
-
区域和国家代码与区域内池 ID 列表(按故障转移优先级排序)的映射。
- --enabled
-
确定是否启用负载平衡器池。 有效值:
true
,false
. - -i, --instance
-
实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
-
指定输出格式。 目前,
json
是唯一受支持的格式。
示例
在区域 demo.com:31984fea73a15b45779fa0df4ef62f9b
中创建全局负载平衡器。
ibmcloud dns glb-create demo.com:31984fea73a15b45779fa0df4ef62f9b --json @glb.json -i "dns-demo"
ibmcloud dns glb-update
更新区域中的全局负载均衡器。
ibmcloud dns glb-update DNS_ZONE_ID GLB_ID (-j, --json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-update DNS_ZONE_ID GLB_ID [--name NAME] [--default-pools POOL_LIST] [--fallback-pool POOL_ID] [--description DESCRIPTION] [--enabled true|false] [--ttl TTL] [--az-pools AZPOOLS1 --az-pools AZPOOLS2] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- DNS_DOMAIN_ID
-
DNS 区域的 ID。 必需。
- GLB_ID
-
全局负载平衡器的 ID。 必需。
- --json
-
用于描述全局负载平衡器的 JSON 文件或 JSON 字符串。 必需。
- 可选字段为
name
,fallback_pool
,default_pools
,description
,ttl
,az_pools
和enabled
:name
:要与负载平衡器关联的 DNS 主机名。fallback_pool
:检测到所有其他池为不健康时使用的池 ID。default_pools
:按故障转移优先级排序的池 ID 列表。description
: 负载均衡器的描述性文本。ttl
:此负载平衡器返回的 IP 地址的 DNS 条目的存活时间 (TTL)。az_pools
:区域和国家代码与区域内池 ID 列表(按故障转移优先级排序)的映射。enabled
:确定是否启用负载平衡器池。 有效值:true
、false
。on
、off
值已被弃用。
样本 JSON 数据:
{ "name": "glb01", "description": "Global load balancer 01", "enabled": false, "ttl": 300, "default_pools": ["cc1deb57-0eb4-45cb-94ce-a3c71c189d12"], "fallback_pool": "cc1deb57-0eb4-45cb-94ce-a3c71c189d12", "az_pools": [ { "availability_zone": "us-south-1", "pools": [ "0fc0bb7c-2fab-476e-8b9b-40fa14bf8e3d" ] }, { "availability_zone": "us-south-2", "pools": [ "f46eba57-f08e-4e38-a76c-f3370d457bd2" ] } ] }
- 可选字段为
- --name
-
与负载均衡器相关联的 DNS 主机名。
- --fallback-pool
-
检测到其他所有池均为不正常运行时要使用的池标识。
- --default-pools
-
按照故障转移优先级对池标识列表进行排序。
- --description
-
负载均衡器的描述性文本。
- --ttl
-
由该负载均衡器返回的 IP 地址的 DNS 条目的生存时间 (TTL)。
- --az-pools
-
区域和国家代码与区域内池 ID 列表(按故障转移优先级排序)的映射。
- --enabled
-
确定是否启用负载平衡器池。 有效值:
true
,false
. - -i, --instance
-
实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
-
指定输出格式。 目前,
json
是唯一受支持的格式。
示例
更新区域 demo.com:31984fea73a15b45779fa0df4ef62f9b
中的全局负载均衡器 699d98642c564d2e855e9661899b7252
。
ibmcloud dns glb-update demo.com:31984fea73a15b45779fa0df4ef62f9b 699d98642c564d2e855e9661899b7252 --json @glb.json -i "dns-demo"
ibmcloud dns glb
在区域中显示全局负载均衡器。
ibmcloud dns glb DNS_DOMAIN_ID GLB_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- DNS_DOMAIN_ID
- DNS 区域的 ID。 必需。
- GLB_ID
- 全局负载平衡器的 ID。 必需。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
在区域 demo.com:31984fea73a15b45779fa0df4ef62f9b
中显示全局负载均衡器 699d98642c564d2e855e9661899b7252
。
ibmcloud dns glb demo.com:31984fea73a15b45779fa0df4ef62f9b 699d98642c564d2e855e9661899b7252 -i "dns-demo"
ibmcloud dns glb-delete
删除 DNS 域中的全局负载平衡器。
ibmcloud dns glb-delete DNS_DOMAIN_ID GLB_ID [-i, --instance INSTANCE] [-f,--force]
命令选项
- DNS_DOMAIN_ID
- DNS 区域的 ID。 必需。
- GLB_ID
- 全局负载平衡器的 ID。 必需。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - -f, --force
- 删除负载均衡器而不提示确认。
示例
删除区域 demo.com:31984fea73a15b45779fa0df4ef62f9b
中的全局负载均衡器 699d98642c564d2e855e9661899b7252
。
ibmcloud dns glb-delete demo.com:31984fea73a15b45779fa0df4ef62f9b 699d98642c564d2e855e9661899b7252 -f -i "dns-demo"
ibmcloud dns glbs
列出区域的所有负载平衡器。
ibmcloud dns glbs DNS_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- DNS_DOMAIN_ID
- DNS 区域的 ID。 必需。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
列示区域 demo.com:31984fea73a15b45779fa0df4ef62f9b
的负载均衡器。
ibmcloud dns glbs demo.com:31984fea73a15b45779fa0df4ef62f9b -i "dns-demo"
ibmcloud dns glb-pool-create
为服务实例创建 GLB 池。
ibmcloud dns glb-pool-create (-j, --json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-pool-create --name NAME --origins ORIGIN1 --origins ORIGIN2 [--description DESCRIPTION] [--enabled true|false] [--healthy-origins-threshold THRESHOLD] [--monitor MONITOR_ID] [--notification-channel CHANNEL] [--healthcheck-region REGION] [--healthcheck-subnets SUBNETS] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- --json
-
用于描述全局负载平衡器池的 JSON 文件或 JSON 字符串。 必需。
-
JSON 数据中的必填字段是
name
,origins
:name
:负载平衡器池的名称。origins
:该池中的起源列表。
-
可选字段为
description
,healthy_origins_threshold
,enabled
,monitor
,notification_channel
,healthcheck_region
和healthcheck_subnets
:description
: 负载均衡器池的描述性文本。healthy_origins_threshold
:该池为流量提供服务时必须保持健康的最小起源数。enabled
:确定是否启用负载平衡器池。 有效值:true
,false
.monitor
:要与此池关联的负载平衡器监控器的 ID。notification_channel
: 通知通道。healthcheck_region
:VSI 的运行状况检查区域。 有效值:us-south
,us-east
,eu-gb
,eu-du
,au-syd
,jp-tok
,br-sao
和ca-tor
。healthcheck_subnets
: VSI 的运行状况检查子网标识的列表。
通过连接监视器创建池时,DNS Services 将从运行状况检查子网中获取一个地址。 确保该健康检查子网有足够的可用 IP 地址。
样本 JSON 数据:
{ "name": "us-pool", "description": "application server pool in US", "origins": [ { "name": "us-app-dal10", "description": "dallas origin 10", "address": "1.1.1.1", "enabled": true }, { "name": "us-app-dal12", "description": "dallas origin 12", "address": "2.2.2.2", "enabled": true } ], "healthy_origins_threshold": 1, "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc", "enabled": true, "notification_channel": "https://mywebsite.com/dns/webhook", "healthcheck_region": "us-south", "healthcheck_subnets": ["0716-a4c0c123-594c-4ef4-ace3-a08858540b5e"] }
-
- --name
-
负载平衡器池的名称。
- --description
-
负载均衡器池的描述性文本。
- --healthy-origins-threshold
-
该池为流量提供服务时必须保持健康的最少源点数量。
- --enabled
-
确定是否启用负载平衡器池。 有效值:
true
,false
. - --monitor
-
要与此池关联的负载平衡器监控器的 ID。
- --notification-channel
-
通知通道。
- 运行状况检查-区域
-
VSI 的运行状况检查区域。 有效值:
us-south
,us-east
,eu-gb
,eu-du
,au-syd
和jp-tok
。 - 运行状况检查-子网
-
VSI 的运行状况检查子网标识的列表。
- -i, --instance
-
实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
-
指定输出格式。 目前,
json
是唯一受支持的格式。
示例
为实例 dns-demo
创建 GLB 池。
ibmcloud dns glb-pool-create --json @glb-pool.json -i "dns-demo"
ibmcloud dns glb-pool-update
更新 GLB 数据库的详细信息。
ibmcloud dns glb-pool-update GLB_POOL_ID [--name NAME] [--enable-origin ORIGIN_NAME --enable-origin ORIGIN_NAME ...] [--disable-origin ORIGIN_NAME --disable-origin ORIGIN_NAME ...] [--add-origin ORIGIN_PARAMETER --add-origin ORIGIN_PARAMETER ...] [--remove-origin ORIGIN_NAME --remove-origin ORIGIN_NAME ...] [--description DESCRIPTION] [--enabled true|false] [--healthy-origins-threshold THRESHOLD] [-detach-monitor] [--attach-monitor MONITOR_ID] [--healthcheck-region REGION] [--healthcheck-subnets SUBNETS] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-pool-update GLB_POOL_ID (-j, --json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- GLB_POOL_ID
-
全局负载平衡器池的 ID。 必需。
- --json
-
用于描述 GLB 池的 JSON 文件或 JSON 字符串。 必需。
- 可选字段为
name
,origins
,description
,healthy_origins_threshold
,enabled
,monitor
,notification_channel
,healthcheck_region
和healthcheck_subnets
:name
:负载平衡器池的名称。origins
:该池中的起源列表。description
: 负载均衡器池的描述性文本。healthy_origins_threshold
:该池为流量提供服务时必须保持健康的最小起源数。enabled
:确定是否启用负载平衡器池。 有效值:true
,false
.monitor
:要与此池关联的负载平衡器监控器的 ID。notification_channel
: 通知通道。healthcheck_region
:VSI 的运行状况检查区域。 有效值:us-south
,us-east
,eu-gb
,eu-du
,au-syd
,jp-tok
,br-sao
和ca-tor
。healthcheck_subnets
: VSI 的运行状况检查子网标识的列表。
样本 JSON 数据:
{ "name": "us-pool", "description": "application server pool in US", "origins": [ { "name": "us-app-dal10", "description": "dallas origin 10", "address": "1.1.1.1", "enabled": true }, { "name": "us-app-dal12", "description": "dallas origin 12", "address": "2.2.2.2", "enabled": true } ], "healthy_origins_threshold": 1, "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc", "enabled": true, "notification_channel": "https://mywebsite.com/dns/webhook", "healthcheck_region": "us-south", "healthcheck_subnets": ["0716-a4c0c123-594c-4ef4-ace3-a08858540b5e"] }
- 可选字段为
- --name
-
负载平衡器池的名称。
- --description
-
负载均衡器池的描述性文本。
- --enable-origin
-
启用池中的源。 值可以为 ORIGIN_NAME 或 ORIGIN_ADDRESS。
- --disable-origin
-
禁用池中的源。 值可以为 ORIGIN_NAME 或 ORIGIN_ADDRESS。
- --add-origin
-
向池添加源。 需要提供 ORIGIN_NAME 和 ORIGIN_ADDRESS。 例如,
--add-origin name=example,address=1.2.3.4,enabled=true,description=origin_description
。 - --remove-origin
-
从池中移除源。 值可以为 ORIGIN_NAME 或 ORIGIN_ADDRESS。
- --detach-monitor
-
从源池拆离监视器。
- --attach-monitor
-
将监视器连接到源池。
- --healthy-origins-threshold
-
该池为流量提供服务时必须保持健康的最少源点数量。
- --enabled
-
确定是否启用负载平衡器池。 有效值:
true
,false
. - 运行状况检查-区域
-
VSI 的运行状况检查区域。 有效值:
us-south
,us-east
,eu-gb
,eu-du
,au-syd
,jp-tok
,br-sao
和ca-tor
。 - 运行状况检查-子网
-
VSI 的运行状况检查子网标识的列表。
- -i, --instance
-
实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
-
指定输出格式。 目前,
json
是唯一受支持的格式。
示例
更新实例 dns-demo
的 GLB 池 17b5962d775c646f3f9725cbc7a53df4
。
ibmcloud dns glb-pool-update 17b5962d775c646f3f9725cbc7a53df4 --json @glb-pool.json -i "dns-demo"
ibmcloud dns glb-pool
显示 GLB 池的详细信息。
ibmcloud dns glb-pool GLB_POOL_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- GLB_POOL_ID
- 全局负载平衡器池的 ID。 必需。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
显示 GLB 池的详细信息 17b5962d775c646f3f9725cbc7a53df4
。
ibmcloud dns glb-pool 17b5962d775c646f3f9725cbc7a53df4 -i "dns-demo"
ibmcloud dns glb-pool-delete
删除 GLB 池。
ibmcloud dns glb-pool-delete GLB_POOL_ID [-i, --instance INSTANCE] [-f,--force]
命令选项
- GLB_POOL_ID
- 全局负载平衡器池的 ID。 必需。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - -f, --force
- 删除负载均衡器池而不提示确认。
示例
删除 GLB 池 17b5962d775c646f3f9725cbc7a53df4
。
ibmcloud dns glb-pool-delete 17b5962d775c646f3f9725cbc7a53df4 -f -i "dns-demo"
ibmcloud dns glb-pools
列出服务实例的所有 GLB 池。
ibmcloud dns glb-pools [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
列出实例 dns-demo
的所有 GLB 池。
ibmcloud dns glb-pools -i "dns-demo"
ibmcloud dns glb-monitor-create
为服务实例创建 GLB 监控程序。
ibmcloud dns glb-monitor-create (-j, --json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-monitor-create --name NAME --type TCP [--port PORT] [--description DESCRIPTION] [--interval INTERVAL] [--retries RETRY] [--timeout TIMEOUT] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-monitor-create --name NAME --type (HTTP|HTTPS) --path PATH [--port PORT] [--description DESCRIPTION] [--method GET|HEAD] [--headers HEADER1 --headers HEADER2...] [--interval INTERVAL] [--retries RETRY] [--timeout TIMEOUT] [--allow-insecure true|false] [--expected-body BODY] [--expected-codes CODE] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- --json
-
用于描述 GLB 监控程序的 JSON 文件或 JSON 字符串。 必需。
- JSON 数据中的必填字段是
name
,type
。name
:负载平衡器监控器的名称。type
:用于健康检查的协议。 有效值:HTTP
,HTTPS
和TCP
。
- 可选字段为
description
,timeout
,retries
和interval
。description
: 负载均衡器监视器的描述性文本。timeout
:健康检查标记为失败前的超时(秒)。 有效值:1-10
。retries
:原点被标记为不健康之前发生超时时尝试重试的次数。 有效值:0-3
。interval
:每次健康检查的间隔时间。 有效值:60-3600
。
- 用于
TCP
类型的健康检查。 额外的必填字段是port
。port
: 用于健康检查的 TCP 端口。
- 用于
HTTP/HTTPS
类型的健康检查。 额外的必填字段是expected_codes
。expected_codes
:健康检查的预期 HTTP 响应代码或代码范围。 有效值:200
,201
,202
,203
,204
,205
,206
,207
,208
,226
和2xx
。
- 额外的选项字段为
port
,expected_body
,method
,path
,header
和allow_insecure
。port
:健康检查连接的端口号。expected_body
:在响应正文中查找的不区分大小写的子字符串。method
:用于健康检查的方法,适用于基于 HTTP/HTTPS 的检查。 有效值:GET
,HEAD
.path
:要进行健康检查的端点路径。header
:在健康检查中要发送的 HTTP 请求头。allow_insecure
:监控器使用 HTTPS 时不验证证书。 有效值:true
,false
.
样本 JSON 数据:
对于 HTTP/HTTPS:
{ "name": "glbmonitor", "description": "Health monitor of web service", "type": "HTTPS", "method": "GET", "path": "/health", "headers": [ { "name": "Host", "value": ["glb.example.com"] }, { "name": "X-App-ID", "value":["abc123"] } ], "port": 443, "timeout": 5, "retries": 2, "interval": 90, "allow_insecure": false, "expected_codes": "2xx", "expected_body": "alive" }
对于 TCP:
{ "name": "glbmonitor", "description": "Health monitor of TCP", "type": "TCP", "port": 80, "timeout": 5, "retries": 2, "interval": 90 }
- JSON 数据中的必填字段是
- --name
-
负载平衡器监控器的名称。
- --type
-
用于运行状况检查的协议。 有效值:
HTTP
,HTTPS
和TCP
。 - --description
-
负载均衡器监视器的描述性文本。
- --timeout
-
健康检查标记为失败前的超时(秒)。 有效值:
1-10
。 - --retries
-
当发生超时时,在将原点标记为不健康之前尝试重试的次数。 有效值:
0-3
。 - --interval
-
每个运行状况检查之间的时间间隔。 有效值:
60-3600
。 - --port
-
健康检查连接的端口号。
- --expected-codes
-
预期的运行状况检查的 HTTP 响应代码或代码范围。 有效值:
200
,201
,202
,203
,204
,205
,206
,207
,208
,226
,2xx
. - --expected-body
-
在响应正文中查找的不区分大小写的子字符串。
- --method
-
用于健康检查的方法,适用于基于 HTTP/HTTPS 的检查。 有效值:
GET
,HEAD
. - --path
-
运行状况检查所依据的端点路径。
- --headers
-
要在运行状况检查中发送的 HTTP 请求头。
- --allow-insecure
-
监控器使用 HTTPS 时不验证证书。 有效值:
on
,off
. - -i, --instance
-
实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
-
指定输出格式。 目前,
json
是唯一受支持的格式。
示例
在实例 dns-demo
中创建 GLB 监视器。
ibmcloud dns glb-monitor-create --json @glb-monitor.json -i "dns-demo"
ibmcloud dns glb-monitor-update
更新服务实例的 GLB 监控程序。
ibmcloud dns glb-monitor-update GLB_MON_ID (-j, --json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-monitor-update GLB_MON_ID [--name NAME] [--type TCP] [--port PORT] [--description DESCRIPTION] [--interval INTERVAL] [--retries RETRY] [--timeout TIMEOUT] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud dns glb-monitor-update GLB_MON_ID [--name NAME] [--type HTTP|HTTPS] [--expected-codes CODE] [--path PATH] [--port PORT] [--description DESCRIPTION] [--method GET|HEAD] [--headers HEADER1 --headers HEADER2...] [--interval INTERVAL] [--retries RETRY] [--timeout TIMEOUT] [--allow-insecure true|false] [--expected-body BODY] [--expected-codes CODE] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- GLB_MON_ID
-
全局负载平衡器监控器的 ID。 必需。 --json
-
用于描述 GLB 监控程序的 JSON 文件或 JSON 字符串。 必需。
- 可选字段为
name
,type
,description
,timeout
,retries
和interval
。name
:负载平衡器监控器的名称。type
:用于健康检查的协议。 有效值:HTTP
,HTTPS
和TCP
。description
: 负载均衡器监视器的描述性文本。timeout
:健康检查标记为失败前的超时(秒)。 有效值:1-10
。retries
:原点被标记为不健康之前发生超时时尝试重试的次数。 有效值:0-3
。interval
:每次健康检查的间隔时间。 有效值:60-3600
。
- 用于
TCP
类型的健康检查。 额外选项字段为port
。port
: 用于健康检查的 TCP 端口。
- 用于
HTTP/HTTPS
类型的健康检查。 额外的选项字段为expected_codes
,port
,expected_body
,method
,path
,header
和allow_insecure
。expected_codes
:健康检查的预期 HTTP 响应代码或代码范围。 有效值:200
,201
,202
,203
,204
,205
,206
,207
,208
,226
和2xx
。port
:健康检查连接的端口号。expected_body
:在响应正文中查找的不区分大小写的子字符串。method
:用于健康检查的方法,适用于基于 HTTP/HTTPS 的检查。 有效值:GET
,HEAD
.path
:要进行健康检查的端点路径。header
:在健康检查中要发送的 HTTP 请求头。allow_insecure
:监控器使用 HTTPS 时不验证证书。 有效值:on
,off
.
样本 JSON 数据:
对于 HTTP/HTTPS:
{ "name": "glbmonitor", "description": "Health monitor of web service", "type": "HTTPS", "method": "GET", "path": "/health", "headers": [ { "name": "Host", "value": ["glb.example.com"] }, { "name": "X-App-ID", "value":["abc123"] } ], "port": 443, "timeout": 5, "retries": 2, "interval": 90, "allow_insecure": false, "expected_codes": "2xx", "expected_body": "alive" }
对于 TCP:
{ "name": "glbmonitor", "description": "Health monitor of TCP", "type": "TCP", "port": 80, "timeout": 5, "retries": 2, "interval": 90 }
- 可选字段为
- --name
-
负载平衡器监控器的名称。
- --type
-
用于运行状况检查的协议。 有效值:
HTTP
,HTTPS
和TCP
。 - --description
-
负载均衡器监视器的描述性文本。
- --timeout
-
健康检查标记为失败前的超时(秒)。 有效值:
1-10
。 - --retries
-
当发生超时时,在将原点标记为不健康之前尝试重试的次数。 有效值:
0-3
。 - --interval
-
每个运行状况检查之间的时间间隔。 有效值:
60-3600
。 - --port
-
健康检查连接的端口号。
- --expected-codes
-
预期的运行状况检查的 HTTP 响应代码或代码范围。 有效值:
200
,201
,202
,203
,204
,205
,206
,207
,208
,226
,2xx
. - --expected-body
-
在响应正文中查找的不区分大小写的子字符串。
- --method
-
用于健康检查的方法,适用于基于 HTTP/HTTPS 的检查。 有效值:
GET
,HEAD
. - --path
-
运行状况检查所依据的端点路径。
- --headers
-
要在运行状况检查中发送的 HTTP 请求头。
- --allow-insecure
-
监控器使用 HTTPS 时不验证证书。 有效值:
on
,off
. - -i, --instance
-
实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
-
指定输出格式。 目前,
json
是唯一受支持的格式。
示例
更新实例 dns-demo
中的 GLB 监视器 f1aba936b94213e5b8dca0c0dbf1f9cc
。
ibmcloud dns glb-monitor-update f1aba936b94213e5b8dca0c0dbf1f9cc --json @glb-monitor.json -i "dns-demo"
ibmcloud dns glb-monitor
显示全局负载平衡器监控器的详细信息。
ibmcloud dns glb-monitor GLB_MON_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- GLB_MON_ID
- 全局负载平衡器监控器的 ID。 必需。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
显示 GLB 监视器的详细信息 f1aba936b94213e5b8dca0c0dbf1f9cc
。
ibmcloud dns glb-monitor f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"
ibmcloud dns glb-monitor-delete
删除服务实例的 GLB 监控程序。
ibmcloud dns glb-monitor-delete GLB_MON_ID [-i, --instance INSTANCE] [-f,--force]
命令选项
- GLB_MON_ID
- 全局负载平衡器监控器的 ID。 必需。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - -f, --force
- 删除负载均衡器监视器而不提示确认。
示例
删除 GLB 监视器 f1aba936b94213e5b8dca0c0dbf1f9cc
。
ibmcloud dns glb-monitor-delete f1aba936b94213e5b8dca0c0dbf1f9cc -f -i "dns-demo"
ibmcloud dns glb-monitors
列出服务实例的 GLB 监控程序。
ibmcloud dns glb-monitors [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
列出实例 dns-demo
的所有 GLB 监视器。
ibmcloud dns glb-monitors -i "dns-demo"
定制解析器
使用以下定制解析器命令来管理定制解析器。
ibmcloud dns custom-resolver-create
为服务实例创建定制解析器。
ibmcloud dns custom-resolver-create --name NAME [--location LOCATION1] [--location LOCATION2] [-description DESCRIPTION] [-f, --force] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- -n, --name
- 自定义解析器的名称。
- -d, --description
- 定制解析器的描述性文本。
- -f, --force
- 允许创建少于 2 个位置的自定义解析器。
- --location
- 自定义解析器运行的位置。 位置子网 CRN 是必需的。 例如,
--location subnet1,enable --location subnet2,disable
。 - -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
为实例 dns-demo
创建定制解析器。
ibmcloud dns custom-resolver-create --name "example" --location crn:v1:bluemix:public:is:us-south-1:a/01652b251c3ae2787110a995d8db0135::subnet:0716-b49ef064-0f89-4fb1-8212-135b12568f04,enable --description "demo" -i "dns-demo"
ibmcloud dns custom-resolver-update
更新服务实例的定制解析器。
ibmcloud dns custom-resolver-update RESOLVER_ID [--name NAME] [--enabled true|false] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- -n, --name
- 自定义解析器的名称。
- -d, --description
- 定制解析器的描述性文本。
- --enabled
- 决定是否启用自定义解析器。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
更新实例 dns-demo
的定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
。
ibmcloud dns custom-resolver-update f1aba936b94213e5b8dca0c0dbf1f9cc --name "example" --enabled true -description "demo" -i "dns-demo"
ibmcloud dns custom-resolver
获取服务实例的自定义解析器详细信息。
ibmcloud dns custom-resolver RESOLVER_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
获取实例 dns-demo
的定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
。
ibmcloud dns custom-resolver f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"
ibmcloud dns custom-resolvers
列出服务实例的自定义解析器。
ibmcloud dns custom-resolvers [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
列出实例 dns-demo
的定制解析器。
ibmcloud dns custom-resolvers -i "dns-demo"
ibmcloud dns custom-resolver-delete
删除服务实例的定制解析器。
ibmcloud dns custom-resolver-delete RESOLVER_ID [-i, --instance INSTANCE] [-f, --force]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --f, --force
- 删除定制解析器而不提示确认。
示例
删除实例 dns-demo
的定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
。
ibmcloud dns custom-resolver-delete f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"
ibmcloud dns custom-resolver-location-add
为服务实例添加自定义解析器位置。
ibmcloud dns custom-resolver-location-add RESOLVER_ID --subnet SUBNET_CRN [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- --subnet
- 子网的 CRN。
- --enabled
- 确定是否启用自定义解析器位置。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
在自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中添加一个位置,例如 dns-demo
。
ibmcloud dns custom-resolver-location-add f1aba936b94213e5b8dca0c0dbf1f9cc --subnet crn:v1:bluemix:public:is:us-south-1:a/01652b251c3ae2787110a995d8db0135::subnet:0716-b49ef064-0f89-4fb1-8212-135b12568f04 --enabled true -i "dns-demo"
ibmcloud dns custom-resolver-location-update
更新服务实例的自定义解析器位置。
ibmcloud dns custom-resolver-location-update RESOLVER_ID LOCATION_ID [--subnet SUBNET_CRN] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- LOCATION_ID
- 自定义解析器位置的 ID。
- --subnet
- 子网的 CRN。
- --enabled
- 确定是否启用自定义解析器位置。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
更新自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中的位置 9a234ede-c2b6-4c39-bc27-d39ec139ecdb
,例如 dns-demo
。
ibmcloud dns custom-resolver-location-update f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb --subnet crn:v1:bluemix:public:is:us-south-1:a/01652b251c3ae2787110a995d8db0135::subnet:0716-b49ef064-0f89-4fb1-8212-135b12568f04 --enabled true -i "dns-demo"
ibmcloud dns custom-resolver-location-delete
删除服务实例的自定义解析器位置。
ibmcloud dns custom-resolver-location-delete RESOLVER_ID LOCATION_ID [-i, --instance INSTANCE] [-f, --force]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- LOCATION_ID
- 自定义解析器位置的 ID。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --f, --force
- 删除自定义解析器位置,不提示确认。
示例
删除自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中的位置 9a234ede-c2b6-4c39-bc27-d39ec139ecdb
,例如 dns-demo
。
ibmcloud dns custom-resolver-location-delete f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb -i "dns-demo"
ibmcloud dns custom-resolver-forwarding-rule-create
为服务实例创建定制解析器转发规则。
ibmcloud dns custom-resolver-forwarding-rule-create RESOLVER_ID --type TYPE --match HOSTNAME --dns-svcs IPs [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- -t, --type
- 转发规则的类型。 有效值: "zone"。
- -d, --description
- 定制解析器转发规则的描述性文本。
- --match
- 匹配的区域或主机名。
- --dns-svcs
- 上游 DNS 服务器被转发到,例如
ip1
,ip2
. - -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
在自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中创建转发规则,例如 dns-demo
。
ibmcloud dns custom-resolver-forwarding-rule-create f1aba936b94213e5b8dca0c0dbf1f9cc --type zone --match "example.com" --dns-svcs 192.168.0.1,192.168.0.2 --description "demo" -i "dns-demo"
ibmcloud dns custom-resolver-forwarding-rule-update
更新服务实例的定制解析器转发规则。
ibmcloud dns custom-resolver-forwarding-rule-update RESOLVER_ID RULE_ID [--match HOSTNAME] [--dns-svcs IPs] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- RULE_ID
- 定制解析器转发规则的标识。
- -d, --description
- 定制解析器转发规则的描述性文本。
- --match
- 匹配的区域或主机名。
- --dns-svcs
- 上游 DNS 服务器被转发到,例如
ip1
,ip2
. - -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
更新自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中的转发规则 9a234ede-c2b6-4c39-bc27-d39ec139ecdb
,例如 dns-demo
。
ibmcloud dns custom-resolver-forwarding-rule-update f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb --type zone --match "example.com" --dns-svcs 192.168.0.1,192.168.0.2 --description "demo" -i "dns-demo"
ibmcloud dns custom-resolver-forwarding-rule
获取服务实例的自定义解析器转发规则详细信息。
ibmcloud dns custom-resolver-forwarding-rule RESOLVER_ID RULE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- RULE_ID
- 定制解析器转发规则的标识。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
在自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中获取转发规则 9a234ede-c2b6-4c39-bc27-d39ec139ecdb
,例如 dns-demo
。
ibmcloud dns custom-resolver-forwarding-rule f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb -i "dns-demo"
ibmcloud dns custom-resolver-forwarding-rules
列出服务实例的定制解析器转发规则。
ibmcloud dns custom-resolver-forwarding-rules RESOLVER_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
列出自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中的转发规则,例如 dns-demo
。
ibmcloud dns custom-resolver-forwarding-rules f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"
ibmcloud dns custom-resolver-forwarding-rule-delete
删除服务实例的定制解析器转发规则。
ibmcloud dns custom-resolver-forwarding-rule-delete RESOLVER_ID RULE_ID [-i, --instance INSTANCE] [-f, --force]
命令选项
- RESOLVER_ID
- 定制解析器的标识。
- RULE_ID
- 自定义解析器转发规则的 ID。
- -i, --instance
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - -f, --force
- 删除自定义解析器转发规则,不提示确认。
示例
删除自定义解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
中的转发规则 9a234ede-c2b6-4c39-bc27-d39ec139ecdb
,例如 dns-demo
。
ibmcloud dns custom-resolver-forwarding-rule-delete f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb -i "dns-demo"
辅助区域
使用以下辅助区域命令来管理辅助区域。
ibmcloud dns secondary-zone-create
为给定定制解析器创建辅助区域。
ibmcloud dns secondary-zone-create RESOLVER_ID --name NAME --transfer-from ADDRESS1,ADDRESS2 [--description DESCRIPTION] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。 必需。
- --name 值
- 辅助区域的域名。
- --transfer-from 值
- 辅助区的源地址。
- --description 值
- 二级区域的描述。
- --enabled 值
- 确定是否启用辅助区段。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
为定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
创建辅助区域。
ibmcloud dns secondary-zone-create f1aba936b94213e5b8dca0c0dbf1f9cc --name "test.com" --transfer-from 169.13.12.10 -i "dns-demo"
ibmcloud dns secondary-zone-update
更新辅助区域。
ibmcloud dns secondary-zone-update RESOLVER_ID SECONDARY_ZONE_ID [--transfer-from ADDRESS1,ADDRESS2] [--description DESCRIPTION] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。 必需。
- SECONDARY_ZONE_ID
- 辅助区的 ID。 必需。
- --transfer-from 值
- 辅助区的源地址。
- --description 值
- 二级区域的描述。
- --enabled 值
- 确定是否启用辅助区段。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
更新定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
的辅助区域 e2aba136a93212e5a8dce0c2dbf6f2ee
。
ibmcloud dns secondary-zone-update f1aba936b94213e5b8dca0c0dbf1f9cc e2aba136a93212e5a8dce0c2dbf6f2ee --transfer-from 169.13.12.10:53 -i "dns-demo"
ibmcloud dns secondary-zone
获取辅助区域的详细信息。
ibmcloud dns secondary-zone RESOLVER_ID SECONDARY_ZONE_ID [-i, --instance INSTANCE_NAME] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。 必需。
- SECONDARY_ZONE_ID
- 辅助区的 ID。 必需。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
获取定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
的辅助区域 e2aba136a93212e5a8dce0c2dbf6f2ee
。
ibmcloud dns secondary-zone f1aba936b94213e5b8dca0c0dbf1f9cc e2aba136a93212e5a8dce0c2dbf6f2ee -i "dns-demo"
ibmcloud dns secondary-zones
列出所有辅助区域。
ibmcloud dns secondary-zones RESOLVER_ID [-i, --instance INSTANCE_NAME] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。 必需。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
列出定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
的所有辅助区域。
ibmcloud dns secondary-zones f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"
ibmcloud dns secondary-zone-delete
删除辅助区域。
ibmcloud dns secondary-zone-delete RESOLVER_ID SECONDARY_ZONE_ID [-i, --instance INSTANCE_NAME] [--output FORMAT]
命令选项
- RESOLVER_ID
- 定制解析器的标识。 必需。
- SECONDARY_ZONE_ID
- 辅助区的 ID。 必需。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
删除定制解析器 f1aba936b94213e5b8dca0c0dbf1f9cc
的辅助区域 e2aba136a93212e5a8dce0c2dbf6f2ee
。
ibmcloud dns secondary-zone-delete f1aba936b94213e5b8dca0c0dbf1f9cc e2aba136a93212e5a8dce0c2dbf6f2ee -i "dns-demo"
跨帐户访问权
使用以下跨帐户访问命令来管理跨帐户。
ibmcloud dns cross-account linked-zone-create
创建链接区域。
ibmcloud dns cross-account linked-zone-create --owner-instance-id OWNER_INSTANCE_ID --owner-zone-id OWNER_ZONE_ID [--label LABEL] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- --owner-instance-id 值
- 所有者实例的 ID。
- --owner-zone-id 值
- 所有者区域的 ID。
- --label 值
- 链接区域的标签。
- --description 值
- 链接区域的描述。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone-create --owner-instance-id abe30019-1c08-42dc-9ad9-a0682af70054 --owner-zone-id 05855abe-3908-4cdc-bf0d-063e0b1c296d --description "linked zone example" --label "dev" -i "dns-demo"
ibmcloud dns cross-account linked-zone-update
更新链接区域。
ibmcloud dns cross-account linked-zone-update LINKED_ZONE_ID [--label LABEL] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- LINKED_ZONE_ID
- 链接区的 ID。
- --label 值
- 链接区域的标签。
- --description 值
- 链接区域的描述。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone-update 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 --description "linked zone example" --label "dev" -i "dns-demo"
ibmcloud dns cross-account linked-zones
列出所有链接的区域。
ibmcloud dns cross-account linked-zones [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zones -i "dns-demo"
ibmcloud dns cross-account linked-zone
获取链接区域的详细信息。
ibmcloud dns cross-account linked-zone LINKED_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- LINKED_ZONE_ID
- 链接区的 ID。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 -i "dns-demo"
ibmcloud dns cross-account linked-zone-delete
删除链接区域。
ibmcloud dns cross-account linked-zone-delete LINKED_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- LINKED_ZONE_ID
- 链接区的 ID。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target INSTANCE
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone-delete 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 -i "dns-demo"
ibmcloud dns cross-account linked-zone-permitted-network-add
为链接区域创建允许的网络
ibmcloud dns cross-account linked-zone-permitted-network-add LINKED_ZONE_ID --vpc-crn VPC_CRN [--type TYPE] [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- LINKED_ZONE_ID
- 链接区的 ID。
- --type 值
- 允许的网络类型。 有效值:
vpc
。 - --vpc-crn 值
- VPC 实例的 CRN。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone-permitted-network-add 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 --vpc-crn "crn:v1:bluemix:public:is:eu-de:a/bcf1865e99742d38d2d5fc3fb80a5496::vpc:6e6cc326-04d1-4c99-a289-efb3ae4193d6" --i "dns-demo"
ibmcloud dns cross-account linked-zone-permitted-network
获取链接区域的允许网络
ibmcloud dns cross-account linked-zone-permitted-network LINKED_ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- LINKED_ZONE_ID
- 链接区的 ID。
- PERMITTED_NETWORK_ID
- 允许网络的 ID。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone-permitted-network 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 6e6cc326-04d1-4c99-a289-efb3ae4193d6 --i "dns-demo"
ibmcloud dns cross-account linked-zone-permitted-network-remove
除去链接区域的允许网络
ibmcloud dns cross-account linked-zone-permitted-network-remove LINKED_ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- LINKED_ZONE_ID
- 链接区的 ID。
- PERMITTED_NETWORK_ID
- 允许网络的 ID。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone-permitted-network-remove 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 6e6cc326-04d1-4c99-a289-efb3ae4193d6 --i "dns-demo"
ibmcloud dns cross-account linked-zone-permitted-networks
列出链接区允许使用的网络
ibmcloud dns cross-account linked-zone-permitted-networks LINKED_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- LINKED_ZONE_ID
- 链接区的 ID。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account linked-zone-permitted-networks 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 --i "dns-demo"
ibmcloud dns cross-account access-request-update
更新访问请求的状态。
ibmcloud dns cross-account access-request-update ZONE_ID REQUEST_ID --action ACTION [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- 所有者区域的 ID。
- Request_Id
- 访问请求的 ID。
- --action 值
- 该操作将应用于访问请求。 有效值:“核准”,"REJECT" 和 "REVOKE"。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account access-request-update 05855abe-3908-4cdc-bf0d-063e0b1c296d 9a234ede-c2b6-4c39-bc27-d39ec139ecdb --action "APPROVE" --i "dns-demo"
ibmcloud dns cross-account access-request
获取访问请求的详细信息。
ibmcloud dns cross-account access-request ZONE_ID REQUEST_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- 所有者区域的 ID。
- Request_Id
- 访问请求的 ID。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account access-request 05855abe-3908-4cdc-bf0d-063e0b1c296d 9a234ede-c2b6-4c39-bc27-d39ec139ecdb --i "dns-demo"
ibmcloud dns cross-account access-requests
列出所有者实例中的访问请求。
ibmcloud dns cross-account access-requests ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]
命令选项
- Zone_ID
- 所有者区域的 ID。
- -i, --instance 值
- 实例名称或标识。 如果未设置,则使用
ibmcloud dns instance-target
指定的上下文实例。 - --output 值
- 指定输出格式。 目前,
json
是唯一受支持的格式。
示例
ibmcloud dns cross-account access-requests 05855abe-3908-4cdc-bf0d-063e0b1c296d --i "dns-demo"