gcloud: Fri Jun 2 10:25:45 UTC 2023

gcloud/beta/network-security/firewall-endpoint-associations/create

@@ -0,0 +1,150 @@
+NAME
+    gcloud beta network-security firewall-endpoint-associations create - create
+        a Firewall Plus endpoint association
+
+SYNOPSIS
+    gcloud beta network-security firewall-endpoint-associations create
+        (FIREWALL_ENDPOINT_ASSOCIATION : --zone=ZONE) --network=NETWORK
+        (--endpoint=ENDPOINT
+          : --endpoint-zone=ENDPOINT_ZONE --organization=ORGANIZATION)
+        [--async] [--labels=[KEY=VALUE,...]]
+        [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) Associate the specified network with the firewall endpoint.
+    Successful creation of a firewall endpoint association results in an
+    association in READY state. Check the progress of association creation by
+    using gcloud network-security firewall-endpoint-associations list.
+
+    For more examples, refer to the EXAMPLES section below.
+
+EXAMPLES
+    To associate a network with a firewall endpoint, run:
+
+        $ gcloud beta network-security firewall-endpoint-associations \
+          create my-assoc \
+          --network=projects/my-project/networks/global/myNetwork \
+          --endpoint=organizations/1234/locations/us-central1-a/\
+        firewallEndpoints/my-endpoint --zone=us-central1-a \
+            --project=my-project
+
+POSITIONAL ARGUMENTS
+     Firewall endpoint association resource - Firewall Plus. The arguments in
+     this group can be used to specify the attributes of this resource. (NOTE)
+     Some attributes are not given arguments in this group but can be set in
+     other ways.
+
+     To set the project attribute:
+      ◆ provide the argument FIREWALL_ENDPOINT_ASSOCIATION on the command
+        line with a fully specified name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+     This must be specified.
+
+       FIREWALL_ENDPOINT_ASSOCIATION
+          ID of the firewall endpoint association or fully qualified identifier
+          for the firewall endpoint association.
+
+          To set the association-name attribute:
+          ▸ provide the argument FIREWALL_ENDPOINT_ASSOCIATION on the command
+            line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --zone=ZONE
+          Zone of the firewall endpoint association.
+
+          To set the zone attribute:
+          ▸ provide the argument FIREWALL_ENDPOINT_ASSOCIATION on the command
+            line with a fully specified name;
+          ▸ provide the argument --zone on the command line.
+
+REQUIRED FLAGS
+     Network resource - Firewall Plus. 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 project attribute:
+      ◆ provide the argument --network on the command line with a fully
+        specified name;
+      ◆ provide the argument --project on the command line;
+      ◆ set the property core/project.
+
+     This must be specified.
+
+       --network=NETWORK
+          ID of the network or fully qualified identifier for the network.
+
+          To set the network-name attribute:
+          ▸ provide the argument --network on the command line.
+
+     Firewall endpoint resource - Firewall Plus. The arguments in this group
+     can be used to specify the attributes of this resource.
+
+     This must be specified.
+
+       --endpoint=ENDPOINT
+          ID of the firewall endpoint or fully qualified identifier for the
+          firewall endpoint.
+
+          To set the endpoint-name attribute:
+          ▸ provide the argument --endpoint on the command line.
+
+          This flag argument must be specified if any of the other arguments in
+          this group are specified.
+
+       --endpoint-zone=ENDPOINT_ZONE
+          Zone of the firewall endpoint.
+
+          To set the endpoint-zone attribute:
+          ▸ provide the argument --endpoint on the command line with a fully
+            specified name;
+          ▸ provide the argument --endpoint-zone on the command line;
+          ▸ provide the argument --zone on the command line;
+          ▸ provide the argument FIREWALL_ENDPOINT_ASSOCIATION on the command
+            line with a fully specified name.
+
+       --organization=ORGANIZATION
+          Organization ID to which the changes should apply.
+
+          To set the organization attribute:
+          ▸ provide the argument --endpoint on the command line with a fully
+            specified name;
+          ▸ provide the argument --organization on the command line.
+
+OPTIONAL FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete. The default is True. Enabled by default, use --no-async to
+        disable.
+
+     --labels=[KEY=VALUE,...]
+        List of label KEY=VALUE pairs to add.
+
+        Keys must start with a lowercase character and contain only hyphens
+        (-), underscores (_), lowercase characters, and numbers. Values must
+        contain only hyphens (-), underscores (_), lowercase characters, and
+        numbers.
+
+     --max-wait=MAX_WAIT; default="60m"
+        Time to synchronously wait for the operation to complete, after which
+        the operation continues asynchronously. Ignored if --no-async isn't
+        specified. See $ gcloud topic datetimes for information on time
+        formats.
+
+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 $ gcloud help for details.
+
+NOTES
+    This command is currently in beta and might change without notice. This
+    variant is also available:
+
+        $ gcloud alpha network-security firewall-endpoint-associations create
+