Docs Packages
  1. Packages
  2. Google Cloud Native
  3. API Docs
  4. dns
  5. dns/v1beta2
  6. Policy

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.31.1 published on Thursday, Jul 20, 2023 by Pulumi
pulumi/pulumi-google-native

google-native.dns/v1beta2.Policy

Explore with Pulumi AI

google-native logo

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.31.1 published on Thursday, Jul 20, 2023 by Pulumi
pulumi/pulumi-google-native

    Creates a new Policy.

    Create Policy Resource

    new Policy(name: string, args?: PolicyArgs, opts?: CustomResourceOptions);
    @overload
def Policy(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           alternative_name_server_config: Optional[PolicyAlternativeNameServerConfigArgs] = None,
           client_operation_id: Optional[str] = None,
           description: Optional[str] = None,
           enable_inbound_forwarding: Optional[bool] = None,
           enable_logging: Optional[bool] = None,
           kind: Optional[str] = None,
           name: Optional[str] = None,
           networks: Optional[Sequence[PolicyNetworkArgs]] = None,
           project: Optional[str] = None)
@overload
def Policy(resource_name: str,
           args: Optional[PolicyArgs] = None,
           opts: Optional[ResourceOptions] = None)
    func NewPolicy(ctx *Context, name string, args *PolicyArgs, opts ...ResourceOption) (*Policy, error)
    public Policy(string name, PolicyArgs? args = null, CustomResourceOptions? opts = null)
    public Policy(String name, PolicyArgs args)
public Policy(String name, PolicyArgs args, CustomResourceOptions options)

    type: google-native:dns/v1beta2:Policy
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args PolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args PolicyArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args PolicyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args PolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args PolicyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Policy Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The Policy resource accepts the following input properties:

    AlternativeNameServerConfig Pulumi.GoogleNative.DNS.V1Beta2.Inputs.PolicyAlternativeNameServerConfig

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    ClientOperationId string

    For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

    Description string

    A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.

    EnableInboundForwarding bool

    Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.

    EnableLogging bool

    Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.

    Kind string
    Name string

    User-assigned name for this policy.

    Networks List<Pulumi.GoogleNative.DNS.V1Beta2.Inputs.PolicyNetwork>

    List of network names specifying networks to which this policy is applied.

    Project string
    AlternativeNameServerConfig PolicyAlternativeNameServerConfigArgs

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    ClientOperationId string

    For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

    Description string

    A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.

    EnableInboundForwarding bool

    Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.

    EnableLogging bool

    Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.

    Kind string
    Name string

    User-assigned name for this policy.

    Networks []PolicyNetworkArgs

    List of network names specifying networks to which this policy is applied.

    Project string
    alternativeNameServerConfig PolicyAlternativeNameServerConfig

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    clientOperationId String

    For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

    description String

    A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.

    enableInboundForwarding Boolean

    Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.

    enableLogging Boolean

    Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.

    kind String
    name String

    User-assigned name for this policy.

    networks List<PolicyNetwork>

    List of network names specifying networks to which this policy is applied.

    project String
    alternativeNameServerConfig PolicyAlternativeNameServerConfig

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    clientOperationId string

    For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

    description string

    A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.

    enableInboundForwarding boolean

    Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.

    enableLogging boolean

    Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.

    kind string
    name string

    User-assigned name for this policy.

    networks PolicyNetwork[]

    List of network names specifying networks to which this policy is applied.

    project string
    alternative_name_server_config PolicyAlternativeNameServerConfigArgs

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    client_operation_id str

    For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

    description str

    A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.

    enable_inbound_forwarding bool

    Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.

    enable_logging bool

    Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.

    kind str
    name str

    User-assigned name for this policy.

    networks Sequence[PolicyNetworkArgs]

    List of network names specifying networks to which this policy is applied.

    project str
    alternativeNameServerConfig Property Map

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    clientOperationId String

    For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

    description String

    A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the policy's function.

    enableInboundForwarding Boolean

    Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.

    enableLogging Boolean

    Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.

    kind String
    name String

    User-assigned name for this policy.

    networks List<Property Map>

    List of network names specifying networks to which this policy is applied.

    project String

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Policy resource produces the following output properties:

    Id string

    The provider-assigned unique ID for this managed resource.

    Id string

    The provider-assigned unique ID for this managed resource.

    id String

    The provider-assigned unique ID for this managed resource.

    id string

    The provider-assigned unique ID for this managed resource.

    id str

    The provider-assigned unique ID for this managed resource.

    id String

    The provider-assigned unique ID for this managed resource.

    Supporting Types

    PolicyAlternativeNameServerConfig, PolicyAlternativeNameServerConfigArgs

    Kind string
    TargetNameServers List<Pulumi.GoogleNative.DNS.V1Beta2.Inputs.PolicyAlternativeNameServerConfigTargetNameServer>

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    Kind string
    TargetNameServers []PolicyAlternativeNameServerConfigTargetNameServer

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind String
    targetNameServers List<PolicyAlternativeNameServerConfigTargetNameServer>

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind string
    targetNameServers PolicyAlternativeNameServerConfigTargetNameServer[]

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind str
    target_name_servers Sequence[PolicyAlternativeNameServerConfigTargetNameServer]

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind String
    targetNameServers List<Property Map>

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    PolicyAlternativeNameServerConfigResponse, PolicyAlternativeNameServerConfigResponseArgs

    Kind string
    TargetNameServers List<Pulumi.GoogleNative.DNS.V1Beta2.Inputs.PolicyAlternativeNameServerConfigTargetNameServerResponse>

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    Kind string
    TargetNameServers []PolicyAlternativeNameServerConfigTargetNameServerResponse

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind String
    targetNameServers List<PolicyAlternativeNameServerConfigTargetNameServerResponse>

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind string
    targetNameServers PolicyAlternativeNameServerConfigTargetNameServerResponse[]

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind str
    target_name_servers Sequence[PolicyAlternativeNameServerConfigTargetNameServerResponse]

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    kind String
    targetNameServers List<Property Map>

    Sets an alternative name server for the associated networks. When specified, all DNS queries are forwarded to a name server that you choose. Names such as .internal are not available when an alternative name server is specified.

    PolicyAlternativeNameServerConfigTargetNameServer, PolicyAlternativeNameServerConfigTargetNameServerArgs

    ForwardingPath Pulumi.GoogleNative.DNS.V1Beta2.PolicyAlternativeNameServerConfigTargetNameServerForwardingPath

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    Ipv4Address string

    IPv4 address to forward queries to.

    Ipv6Address string

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    Kind string
    ForwardingPath PolicyAlternativeNameServerConfigTargetNameServerForwardingPath

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    Ipv4Address string

    IPv4 address to forward queries to.

    Ipv6Address string

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    Kind string
    forwardingPath PolicyAlternativeNameServerConfigTargetNameServerForwardingPath

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4Address String

    IPv4 address to forward queries to.

    ipv6Address String

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind String
    forwardingPath PolicyAlternativeNameServerConfigTargetNameServerForwardingPath

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4Address string

    IPv4 address to forward queries to.

    ipv6Address string

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind string
    forwarding_path PolicyAlternativeNameServerConfigTargetNameServerForwardingPath

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4_address str

    IPv4 address to forward queries to.

    ipv6_address str

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind str
    forwardingPath "default" | "private"

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4Address String

    IPv4 address to forward queries to.

    ipv6Address String

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind String

    PolicyAlternativeNameServerConfigTargetNameServerForwardingPath, PolicyAlternativeNameServerConfigTargetNameServerForwardingPathArgs

    Default
    default

    Cloud DNS makes forwarding decision based on IP address ranges; that is, RFC1918 addresses forward to the target through the VPC and non-RFC1918 addresses forward to the target through the internet

    Private
    private

    Cloud DNS always forwards to this target through the VPC.

    PolicyAlternativeNameServerConfigTargetNameServerForwardingPathDefault
    default

    Cloud DNS makes forwarding decision based on IP address ranges; that is, RFC1918 addresses forward to the target through the VPC and non-RFC1918 addresses forward to the target through the internet

    PolicyAlternativeNameServerConfigTargetNameServerForwardingPathPrivate
    private

    Cloud DNS always forwards to this target through the VPC.

    Default
    default

    Cloud DNS makes forwarding decision based on IP address ranges; that is, RFC1918 addresses forward to the target through the VPC and non-RFC1918 addresses forward to the target through the internet

    Private
    private

    Cloud DNS always forwards to this target through the VPC.

    Default
    default

    Cloud DNS makes forwarding decision based on IP address ranges; that is, RFC1918 addresses forward to the target through the VPC and non-RFC1918 addresses forward to the target through the internet

    Private
    private

    Cloud DNS always forwards to this target through the VPC.

    DEFAULT
    default

    Cloud DNS makes forwarding decision based on IP address ranges; that is, RFC1918 addresses forward to the target through the VPC and non-RFC1918 addresses forward to the target through the internet

    PRIVATE
    private

    Cloud DNS always forwards to this target through the VPC.

    "default"
    default

    Cloud DNS makes forwarding decision based on IP address ranges; that is, RFC1918 addresses forward to the target through the VPC and non-RFC1918 addresses forward to the target through the internet

    "private"
    private

    Cloud DNS always forwards to this target through the VPC.

    PolicyAlternativeNameServerConfigTargetNameServerResponse, PolicyAlternativeNameServerConfigTargetNameServerResponseArgs

    ForwardingPath string

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    Ipv4Address string

    IPv4 address to forward queries to.

    Ipv6Address string

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    Kind string
    ForwardingPath string

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    Ipv4Address string

    IPv4 address to forward queries to.

    Ipv6Address string

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    Kind string
    forwardingPath String

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4Address String

    IPv4 address to forward queries to.

    ipv6Address String

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind String
    forwardingPath string

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4Address string

    IPv4 address to forward queries to.

    ipv6Address string

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind string
    forwarding_path str

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4_address str

    IPv4 address to forward queries to.

    ipv6_address str

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind str
    forwardingPath String

    Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.

    ipv4Address String

    IPv4 address to forward queries to.

    ipv6Address String

    IPv6 address to forward to. Does not accept both fields (ipv4 & ipv6) being populated. Public preview as of November 2022.

    kind String

    PolicyNetwork, PolicyNetworkArgs

    Kind string
    NetworkUrl string

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    Kind string
    NetworkUrl string

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind String
    networkUrl String

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind string
    networkUrl string

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind str
    network_url str

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind String
    networkUrl String

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    PolicyNetworkResponse, PolicyNetworkResponseArgs

    Kind string
    NetworkUrl string

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    Kind string
    NetworkUrl string

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind String
    networkUrl String

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind string
    networkUrl string

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind str
    network_url str

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    kind String
    networkUrl String

    The fully qualified URL of the VPC network to bind to. This should be formatted like https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}

    Package Details

    Repository
    Google Cloud Native pulumi/pulumi-google-native
    License
    Apache-2.0
    google-native logo

    Google Cloud Native is in preview. Google Cloud Classic is fully supported.

    Google Cloud Native v0.31.1 published on Thursday, Jul 20, 2023 by Pulumi
    pulumi/pulumi-google-native