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. 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 esse 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 direcionados à 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 este 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 a 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
Busca a representação de uma Política existente.
list
Enumerar todas as políticas associadas a um projeto.
patch
Aplicar uma atualização parcial a uma política atual.
atualizar
Atualizar uma política existente.