File: //snap/google-cloud-cli/394/help/man/man1/gcloud_compute_firewall-policies_associations_create.1
.TH "GCLOUD_COMPUTE_FIREWALL\-POLICIES_ASSOCIATIONS_CREATE" 1
.SH "NAME"
.HP
gcloud compute firewall\-policies associations create \- create a new association between a firewall policy and an organization or folder resource
.SH "SYNOPSIS"
.HP
\f5gcloud compute firewall\-policies associations create\fR \fB\-\-firewall\-policy\fR=\fIFIREWALL_POLICY\fR [\fB\-\-folder\fR=\fIFOLDER\fR] [\fB\-\-name\fR=\fINAME\fR] [\fB\-\-organization\fR=\fIORGANIZATION\fR] [\fB\-\-replace\-association\-on\-target\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
\fBgcloud compute firewall\-policies associations create\fR is used to create
organization firewall policy associations. An organization firewall policy is a
set of rules that controls access to various resources.
.SH "EXAMPLES"
To associate an organization firewall policy under folder with ID ``123456789"
to folder ``987654321", run:
.RS 2m
$ gcloud compute firewall\-policies associations create \e
\-\-firewall\-policy=123456789 \-\-folder=987654321
.RE
.SH "REQUIRED FLAGS"
.RS 2m
.TP 2m
\fB\-\-firewall\-policy\fR=\fIFIREWALL_POLICY\fR
Security policy ID of the association.
.RE
.sp
.SH "OPTIONAL FLAGS"
.RS 2m
.TP 2m
\fB\-\-folder\fR=\fIFOLDER\fR
ID of the folder with which the association is created.
.TP 2m
\fB\-\-name\fR=\fINAME\fR
Name to identify this association. If unspecified, the name will be set to
"organization\-{ORGANIZATION_ID}" or "folder\-{FOLDER_ID}".
.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION\fR
ID of the organization in which the firewall policy is to be associated. Must be
set if FIREWALL_POLICY is short name.
.TP 2m
\fB\-\-replace\-association\-on\-target\fR
By default, if you attempt to insert an association to an organization or folder
resource that is already associated with a firewall policy the method will fail.
If this is set, the existing association will be deleted at the same time that
the new association is created.
.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"
These variants are also available:
.RS 2m
$ gcloud alpha compute firewall\-policies associations create
.RE
.RS 2m
$ gcloud beta compute firewall\-policies associations create
.RE