gcloud beta saas-runtime units create - create a Unit

gcloud beta saas-runtime units createUNIT[--labels=[LABELS,…]][--location=LOCATION][--maintenance-pinned-until-time=MAINTENANCE_PINNED_UNTIL_TIME][--management-mode=MANAGEMENT_MODE][--tenant=TENANT][--unit-kind=UNIT_KIND][GCLOUD_WIDE_FLAG …]

Unit resource - Identifier. The resource name (full URI of the resource)following the standard naming scheme:

"projects/{project}/locations/{location}/units/{unit}"ThisrepresentsaCloudresource.(NOTE)Someattributesarenotgivenargumentsinthisgroupbutcanbesetinotherways.

To set theproject attribute:

• provide the argumentunit on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argumentunit on the command line with a fullyspecified name;
• provide the argument--location on the command line.

This must be specified.

UNIT

ID of the unit or fully qualified identifier for the unit.

To set theunit attribute:

• provide the argumentunit on the command line.

--labels=[LABELS,…]

The labels on the resource, which can be used for categorization. similar toKubernetes resource labels.

KEY

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

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 [unit, tenant, unit-kind], provides fallback value for resourcelocation attribute. When the resource's full URI path is not provided, locationwill fallback to this flag value.

Captures requested directives for performing future maintenance on the unit.This includes a request for the unit to skip maintenance for a period of timeand remain pinned to its current release as well as controls for postponingmaintenance scheduled in future.

--maintenance-pinned-until-time=MAINTENANCE_PINNED_UNTIL_TIME

If present, it fixes the release on the unit until the given time; i.e. changesto the release field will be rejected. Rollouts should and will also respectthis by not requesting an upgrade in the first place.

--management-mode=MANAGEMENT_MODE

Indicates whether the Unit life cycle is controlled by the user or by thesystem. Immutable once created.MANAGEMENT_MODE must beone of:

system

The system will decide when to deprovision and delete the unit. User still candeprovision or delete the unit manually.

user

Unit's lifecycle is managed by the user.

Tenant resource - Reference to the Saas Tenant resource this unit belongs to.This for example informs the maintenance policies to use for scheduling futureupdates on a unit. (optional and immutable once created) This represents a Cloudresource. (NOTE) Some attributes are not given arguments in this group but canbe set in other ways.

To set theproject attribute:

• provide the argument--tenant on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argument--tenant on the command line with a fullyspecified name;
• provide the argument--location on the command line.

--tenant=TENANT

ID of the tenant or fully qualified identifier for the tenant.

To set thetenant attribute:

• provide the argument--tenant on the command line.

UnitKind resource - Reference to the UnitKind this Unit belongs to (required andimmutable once created). This represents a Cloud resource. (NOTE) Someattributes are not given arguments in this group but can be set in other ways.

To set theproject attribute:

• provide the argument--unit-kind on the command line with a fullyspecified name;
• provide the argument--project on the command line;
• set the propertycore/project.

To set thelocation attribute:

• provide the argument--unit-kind on the command line with a fullyspecified name;
• provide the argument--location on the command line.

--unit-kind=UNIT_KIND

ID of the unitKind or fully qualified identifier for the unitKind.

To set theunit-kind attribute:

• provide the argument--unit-kind on the command line.

Run$gcloud help for details.