Políticas

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

Representações de recursos

Uma política é um conjunto de regras de DNS aplicadas a um ou mais recursos de nuvem privada virtual.

{
  "kind": "dns#policy",
  "id": unsigned long,
  "name": string,
  "enableInboundForwarding": boolean,
  "description": string,
  "networks": [
    {
      "kind": "dns#policyNetwork",
      "networkUrl": string
    }
  ],
  "alternativeNameServerConfig": {
    "kind": "dns#policyAlternativeNameServerConfig",
    "targetNameServers": [
      {
        "kind": "dns#policyAlternativeNameServerConfigTargetNameServer",
        "ipv4Address": string,
        "forwardingPath": string
      }
    ]
  },
  "enableLogging": boolean
}
Nome da propriedade Valor Descrição Observações
alternativeNameServerConfig nested object Define um servidor de nomes alternativo para as redes associadas. Quando especificadas, todas as consultas DNS são encaminhadas para um servidor de nomes escolhido por você. Nomes como .internal não estão disponíveis quando um servidor de nomes alternativo é especificado.
alternativeNameServerConfig.kind string Identifica o tipo de recurso. Valor: a string fixa "dns#policyAlternativeNameServerConfig".
alternativeNameServerConfig.targetNameServers[] list Define um servidor de nomes alternativo para as redes associadas. Quando especificadas, todas as consultas DNS são encaminhadas para um servidor de nomes escolhido por você. Nomes como .internal não estão disponíveis quando um servidor de nomes alternativo é especificado.
alternativeNameServerConfig.targetNameServers[].forwardingPath string Caminho de encaminhamento para este TargetNameServer. Se não for definido ou for definido como DEFAULT, o Cloud DNS tomará as decisões de encaminhamento com base nos intervalos de endereços, ou seja, os endereços RFC1918 serão enviados para a VPC. Os 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 este destino:

Valores aceitáveis são:
  • "default"
  • "private"
alternativeNameServerConfig.targetNameServers[].ipv4Address string Endereço IPv4 para encaminhamento.
alternativeNameServerConfig.targetNameServers[].kind string Identifica o tipo de recurso. Valor: a string fixa "dns#policyAlternativeNameServerConfigTargetNameServer".
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 política.
enableInboundForwarding boolean Permite que as redes vinculadas a essa política recebam consultas DNS enviadas por VMs ou aplicativos por conexões VPN. Quando ativado, um endereço IP virtual será alocado de cada uma das sub-redes vinculadas a essa política.
enableLogging boolean Controla se a geração de registros está ativada nas redes vinculadas a essa política. Se nenhum valor for definido, o padrão será sem registro.
id unsigned long Identificador exclusivo do recurso; definido pelo servidor (somente saída).
kind string Identifica o tipo de recurso. Valor: a string fixa "dns#policy".
name string Nome atribuído pelo usuário para esta política.
networks[] list Lista de nomes de redes que especificam as redes às quais essa política é aplicada.
networks[].kind string Identifica o tipo de recurso. Valor: a string fixa "dns#policyNetwork".
networks[].networkUrl string O URL totalmente qualificado da rede VPC que será vinculada. Ele precisa ser formatado como https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

Métodos

criar
Criar uma nova política
delete
Excluir uma política criada anteriormente. Falhará se a política ainda estiver sendo referenciada por uma rede.
get
Busque a representação de uma política existente.
list
Enumerar todas as políticas associadas a um projeto.
patch
Aplique uma atualização parcial a uma política existente.
atualizar
Atualizar uma política existente.