IBM Cloud Docs
Referencia de CLI de DNS Services

Referencia de CLI de DNS Services

Siga estas instrucciones para utilizar el IBM Cloud® DNS Services interfaz de línea de comando (CLI).

Antes de empezar

Siga estos pasos para utilizar la CLI de DNS Services, que se implementa como un plugin de CLI de IBM Cloud. Este complemento le proporciona los medios para administrar su instancia de servicio y sus recursos asociados a través de una interfaz de usuario de línea de comandos.

  1. Instale la CLI de IBM Cloud.

  2. Instalar o actualizar el cloud-dns-services complemento al IBM Cloud CLI.

    Para instalar el plugin, indique el mandato siguiente.

    ibmcloud plugin install cloud-dns-services
    

    Para actualizar:

    ibmcloud plugin update cloud-dns-services
    

    Para ver los complementos y las versiones instalados

    ibmcloud plugin list
    

Instancias

Administrar DNS Services instancias utilizando lo siguiente instance comandos.

ibmcloud dns instances

Listar todas las instancias de Servicios DNS.

   ibmcloud dns instances [--output FORMAT]

Opción de mandato

--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns instance-target

Configure la instancia del servicio de contexto para que funcione.

   ibmcloud dns instance-target [INSTANCE] [--unset]

Opciones de mandato

INSTANCIA
El nombre o el ID de una instancia de Servicios DNS. Si está presente, establezca la instancia de contexto en operate ; si no, muestra la instancia de contexto actual.
--unset
Desactivar instancia de contexto.

ibmcloud dns instance-create

Crear una instancia de Servicios DNS.

Usar ibmcloud target -g RESOURCE_GROUP para establecer el grupo de recursos de destino antes de crear un DNS Services instancia. Utilice ibmcloud resource groups para ver la lista de grupos de recursos disponibles.

   ibmcloud dns instance-create INSTANCE_NAME PLAN [-g, --resource-group RESOURCE_GROUP] [--output FORMAT]

Opciones de mandato

instance_name
El nombre de la instancia de Servicios DNS.
PLAN
El nombre o ID de un plan de servicios.
-g, --resource-group
El nombre o el ID de un grupo de recursos.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns instance-update

Actualizar una instancia de Servicios DNS.

   ibmcloud dns instance-update INSTANCE [--name NAME] [--plan PLAN] [--output FORMAT]

Opciones de mandato

INSTANCIA
El nombre o el ID de una instancia de Servicios DNS.
--name
El nombre de instancia de Servicios DNS.
--plan
El nombre o el ID de un plan de Servicios DNS. Utilice ibmcloud dns plans para ver los planes disponibles.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns instance-delete

Suprimir una instancia de Servicios DNS.

   ibmcloud dns instance-delete INSTANCE [--force] 

Opciones de mandato

INSTANCIA
El nombre o el ID de una instancia de Servicios DNS.
--force
Suprimir una instancia sin solicitar confirmación.

ibmcloud dns instance

Mostrar detalles de una instancia de Servicios DNS.

   ibmcloud dns instance INSTANCE [--output FORMAT]

Opciones de mandato

INSTANCIA
El nombre o el ID de una instancia de Servicios DNS.
--output
Especificar el formato de salida, solo se admite JSON.

ibmcloud dns plans

Listar todas las instancias de Servicios DNS.

   ibmcloud dns plans

Zonas

Administre zonas DNS usando lo siguiente zone comandos.

ibmcloud dns zone-create

Crear una zona DNS.

   ibmcloud dns zone-create ZONE_NAME [-d, --description DESC] [-l, --label LABEL] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

NOMBRE_ZONIZ
El nombre de la zona DNS.
-d, --description
El texto que describe el propósito de una zona DNS.
-l, --label
La etiqueta de una zona DNS.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns zone

Obtener los detalles de la zona DNS.

   ibmcloud dns zone ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona DNS.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns zone-update

Actualizar descripción y etiqueta de una zona DNS.

   ibmcloud dns zone-update ZONE_ID [-d, --description DESC] [-l, --label LABEL] [--instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona DNS.
-d, --description
El texto que describe el propósito de una zona DNS.
-l, --label
La etiqueta de una zona DNS.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns zone-delete

Suprimir una zona DNS.

   ibmcloud dns zone-delete ZONE_ID [-i, --instance INSTANCE] [-f,--force]

Opciones de mandato

zone_id
El ID de la zona DNS.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
-f, --force
Suprimir una zona sin solicitar confirmación.

ibmcloud dns zones

Generar una lista de todas las zonas DNS para una instancia de servicio.

   ibmcloud dns zones [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Redes permitidas

Administre las redes permitidas utilizando lo siguiente permitted-network comandos.

ibmcloud dns permitted-network-add

Añadir una red permitida para una zona DNS.

   ibmcloud dns permitted-network-add ZONE_ID --vpc-crn VPC_CRN [--type TYPE] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona DNS.
--type
El tipo de red permitida. Valores válidos: vpc.
--vpc-crn
El CRN de la instancia de VPC.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns permitted-network

Obtener los detalles de la red permitida.

   ibmcloud dns permitted-network ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona DNS.
ID de red PERMITTED_NETWORK_ID
El ID de la red permitida.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns permitted-network-remove

Eliminar una red permitida.

   ibmcloud dns permitted-network-remove ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [-f,--force]

Opciones de mandato

zone_id
El ID de la zona DNS.
ID de red PERMITTED_NETWORK_ID
El ID de la red permitida.
--instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
-f, --force
Eliminar una red permitida sin solicitar confirmación.

ibmcloud dns permitted-networks

Listar redes permitidas para una zona.

   ibmcloud dns permitted-networks ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona DNS.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Registros de recursos

Administre el rendimiento del registro de recursos utilizando lo siguiente resource-record comandos.

ibmcloud dns resource-record-create

Crear un registro de recurso para una zona 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]

Opciones de mandato

zone_id
El ID de la zona DNS.
--name
Nombre de registro de recurso.
--type
Tipo de registro de recurso.
--ipv4
Dirección IPv4.
--ipv6
Dirección IPv6.
--cname
Nombre canónico.
--ptrdname
Nombre de host del registro A o AAAA relevante.
--text
Texto legible.
--exchange
Nombre de host del servidor de Exchange.
--preference
Preferencia del registro MX.
--service
El nombre simbólico del servicio buscado, comenzando con un guión bajo._.
--protocol
El nombre simbólico del protocolo buscado.
--port
Número de puerto del servidor de destino.
--weight
Ponderación de la distribución de consultas entre varios servidores de destino.
--priority
Prioridad del registro SRV.
--target
Nombre de host del servidor de destino.
--ttl
Vida, en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.
-r, --record-content
El archivo JSON o cadena JSON que se utiliza para describir un registro de recursos DNS. Consulte Campos obligatorios para -r --record-content para obtener más detalles.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Campos obligatorios para -r --record-content

El campo obligatorio en los datos JSON es type.

Tipo de registro de recurso. Valores válidos: A, AAAA, CNAME, PTR, TXT, MX, SRV.

  • Para el tipo A, AAAA: los campos obligatorios adicionales son name, rdata.
    • name: nombre de registro de recurso.
    • rdata: contenido del registro de recurso.
      • ip: dirección IPv4/IPv6
  • Los campos opcionales adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
             "name": "testA",
             "type": "A",
             "rdata": {
                 "ip": "1.2.3.4"
                }
        }
        {
            "name": "testAAAA",
            "type": "AAAA",
            "rdata": {
                "ip": "2001:0db8:0012:0001:3c5e:7354:0000:5db1"
            }
        }
  • Para el tipo CNAME: los campos obligatorios adicionales son name, rdata.
    • name: nombre de registro de recurso.
    • rdata: El contenido del registro de recurso tipo CNAME.
      • cname: nombre canónico.
  • Los campos opcionales adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "name": "testCNAME",
            "type": "CNAME",
            "rdata": {
                "cname": "example.com"
            }
        }
  • Para el tipo PTR: los campos obligatorios adicionales son name, rdata.
    • name: nombre de registro de recurso.
    • rdata: el contenido del registro de recurso type-PTR.
      • ptrdname: nombre de host del registro A o AAAA relevante.
  • Los campos de opciones adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "name": "1.2.3.4",
            "type": "PTR",
            "rdata": {
                "ptrdname": "testA.example.com"
            }
        }
  • Para el tipo TXT: los campos obligatorios adicionales son name, rdata.
    • name: nombre de registro de recurso.
    • rdata: el contenido del registro de recurso type-TXT.
      • text: texto legible por el hombre.
  • Los campos opcionales adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "name": "testTXT",
            "type":"TXT",
            "rdata": {
                "text": "text information"
            }
        }
  • Para el tipo MX: los campos obligatorios adicionales son name, rdata.
    • name: nombre de registro de recurso.
    • rdata: el contenido del registro de recurso type-MX.
      • exchange: nombre de host del servidor de Exchange.
      • preference: preferencia del registro MX
  • Los campos opcionales adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
           "name": "testMX",
           "type": "MX",
           "rdata": {
                "preference": 10,
                "exchange": "mailserver.example.com"
            }
        }
  • Para el tipo SRV: los campos obligatorios adicionales son name, rdata, service, protocol.
    • name: nombre de registro de recurso.
    • rdata: el contenido del registro de recurso type-SRV.
      • priority: prioridad del registro SRV.
      • weight: peso de las consultas distribuidas entre varios servidores de destino.
      • port: número de puerto del servidor de destino.
      • target: nombre de host del servidor de destino.
    • service: El nombre simbólico del servicio deseado, comenzando con un guión bajo._.
    • protocol: El nombre simbólico del protocolo deseado.
  • Los campos de opciones adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "type": "SRV",
            "name": "testSRV",
            "rdata": {
                "priority": 100,
                "weight": 100,
                "port": 8000,
                "target": "siphost.com"
            },
            "service": "_sip",
            "protocol": "udp"
        }

ibmcloud dns resource-record-update

Actualizar un registro de recurso para una zona 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]

Opciones de mandato

zone_id
El ID de la zona DNS.
ID_REGISTRO
El ID del registro.
--name
Nombre de registro de recurso.
--type
Tipo de registro de recurso.
--ipv4
Dirección IPv4.
--ipv6
Dirección IPv6.
--cname
Nombre canónico.
--ptrdname
Nombre de host del registro A o AAAA relevante.
--text
Texto legible.
--exchange
Nombre de host del servidor de Exchange.
--preference
Preferencia del registro MX.
--service
El nombre simbólico del servicio buscado, comenzando con un guión bajo._.
--protocol
El nombre simbólico del protocolo buscado.
--port
Número de puerto del servidor de destino.
--weight
Ponderación de la distribución de consultas entre varios servidores de destino.
--priority
Prioridad del registro SRV.
--target
Nombre de host del servidor de destino.
--ttl
Vida, en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.
-r, --record-content
El archivo JSON o cadena JSON que se utiliza para describir un registro de recursos DNS. Consulte Campos obligatorios para -r, --record-content para obtener más detalles.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece el nombre, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especificar el formato de salida, solo se admite JSON.

Campos obligatorios para -r, --record-content

El campo obligatorio en los datos JSON es name. Nombre de registro de recurso.

Los registros PTR no necesitan este campo.

  • Para el tipo A, AAAA: los campos obligatorios adicionales son rdata.
    • rdata: contenido del registro de recurso.
      • ip: dirección IPv4/IPv6
  • Los campos de opciones adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
             "name": "testA",
             "rdata": {
                 "ip": "1.2.3.4"
            }
        }
        {
            "name": "testAAAA",
            "rdata": {
                "ip": "2001:0db8:0012:0001:3c5e:7354:0000:5db1"
            }
        }
  • Para el tipo CNAME: los campos obligatorios adicionales son rdata.
    • rdata: el contenido del registro de recurso type-PTR.
    • cname: nombre canónico
  • Los campos de opciones adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "name": "testCNAME",
            "rdata": {
                "cname": "example.com"
            }
        }
  • Para el tipo PTR: los campos de opciones adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "ttl": 360,
        }
  • Para el tipo TXT: los campos obligatorios adicionales son rdata.
    • rdata: el contenido del registro de recurso type-TXT.
    • text: texto legible por el hombre.
  • Los campos opcionales adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "name": "testTXT",
            "rdata": {
                "text": "text information"
            }
        }
  • Para el tipo MX: los campos obligatorios adicionales son rdata.
    • rdata: el contenido del registro de recurso type-MX.
      • exchange: nombre de host del servidor de Exchange.
      • preference: preferencia del registro MX
  • Los campos opcionales adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "name": "testMX",
            "content": "smtp.example.com",
            "priority": 10
        }
  • Para el tipo SRV: los campos obligatorios adicionales son rdata, service, protocol.
    • rdata: el contenido del registro de recurso type-SRV.
      • priority: prioridad del registro SRV
      • weight: peso de las consultas distribuidas entre varios servidores de destino.
      • port: número de puerto del servidor de destino.
      • target: nombre de host del servidor de destino.
    • service: El nombre simbólico del servicio deseado, comienza con un guión bajo._.
    • protocol: El nombre simbólico del protocolo deseado.
  • Los campos de opciones adicionales son ttl.
    • ttl: vida en segundos. El valor predeterminado es 900. Valores válidos: 60, 120, 300, 600, 900, 1800, 3600, 7200, 18000, 43200.

Datos JSON de ejemplo:

        {
            "name": "testSRV"
            "rdata": {
                "priority": 100,
                "weight": 100,
                "port": 8000,
                "target": "siphost.com"
            },
            "service": "_sip",
            "protocol": "udp"
        }

ibmcloud dns resource-record

Obtener un registro de recurso para una zona DNS.

   ibmcloud dns resource-record ZONE_ID RECORD_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona DNS.
ID_REGISTRO
El ID del registro de recurso.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece el nombre, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output FORMAT
Especifique el formato de salida. Actualmente,json es el único formato admitido.

ibmcloud dns resource-record-delete

Suprimir un registro de recurso para una zona DNS.

   ibmcloud dns resource-record-delete ZONE_ID RECORD_ID [-i, --instance INSTANCE] [-f,--force]

Opciones de mandato

zone_id : El ID de la zona DNS.

ID_REGISTRO
El ID del registro de recurso.
-i, --instance INSTANCIA
Nombre o ID de instancia. Si no se establece el nombre, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
-f, --force
Suprimir registro de recurso sin solicitud de confirmación.

ibmcloud dns resource-records

Listar todos los registros de recursos para una zona DNS.

   ibmcloud dns resource-records ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona DNS.
--page
Número de página de resultados paginados (predeterminado 1).
--per-page
Número de registros de recursos por página. Mín.: 50. Máx.: 1000 (predeterminado 200).
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplo de mandato

Listar registros de recursos con paginación:

ibmcloud dns resource-records ZONE_ID --per-page 1000 --page 1

Mandato de ejemplo para listar registros de recursos con paginación

ibmcloud dns resource-records ZONE_ID --per-page 1000 --page 1

ibmcloud dns resource-records-import

Importe registros de recursos de archivo de zona BIND.

ibmcloud dns resource-records-import DNS_ZONE_ID (--file FILE) [-i, --instance INSTANCE_NAME | INSTANCE_ID] [--output FORMAT]

Opciones de mandato

DNS_ID_ZON
El ID de la zona DNS.
--file
Archivo de zona BIND que va a importar. Tipo de soporte: A, AAAA, CNAME, MX, PTR, SRV, TXT.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Importe registros de recursos del archivo de zona BIND dns_records.cfg en la zona f1d596fc-7e86-4b99-b912-9508167e9e56 para la instancia dns-demo.

ibmcloud dns resource-records-import f1d596fc-7e86-4b99-b912-9508167e9e56 --file dns_records.cfg -i "dns-demo"

ibmcloud dns resource-records-export

Exporte registros de recursos al archivo de zona BIND.

ibmcloud dns resource-records-export DNS_ZONE_ID [--file FILE] [-i, --instance INSTANCE_NAME | INSTANCE_ID] [--output FORMAT]

Opciones de mandato

DNS_ID_ZON
El ID de la zona DNS.
--file
El archivo de zona BIND guarda los registros de recursos exportados.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Exporte registros de recursos en la zona f1d596fc-7e86-4b99-b912-9508167e9e56 al archivo de zona dns_records.cfg para la instancia dns-demo.

ibmcloud dns resource-records-export f1d596fc-7e86-4b99-b912-9508167e9e56 --file dns_records.cfg -i "dns-demo"

Equilibrador de carga global

Administre balanceadores de carga globales utilizando lo siguiente glb comandos.

ibmcloud dns glb-create

Crear un equilibrador de carga global en una zona.

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]

Opciones de mandato

DNS_ID_Dominio

El ID de la zona DNS.    Obligatorio.

--json

El archivo JSON o cadena JSON que se utiliza para describir un equilibrador de carga global. Obligatorio.

  • Los campos obligatorios en los datos JSON son name, fallback_pool, default_pools:
    • name: el nombre de host DNS para asociarlo al equilibrador de carga.
    • fallback_pool: el ID de agrupación que se va a utilizar cuando se detecten todas las demás agrupaciones como en mal estado.
    • default_pools: una lista de ID de agrupaciones por su prioridad de migración tras error.
  • Los campos opcionales son description, ttl, az_pools, enabled:
    • description: el texto descriptivo del equilibrador de carga.
    • ttl: vida (TTL - Time To Live) de la entrada DNS para la dirección IP que ha devuelto este equilibrador de carga.
    • az_pools: una correlación de códigos de región y de país con una lista de ID de agrupación (clasificada por la prioridad de migración tras error) para la región.
    • enabled: determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos:true,false. Los valores on y off están en desuso.

Datos JSON de ejemplo:

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

Nombre de host DNS que se asocia con el equilibrador de carga.

--fallback-pool

ID de agrupación que se utiliza cuando todas las otras agrupaciones se han detectado como no en buen estado.

--default-pools

Lista de ID de agrupaciones ordenados por prioridad de migración tras error.

--description

El texto descriptivo del equilibrador de carga.

--ttl

Tiempo de vida (TTL) de la entrada DNS para la dirección IP devuelta por este equilibrador de carga.

--az-pools

Una asignación de códigos de región y país a una lista de ID de grupo (ordenados por su prioridad de conmutación por error) para la región.

--enabled

Determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos: true, false.

-i, --instance

Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.

--output

Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Crear un equilibrador de carga global en la zona demo.com:31984fea73a15b45779fa0df4ef62f9b.

ibmcloud dns glb-create demo.com:31984fea73a15b45779fa0df4ef62f9b --json @glb.json -i "dns-demo"

ibmcloud dns glb-update

Actualizar un equilibrador de carga global en una zona.

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]

Opciones de mandato

DNS_ID_Dominio

El ID de la zona DNS.    Obligatorio.

ID_GLB

El ID del equilibrador de carga global. Obligatorio.

--json

El archivo JSON o cadena JSON que se utiliza para describir un equilibrador de carga global. Obligatorio.

  • Los campos opcionales son name, fallback_pool, default_pools, description, ttl, az_pools, enabled:
    • name: el nombre de host DNS para asociarlo al equilibrador de carga.
    • fallback_pool: el ID de agrupación que se va a utilizar cuando se detecten todas las demás agrupaciones como en mal estado.
    • default_pools: una lista de ID de agrupaciones por su prioridad de migración tras error.
    • description: el texto descriptivo del equilibrador de carga.
    • ttl: vida (TTL - Time To Live) de la entrada DNS para la dirección IP que ha devuelto este equilibrador de carga.
    • az_pools: una correlación de códigos de región y de país con una lista de ID de agrupación (clasificada por la prioridad de migración tras error) para la región.
    • enabled: determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos:true,false. Los valores on,off están en desuso.

Datos JSON de ejemplo:

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

Nombre de host DNS que se asocia con el equilibrador de carga.

--fallback-pool

ID de agrupación que se utiliza cuando todas las otras agrupaciones se han detectado como no en buen estado.

--default-pools

Lista de ID de agrupaciones ordenados por prioridad de migración tras error.

--description

El texto descriptivo del equilibrador de carga.

--ttl

Tiempo de vida (TTL) de la entrada DNS para la dirección IP devuelta por este equilibrador de carga.

--az-pools

Una asignación de códigos de región y país a una lista de ID de grupo (ordenados por su prioridad de conmutación por error) para la región.

--enabled

Determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos: true, false.

-i, --instance

Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.

--output

Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Actualizar un equilibrador de carga global 699d98642c564d2e855e9661899b7252 en la zona demo.com:31984fea73a15b45779fa0df4ef62f9b.

ibmcloud dns glb-update demo.com:31984fea73a15b45779fa0df4ef62f9b 699d98642c564d2e855e9661899b7252 --json @glb.json -i "dns-demo"

ibmcloud dns glb

Mostrar un equilibrador de carga global en una zona.

ibmcloud dns glb DNS_DOMAIN_ID GLB_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

DNS_ID_Dominio
El ID de la zona DNS.    Obligatorio.
ID_GLB
El ID de un equilibrador de carga global. Obligatorio.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Mostrar un equilibrador de carga global 699d98642c564d2e855e9661899b7252 en la zona demo.com:31984fea73a15b45779fa0df4ef62f9b.

ibmcloud dns glb demo.com:31984fea73a15b45779fa0df4ef62f9b 699d98642c564d2e855e9661899b7252 -i "dns-demo"

ibmcloud dns glb-delete

Suprimir un equilibrador de carga global en un dominio DNS.

ibmcloud dns glb-delete DNS_DOMAIN_ID GLB_ID [-i, --instance INSTANCE] [-f,--force]

Opciones de mandato

DNS_ID_Dominio
El ID de la zona DNS.    Obligatorio.
ID_GLB
El ID de un equilibrador de carga global. Obligatorio.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
-f, --force
Suprimir equilibrador de carga sin solicitud de confirmación.

Ejemplos

Suprimir un equilibrador de carga global 699d98642c564d2e855e9661899b7252 en la zona demo.com:31984fea73a15b45779fa0df4ef62f9b.

ibmcloud dns glb-delete demo.com:31984fea73a15b45779fa0df4ef62f9b 699d98642c564d2e855e9661899b7252 -f -i "dns-demo"

ibmcloud dns glbs

Listar todos los equilibradores de carga para la zona.

ibmcloud dns glbs DNS_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

DNS_ID_Dominio
El ID de la zona DNS.    Obligatorio.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Listar los equilibradores de carga para la zona demo.com:31984fea73a15b45779fa0df4ef62f9b.

ibmcloud dns glbs demo.com:31984fea73a15b45779fa0df4ef62f9b -i "dns-demo"

ibmcloud dns glb-pool-create

Crear una agrupación GLB para una instancia de servicio.

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]

Opciones de mandato

--json

El archivo JSON o cadena JSON que se utiliza para describir un grupo de equilibrador de carga global. Obligatorio.

  • Los campos obligatorios en los datos JSON son name, origins:

    • name: el nombre de la agrupación de equilibrador de carga.
    • origins: la lista de orígenes dentro de esta agrupación.
  • Los campos opcionales son description, healthy_origins_threshold, enabled, monitor, notification_channel, healthcheck_region, healthcheck_subnets:

    • description: el texto descriptivo de la agrupación del equilibrador de carga.
    • healthy_origins_threshold: el número mínimo de orígenes que debe hallarse en buen estado para que esta agrupación distribuya tráfico.
    • enabled: determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos: true, false.
    • monitor: el ID del monitor del equilibrador de carga que se asociará a este grupo.
    • notification_channel: el canal de notificación.
    • healthcheck_region: la región de comprobación de estado de las VSI. Valores válidos: us-south, us-east, eu-gb, eu-du, au-syd, jp-tok, br-sao, ca-tor.
    • healthcheck_subnets: una lista de ID de subred de comprobación de estado de las VSI.

    Cuando crea una agrupación conectando un supervisor, los servicios de DNS toman una dirección de la subred de comprobación de estado. Asegúrese de que esta subred de verificación de estado tenga suficientes direcciones IP disponibles.

Datos JSON de ejemplo:

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

El nombre del grupo de equilibradores de carga.

--description

El texto descriptivo del grupo de equilibradores de carga.

--healthy-origins-threshold

La cantidad mínima de orígenes que deben estar en buen estado para que este grupo atienda tráfico.

--enabled

Determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos: true, false.

--monitor

El ID del monitor del equilibrador de carga que se asociará a este grupo.

--notification-channel

El canal de notificación.

región de comprobación de estado

Región de control de estado de las VSI. Valores válidos: us-south, us-east, eu-gb, eu-du, au-syd, jp-tok.

subredes de comprobación de estado

Una lista de ID de subred de verificación de estado de VSI.

-i, --instance

Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.

--output

Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Crear una agrupación GLB para la instancia dns-demo.

ibmcloud dns glb-pool-create --json @glb-pool.json -i "dns-demo"

ibmcloud dns glb-pool-update

Actualizar los detalles de una agrupación 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]

Opciones de mandato

ID_POOL_GLB

El ID del grupo de equilibradores de carga global. Obligatorio.

--json

El archivo JSON o cadena JSON que se utiliza para describir un grupo GLB. Obligatorio.

  • Los campos opcionales son name, origins, description, healthy_origins_threshold, enabled, monitor, notification_channel, healthcheck_region, healthcheck_subnets:
    • name: el nombre de la agrupación de equilibrador de carga.
    • origins: la lista de orígenes dentro de esta agrupación.
    • description: el texto descriptivo de la agrupación del equilibrador de carga.
    • healthy_origins_threshold: el número mínimo de orígenes que debe hallarse en buen estado para que esta agrupación distribuya tráfico.
    • enabled: determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos: true, false.
    • monitor: el ID del monitor del equilibrador de carga que se asociará a este grupo.
    • notification_channel: el canal de notificación.
    • healthcheck_region: la región de comprobación de estado de las VSI. Valores válidos: us-south, us-east, eu-gb, eu-du, au-syd, jp-tok, br-sao, ca-tor.
    • healthcheck_subnets: una lista de ID de subred de comprobación de estado de las VSI.

Datos JSON de ejemplo:

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

El nombre del grupo de equilibradores de carga.

--description

El texto descriptivo del grupo de equilibradores de carga.

--enable-origin

Habilite el origen dentro de la agrupación. El valor puede ser ORIGIN_NAME u ORIGIN_ADDRESS.

--disable-origin

Inhabilite el origen dentro de la agrupación. El valor puede ser ORIGIN_NAME u ORIGIN_ADDRESS.

--add-origin

Añada un origen a la agrupación. ORIGIN_NAME y ORIGIN_ADDRESS son obligatorios. Por ejemplo, --add-origin name=example,address=1.2.3.4,enabled=true,description=origin_description.

--remove-origin

Elimine un origen de la agrupación. El valor puede ser ORIGIN_NAME u ORIGIN_ADDRESS.

--detach-monitor

Separe el monitor del grupo de origen.

--attach-monitor

Conecte el monitor al grupo de origen.

--healthy-origins-threshold

La cantidad mínima de orígenes que deben estar en buen estado para que este grupo atienda tráfico.

--enabled

Determina si el grupo de equilibradores de carga está habilitado o no. Valores válidos: true, false.

región de comprobación de estado

Región de control de estado de las VSI. Valores válidos:us-south,us-east,eu-gb,eu-du,au-syd,jp-tok,br-sao,ca-tor.

subredes de comprobación de estado

Una lista de ID de subred de verificación de estado de VSI.

-i, --instance

Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.

--output

Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Actualizar una agrupación GLB 17b5962d775c646f3f9725cbc7a53df4 para la instancia dns-demo.

ibmcloud dns glb-pool-update 17b5962d775c646f3f9725cbc7a53df4 --json @glb-pool.json -i "dns-demo"

ibmcloud dns glb-pool

Mostrar los detalles de una agrupación GLB.

ibmcloud dns glb-pool GLB_POOL_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_POOL_GLB
El ID del grupo de equilibradores de carga global. Obligatorio.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Mostrar los detalles del pool GLB 17b5962d775c646f3f9725cbc7a53df4.

ibmcloud dns glb-pool 17b5962d775c646f3f9725cbc7a53df4 -i "dns-demo"

ibmcloud dns glb-pool-delete

Suprimir una agrupación GLB.

ibmcloud dns glb-pool-delete GLB_POOL_ID [-i, --instance INSTANCE] [-f,--force]

Opciones de mandato

ID_POOL_GLB
El ID del grupo de equilibradores de carga global. Obligatorio.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
-f, --force
Suprimir agrupación de equilibradores de carga sin solicitud de confirmación.

Ejemplos

Suprimir la agrupación de GLB 17b5962d775c646f3f9725cbc7a53df4.

ibmcloud dns glb-pool-delete 17b5962d775c646f3f9725cbc7a53df4 -f -i "dns-demo"

ibmcloud dns glb-pools

Listar todas las agrupaciones GLB para una instancia de servicio.

ibmcloud dns glb-pools [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Listar todas las agrupaciones GLB para la instancia dns-demo.

ibmcloud dns glb-pools -i "dns-demo"

ibmcloud dns glb-monitor-create

Crear un supervisor GLB para una instancia de servicio.

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]

Opciones de mandato

--json

El archivo JSON o cadena JSON que se utiliza para describir un monitor GLB. Obligatorio.

  • Los campos obligatorios en los datos JSON son name, type.
    • name: el nombre del supervisor del equilibrador de carga.
    • type: El protocolo que se utilizará para la comprobación de estado. Valores válidos: HTTP, HTTPS, TCP.
  • Los campos opcionales son description, timeout, retries, interval.
    • description: el texto descriptivo del supervisor del equilibrador de carga.
    • timeout: el tiempo de espera (en segundos) antes de que la comprobación de estado se marque como fallida. Valores válidos: 1-10.
    • retries: el número de reintentos que se deben realizar cuando se agota el tiempo de espera antes de que el origen se marque como incorrecto. Valores válidos: 0-3.
    • interval: el intervalo entre cada comprobación de estado. Valores válidos: 60-3600.
  • Para TCP-Tipo de controles de salud. Los campos obligatorios adicionales son port.
    • port: el puerto TCP que se utilizará para la comprobación de estado.
  • Para HTTP/HTTPS-Tipo de controles de salud. Los campos obligatorios adicionales son expected_codes.
    • expected_codes: el código de respuesta HTTP esperado o el rango de códigos de las comprobaciones de estado. Valores válidos: 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 2xx.
  • Los campos de opciones adicionales son port, expected_body, method, path, header, allow_insecure.
    • port: el número de puerto al que se conecta la comprobación de estado.
    • expected_body: una subcadena que no distingue entre mayúsculas y minúsculas para buscar en el cuerpo de la respuesta.
    • method: El método a utilizar para la verificación de estado aplicable a las comprobaciones basadas en HTTP/HTTPS. Valores válidos: GET, HEAD.
    • path: la vía de acceso de punto final en la que comprobar el estado.
    • header: Las cabeceras de solicitud HTTP que se enviarán en la comprobación de estado.
    • allow_insecure: no validar el certificado cuando el supervisor utilice HTTPS. Valores válidos: true, false.

Datos JSON de ejemplo:

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

Para TCP:

{
  "name": "glbmonitor",
  "description": "Health monitor of TCP",
  "type": "TCP",
  "port": 80,
  "timeout": 5,
  "retries": 2,
  "interval": 90
}
--name

El nombre del monitor del equilibrador de carga.

--type

El protocolo que se utiliza para la comprobación de estado. Valores válidos: HTTP, HTTPS, TCP.

--description

El texto descriptivo del monitor del equilibrador de carga.

--timeout

El tiempo de espera (en segundos) antes de que la comprobación de estado se marque como fallida. Valores válidos: 1-10.

--retries

El número de reintentos que se deben intentar cuando se agota el tiempo de espera antes de que el origen se marque como incorrecto. Valores válidos: 0-3.

--interval

Intervalo entre cada comprobación de estado. Valores válidos: 60-3600.

--port

El número de puerto al que se conecta la comprobación de estado.

--expected-codes

Código o rango de código de respuesta HTTP esperado de la comprobación de estado. Valores válidos: 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 2xx.

--expected-body

Una subcadena que no distingue entre mayúsculas y minúsculas para buscar en el cuerpo de la respuesta.

--method

El método que se utilizará para la comprobación de estado aplicable a las comprobaciones basadas en HTTP/HTTPS. Valores válidos: GET, HEAD.

--path

Vía de acceso de punto final a la comprobación de estado.

--headers

Cabeceras de solicitud HTTP que se deben enviar en la comprobación de estado.

--allow-insecure

No valide el certificado cuando el monitor utilice HTTPS. Valores válidos: on, off.

-i, --instance

Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.

--output

Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Crear un supervisor GLB en la instancia dns-demo.

ibmcloud dns glb-monitor-create --json @glb-monitor.json -i "dns-demo"

ibmcloud dns glb-monitor-update

Actualizar un supervisor GLB para una instancia de servicio.

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]

Opciones de mandato

ID_MON_GLB

El ID de un monitor de equilibrador de carga global. Obligatorio. --json

El archivo JSON o cadena JSON que se utiliza para describir un monitor GLB. Obligatorio.

  • Los campos opcionales son name, type, description, timeout, retries, interval.
    • name: el nombre del supervisor del equilibrador de carga.
    • type: El protocolo que se utilizará para la comprobación de estado. Valores válidos: HTTP, HTTPS, TCP.
    • description: el texto descriptivo del supervisor del equilibrador de carga.
    • timeout: el tiempo de espera (en segundos) antes de que la comprobación de estado se marque como fallida. Valores válidos: 1-10.
    • retries: el número de reintentos que se deben realizar cuando se agota el tiempo de espera antes de que el origen se marque como incorrecto. Valores válidos: 0-3.
    • interval: el intervalo entre cada comprobación de estado. Valores válidos: 60-3600.
  • Para TCP-tipo chequeo de salud. Los campos de opciones adicionales son port.
    • port: el puerto TCP que se utilizará para la comprobación de estado.
  • Para HTTP/HTTPS-tipo chequeo de salud. Los campos de opciones adicionales son expected_codes, port, expected_body, method, path, header, allow_insecure.
    • expected_codes: el código de respuesta HTTP esperado o el rango de códigos de la comprobación de estado. Valores válidos: 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 2xx.
    • port: el número de puerto al que se conecta la comprobación de estado.
    • expected_body: una subcadena que no distingue entre mayúsculas y minúsculas para buscar en el cuerpo de la respuesta.
    • method: el método a utilizar para la comprobación de estado aplicable a las comprobaciones basadas en HTTP/HTTPS. Valores válidos: GET, HEAD.
    • path: la vía de acceso de punto final en la que comprobar el estado.
    • header: Las cabeceras de solicitud HTTP que se enviarán en la comprobación de estado.
    • allow_insecure: no validar el certificado cuando el supervisor utilice HTTPS. Valores válidos: on, off.

Datos JSON de ejemplo:

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

Para TCP:

{
  "name": "glbmonitor",
  "description": "Health monitor of TCP",
  "type": "TCP",
  "port": 80,
  "timeout": 5,
  "retries": 2,
  "interval": 90
}
--name

El nombre del monitor del equilibrador de carga.

--type

El protocolo que se utiliza para la comprobación de estado. Valores válidos: HTTP, HTTPS, TCP.

--description

El texto descriptivo del monitor del equilibrador de carga.

--timeout

El tiempo de espera (en segundos) antes de que la comprobación de estado se marque como fallida. Valores válidos: 1-10.

--retries

El número de reintentos que se deben intentar cuando se agota el tiempo de espera antes de que el origen se marque como incorrecto. Valores válidos: 0-3.

--interval

Intervalo entre cada comprobación de estado. Valores válidos: 60-3600.

--port

El número de puerto al que se conecta la comprobación de estado.

--expected-codes

Código o rango de código de respuesta HTTP esperado de la comprobación de estado. Valores válidos: 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 2xx.

--expected-body

Una subcadena que no distingue entre mayúsculas y minúsculas para buscar en el cuerpo de la respuesta.

--method

El método que se utilizará para la comprobación de estado aplicable a las comprobaciones basadas en HTTP/HTTPS. Valores válidos: GET, HEAD.

--path

Vía de acceso de punto final a la comprobación de estado.

--headers

Cabeceras de solicitud HTTP que se deben enviar en la comprobación de estado.

--allow-insecure

No valide el certificado cuando el monitor utilice HTTPS. Valores válidos: on, off.

-i, --instance

Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.

--output

Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Actualizar supervisores de GLB f1aba936b94213e5b8dca0c0dbf1f9cc en la instancia dns-demo.

ibmcloud dns glb-monitor-update f1aba936b94213e5b8dca0c0dbf1f9cc --json @glb-monitor.json -i "dns-demo"

ibmcloud dns glb-monitor

Muestra los detalles de un monitor de equilibrador de carga global.

ibmcloud dns glb-monitor GLB_MON_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_MON_GLB
El ID de un monitor de equilibrador de carga global. Obligatorio.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Mostrar los detalles del monitor GLB f1aba936b94213e5b8dca0c0dbf1f9cc.

ibmcloud dns glb-monitor f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"

ibmcloud dns glb-monitor-delete

Suprimir un supervisor GLB para una instancia de servicio.

ibmcloud dns glb-monitor-delete GLB_MON_ID [-i, --instance INSTANCE] [-f,--force]

Opciones de mandato

ID_MON_GLB
El ID de un monitor de equilibrador de carga global. Obligatorio.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
-f, --force
Suprimir supervisor de equilibradores de carga sin solicitud de confirmación.

Ejemplos

Eliminar el monitor GLB f1aba936b94213e5b8dca0c0dbf1f9cc.

ibmcloud dns glb-monitor-delete f1aba936b94213e5b8dca0c0dbf1f9cc -f -i "dns-demo"

ibmcloud dns glb-monitors

Listar supervisores GLB para una instancia de servicio.

ibmcloud dns glb-monitors [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Listar todos los supervisores GLB para la instancia dns-demo.

ibmcloud dns glb-monitors -i "dns-demo"

Programa de resolución personalizado

Gestione los programas de resolución personalizados utilizando los siguientes mandatos del programa de resolución personalizado.

ibmcloud dns custom-resolver-create

Cree un programa de resolución personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-create --name NAME [--location LOCATION1] [--location LOCATION2] [-description DESCRIPTION] [-f, --force] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

-n, --name
El nombre del programa de resolución personalizado.
-d, --description
El texto descriptivo del programa de resolución personalizado.
-f, --force
Permitir la creación de solucionadores personalizados con menos de 2 ubicaciones.
--location
Las ubicaciones en las que se ejecuta el solucionador personalizado. Se necesita el CRN de la subred de ubicación. Por ejemplo, --location subnet1,enable  --location subnet2,disable.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Cree un programa de resolución personalizado para la instancia 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

Actualice un programa de resolución personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-update RESOLVER_ID [--name NAME] [--enabled true|false] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
-n, --name
El nombre del programa de resolución personalizado.
-d, --description
El texto descriptivo del programa de resolución personalizado.
--enabled
Determina si se habilita o no la resolución personalizada.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Actualice un programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc para la instancia dns-demo.

ibmcloud dns custom-resolver-update f1aba936b94213e5b8dca0c0dbf1f9cc --name "example" --enabled true -description "demo" -i "dns-demo"

ibmcloud dns custom-resolver

Obtenga los detalles del solucionador personalizado para una instancia de servicio.

ibmcloud dns custom-resolver RESOLVER_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Obtenga un programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc para la instancia dns-demo.

ibmcloud dns custom-resolver f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"

ibmcloud dns custom-resolvers

Liste programas de resolución personalizados para una instancia de servicio.

ibmcloud dns custom-resolvers [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Liste los programas de resolución personalizados para la instancia dns-demo.

ibmcloud dns custom-resolvers -i "dns-demo"

ibmcloud dns custom-resolver-delete

Suprima un programa de resolución personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-delete RESOLVER_ID [-i, --instance INSTANCE] [-f, --force]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--f, --force
Suprima el programa de resolución personalizado sin solicitar confirmación.

Ejemplos

Suprima un programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc para la instancia dns-demo.

ibmcloud dns custom-resolver-delete f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"

ibmcloud dns custom-resolver-location-add

Agregue una ubicación de resolución personalizada para una instancia de servicio.

ibmcloud dns custom-resolver-location-add RESOLVER_ID --subnet SUBNET_CRN [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
--subnet
El CRN de la subred.
--enabled
Determina si se habilita o no la ubicación del solucionador personalizado.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Agregar una ubicación en el solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo 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

Actualice la ubicación del solucionador personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-location-update RESOLVER_ID LOCATION_ID [--subnet SUBNET_CRN] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
ID_XX_ENCODE_CASE_ONE ubicación
El ID de la ubicación del solucionador personalizado.
--subnet
El CRN de la subred.
--enabled
Determina si se habilita o no la ubicación del solucionador personalizado.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Actualizar la ubicación 9a234ede-c2b6-4c39-bc27-d39ec139ecdb en solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo 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

Elimine la ubicación de resolución personalizada para una instancia de servicio.

ibmcloud dns custom-resolver-location-delete RESOLVER_ID LOCATION_ID [-i, --instance INSTANCE] [-f, --force]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
ID_XX_ENCODE_CASE_ONE ubicación
El ID de la ubicación del solucionador personalizado.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--f, --force
Elimine la ubicación del solucionador personalizado sin solicitar confirmación.

Ejemplos

Eliminar la ubicación 9a234ede-c2b6-4c39-bc27-d39ec139ecdb en solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo dns-demo.

ibmcloud dns custom-resolver-location-delete f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb -i "dns-demo"

ibmcloud dns custom-resolver-forwarding-rule-create

Cree una regla de reenvío del programa de resolución personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-forwarding-rule-create RESOLVER_ID --type TYPE --match HOSTNAME --dns-svcs IPs [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
-t, --type
El tipo de la regla de reenvío. Valores válidos: "zone".
-d, --description
El texto descriptivo de la regla de reenvío del programa de resolución personalizado.
--match
La zona o el nombre de host coincidentes.
--dns-svcs
Los servidores DNS ascendentes se reenvían, por ejemplo, a:ip1,ip2.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Crear una regla de reenvío en un solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo 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

Actualice una regla de reenvío del programa de resolución personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-forwarding-rule-update RESOLVER_ID RULE_ID [--match HOSTNAME] [--dns-svcs IPs] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
ID_REGLA
El ID de la regla de reenvío del programa de resolución personalizado.
-d, --description
El texto descriptivo de la regla de reenvío del programa de resolución personalizado.
--match
La zona o el nombre de host coincidentes.
--dns-svcs
Los servidores DNS ascendentes se reenvían, por ejemplo, a:ip1,ip2.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Actualizar la regla de reenvío 9a234ede-c2b6-4c39-bc27-d39ec139ecdb en solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo 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

Obtenga los detalles de la regla de reenvío de resolución personalizada para una instancia de servicio.

ibmcloud dns custom-resolver-forwarding-rule RESOLVER_ID RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
ID_REGLA
El ID de la regla de reenvío del programa de resolución personalizado.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Obtener la regla de reenvío 9a234ede-c2b6-4c39-bc27-d39ec139ecdb en solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo dns-demo.

ibmcloud dns custom-resolver-forwarding-rule f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb -i "dns-demo"

ibmcloud dns custom-resolver-forwarding-rules

Liste reglas de reenvío del programa de resolución personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-forwarding-rules RESOLVER_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Listar reglas de reenvío en un solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo dns-demo.

ibmcloud dns custom-resolver-forwarding-rules f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"

ibmcloud dns custom-resolver-forwarding-rule-delete

Suprima una regla de reenvío del programa de resolución personalizado para una instancia de servicio.

ibmcloud dns custom-resolver-forwarding-rule-delete RESOLVER_ID RULE_ID [-i, --instance INSTANCE] [-f, --force]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado.
ID_REGLA
El ID de la regla de reenvío de resolución personalizada.
-i, --instance
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
-f, --force
Elimine la regla de reenvío de resolución personalizada sin solicitar confirmación.

Ejemplos

Eliminar la regla de reenvío 9a234ede-c2b6-4c39-bc27-d39ec139ecdb en solucionador personalizado f1aba936b94213e5b8dca0c0dbf1f9cc por ejemplo dns-demo.

ibmcloud dns custom-resolver-forwarding-rule-delete f1aba936b94213e5b8dca0c0dbf1f9cc 9a234ede-c2b6-4c39-bc27-d39ec139ecdb -i "dns-demo"

Zonas secundarias

Administre zonas secundarias utilizando los siguientes comandos de zonas secundarias.

ibmcloud dns secondary-zone-create

Cree una zona secundaria para un programa de resolución personalizado determinado.

ibmcloud dns secondary-zone-create RESOLVER_ID --name NAME --transfer-from ADDRESS1,ADDRESS2 [--description DESCRIPTION] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado. Obligatorio.
--name valor
El nombre de dominio de la zona secundaria.
--transfer-from valor
Las direcciones de origen de la zona secundaria.
--description valor
La descripción de la zona secundaria.
--enabled valor
Determina si la zona secundaria está habilitada o no.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Cree una zona secundaria para el programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc.

ibmcloud dns secondary-zone-create f1aba936b94213e5b8dca0c0dbf1f9cc --name "test.com" --transfer-from 169.13.12.10 -i "dns-demo"

ibmcloud dns secondary-zone-update

Actualizar una zona secundaria.

ibmcloud dns secondary-zone-update RESOLVER_ID SECONDARY_ZONE_ID [--transfer-from ADDRESS1,ADDRESS2] [--description DESCRIPTION] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado. Obligatorio.
ID_ZONA_SECUNDARIA
El ID de la zona secundaria. Obligatorio.
--transfer-from valor
Las direcciones de origen de la zona secundaria.
--description valor
La descripción de la zona secundaria.
--enabled valor
Determina si la zona secundaria está habilitada o no.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Actualizar una zona secundaria e2aba136a93212e5a8dce0c2dbf6f2ee para el programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc.

ibmcloud dns secondary-zone-update f1aba936b94213e5b8dca0c0dbf1f9cc e2aba136a93212e5a8dce0c2dbf6f2ee --transfer-from 169.13.12.10:53 -i "dns-demo"

ibmcloud dns secondary-zone

Obtener los detalles de una zona secundaria.

ibmcloud dns secondary-zone RESOLVER_ID SECONDARY_ZONE_ID [-i, --instance INSTANCE_NAME] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado. Obligatorio.
ID_ZONA_SECUNDARIA
El ID de la zona secundaria. Obligatorio.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Obtenga una zona secundaria e2aba136a93212e5a8dce0c2dbf6f2ee para el programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc.

ibmcloud dns secondary-zone f1aba936b94213e5b8dca0c0dbf1f9cc e2aba136a93212e5a8dce0c2dbf6f2ee -i "dns-demo"

ibmcloud dns secondary-zones

Listar todas las zonas secundarias.

ibmcloud dns secondary-zones RESOLVER_ID [-i, --instance INSTANCE_NAME] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado. Obligatorio.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Listar todas las zonas secundarias para un programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc.

ibmcloud dns secondary-zones f1aba936b94213e5b8dca0c0dbf1f9cc -i "dns-demo"

ibmcloud dns secondary-zone-delete

Suprimir una zona secundaria.

ibmcloud dns secondary-zone-delete RESOLVER_ID SECONDARY_ZONE_ID [-i, --instance INSTANCE_NAME] [--output FORMAT]

Opciones de mandato

ID_RESOLUCIÓN
El ID del solucionador personalizado. Obligatorio.
ID_ZONA_SECUNDARIA
El ID de la zona secundaria. Obligatorio.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

Suprimir una zona secundaria e2aba136a93212e5a8dce0c2dbf6f2ee para un programa de resolución personalizado f1aba936b94213e5b8dca0c0dbf1f9cc.

ibmcloud dns secondary-zone-delete f1aba936b94213e5b8dca0c0dbf1f9cc e2aba136a93212e5a8dce0c2dbf6f2ee -i "dns-demo"

Acceso entre cuentas

Gestione cuentas cruzadas utilizando los siguientes mandatos de acceso entre cuentas.

ibmcloud dns cross-account linked-zone-create

Cree una zona enlazada.

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]

Opciones de mandato

--owner-instance-id valor
El ID de la instancia del propietario.
--owner-zone-id valor
El ID de la zona del propietario.
--label valor
La etiqueta de la zona vinculada.
--description valor
La descripción de la zona enlazada.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

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

Actualizar una zona enlazada.

ibmcloud dns cross-account linked-zone-update LINKED_ZONE_ID [--label LABEL] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_ZONA_ENLAZADA_
El ID de la zona vinculada.
--label valor
La etiqueta de la zona vinculada.
--description valor
La descripción de la zona enlazada.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

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

Listar todas las zonas enlazadas.

ibmcloud dns cross-account linked-zones [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

ibmcloud dns cross-account linked-zones -i "dns-demo"

ibmcloud dns cross-account linked-zone

Obtener detalles de la zona enlazada.

ibmcloud dns cross-account linked-zone LINKED_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_ZONA_ENLAZADA_
El ID de la zona vinculada.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

ibmcloud dns cross-account linked-zone 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 -i "dns-demo"

ibmcloud dns cross-account linked-zone-delete

Suprimir una zona enlazada.

ibmcloud dns cross-account linked-zone-delete LINKED_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_ZONA_ENLAZADA_
El ID de la zona vinculada.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target INSTANCE se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

ibmcloud dns cross-account linked-zone-delete 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 -i "dns-demo"

ibmcloud dns cross-account linked-zone-permitted-network-add

Crear una red permitida para una zona vinculada

   ibmcloud dns cross-account linked-zone-permitted-network-add LINKED_ZONE_ID --vpc-crn VPC_CRN [--type TYPE] [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_ZONA_ENLAZADA_
El ID de la zona vinculada.
--type valor
El tipo de red permitida. Valores válidos: vpc.
--vpc-crn valor
El CRN de la instancia de VPC.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

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

Obtener una red permitida para una zona vinculada

   ibmcloud dns cross-account linked-zone-permitted-network LINKED_ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_ZONA_ENLAZADA_
El ID de la zona vinculada.
ID de red PERMITTED_NETWORK_ID
El ID de la red permitida.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

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

Eliminar una red permitida para una zona vinculada

   ibmcloud dns cross-account linked-zone-permitted-network-remove LINKED_ZONE_ID PERMITTED_NETWORK_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_ZONA_ENLAZADA_
El ID de la zona vinculada.
ID de red PERMITTED_NETWORK_ID
El ID de la red permitida.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

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

Enumerar las redes permitidas para una zona vinculada

   ibmcloud dns cross-account linked-zone-permitted-networks LINKED_ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

ID_ZONA_ENLAZADA_
El ID de la zona vinculada.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

ibmcloud dns cross-account linked-zone-permitted-networks 5365b73c-ce6f-4d6f-ad9f-d9c131b26370 --i "dns-demo"

ibmcloud dns cross-account access-request-update

Actualizar el estado de una solicitud de acceso.

   ibmcloud dns cross-account access-request-update ZONE_ID REQUEST_ID --action ACTION [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona del propietario.
request_id
El ID de la solicitud de acceso.
--action valor
La acción se aplica a la solicitud de acceso. Valores válidos: "APROBAR", "RECHAZAR", "REVOCAR".
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

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

Obtener detalles de una solicitud de acceso.

   ibmcloud dns cross-account access-request ZONE_ID REQUEST_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona del propietario.
request_id
El ID de la solicitud de acceso.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

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

Listar solicitudes de acceso en la instancia del propietario.

   ibmcloud dns cross-account access-requests ZONE_ID [-i, --instance INSTANCE] [--output FORMAT]

Opciones de mandato

zone_id
El ID de la zona del propietario.
-i, --instance valor
Nombre o ID de instancia. Si no se establece, la instancia de contexto especificada por ibmcloud dns instance-target se utiliza.
--output value
Especifique el formato de salida. Actualmente,json es el único formato admitido.

Ejemplos

ibmcloud dns cross-account access-requests 05855abe-3908-4cdc-bf0d-063e0b1c296d --i "dns-demo"