IBM Cloud Docs
DNS Services CLI 参考

DNS Services CLI 参考

请按照以下说明使用 IBM Cloud® DNS Services 命令行界面 (CLI)。

准备工作

完成以下步骤以使用 DNS Services CLI,该 CLI 是作为 IBM Cloud CLI 插件实现的。 该插件为您提供了通过命令行用户界面管理服务实例及其相关资源的方法。

  1. 安装 IBM Cloud CLI

  2. 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

资源记录类型。 有效值: AAAAACNAMEPTRTXTMXSRV

  • 对于类型 A,AAAA: 额外的必填字段为 namerdata
    • name: 资源记录名称。
    • rdata: 资源记录的内容。
      • ip: IPv4/IPv6 地址
  • 额外的可选字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 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: 额外的必填字段为 namerdata
    • name: 资源记录名称。
    • rdata:type-CNAME 资源记录的内容。
      • cname: 规范名称。
  • 额外的可选字段为 ttl
    • ttl: 秒中的生存时间。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
            "name": "testCNAME",
            "type": "CNAME",
            "rdata": {
                "cname": "example.com"
            }
        }
  • 对于类型 PTR: 额外的必填字段为 namerdata
    • name: 资源记录名称。
    • rdata:type-PTR 资源记录的内容。
      • ptrdname: 相关 A 或 AAAA 记录的主机名。
  • 额外选项字段为 ttl
    • ttl: 秒中的生存时间。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
            "name": "1.2.3.4",
            "type": "PTR",
            "rdata": {
                "ptrdname": "testA.example.com"
            }
        }
  • 对于类型 TXT: 额外的必填字段为 namerdata
    • name: 资源记录名称。
    • rdata: 类型为 TXT 资源记录的内容。
      • text: 人类可读文本。
  • 额外的可选字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
            "name": "testTXT",
            "type":"TXT",
            "rdata": {
                "text": "text information"
            }
        }
  • 对于类型 MX: 额外的必填字段为 namerdata
    • name: 资源记录名称。
    • rdata:type-MX 资源记录的内容。
      • exchange: Exchange Server 的主机名。
      • preference:MX 记录的首选项
  • 额外的可选字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
           "name": "testMX",
           "type": "MX",
           "rdata": {
                "preference": 10,
                "exchange": "mailserver.example.com"
            }
        }
  • 对于类型 SRV: 额外的必填字段为 namerdataserviceprotocol
    • name: 资源记录名称。
    • rdata: 类型为 SRV 的资源记录的内容。
      • priority: SRV 记录的优先级。
      • weight: 在多个目标服务器之间分发查询的权重。
      • port:目标服务器的端口号。
      • target: 目标服务器的主机名。
    • service:所需服务的符号名称,以下划线开头 _
    • protocol:所需协议的符号名称。
  • 额外选项字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 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。 有效值: 601203006009001800360072001800043200
-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。 有效值: 601203006009001800360072001800043200

样本 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。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
            "name": "testCNAME",
            "rdata": {
                "cname": "example.com"
            }
        }
  • 对于类型 PTR: 额外选项字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
            "ttl": 360,
        }
  • 对于类型 TXT: 额外的必填字段为 rdata
    • rdata: 类型为 TXT 资源记录的内容。
    • text: 人类可读文本。
  • 额外的可选字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
            "name": "testTXT",
            "rdata": {
                "text": "text information"
            }
        }
  • 对于类型 MX: 额外的必填字段为 rdata
    • rdata:type-MX 资源记录的内容。
      • exchange: Exchange Server 的主机名。
      • preference:MX 记录的首选项
  • 额外的可选字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 JSON 数据:

        {
            "name": "testMX",
            "content": "smtp.example.com",
            "priority": 10
        }
  • 对于类型 SRV: 额外的必填字段为 rdataserviceprotocol
    • rdata: 类型为 SRV 的资源记录的内容。
      • priority: SRV 记录的优先级
      • weight: 在多个目标服务器之间分发查询的权重。
      • port:目标服务器的端口号。
      • target: 目标服务器的主机名。
    • service:所需服务的符号名称,以下划线开头 _
    • protocol:所需协议的符号名称。
  • 额外选项字段为 ttl
    • ttl: 生存时间 (以秒计)。 默认值为 900。 有效值: 601203006009001800360072001800043200

样本 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 数据中的必填字段为 namefallback_pooldefault_pools:
    • name:要与负载平衡器关联的 DNS 主机名。
    • fallback_pool:检测到所有其他池为不健康时使用的池 ID。
    • default_pools:按故障转移优先级排序的池 ID 列表。
  • 可选字段为 descriptionttlaz_poolsenabled:
    • description: 负载均衡器的描述性文本。
    • ttl:此负载平衡器返回的 IP 地址的 DNS 条目的存活时间 (TTL)。
    • az_pools:区域和国家代码与区域内池 ID 列表(按故障转移优先级排序)的映射。
    • enabled:确定是否启用负载平衡器池。 有效值:truefalseonoff 已被弃用。

样本 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 中创建全局负载平衡器。

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 字符串。 必需。

  • 可选字段为 namefallback_pooldefault_poolsdescriptionttlaz_poolsenabled:
    • name:要与负载平衡器关联的 DNS 主机名。
    • fallback_pool:检测到所有其他池为不健康时使用的池 ID。
    • default_pools:按故障转移优先级排序的池 ID 列表。
    • description: 负载均衡器的描述性文本。
    • ttl:此负载平衡器返回的 IP 地址的 DNS 条目的存活时间 (TTL)。
    • az_pools:区域和国家代码与区域内池 ID 列表(按故障转移优先级排序)的映射。
    • enabled:确定是否启用负载平衡器池。 有效值:truefalseonoff 值已被弃用。

样本 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:该池中的起源列表。
  • 可选字段为 descriptionhealthy_origins_thresholdenabledmonitornotification_channelhealthcheck_regionhealthcheck_subnets:

    • description: 负载均衡器池的描述性文本。
    • healthy_origins_threshold:该池为流量提供服务时必须保持健康的最小起源数。
    • enabled:确定是否启用负载平衡器池。 有效值:true, false.
    • monitor:要与此池关联的负载平衡器监控器的 ID。
    • notification_channel: 通知通道。
    • healthcheck_region:VSI 的运行状况检查区域。 有效值: us-southus-easteu-gbeu-duau-sydjp-tokbr-saoca-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-southus-easteu-gbeu-duau-sydjp-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 字符串。 必需。

  • 可选字段为 nameoriginsdescriptionhealthy_origins_thresholdenabledmonitornotification_channelhealthcheck_regionhealthcheck_subnets:
    • name:负载平衡器池的名称。
    • origins:该池中的起源列表。
    • description: 负载均衡器池的描述性文本。
    • healthy_origins_threshold:该池为流量提供服务时必须保持健康的最小起源数。
    • enabled:确定是否启用负载平衡器池。 有效值:true, false.
    • monitor:要与此池关联的负载平衡器监控器的 ID。
    • notification_channel: 通知通道。
    • healthcheck_region:VSI 的运行状况检查区域。 有效值: us-southus-easteu-gbeu-duau-sydjp-tokbr-saoca-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-southus-easteu-gbeu-duau-sydjp-tokbr-saoca-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:用于健康检查的协议。 有效值: HTTPHTTPSTCP
  • 可选字段为 descriptiontimeoutretriesinterval
    • description: 负载均衡器监视器的描述性文本。
    • timeout:健康检查标记为失败前的超时(秒)。 有效值: 1-10
    • retries:原点被标记为不健康之前发生超时时尝试重试的次数。 有效值: 0-3
    • interval:每次健康检查的间隔时间。 有效值: 60-3600
  • 用于 TCP 类型的健康检查。 额外的必填字段是 port
    • port: 用于健康检查的 TCP 端口。
  • 用于 HTTP/HTTPS 类型的健康检查。 额外的必填字段是 expected_codes
    • expected_codes:健康检查的预期 HTTP 响应代码或代码范围。 有效值: 2002012022032042052062072082262xx
  • 额外的选项字段为 portexpected_bodymethodpathheaderallow_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
}
--name

负载平衡器监控器的名称。

--type

用于运行状况检查的协议。 有效值: HTTPHTTPSTCP

--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 字符串。 必需。

  • 可选字段为 nametypedescriptiontimeoutretriesinterval
    • name:负载平衡器监控器的名称。
    • type:用于健康检查的协议。 有效值: HTTPHTTPSTCP
    • description: 负载均衡器监视器的描述性文本。
    • timeout:健康检查标记为失败前的超时(秒)。 有效值: 1-10
    • retries:原点被标记为不健康之前发生超时时尝试重试的次数。 有效值: 0-3
    • interval:每次健康检查的间隔时间。 有效值: 60-3600
  • 用于 TCP 类型的健康检查。 额外选项字段为 port
    • port: 用于健康检查的 TCP 端口。
  • 用于 HTTP/HTTPS 类型的健康检查。 额外的选项字段为 expected_codesportexpected_bodymethodpathheaderallow_insecure
    • expected_codes:健康检查的预期 HTTP 响应代码或代码范围。 有效值: 2002012022032042052062072082262xx
    • 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

用于运行状况检查的协议。 有效值: HTTPHTTPSTCP

--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"