.TH "GCLOUD_ALPHA_DNS_POLICIES_CREATE" 1



.SH "NAME"
.HP
gcloud alpha dns policies create \- creates a new Cloud DNS policy



.SH "SYNOPSIS"
.HP
\f5gcloud alpha dns policies create\fR \fIPOLICY\fR \fB\-\-description\fR=\fIDESCRIPTION\fR \fB\-\-networks\fR=[\fINETWORKS\fR,...] [\fB\-\-alternative\-name\-servers\fR=[\fINAME_SERVERS\fR,...]] [\fB\-\-enable\-dns64\-all\-queries\fR] [\fB\-\-enable\-inbound\-forwarding\fR] [\fB\-\-enable\-logging\fR] [\fB\-\-private\-alternative\-name\-servers\fR=[\fINAME_SERVERS\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR This command creates a new Cloud DNS policy.



.SH "EXAMPLES"

To create a new policy with minimal arguments, run:

.RS 2m
$ gcloud alpha dns policies create mypolicy \e
    \-\-description='My new policy test policy 5' \-\-networks=''
.RE

To create a new policy with all optional arguments, run:

.RS 2m
$ gcloud alpha dns policies create mypolicy \e
    \-\-description='My new policy test policy 5' \e
    \-\-networks=network1,network2 \e
    \-\-alternative\-name\-servers=192.168.1.1,192.168.1.2 \e
    \-\-private\-alternative\-name\-servers=100.64.0.1 \e
    \-\-enable\-inbound\-forwarding \-\-enable\-logging \e
    \-\-enable\-dns64\-all\-queries
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Policy resource \- The policy to create. This represents a Cloud resource.
(NOTE) Some attributes are not given arguments in this group but can be set in
other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5policy\fR on the command line with a fully specified
name;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIPOLICY\fR

ID of the policy or fully qualified identifier for the policy.

To set the \f5policy\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5policy\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

A description of the policy.

.TP 2m
\fB\-\-networks\fR=[\fINETWORKS\fR,...]

The comma separated list of network names to associate with the policy.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-alternative\-name\-servers\fR=[\fINAME_SERVERS\fR,...]

List of alternative name servers to forward to. Non\-RFC1918 addresses will
forward to the target through the Internet.RFC1918 addresses will forward
through the VPC.

.TP 2m
\fB\-\-enable\-dns64\-all\-queries\fR

Specifies whether to allow networks bound to this policy to use DNS64 for
IPv6\-only VM instances.

.TP 2m
\fB\-\-enable\-inbound\-forwarding\fR

Specifies whether to allow networks bound to this policy to receive DNS queries
sent by VMs or applications over VPN connections. Defaults to False.

.TP 2m
\fB\-\-enable\-logging\fR

Specifies whether to enable query logging. Defaults to False.

.TP 2m
\fB\-\-private\-alternative\-name\-servers\fR=[\fINAME_SERVERS\fR,...]

List of alternative name servers to forward to. All addresses specified for this
parameter will be reached through the VPC.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "NOTES"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

.RS 2m
$ gcloud dns policies create
.RE

.RS 2m
$ gcloud beta dns policies create
.RE