ManagedZones

Para ver uma lista de métodos desse recurso, consulte o fim desta página.

Representações de recursos

Uma zona é uma subárvore do namespace DNS com uma responsabilidade administrativa. Um ManagedZone é um recurso que representa uma zona DNS hospedada pelo serviço Cloud DNS.

{
  "kind": "dns#managedZone",
  "name": string,
  "dnsName": string,
  "description": string,
  "id": unsigned long,
  "nameServers": [
    string
  ],
  "creationTime": string,
  "dnssecConfig": {
    "kind": "dns#managedZoneDnsSecConfig",
    "state": string,
    "defaultKeySpecs": [
      {
        "kind": "dns#dnsKeySpec",
        "keyType": string,
        "algorithm": string,
        "keyLength": unsigned integer
      }
    ],
    "nonExistence": string
  },
  "nameServerSet": string,
  "visibility": string,
  "privateVisibilityConfig": {
    "kind": "dns#managedZonePrivateVisibilityConfig",
    "networks": [
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": string
      }
    ]
  },
  "forwardingConfig": {
    "kind": "dns#managedZoneForwardingConfig",
    "targetNameServers": [
      {
        "kind": "dns#managedZoneForwardingConfigNameServerTarget",
        "ipv4Address": string,
        "forwardingPath": string
      }
    ]
  },
  "labels": {
    (key): string
  },
  "peeringConfig": {
    "kind": "dns#managedZonePeeringConfig",
    "targetNetwork": {
      "kind": "dns#managedZonePeeringConfigTargetNetwork",
      "networkUrl": string,
      "deactivateTime": string
    }
  },
  "reverseLookupConfig": {
    "kind": "dns#managedZoneReverseLookupConfig"
  }
}
Nome da propriedade Valor Descrição Observações
creationTime string Horário em que esse recurso foi criado no servidor. Está no formato de texto RFC3339. Apenas saída.
description string Uma string mutável de no máximo 1.024 caracteres associados a esse recurso para conveniência do usuário. Não tem efeito na função da zona gerenciada.
dnsName string O nome DNS dessa zona gerenciada, por exemplo, "example.com".
dnssecConfig nested object Configuração da DNSSEC.
dnssecConfig.defaultKeySpecs[] list Especifica parâmetros para gerar DnsKeys iniciais para essa ManagedZone. Só podem ser alterados enquanto o estado estiver OFF.
dnssecConfig.defaultKeySpecs[].algorithm string String mnemônica que especifica o algoritmo DNSSEC dessa chave.

Os valores aceitáveis são:
  • "ecdsap256sha256"
  • "ecdsap384sha384"
  • "rsasha1"
  • "rsasha256"
  • "rsasha512"
dnssecConfig.defaultKeySpecs[].keyLength unsigned integer comprimento das chaves em bits.
dnssecConfig.defaultKeySpecs[].keyType string Especifica se é uma chave de assinatura de chave (KSK) ou uma chave de assinatura de zona (ZSK). As chaves de assinatura de chave têm o sinalizador de Ponto de entrada seguro definido e, quando ativo, serão usadas somente para assinar conjuntos de registros de recurso do tipo DNSKEY. As chaves de assinatura da zona não têm a sinalização de Ponto de entrada seguro e serão usadas para assinar todos os outros tipos de conjuntos de registros de recurso.

Os valores aceitáveis são:
  • "keySigning"
  • "zoneSigning"
dnssecConfig.defaultKeySpecs[].kind string Identifica o tipo de recurso. Valor: a string fixa "dns#dnsKeySpec".
dnssecConfig.kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZoneDnsSecConfig".
dnssecConfig.nonExistence string Especifica o mecanismo para respostas autenticadas de negação de existência. Só pode ser alterado enquanto o estado estiver OFF.

Os valores aceitáveis são:
  • "nsec"
  • "nsec3"
dnssecConfig.state string Especifica se a DNSSEC está ativada e em qual modo ela está.

Os valores aceitáveis são:
  • "off"
  • "on"
  • "transfer"
forwardingConfig nested object A presença deste campo indica que o encaminhamento de saída está ativado para esta zona. O valor deste campo contém o conjunto de destinos a serem encaminhados.
forwardingConfig.kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZoneForwardingConfig".
forwardingConfig.targetNameServers[] list Lista de servidores de nomes de destino a serem encaminhados. O Cloud DNS selecionará o melhor servidor de nomes disponível se mais de um destino for fornecido.
forwardingConfig.targetNameServers[].forwardingPath string Caminho de encaminhamento para este NameServerTarget. Se não for definido ou definido como DEFAULT, o Cloud DNS tomará uma decisão de encaminhamento com base em intervalos de endereços, ou seja, endereços RFC1918 vão para a VPC, e endereços não RFC1918 vão para a Internet. Quando definido como PRIVATE, o Cloud DNS sempre enviará consultas por meio da VPC para esse destino.

Os valores aceitáveis são:
  • "default"
  • "private"
forwardingConfig.targetNameServers[].ipv4Address string Endereço IPv4 de um servidor de nomes de destino.
forwardingConfig.targetNameServers[].kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZoneForwardingConfigNameServerTarget".
id unsigned long Identificador exclusivo do recurso. definida pelo servidor (somente saída)
kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZone".
labels object Rótulos do usuário.
labels.(key) string
name string Nome atribuído pelo usuário a este recurso. Precisa ser exclusivo no projeto. O nome precisa ter de 1 a 63 caracteres, começar com uma letra, terminar com uma letra ou um dígito e conter apenas letras minúsculas, dígitos ou traços.
nameServerSet string Opcionalmente, especifica o NameServerSet para esta ManagedZone. Um NameServerSet é um conjunto de servidores de nomes DNS que hospedam as mesmas ManagedZones. A maioria dos usuários deixará esse campo não definido.
nameServers[] list Delegar sua managed_zone para esses servidores de nomes virtuais; definidos pelo servidor (somente saída)
peeringConfig nested object A presença deste campo indica que o peering de DNS está ativado para esta zona. O valor deste campo contém a rede para peering.
peeringConfig.kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZonePeeringConfig".
peeringConfig.targetNetwork nested object A rede a ser pareada.
peeringConfig.targetNetwork.deactivateTime string O horário em que a zona foi desativada, no formato de data e hora RFC 3339. Uma string vazia indica que a conexão de peering está ativa. A rede do produtor pode desativar uma zona. A zona será desativada automaticamente se a rede produtora que a zona segmentou for excluída. Apenas saída.
peeringConfig.targetNetwork.kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZonePeeringConfigTargetNetwork".
peeringConfig.targetNetwork.networkUrl string O URL totalmente qualificado da rede VPC ao qual encaminhará as consultas. Ele precisa estar formatado como https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
privateVisibilityConfig nested object Para zonas visíveis de modo privado, o conjunto de recursos de nuvem privada virtual que contém a zona visível.
privateVisibilityConfig.kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZonePrivateVisibilityConfig".
privateVisibilityConfig.networks[] list A lista de redes VPC que podem ver essa zona.
privateVisibilityConfig.networks[].kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZonePrivateVisibilityConfigNetwork".
privateVisibilityConfig.networks[].networkUrl string O URL totalmente qualificado da rede VPC a ser vinculada. Ele deve ser formatado como https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
reverseLookupConfig nested object A presença desse campo indica que essa é uma zona de pesquisa reversa gerenciada e o Cloud DNS resolverá consultas de pesquisa reversa usando registros configurados automaticamente para recursos da VPC. Isso se aplica apenas a redes listadas em private_visibility_config.
reverseLookupConfig.kind string Identifica o tipo de recurso. Valor: a string fixa "dns#managedZoneReverseLookupConfig".
visibility string A visibilidade da zona: as zonas públicas são expostas à Internet, enquanto as zonas privadas são visíveis apenas para os recursos da nuvem privada virtual.

Os valores aceitáveis são:
  • "private"
  • "public"

Métodos

criar
Para criar uma nova zona gerenciada.
delete
Excluir uma ManagedZone criada anteriormente.
get
Busque a representação de uma ManagedZone existente.
list
Enumerar ManagedZones que foram criadas, mas ainda não excluídas.
patch
Aplique uma atualização parcial a uma ManagedZone existente.
atualizar
Atualize uma ManagedZone existente.