1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-11 15:39:42 +00:00
gcloud-help/gcloud/beta/saas-runtime/unit-kinds/create
2026-04-08 12:08:12 +00:00

249 lines
9.1 KiB
Text

NAME
gcloud beta saas-runtime unit-kinds create - create a Unit Kind
SYNOPSIS
gcloud beta saas-runtime unit-kinds create UNIT_KIND --saas=SAAS
[--default-release=DEFAULT_RELEASE]
[--dependencies=[alias=ALIAS],[unitKind=UNITKIND]]
[--input-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]]
[--labels=[LABELS,...]] [--location=LOCATION]
[--output-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Create a Unit Kind
EXAMPLES
To create the Unit Kind, run:
$ gcloud beta saas-runtime unit-kinds create
POSITIONAL ARGUMENTS
UnitKind resource - Identifier. The resource name (full URI of the
resource) following the standard naming scheme:
"projects/{project}/locations/{location}/unitKinds/{unitKind}" 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
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.
REQUIRED FLAGS
Saas resource - A reference to the Saas that defines the product (managed
service) that the producer wants to manage with App Lifecycle Manager.
Immutable once set. 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 --saas 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 --saas on the command line with a fully
specified name;
◆ provide the argument --location on the command line.
This must be specified.
--saas=SAAS
ID of the saas or fully qualified identifier for the saas.
To set the saas attribute:
▸ provide the argument --saas on the command line.
OPTIONAL FLAGS
Release resource - A reference to the Release object to use as default for
creating new units of this Unit Kind (optional).
If not specified, a new unit must explicitly reference which release to
use for its creation. 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 --default-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 --default-release on the command line with a
fully specified name;
◆ provide the argument --location on the command line.
--default-release=DEFAULT_RELEASE
ID of the release or fully qualified identifier for the release.
To set the release attribute:
◆ provide the argument --default-release on the command line.
--dependencies=[alias=ALIAS],[unitKind=UNITKIND]
List of other unit kinds that this release will depend on. Dependencies
will be automatically provisioned if not found. Maximum 10.
alias
An alias for the dependency. Used for input variable mapping.
unitKind
The unit kind of the dependency.
Shorthand Example:
--dependencies=alias=string,unitKind=string --dependencies=alias=string,unitKind=string
JSON Example:
--dependencies='[{"alias": "string", "unitKind": "string"}]'
File Example:
--dependencies=path_to_file.(yaml|json)
--input-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]
List of inputVariables for this release that will either be retrieved
from a dependency's outputVariables, or will be passed on to a
dependency's inputVariables. Maximum 100.
from
Output variables which will get their values from dependencies.
dependency
Alias of the dependency that the outputVariable will pass its
value to.
outputVariable
Name of the outputVariable on the dependency.
to
Input variables whose values will be passed on to dependencies.
dependency
Alias of the dependency that the inputVariable will pass its
value to.
ignoreForLookup
Indicates if this mapping should be used during lookup or not.
inputVariable
Name of the inputVariable on the dependency.
variable
name of the variable.
Shorthand Example:
--input-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string --input-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string
JSON Example:
--input-variable-mappings='[{"from": {"dependency": "string", "outputVariable": "string"}, "to": {"dependency": "string", "ignoreForLookup": boolean, "inputVariable": "string"}, "variable": "string"}]'
File Example:
--input-variable-mappings=path_to_file.(yaml|json)
--labels=[LABELS,...]
The labels on the resource, which can be used for categorization.
similar to Kubernetes resource labels.
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 [default-release, saas, 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.
--output-variable-mappings=[from=FROM],[to=TO],[variable=VARIABLE]
List of inputVariables for this release that will either be retrieved
from a dependency's outputVariables, or will be passed on to a
dependency's inputVariables. Maximum 100.
from
Output variables which will get their values from dependencies.
dependency
Alias of the dependency that the outputVariable will pass its
value to.
outputVariable
Name of the outputVariable on the dependency.
to
Input variables whose values will be passed on to dependencies.
dependency
Alias of the dependency that the inputVariable will pass its
value to.
ignoreForLookup
Indicates if this mapping should be used during lookup or not.
inputVariable
Name of the inputVariable on the dependency.
variable
name of the variable.
Shorthand Example:
--output-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string --output-variable-mappings=from={dependency=string,outputVariable=string},to={dependency=string,ignoreForLookup=boolean,inputVariable=string},variable=string
JSON Example:
--output-variable-mappings='[{"from": {"dependency": "string", "outputVariable": "string"}, "to": {"dependency": "string", "ignoreForLookup": boolean, "inputVariable": "string"}, "variable": "string"}]'
File Example:
--output-variable-mappings=path_to_file.(yaml|json)
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.