gcloud-help/gcloud/beta/saas-runtime/flags/releases/create

NAME
    gcloud beta saas-runtime flags releases create - create Flag Release

SYNOPSIS
    gcloud beta saas-runtime flags releases create FLAG_RELEASE
        --unit-kind=UNIT_KIND [--annotations=[ANNOTATIONS,...]]
        [--labels=[LABELS,...]] [--location=LOCATION]
        [--obsolete-flags=[OBSOLETE_FLAGS,...]]
        [--all-flags | --flag-sets=[FLAG_SETS,...]
          | --revisions=[REVISIONS,...]] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Create a new Flag Release resource. A Flag Release defines a
    specific set of flag revisions to be applied to a UnitKind. It serves as
    the immutable input for a Rollout.

EXAMPLES
    To create a targeted Flag Release for specific flag revisions, run:

        $ gcloud beta saas-runtime flags releases create my-release \
          --unit-kind=my-unit-kind --revisions=rev-1,rev-2 \
          --location=global

    To create a Flag Release that includes all current flags in a UnitKind,
    run:

        $ gcloud beta saas-runtime flags releases create full-sync \
          --unit-kind=my-unit-kind --all-flags --location=global

POSITIONAL ARGUMENTS
     FlagRelease resource - ID of the Flag Release:

         "projects/{project}/locations/{location}/flagReleases/{flag_release_id}"

     This follows the standard Google Cloud naming scheme (URI). 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 flag_release on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument flag_release on the command line with a fully
        specified name;
      ◆ provide the argument --location on the command line.

     This must be specified.

       FLAG_RELEASE
          ID of the flagRelease or fully qualified identifier for the
          flagRelease.

          To set the flag_release attribute:
          ▸ provide the argument flag_release on the command line.

REQUIRED FLAGS
     UnitKind resource - UnitKind (ID) this Flag Release applies to. 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 --unit-kind on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument --unit-kind on the command line with a fully
        specified name;
      ◆ provide the argument --location on the command line.

     This must be specified.

       --unit-kind=UNIT_KIND
          ID of the unitKind or fully qualified identifier for the unitKind.

          To set the unit-kind attribute:
          ▸ provide the argument --unit-kind on the command line.

OPTIONAL FLAGS
     --annotations=[ANNOTATIONS,...]
        Unstructured key-value map stored with a resource that may be set by
        external tools to store and retrieve arbitrary metadata. Annotations
        are not queryable and should be preserved when modifying objects.

         KEY
            Sets KEY value.

         VALUE
            Sets VALUE value.

        Shorthand Example:

            --annotations=string=string

        JSON Example:

            --annotations='{"string": "string"}'

        File Example:

            --annotations=path_to_file.(yaml|json)

     --labels=[LABELS,...]
        Labels on the resource, which can be used for categorization.

         KEY
            Keys must start with a lowercase character and contain only hyphens
            (-), underscores (_), lowercase characters, and numbers.

         VALUE
            Values must contain only hyphens (-), underscores (_), lowercase
            characters, and numbers.

        Shorthand Example:

            --labels=string=string

        JSON Example:

            --labels='{"string": "string"}'

        File Example:

            --labels=path_to_file.(yaml|json)

     --location=LOCATION
        For resources [flag_release, obsolete-flags, revisions, unit-kind],
        provides fallback value for resource location attribute. When the
        resource's full URI path is not provided, location will fallback to
        this flag value.

     Flag resource - Flags (IDs) to be removed from the given UnitKind and all
     the related Units. If Flag (ID) is provided here, its Flag Revisions will
     be removed from the UnitKind and Units. 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 --obsolete-flags on the command line with a
        fully specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     To set the location attribute:
      ◆ provide the argument --obsolete-flags on the command line with a
        fully specified name;
      ◆ provide the argument --location on the command line.

     --obsolete-flags=[OBSOLETE_FLAGS,...]
        IDs of the flags or fully qualified identifiers for the flags.

        To set the flag attribute:
        ◆ provide the argument --obsolete-flags on the command line.

     Flags for specifying the content of the release. You can use only one of
     the following flags.

     At most one of these can be specified:

       --all-flags
          All flags in the flag release's unit kind will be included to be
          rolled out.

       --flag-sets=[FLAG_SETS,...]
          Flag sets to be rolled out. All flags in provided flag sets that are
          in the flag release's unit kind will be included to be rolled out.

       Or at least one of these can be specified:

         FlagRevision resource - Flag Revisions (IDs) to be rolled out. 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 --revisions on the command line with a fully
            specified name;
          ▫ provide the argument --project on the command line;
          ▫ set the property core/project.

         To set the location attribute:
          ▫ provide the argument --revisions on the command line with a fully
            specified name;
          ▫ provide the argument --location on the command line.

         --revisions=[REVISIONS,...]
            IDs of the flagRevisions or fully qualified identifiers for the
            flagRevisions.

            To set the flag-revision attribute:
            ▫ provide the argument --revisions on the command line.

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.

API REFERENCE
    This command uses the saasservicemgmt/v1beta1 API. The full documentation
    for this API can be found at: https://cloud.google.com/saas-runtime/docs

NOTES
    This command is currently in beta and might change without notice.