NAME
    gcloud alpha number-registry custom-ranges create - create a custom range
        resource

SYNOPSIS
    gcloud alpha number-registry custom-ranges create CUSTOM_RANGE [--async]
        [--attributes=[key=KEY],[value=VALUE]] [--description=DESCRIPTION]
        [--labels=[LABELS,...]] [--location=LOCATION]
        [--parent-range=PARENT_RANGE] [--realm=REALM] [--request-id=REQUEST_ID]
        [--ipv4-cidr-range=IPV4_CIDR_RANGE | --ipv6-cidr-range=IPV6_CIDR_RANGE]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Create a custom range resource.

EXAMPLES
    To create a custom range my-custom-range run:

        $ gcloud alpha number-registry custom-ranges create \
            my-custom-range --location=global --realm=my-realm \
            --ipv4-cidr-range=10.0.0.0/24 \

POSITIONAL ARGUMENTS
     CustomRange resource - Identifier. name of resource 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 custom_range 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 custom_range on the command line with a fully
        specified name;
      ◆ provide the argument --location on the command line.

     This must be specified.

       CUSTOM_RANGE
          ID of the customRange or fully qualified identifier for the
          customRange.

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

FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --attributes=[key=KEY],[value=VALUE]
        The attributes of the CustomRange.

         key
            Key of attribute.

         value
            Value of attribute.

        Shorthand Example:

            --attributes=key=string,value=string --attributes=key=string,value=string

        JSON Example:

            --attributes='[{"key": "string", "value": "string"}]'

        File Example:

            --attributes=path_to_file.(yaml|json)

     --description=DESCRIPTION
        Description of the CustomRange.

     --labels=[LABELS,...]
        Labels as key value pairs.

         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 [custom_range, parent-range, realm], provides fallback
        value for resource location attribute. When the resource's full URI
        path is not provided, location will fallback to this flag value.

     CustomRange resource - The parent range of the CustomRange. Do not allow
     setting parent range if realm is specified. Format must follow this
     pattern:
     projects/{project}/locations/{location}/customRanges/{custom_range} 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 --parent-range 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 --parent-range on the command line with a fully
        specified name;
      ◆ provide the argument --location on the command line.

     --parent-range=PARENT_RANGE
        ID of the customRange or fully qualified identifier for the
        customRange.

        To set the custom-range attribute:
        ◆ provide the argument --parent-range on the command line.

     Realm resource - The realm of the CustomRange. The realm must be in the
     same project as the custom range. Do not allow setting realm if parent
     range is specified, since the realm should be inherited from the parent
     range. Format must follow this pattern:
     projects/{project}/locations/{location}/realms/{realm} 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 --realm 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 --realm on the command line with a fully
        specified name;
      ◆ provide the argument --location on the command line.

     --realm=REALM
        ID of the realm or fully qualified identifier for the realm.

        To set the realm attribute:
        ◆ provide the argument --realm on the command line.

     --request-id=REQUEST_ID
        An optional request ID to identify requests. Specify a unique request
        ID so that if you must retry your request, the server will know to
        ignore the request if it has already been completed. The server will
        guarantee that for at least 60 minutes since the first request.

        For example, consider a situation where you make an initial request and
        the request times out. If you make the request again with the same
        request ID, the server can check if original operation with the same
        request ID was received, and if so, will ignore the second request.
        This prevents clients from accidentally creating duplicate commitments.

        The request ID must be a valid UUID with the exception that zero UUID
        is not supported (00000000-0000-0000-0000-000000000000).

     Arguments for the ip cidr range.

     At most one of these can be specified:

       --ipv4-cidr-range=IPV4_CIDR_RANGE
          The IPv4 CIDR range of the CustomRange.

       --ipv6-cidr-range=IPV6_CIDR_RANGE
          The IPv6 CIDR range of the CustomRange.

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 cloudnumberregistry/v1alpha API. The full
    documentation for this API can be found at:
    https://docs.cloud.google.com/number-registry/reference/rest

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.

