gcloud alpha number-registry custom-ranges create

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:

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.