diff --git a/gcloud/_version b/gcloud/_version index 00484b6b9..fa0cd6353 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 538.0.0 -alpha 2025.09.05 -beta 2025.09.05 +Google Cloud SDK 539.0.0 +alpha 2025.09.12 +beta 2025.09.12 bq 2.1.23 bundled-python3-unix 3.12.9 -core 2025.09.05 +core 2025.09.12 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/create b/gcloud/alpha/access-context-manager/cloud-bindings/create index 4770792f3..3c36ea439 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/create +++ b/gcloud/alpha/access-context-manager/cloud-bindings/create @@ -110,6 +110,15 @@ EXAMPLES --level=accessPolicies/123/accessLevels/abc \ --organization='1234567890' \ + To create a new cloud access binding for a specific federated principal, + run: + + $ gcloud alpha access-context-manager cloud-bindings create \ + --federated-principal='//iam.googleapis.com/projects/1234567890/\ + locations/global/workloadIdentityPools/my-pool/subject/my-subject' \ + --level=accessPolicies/123/accessLevels/abc \ + --organization='1234567890' + To create a new cloud access binding with global session settings, specify your session length using an ISO duration string and the session-length flag. For example: diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/list b/gcloud/alpha/access-context-manager/cloud-bindings/list index 3b9e01fc3..a01414d15 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/list +++ b/gcloud/alpha/access-context-manager/cloud-bindings/list @@ -95,6 +95,18 @@ EXAMPLES serviceAccountProjectNumber: 123456789 name: organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N + If filter is specified as principal:federatedPrincipal, the output is + printed in the following format: + + --- + accessLevels: + - accessPolicies/9522/accessLevels/device_trusted + dryRunAccessLevels: + - accessPolicies/9522/accessLevels/specific_location + principal: + federatedPrincipal: principal://iam.googleapis.com/projects/123/locations/global/workloadIdentityPools/pool-id/subject/subject-id + name: organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N + FLAGS Organization resource - The parent organization of the bindings you want to list. This represents a Cloud resource. diff --git a/gcloud/alpha/backup-dr/help b/gcloud/alpha/backup-dr/help index 2be9ebc79..552ec3987 100644 --- a/gcloud/alpha/backup-dr/help +++ b/gcloud/alpha/backup-dr/help @@ -49,6 +49,9 @@ GROUPS (ALPHA) Show protection summary for resources in a particular location and project. + service-config + (ALPHA) Manage Backup and DR Service configuration. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/backup-dr/service-config/help b/gcloud/alpha/backup-dr/service-config/help new file mode 100644 index 000000000..71d5d5242 --- /dev/null +++ b/gcloud/alpha/backup-dr/service-config/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha backup-dr service-config - manage Backup and DR Service + configuration + +SYNOPSIS + gcloud alpha backup-dr service-config COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Backup and DR Service configuration. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + init + (ALPHA) Initialize a Backup and DR Service configuration. + +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. This variant is also available: + + $ gcloud backup-dr service-config + diff --git a/gcloud/alpha/backup-dr/service-config/init b/gcloud/alpha/backup-dr/service-config/init new file mode 100644 index 000000000..5fe3ab880 --- /dev/null +++ b/gcloud/alpha/backup-dr/service-config/init @@ -0,0 +1,69 @@ +NAME + gcloud alpha backup-dr service-config init - initialize a Backup and DR + Service configuration + +SYNOPSIS + gcloud alpha backup-dr service-config init --location=LOCATION + --resource-type=RESOURCE_TYPE [--no-async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Initialize a Backup and DR Service configuration. + +EXAMPLES + To initialize a new service configuration in location MY_LOCATION and + project MY_PROJECT for resource type MY_RESOURCE_TYPE, run: + + $ gcloud alpha backup-dr service-config init --project=MY_PROJECT \ + --location=MY_LOCATION --resource-type=MY_RESOURCE_TYPE + +REQUIRED FLAGS + Location resource - The location for which the service configuration + should be created. 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + --resource-type=RESOURCE_TYPE + The resource type to which the default service configuration will be + applied. Examples include, "compute..com/Instance" + +OPTIONAL FLAGS + --no-async + Wait for the operation in progress to complete. + +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 backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +BRIEF + Initializes a Backup and DR Service configuration. + +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. This variant is also available: + + $ gcloud backup-dr service-config init + diff --git a/gcloud/alpha/bigtable/materialized-views/update b/gcloud/alpha/bigtable/materialized-views/update index 740ae5564..a99987284 100644 --- a/gcloud/alpha/bigtable/materialized-views/update +++ b/gcloud/alpha/bigtable/materialized-views/update @@ -12,9 +12,11 @@ DESCRIPTION (ALPHA) Update a Bigtable materialized view. EXAMPLES - To update a materialized view, run: $ gcloud alpha bigtable materialized-views update \ + To update a materialized view, run: + + $ gcloud alpha bigtable materialized-views update \ my-materialized-view-id --instance=my-instance-id \ - --deletion-protection=true" + --deletion-protection=true POSITIONAL ARGUMENTS Materialized view resource - The materialized view to update. The diff --git a/gcloud/alpha/cluster-director/clusters/create b/gcloud/alpha/cluster-director/clusters/create index ce425007c..14e42f647 100644 --- a/gcloud/alpha/cluster-director/clusters/create +++ b/gcloud/alpha/cluster-director/clusters/create @@ -8,58 +8,41 @@ SYNOPSIS (--config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS], [name=NAME], [networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] - | [--compute-resource-disks=[boot=BOOT],[computeId=COMPUTEID], - [sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] - --compute-resources=[guestAcceleratorCount=GUESTACCELERATORCOUNT], - [guestAcceleratorType=GUESTACCELERATORTYPE],[machineType=MACHINETYPE], - [maxRunDuration=MAXRUNDURATION],[name=NAME], - [provisioningModel=PROVISIONINGMODEL], - [terminationAction=TERMINATIONACTION],[zone=ZONE] - --slurm-login-node=[count=COUNT],[enableOSLogin=ENABLEOSLOGIN], + | [--slurm-login-node=[count=COUNT],[enableOSLogin=ENABLEOSLOGIN], [enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS], - [machineType=MACHINETYPE],[serviceAccountEmail=SERVICEACCOUNTEMAIL], - [serviceAccountScopes=SERVICEACCOUNTSCOPES], - [startupScript=STARTUPSCRIPT],[zone=ZONE] - --slurm-login-node-disks=[boot=BOOT], - [sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] - --slurm-node-sets=[computeId=COMPUTEID], - [enableIPForward=ENABLEIPFORWARD],[enableOSLogin=ENABLEOSLOGIN], - [enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS], - [maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[name=NAME], - [serviceAccountEmail=SERVICEACCOUNTEMAIL], - [serviceAccountScopes=SERVICEACCOUNTSCOPES], + [machineType=MACHINETYPE],[startupScript=STARTUPSCRIPT],[zone=ZONE] + --slurm-node-sets=[computeId=COMPUTEID],[id=ID],[labels=LABELS], + [maxDynamicNodeCount=MAXDYNAMICNODECOUNT], [startupScript=STARTUPSCRIPT],[staticNodeCount=STATICNODECOUNT] --slurm-partitions=[exclusive=EXCLUSIVE], - [name=NAME],[nodesetIds=NODESETIDS] (--create-network=CREATE_NETWORK - | --network=NETWORK --subnet=SUBNET) - : --compute-resource-reservations=[computeId=COMPUTEID], - [key=KEY],[type=TYPE],[values=VALUES] - --create-filestores=[description=DESCRIPTION],[fileshare=FILESHARE], - [name=NAME],[protocol=PROTOCOL],[sizeGb=SIZEGB],[tier=TIER] - --create-gcs-buckets=[enableAutoclass=ENABLEAUTOCLASS], + [id=ID],[nodesetIds=NODESETIDS] + (--create-network=[description=DESCRIPTION],[name=NAME] + | --network=NETWORK --subnet=SUBNET) : --buckets=[BUCKETS,...] + --create-buckets=[enableAutoclass=ENABLEAUTOCLASS], [enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] - --create-lustres=[description=DESCRIPTION], - [filesystem=FILESYSTEM],[name=NAME],[sizeGb=SIZEGB] - --description=DESCRIPTION --filestores=[FILESTORES,...] - --gcs-buckets=[GCS_BUCKETS,...] --labels=[LABELS,...] + --create-filestores=[capacityGb=CAPACITYGB],[description=DESCRIPTION], + [fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[tier=TIER] + --create-lustres=[capacityGb=CAPACITYGB], + [description=DESCRIPTION],[filesystem=FILESYSTEM],[name=NAME] + --description=DESCRIPTION + --dws-flex-instances=[id=ID], + [machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + --filestores=[FILESTORES,...] --labels=[LABELS,...] --lustres=[LUSTRES,...] - --slurm-config=[jobEpilogBashScripts=JOBEPILOGBASHSCRIPTS], - [jobPrologBashScripts=JOBPROLOGBASHSCRIPTS], - [prologEpilogTimeout=PROLOGEPILOGTIMEOUT],[prologFlags=PROLOGFLAGS], - [requeueExitCodes=REQUEUEEXITCODES], - [requeueHoldExitCodes=REQUEUEHOLDEXITCODES], - [taskEpilogBashScripts=TASKEPILOGBASHSCRIPTS], - [taskPrologBashScripts=TASKPROLOGBASHSCRIPTS] - --slurm-default-partition=SLURM_DEFAULT_PARTITION]) [--async] - [GCLOUD_WIDE_FLAG ...] + --on-demand-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + --reserved-instances=[id=ID], + [machineType=MACHINETYPE],[reservation=RESERVATION] + --slurm-default-partition=SLURM_DEFAULT_PARTITION + --spot-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE]]) + [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha cluster-director clusters create facilitates the creation of a cluster resource. There are following ways to create a cluster: - ▪ Using granular flags to define cluster specs. - ▪ Using --config flag with cluster specs in JSON format. + ▪ [Preferred] Use granular flags to define cluster specs. + ▪ Use --config flag with cluster specs in JSON format. Please refer to the examples below for more details. @@ -70,31 +53,24 @@ EXAMPLES $ gcloud alpha cluster-director clusters create my-cluster \ --location us-central1-a \ --description "My cluster description" \ - --labels env=prod,client=gcloud-cli --create-network network0 \ + --labels env=prod,client=gcloud-cli \ + --create-network name=network0 \ --create-filestores \ name=locations/us-central1-a/instances/filestore0,\ - tier=TIER_BASIC_HDD,sizeGb={filestoreSize},fileshare={fileshare} \ + tier=BASIC_HDD,capacityGb={filestoreSize},fileshare={fileshare} \ --filestores locations/us-central1-a/instances/filestore1 \ - --create-gcs-buckets name=bucket0 --gcs-buckets bucket1 \ + --create-buckets name=bucket0 --buckets bucket1 \ --create-lustres \ name=locations/us-central1-a/instances/lustre0,\ - sizeGb={lustreSize},filesystem={filesystem} \ + capacityGb={lustreSize},filesystem={filesystem} \ --lustres locations/us-central1-a/instances/lustre1 \ - --compute-resources \ - name=compute0,zone=us-central1-a,machineType={machineType} \ - --compute-resource-disks \ - computeId=compute0,type={diskType},sizeGb={diskSize},boot=true,\ - sourceImage={family/image} \ - --compute-resource-reservations \ - computeId=compute0,type=RESERVATION_TYPE_SPECIFIC_RESERVATION,\ - values=zones/us-central1-a/reservations/{reservation} \ + --reserved-instances \ + id=compute0,machineType={machineType},reservation=zones/\ + us-central1-a/reservations/{reservation} \ --slurm-login-node \ machineType={machineType},zone=us-central1-a \ - --slurm-login-node-disks \ - type={diskType},sizeGb={diskSize},boot=true,\ - sourceImage={family/image} \ - --slurm-node-sets name=nodeset0,computeId=compute0 \ - --slurm-partitions name=partition0,nodesetIds=[nodeset0] \ + --slurm-node-sets id=nodeset0,computeId=compute0 \ + --slurm-partitions id=partition0,nodesetIds=[nodeset0] \ --slurm-default-partition partition0 --format json To create a cluster my-cluster in location us-central1-a with config in @@ -509,112 +485,11 @@ REQUIRED FLAGS Flag Configurations to define cluster spec. - --compute-resource-disks=[boot=BOOT],[computeId=COMPUTEID],[sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] - Parameters to define disk config for compute resource. - - For e.g. --compute-resource-disks - computeId={computeId},type={diskType},boot=true,sizeGb={diskSize},sourceImage={family/{image-family} - | {image}} - - Note: - ▫ for boot disk, all fields are required. - ▫ for non-boot disk, only computeId, type and sizeGb are - required. - - Required, sets compute_resource_disks value. - - boot - Sets boot value. - - computeId - Required, sets computeId value. - - sizeGb - Required, sets sizeGb value. - - sourceImage - Sets sourceImage value. - - type - Required, sets type value. - - Shorthand Example: - - --compute-resource-disks=boot=boolean,computeId=string,sizeGb=int,sourceImage=string,type=string --compute-resource-disks=boot=boolean,computeId=string,sizeGb=int,sourceImage=string,type=string - - JSON Example: - - --compute-resource-disks='[{"boot": boolean, "computeId": "string", "sizeGb": int, "sourceImage": "string", "type": "string"}]' - - File Example: - - --compute-resource-disks=path_to_file.(yaml|json) - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --compute-resources=[guestAcceleratorCount=GUESTACCELERATORCOUNT],[guestAcceleratorType=GUESTACCELERATORTYPE],[machineType=MACHINETYPE],[maxRunDuration=MAXRUNDURATION],[name=NAME],[provisioningModel=PROVISIONINGMODEL],[terminationAction=TERMINATIONACTION],[zone=ZONE] - Parameters to define cluster compute resource. - - For e.g. --compute-resources - name={computeId},zone={zone},machineType={machineType} - - Supported provisioningModel values: - ▫ PROVISIONING_MODEL_STANDARD - ▫ PROVISIONING_MODEL_SPOT - ▫ PROVISIONING_MODEL_FLEX_START - ▫ PROVISIONING_MODEL_RESERVATION_BOUND - - Supported terminationAction values: - ▫ TERMINATION_ACTION_DELETE - ▫ TERMINATION_ACTION_STOP. - - Required, sets compute_resources value. - - guestAcceleratorCount - Sets guestAcceleratorCount value. - - guestAcceleratorType - Sets guestAcceleratorType value. - - machineType - Required, sets machineType value. - - maxRunDuration - Sets maxRunDuration value. - - name - Required, sets name value. - - provisioningModel - Sets provisioningModel value. - - terminationAction - Sets terminationAction value. - - zone - Required, sets zone value. - - Shorthand Example: - - --compute-resources=guestAcceleratorCount=int,guestAcceleratorType=string,machineType=string,maxRunDuration=int,name=string,provisioningModel=string,terminationAction=string,zone=string --compute-resources=guestAcceleratorCount=int,guestAcceleratorType=string,machineType=string,maxRunDuration=int,name=string,provisioningModel=string,terminationAction=string,zone=string - - JSON Example: - - --compute-resources='[{"guestAcceleratorCount": int, "guestAcceleratorType": "string", "machineType": "string", "maxRunDuration": int, "name": "string", "provisioningModel": "string", "terminationAction": "string", "zone": "string"}]' - - File Example: - - --compute-resources=path_to_file.(yaml|json) - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --slurm-login-node=[count=COUNT],[enableOSLogin=ENABLEOSLOGIN],[enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS],[machineType=MACHINETYPE],[serviceAccountEmail=SERVICEACCOUNTEMAIL],[serviceAccountScopes=SERVICEACCOUNTSCOPES],[startupScript=STARTUPSCRIPT],[zone=ZONE] + --slurm-login-node=[count=COUNT],[enableOSLogin=ENABLEOSLOGIN],[enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS],[machineType=MACHINETYPE],[startupScript=STARTUPSCRIPT],[zone=ZONE] Parameters to define slurm cluster login node. For e.g. --slurm-login-node - machineType={machineType},zone={zone},count={count},enableOSLogin=true,enablePublicIPs=true,serviceAccountEmail={serviceAccountEmail},serviceAccountScopes=[scope1,scope2],startupScript="echo + machineType={machineType},zone={zone},count={count},enableOSLogin=true,enablePublicIPs=true,startupScript="echo hello",labels="{key1=value1,key2=value2}" Defaults: @@ -627,8 +502,7 @@ REQUIRED FLAGS ◇ Either str or file_path ◇ For file_path, only bash file format (.sh or .bash) is supported. - ◇ For file_path, absolute or relative path to current work - directory is supported. + ◇ For file_path, only absolute path is supported. Required, sets slurm_login_node value. @@ -653,12 +527,6 @@ REQUIRED FLAGS machineType Required, sets machineType value. - serviceAccountEmail - Sets serviceAccountEmail value. - - serviceAccountScopes - Sets serviceAccountScopes value. - startupScript Sets startupScript value. @@ -667,11 +535,11 @@ REQUIRED FLAGS Shorthand Example: - --slurm-login-node=count=int,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},machineType=string,serviceAccountEmail=string,serviceAccountScopes,startupScript=string,zone=string + --slurm-login-node=count=int,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},machineType=string,startupScript=string,zone=string JSON Example: - --slurm-login-node='{"count": int, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccountEmail": "string", "serviceAccountScopes", "startupScript": "string", "zone": "string"}' + --slurm-login-node='{"count": int, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "machineType": "string", "startupScript": "string", "zone": "string"}' File Example: @@ -680,78 +548,30 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --slurm-login-node-disks=[boot=BOOT],[sizeGb=SIZEGB],[sourceImage=SOURCEIMAGE],[type=TYPE] - Parameters to define disk config for slurm cluster login node. - - For e.g. --slurm-login-node-disks - type={diskType},boot=true,sizeGb={diskSize},sourceImage={family/{image-family} - | {image}} - - Note: - ▫ for boot disk, all fields are required. - ▫ for non-boot disk, only type and sizeGb are required. - - Required, sets slurm_login_node_disks value. - - boot - Sets boot value. - - sizeGb - Required, sets sizeGb value. - - sourceImage - Sets sourceImage value. - - type - Required, sets type value. - - Shorthand Example: - - --slurm-login-node-disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}] --slurm-login-node-disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}] - - JSON Example: - - --slurm-login-node-disks='[{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}]' - - File Example: - - --slurm-login-node-disks=path_to_file.(yaml|json) - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --slurm-node-sets=[computeId=COMPUTEID],[enableIPForward=ENABLEIPFORWARD],[enableOSLogin=ENABLEOSLOGIN],[enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[name=NAME],[serviceAccountEmail=SERVICEACCOUNTEMAIL],[serviceAccountScopes=SERVICEACCOUNTSCOPES],[startupScript=STARTUPSCRIPT],[staticNodeCount=STATICNODECOUNT] + --slurm-node-sets=[computeId=COMPUTEID],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[startupScript=STARTUPSCRIPT],[staticNodeCount=STATICNODECOUNT] Parameters to define slurm cluster nodeset config. For e.g. --slurm-node-sets - name={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},enableOSLogin=true,enableIPForward=false,enablePublicIPs=false,serviceAccountEmail={serviceAccountEmail},serviceAccountScopes=[scope1,scope2],startupScript="echo + id={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},startupScript="echo hello",labels="{key1=value1,key2=value2}" Defaults: ▫ staticNodeCount: 1 - ▫ enableOSLogin: true Note: ▫ startupScript: ◇ Either str or file_path ◇ For file_path, only bash file format (.sh or .bash) is supported. - ◇ For file_path, absolute or relative path to current work - directory is supported. + ◇ For file_path, only absolute path is supported. Required, sets slurm_node_sets value. computeId Required, sets computeId value. - enableIPForward - Sets enableIPForward value. - - enableOSLogin - Sets enableOSLogin value. - - enablePublicIPs - Sets enablePublicIPs value. + id + Required, sets id value. labels Sets labels value. @@ -765,15 +585,6 @@ REQUIRED FLAGS maxDynamicNodeCount Sets maxDynamicNodeCount value. - name - Required, sets name value. - - serviceAccountEmail - Sets serviceAccountEmail value. - - serviceAccountScopes - Sets serviceAccountScopes value. - startupScript Sets startupScript value. @@ -782,11 +593,11 @@ REQUIRED FLAGS Shorthand Example: - --slurm-node-sets=computeId=string,enableIPForward=boolean,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},maxDynamicNodeCount=int,name=string,serviceAccountEmail=string,serviceAccountScopes=[string],startupScript=string,staticNodeCount=int --slurm-node-sets=computeId=string,enableIPForward=boolean,enableOSLogin=boolean,enablePublicIPs=boolean,labels={string=string},maxDynamicNodeCount=int,name=string,serviceAccountEmail=string,serviceAccountScopes=[string],startupScript=string,staticNodeCount=int + --slurm-node-sets=computeId=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,staticNodeCount=int --slurm-node-sets=computeId=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,staticNodeCount=int JSON Example: - --slurm-node-sets='[{"computeId": "string", "enableIPForward": boolean, "enableOSLogin": boolean, "enablePublicIPs": boolean, "labels": {"string": "string"}, "maxDynamicNodeCount": int, "name": "string", "serviceAccountEmail": "string", "serviceAccountScopes": ["string"], "startupScript": "string", "staticNodeCount": int}]' + --slurm-node-sets='[{"computeId": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "startupScript": "string", "staticNodeCount": int}]' File Example: @@ -795,30 +606,30 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --slurm-partitions=[exclusive=EXCLUSIVE],[name=NAME],[nodesetIds=NODESETIDS] + --slurm-partitions=[exclusive=EXCLUSIVE],[id=ID],[nodesetIds=NODESETIDS] Parameters to define slurm cluster partitions. For e.g. --slurm-partitions - name={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. + id={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. Required, sets slurm_partitions value. exclusive Sets exclusive value. - name - Required, sets name value. + id + Required, sets id value. nodesetIds Required, sets nodesetIds value. Shorthand Example: - --slurm-partitions=exclusive=boolean,name=string,nodesetIds=[string] --slurm-partitions=exclusive=boolean,name=string,nodesetIds=[string] + --slurm-partitions=exclusive=boolean,id=string,nodesetIds=[string] --slurm-partitions=exclusive=boolean,id=string,nodesetIds=[string] JSON Example: - --slurm-partitions='[{"exclusive": boolean, "name": "string", "nodesetIds": ["string"]}]' + --slurm-partitions='[{"exclusive": boolean, "id": "string", "nodesetIds": ["string"]}]' File Example: @@ -827,122 +638,31 @@ REQUIRED FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --compute-resource-reservations=[computeId=COMPUTEID],[key=KEY],[type=TYPE],[values=VALUES] - Parameters to define reservation for compute resource. + --buckets=[BUCKETS,...] + Reference of existing Google Cloud Storage bucket. - For e.g. --compute-resource-reservations - computeId={computeId},type=RESERVATION_TYPE_SPECIFIC_RESERVATION,values=zones/{zone}/reservations/{reservation} + For e.g. --buckets {bucket-path} - Supported type values: - ▫ RESERVATION_TYPE_NO_RESERVATION - ▫ RESERVATION_TYPE_ANY_RESERVATION - ▫ RESERVATION_TYPE_SPECIFIC_RESERVATION - - Defaults: - ▫ key: compute.googleapis.com/reservation-name (if type is - RESERVATION_TYPE_SPECIFIC_RESERVATION or - RESERVATION_TYPE_ANY_RESERVATION). - - Sets compute_resource_reservations value. - - computeId - Required, sets computeId value. - - key - Sets key value. - - type - Required, sets type value. - - values - Sets values value. - - Shorthand Example: - - --compute-resource-reservations=computeId=string,key=string,type=string,values --compute-resource-reservations=computeId=string,key=string,type=string,values - - JSON Example: - - --compute-resource-reservations='[{"computeId": "string", "key": "string", "type": "string", "values"}]' - - File Example: - - --compute-resource-reservations=path_to_file.(yaml|json) - - --create-filestores=[description=DESCRIPTION],[fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[sizeGb=SIZEGB],[tier=TIER] - Parameters to create a filestore instance. - - For e.g. --create-filestores - name=locations/{location}/instances/{filestore},tier=TIER_BASIC_HDD,sizeGb=100,fileshare=nfsshare - - Supported tier values: - ▫ TIER_BASIC_HDD - ▫ TIER_BASIC_SSD - ▫ TIER_HIGH_SCALE_SSD - ▫ TIER_ZONAL - ▫ TIER_ENTERPRISE - ▫ TIER_REGIONAL - - Supported protocol values: - ▫ PROTOCOL_NFSV3 - ▫ PROTOCOL_NFSV41 - ▫ If not specified, defaults to PROTOCOL_NFSV3 - - Defaults: - ▫ protocol: PROTOCOL_NFSV3. - - Sets create_filestores value. - - description - Sets description value. - - fileshare - Required, sets fileshare value. - - name - Required, sets name value. - - protocol - Sets protocol value. - - sizeGb - Required, sets sizeGb value. - - tier - Required, sets tier value. - - Shorthand Example: - - --create-filestores=description=string,fileshare=string,name=string,protocol=string,sizeGb=int,tier=string --create-filestores=description=string,fileshare=string,name=string,protocol=string,sizeGb=int,tier=string - - JSON Example: - - --create-filestores='[{"description": "string", "fileshare": "string", "name": "string", "protocol": "string", "sizeGb": int, "tier": "string"}]' - - File Example: - - --create-filestores=path_to_file.(yaml|json) - - --create-gcs-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] + --create-buckets=[enableAutoclass=ENABLEAUTOCLASS],[enableHNS=ENABLEHNS],[name=NAME],[storageClass=STORAGECLASS] Parameters to create a Google Cloud Storage bucket. - For e.g. --create-gcs-buckets name={bucket-path} + For e.g. --create-buckets name={bucket-path} Supported storageClass values: - ▫ STORAGE_CLASS_STANDARD - ▫ STORAGE_CLASS_NEARLINE - ▫ STORAGE_CLASS_COLDLINE - ▫ STORAGE_CLASS_ARCHIVE + ▫ STANDARD + ▫ NEARLINE + ▫ COLDLINE + ▫ ARCHIVE Defaults: - ▫ storageClass: STORAGE_CLASS_STANDARD + ▫ storageClass: STANDARD Note: ▫ Either storageClass or enableAutoclass can be set. ▫ if enableAutoclass is set, enableHNS should not be set. ▫ HNS: Hierarchical namespace. - Sets create_gcs_buckets value. + Sets create_buckets value. enableAutoclass Sets enableAutoclass value. @@ -958,24 +678,81 @@ REQUIRED FLAGS Shorthand Example: - --create-gcs-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string --create-gcs-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string + --create-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string --create-buckets=enableAutoclass=boolean,enableHNS=boolean,name=string,storageClass=string JSON Example: - --create-gcs-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string"}]' + --create-buckets='[{"enableAutoclass": boolean, "enableHNS": boolean, "name": "string", "storageClass": "string"}]' File Example: - --create-gcs-buckets=path_to_file.(yaml|json) + --create-buckets=path_to_file.(yaml|json) - --create-lustres=[description=DESCRIPTION],[filesystem=FILESYSTEM],[name=NAME],[sizeGb=SIZEGB] + --create-filestores=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[fileshare=FILESHARE],[name=NAME],[protocol=PROTOCOL],[tier=TIER] + Parameters to create a filestore instance. + + For e.g. --create-filestores + name=locations/{location}/instances/{filestore},tier=BASIC_HDD,capacityGb={filestoreSize},fileshare={fileshare} + + Supported tier values: + ▫ BASIC_HDD + ▫ BASIC_SSD + ▫ HIGH_SCALE_SSD + ▫ ZONAL + ▫ ENTERPRISE + ▫ REGIONAL + + Supported protocol values: + ▫ NFSV3 + ▫ NFSV41 + ▫ If not specified, defaults to NFSV3 + + Defaults: + ▫ protocol: NFSV3. + + Sets create_filestores value. + + capacityGb + Required, sets capacityGb value. + + description + Sets description value. + + fileshare + Required, sets fileshare value. + + name + Required, sets name value. + + protocol + Sets protocol value. + + tier + Required, sets tier value. + + Shorthand Example: + + --create-filestores=capacityGb=int,description=string,fileshare=string,name=string,protocol=string,tier=string --create-filestores=capacityGb=int,description=string,fileshare=string,name=string,protocol=string,tier=string + + JSON Example: + + --create-filestores='[{"capacityGb": int, "description": "string", "fileshare": "string", "name": "string", "protocol": "string", "tier": "string"}]' + + File Example: + + --create-filestores=path_to_file.(yaml|json) + + --create-lustres=[capacityGb=CAPACITYGB],[description=DESCRIPTION],[filesystem=FILESYSTEM],[name=NAME] Parameters to create a Lustre instance. For e.g. --create-lustres - name=locations/{location}/instances/{lustre},sizeGb={lustreSize},filesystem={filesystem}. + name=locations/{location}/instances/{lustre},capacityGb={lustreSize},filesystem={filesystem}. Sets create_lustres value. + capacityGb + Required, sets capacityGb value. + description Sets description value. @@ -985,16 +762,13 @@ REQUIRED FLAGS name Required, sets name value. - sizeGb - Required, sets sizeGb value. - Shorthand Example: - --create-lustres=description=string,filesystem=string,name=string,sizeGb=int --create-lustres=description=string,filesystem=string,name=string,sizeGb=int + --create-lustres=capacityGb=int,description=string,filesystem=string,name=string --create-lustres=capacityGb=int,description=string,filesystem=string,name=string JSON Example: - --create-lustres='[{"description": "string", "filesystem": "string", "name": "string", "sizeGb": int}]' + --create-lustres='[{"capacityGb": int, "description": "string", "filesystem": "string", "name": "string"}]' File Example: @@ -1005,16 +779,43 @@ REQUIRED FLAGS For e.g. --description (ALPHA) Creates a Cluster Director resource. + --dws-flex-instances=[id=ID],[machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + Parameters to define cluster DWS Flex instances. + + For e.g. --dws-flex-instances + id={computeId},zone={zone},machineType={machineType},maxDuration=10000s. + + Sets dws_flex_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + maxDuration + Required, sets maxDuration value. + + zone + Required, sets zone value. + + Shorthand Example: + + --dws-flex-instances=id=string,machineType=string,maxDuration=string,zone=string --dws-flex-instances=id=string,machineType=string,maxDuration=string,zone=string + + JSON Example: + + --dws-flex-instances='[{"id": "string", "machineType": "string", "maxDuration": "string", "zone": "string"}]' + + File Example: + + --dws-flex-instances=path_to_file.(yaml|json) + --filestores=[FILESTORES,...] Reference of existing filestore instance. For e.g. --filestores locations/{location}/instances/{filestore} - --gcs-buckets=[GCS_BUCKETS,...] - Reference of existing Google Cloud Storage bucket. - - For e.g. --gcs-buckets {bucket-path} - --labels=[LABELS,...] Cluster labels as key value pairs. @@ -1045,85 +846,127 @@ REQUIRED FLAGS For e.g. --lustres locations/{location}/instances/{lustre} - --slurm-config=[jobEpilogBashScripts=JOBEPILOGBASHSCRIPTS],[jobPrologBashScripts=JOBPROLOGBASHSCRIPTS],[prologEpilogTimeout=PROLOGEPILOGTIMEOUT],[prologFlags=PROLOGFLAGS],[requeueExitCodes=REQUEUEEXITCODES],[requeueHoldExitCodes=REQUEUEHOLDEXITCODES],[taskEpilogBashScripts=TASKEPILOGBASHSCRIPTS],[taskPrologBashScripts=TASKPROLOGBASHSCRIPTS] - Parameters to define slurm cluster config. + --on-demand-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + Parameters to define cluster on demand instances. - For e.g. --slurm-config - requeueExitCodes=[1,2,3],requeueHoldExitCodes=[4,5,6],prologFlags=[ALLOC,CONTAIN,NO_HOLD],prologEpilogTimeout=10000s,jobPrologBashScripts=["echo - hello",...],jobEpilogBashScripts=["echo - goodbye",...],taskPrologBashScripts=["echo - hi",...],taskEpilogBashScripts=["echo bye",...] + For e.g. --on-demand-instances + id={computeId},zone={zone},machineType={machineType}. - Supported prologFlags values: - ▫ ALLOC - ▫ CONTAIN - ▫ DEFER_BATCH - ▫ NO_HOLD - ▫ FORCE_REQUEUE_ON_FAIL - ▫ RUN_IN_JOB - ▫ SERIAL - ▫ X11 + Sets on_demand_instances value. - Note: - ▫ jobPrologBashScripts, jobEpilogBashScripts, - taskPrologBashScripts, taskEpilogBashScripts: - ◇ Either str or file_path - ◇ For file_path, only bash file format (.sh or .bash) is - supported. - ◇ For file_path, absolute or relative path to current work - directory is supported. + id + Required, sets id value. - Sets slurm_config value. + machineType + Required, sets machineType value. - jobEpilogBashScripts - Sets jobEpilogBashScripts value. - - jobPrologBashScripts - Sets jobPrologBashScripts value. - - prologEpilogTimeout - Sets prologEpilogTimeout value. - - prologFlags - Sets prologFlags value. - - requeueExitCodes - Sets requeueExitCodes value. - - requeueHoldExitCodes - Sets requeueHoldExitCodes value. - - taskEpilogBashScripts - Sets taskEpilogBashScripts value. - - taskPrologBashScripts - Sets taskPrologBashScripts value. + zone + Required, sets zone value. Shorthand Example: - --slurm-config=jobEpilogBashScripts=[string],jobPrologBashScripts=[string],prologEpilogTimeout=string,prologFlags=[string],requeueExitCodes=[int],requeueHoldExitCodes=[int],taskEpilogBashScripts=[string],taskPrologBashScripts=[string] + --on-demand-instances=id=string,machineType=string,zone=string --on-demand-instances=id=string,machineType=string,zone=string JSON Example: - --slurm-config='{"jobEpilogBashScripts": ["string"], "jobPrologBashScripts": ["string"], "prologEpilogTimeout": "string", "prologFlags": ["string"], "requeueExitCodes": [int], "requeueHoldExitCodes": [int], "taskEpilogBashScripts": ["string"], "taskPrologBashScripts": ["string"]}' + --on-demand-instances='[{"id": "string", "machineType": "string", "zone": "string"}]' File Example: - --slurm-config=path_to_file.(yaml|json) + --on-demand-instances=path_to_file.(yaml|json) + + --reserved-instances=[id=ID],[machineType=MACHINETYPE],[reservation=RESERVATION] + Parameters to define cluster reserved instances. + + For e.g. --reserved-instances + id={computeId},reservation=zones/{zone}/reservations/{reservation},machineType={machineType}. + + Sets reserved_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + reservation + Required, sets reservation value. + + Shorthand Example: + + --reserved-instances=id=string,machineType=string,reservation=string --reserved-instances=id=string,machineType=string,reservation=string + + JSON Example: + + --reserved-instances='[{"id": "string", "machineType": "string", "reservation": "string"}]' + + File Example: + + --reserved-instances=path_to_file.(yaml|json) --slurm-default-partition=SLURM_DEFAULT_PARTITION Parameters to define slurm cluster default partition. For e.g. --slurm-default-partition {partitionId} + --spot-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + Parameters to define cluster spot instances. + + For e.g. --spot-instances + id={computeId},zone={zone},machineType={machineType}. + + Sets spot_instances value. + + id + Required, sets id value. + + machineType + Required, sets machineType value. + + zone + Required, sets zone value. + + Shorthand Example: + + --spot-instances=id=string,machineType=string,zone=string --spot-instances=id=string,machineType=string,zone=string + + JSON Example: + + --spot-instances='[{"id": "string", "machineType": "string", "zone": "string"}]' + + File Example: + + --spot-instances=path_to_file.(yaml|json) + Network configuration for the cluster. Exactly one of these must be specified: - --create-network=CREATE_NETWORK - Name of the network to be created. + --create-network=[description=DESCRIPTION],[name=NAME] + Parameters to create a network. - For e.g. --create-network {network} + For e.g. --create-network name={network},description=(ALPHA) + Creates a Cluster Director resource.. + + Sets create_network value. + + description + Sets description value. + + name + Required, sets name value. + + Shorthand Example: + + --create-network=description=string,name=string + + JSON Example: + + --create-network='{"description": "string", "name": "string"}' + + File Example: + + --create-network=path_to_file.(yaml|json) Use an existing network source for the cluster. @@ -1132,11 +975,17 @@ REQUIRED FLAGS For e.g. --network {network} + This flag argument must be specified if any of the other + arguments in this group are specified. + --subnet=SUBNET Reference of existing subnetwork name. For e.g. --subnet regions/{region}/subnetworks/{subnetwork} + This flag argument must be specified if any of the other + arguments in this group are specified. + OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/alpha/cluster-director/clusters/help b/gcloud/alpha/cluster-director/clusters/help index f20627b4e..6ad31f86c 100644 --- a/gcloud/alpha/cluster-director/clusters/help +++ b/gcloud/alpha/cluster-director/clusters/help @@ -29,7 +29,7 @@ COMMANDS (ALPHA) List Cluster Director resources. update - (ALPHA) Updates the parameters of a Cluster Director resource. + (ALPHA) Updates a Cluster Director resource. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/cluster-director/clusters/update b/gcloud/alpha/cluster-director/clusters/update index 450b7199e..bc795e50d 100644 --- a/gcloud/alpha/cluster-director/clusters/update +++ b/gcloud/alpha/cluster-director/clusters/update @@ -1,30 +1,127 @@ NAME - gcloud alpha cluster-director clusters update - updates the parameters of a - Cluster Director resource + gcloud alpha cluster-director clusters update - updates a Cluster Director + resource SYNOPSIS gcloud alpha cluster-director clusters update (CLUSTER : --location=LOCATION) - --config=[compute=COMPUTE],[computeResources=COMPUTERESOURCES], - [description=DESCRIPTION],[labels=LABELS],[name=NAME], - [networkResources=NETWORKRESOURCES],[networks=NETWORKS], - [orchestrator=ORCHESTRATOR],[reconciling=RECONCILING], - [storageResources=STORAGERESOURCES],[storages=STORAGES] - --update-mask=UPDATE_MASK [--async] [GCLOUD_WIDE_FLAG ...] + (--add-dws-flex-instances=[id=ID], + [machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + --add-labels=[ADD_LABELS,...] + --add-on-demand-instances=[id=ID], + [machineType=MACHINETYPE],[zone=ZONE] + --add-reserved-instances=[id=ID], + [machineType=MACHINETYPE],[reservation=RESERVATION] + --add-slurm-node-sets=[computeId=COMPUTEID],[id=ID],[labels=LABELS], + [maxDynamicNodeCount=MAXDYNAMICNODECOUNT], + [startupScript=STARTUPSCRIPT],[staticNodeCount=STATICNODECOUNT] + --add-slurm-partitions=[exclusive=EXCLUSIVE], + [id=ID],[nodesetIds=NODESETIDS] + --add-spot-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + --description=DESCRIPTION + --remove-dws-flex-instances=[REMOVE_DWS_FLEX_INSTANCES,...] + --remove-labels=[REMOVE_LABELS,...] + --remove-on-demand-instances=[REMOVE_ON_DEMAND_INSTANCES,...] + --remove-reserved-instances=[REMOVE_RESERVED_INSTANCES,...] + --remove-slurm-node-sets=[REMOVE_SLURM_NODE_SETS,...] + --remove-slurm-partitions=[REMOVE_SLURM_PARTITIONS,...] + --remove-spot-instances=[REMOVE_SPOT_INSTANCES,...] + --slurm-default-partition=SLURM_DEFAULT_PARTITION + --update-slurm-node-sets=[id=ID], + [maxDynamicNodeCount=MAXDYNAMICNODECOUNT], + [staticNodeCount=STATICNODECOUNT] + --update-slurm-partitions=[exclusive=EXCLUSIVE], + [id=ID],[nodesetIds=NODESETIDS] + | --config=[compute=COMPUTE],[description=DESCRIPTION], + [labels=LABELS],[name=NAME], + [networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + --update-mask=UPDATE_MASK) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Updates the parameters of a Cluster Director resource. + (ALPHA) gcloud alpha cluster-director clusters update facilitates the + updation of a cluster resource. + + There are following ways to update a cluster: + ▪ [Preferred] Use granular flags to update cluster specs, based on + read-modify-update pattern. + ◆ Read the existing cluster specs through get cluster request. + ◆ Modify the cluster specs through granular flags. + ◆ Update the cluster specs through patch cluster request. + ▪ Use --config with cluster specs and --update-mask flags, both in JSON + format. + ◆ Map and repeated fields update requires existing and new values. + ◆ For e.g. if we want to update a cluster to add a new nodeset, then + we will use the update_mask "orchestrator.slurm.node_sets", and the + patch cluster must include all the existing nodesets as well as the + new one. + + Please refer to the examples below for more details. EXAMPLES - To update the labels of a cluster my-cluster in location us-central1-a with - config file my-cluster-config.json run the following JSON example: + To update a cluster my-cluster in location us-central1-a with granular + flags, run the following example: + + Add labels, reserved instances, slurm node sets, slurm partitions and + update description and default partition: + + $ gcloud alpha cluster-director clusters update my-cluster \ + --location us-central1-a \ + --description "My updated cluster description" \ + --add-labels env=prod,client=gcloud-cli \ + --add-on-demand-instances \ + id=compute1,zone=us-central1-a,machineType=n2-standard-2 \ + --add-reserved-instances \ + id=compute2,reservation=zones/us-central1-a/reservations/\ + {reservation},machineType={machineType} \ + --add-spot-instances \ + id=compute3,zone=us-central1-a,machineType=n2-standard-2 \ + --add-dws-flex-instances \ + id=compute4,zone=us-central1-a,machineType=a4-highgpu-8g,\ + maxDuration=10000s \ + --add-slurm-node-sets id=nodeset1,computeId=compute1 \ + --add-slurm-node-sets id=nodeset2,computeId=compute2 \ + --add-slurm-node-sets id=nodeset3,computeId=compute3 \ + --add-slurm-node-sets id=nodeset4,computeId=compute4 \ + --add-slurm-partitions id=partition1,nodesetIds=[nodeset1] \ + --add-slurm-partitions \ + id=partition2,nodesetIds=[nodeset2,nodeset3,nodeset4] \ + --slurm-default-partition partition1 + + Update slurm node sets and slurm partitions: + + $ gcloud alpha cluster-director clusters update my-cluster \ + --location us-central1-a \ + --update-slurm-node-sets \ + id=nodeset1,staticNodeCount=2,maxDynamicNodeCount=10 \ + --update-slurm-partitions \ + id=partition1,nodesetIds=[nodeset0],exclusive=true + + Remove slurm node sets, slurm partitions and reserved instances and update + default partition: + + $ gcloud alpha cluster-director clusters update my-cluster \ + --location us-central1-a --slurm-default-partition partition0 \ + --remove-labels env,client \ + --remove-slurm-partitions partition1 \ + --remove-slurm-partitions partition2 \ + --remove-slurm-node-sets nodeset1 \ + --remove-slurm-node-sets nodeset2 \ + --remove-slurm-node-sets nodeset3 \ + --remove-slurm-node-sets nodeset4 \ + --remove-on-demand-instances compute1 \ + --remove-reserved-instances compute2 \ + --remove-spot-instances compute3 \ + --remove-dws-flex-instances compute4 + + Or cluster my-cluster in location us-central1-a with config JSON run the + following JSON example: $ gcloud alpha cluster-director clusters update my-cluster \ --location=us-central1-a --update-mask=labels \ --config='{"key": "value"}' - Or create a JSON file with the cluster specs and run the following file - example: + Or create a JSON file my-cluster-config.json with the cluster specs and run + the following file example: $ gcloud alpha cluster-director clusters update my-cluster \ --location=us-central1-a --update-mask=labels \ @@ -39,7 +136,7 @@ EXAMPLES --config-from-file=my-cluster-config.json POSITIONAL ARGUMENTS - Cluster resource - Identifier. Name of the cluster. Formats: cluster | + Cluster resource - Name of the cluster resource. Formats: cluster | projects/{project}/locations/{locations}/clusters/{cluster} The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be @@ -71,81 +168,50 @@ POSITIONAL ARGUMENTS ▸ provide the argument --location on the command line. REQUIRED FLAGS - --config=[compute=COMPUTE],[computeResources=COMPUTERESOURCES],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[networks=NETWORKS],[orchestrator=ORCHESTRATOR],[reconciling=RECONCILING],[storageResources=STORAGERESOURCES],[storages=STORAGES] - Required, Configuration of the cluster specs to be updated in shorthand - | JSON string | file path format. + Cluster configuration for provisioning with updates. - compute - Sets compute value. + Exactly one of these must be specified: - atmTags - Sets atmTags value. + Flag Configurations to define cluster updates. - key - Sets key value. + --add-dws-flex-instances=[id=ID],[machineType=MACHINETYPE],[maxDuration=MAXDURATION],[zone=ZONE] + Parameters to define cluster DWS Flex instances. - value - Sets value value. + For e.g. --add-dws-flex-instances + id={computeId},zone={zone},machineType={machineType},maxDuration=10000s. - resourceRequests - Sets resourceRequests value. + Sets add_dws_flex_instances value. - disks - Sets disks value. + id + Required, sets id value. - boot - Sets boot value. + machineType + Required, sets machineType value. - sizeGb - Sets sizeGb value. + maxDuration + Required, sets maxDuration value. - sourceImage - Sets sourceImage value. + zone + Required, sets zone value. - type - Sets type value. + Shorthand Example: - guestAccelerators - Sets guestAccelerators value. + --add-dws-flex-instances=id=string,machineType=string,maxDuration=string,zone=string --add-dws-flex-instances=id=string,machineType=string,maxDuration=string,zone=string - acceleratorType - Sets acceleratorType value. + JSON Example: - count - Sets count value. + --add-dws-flex-instances='[{"id": "string", "machineType": "string", "maxDuration": "string", "zone": "string"}]' - id - Sets id value. + File Example: - machineType - Sets machineType value. + --add-dws-flex-instances=path_to_file.(yaml|json) - maxRunDuration - Sets maxRunDuration value. + --add-labels=[ADD_LABELS,...] + Cluster labels as key value pairs. - provisioningModel - Sets provisioningModel value. + For e.g. --add-labels key1=value1,key2=value2. - reservationAffinity - Sets reservationAffinity value. - - key - Sets key value. - - type - Sets type value. - - values - Sets values value. - - terminationAction - Sets terminationAction value. - - zone - Sets zone value. - - computeResources - Sets computeResources value. + Sets add_labels value. KEY Sets KEY value. @@ -153,248 +219,304 @@ REQUIRED FLAGS VALUE Sets VALUE value. - newDwsFlexInstances - Sets newDwsFlexInstances value. + Shorthand Example: - atmTags - Sets atmTags value. + --add-labels={string=string} - KEY - Sets KEY value. + JSON Example: - VALUE - Sets VALUE value. + --add-labels='{"string": "string"}' - machineType - Sets machineType value. + File Example: - maxDuration - Sets maxDuration value. + --add-labels=path_to_file.(yaml|json) - zone - Sets zone value. + --add-on-demand-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + Parameters to define cluster on demand instances. - newOnDemandInstances - Sets newOnDemandInstances value. + For e.g. --add-on-demand-instances + id={computeId},zone={zone},machineType={machineType}. - atmTags - Sets atmTags value. + Sets add_on_demand_instances value. - KEY - Sets KEY value. + id + Required, sets id value. - VALUE - Sets VALUE value. + machineType + Required, sets machineType value. - machineType - Sets machineType value. + zone + Required, sets zone value. - zone - Sets zone value. + Shorthand Example: - newReservedInstances - Sets newReservedInstances value. + --add-on-demand-instances=id=string,machineType=string,zone=string --add-on-demand-instances=id=string,machineType=string,zone=string - atmTags - Sets atmTags value. + JSON Example: - KEY - Sets KEY value. + --add-on-demand-instances='[{"id": "string", "machineType": "string", "zone": "string"}]' - VALUE - Sets VALUE value. + File Example: - reservation - Sets reservation value. + --add-on-demand-instances=path_to_file.(yaml|json) - newSpotInstances - Sets newSpotInstances value. + --add-reserved-instances=[id=ID],[machineType=MACHINETYPE],[reservation=RESERVATION] + Parameters to define cluster reserved instances. - atmTags - Sets atmTags value. + For e.g. --add-reserved-instances + id={computeId},reservation=zones/{zone}/reservations/{reservation},machineType={machineType}. - KEY - Sets KEY value. + Sets add_reserved_instances value. - VALUE - Sets VALUE value. + id + Required, sets id value. - machineType - Sets machineType value. + machineType + Required, sets machineType value. - zone - Sets zone value. + reservation + Required, sets reservation value. - description - Sets description value. + Shorthand Example: - labels - Sets labels value. + --add-reserved-instances=id=string,machineType=string,reservation=string --add-reserved-instances=id=string,machineType=string,reservation=string - KEY - Keys must start with a lowercase character and contain only - hyphens (-), underscores (_), lowercase characters, and - numbers. + JSON Example: - VALUE - Values must contain only hyphens (-), underscores (_), - lowercase characters, and numbers. + --add-reserved-instances='[{"id": "string", "machineType": "string", "reservation": "string"}]' - name - Sets name value. + File Example: - networkResources - Sets networkResources value. + --add-reserved-instances=path_to_file.(yaml|json) - KEY - Sets KEY value. + --add-slurm-node-sets=[computeId=COMPUTEID],[id=ID],[labels=LABELS],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[startupScript=STARTUPSCRIPT],[staticNodeCount=STATICNODECOUNT] + Parameters to define slurm cluster nodeset config. - VALUE - Sets VALUE value. + For e.g. --add-slurm-node-sets + id={nodesetId},computeId={computeId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount},startupScript="echo + hello",labels="{key1=value1,key2=value2}" - computeNetwork - Sets computeNetwork value. + Defaults: + ▫ staticNodeCount: 1 - network - Sets network value. + Note: + ▫ startupScript: + ◇ Either str or file_path + ◇ For file_path, only bash file format (.sh or .bash) is + supported. + ◇ For file_path, only absolute path is supported. - subnetwork - Sets subnetwork value. + Sets add_slurm_node_sets value. - config - Sets config value. + computeId + Required, sets computeId value. - existingComputeNetwork - Sets existingComputeNetwork value. + id + Required, sets id value. - network - Sets network value. + labels + Sets labels value. - subnetwork - Sets subnetwork value. + KEY + Sets KEY value. - existingNetwork - Sets existingNetwork value. + VALUE + Sets VALUE value. - network - Sets network value. + maxDynamicNodeCount + Sets maxDynamicNodeCount value. - subnetwork - Sets subnetwork value. + startupScript + Sets startupScript value. - newComputeNetwork - Sets newComputeNetwork value. + staticNodeCount + Sets staticNodeCount value. - description - Sets description value. + Shorthand Example: - network - Sets network value. + --add-slurm-node-sets=computeId=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,staticNodeCount=int --add-slurm-node-sets=computeId=string,id=string,labels={string=string},maxDynamicNodeCount=int,startupScript=string,staticNodeCount=int - newNetwork - Sets newNetwork value. + JSON Example: - description - Sets description value. + --add-slurm-node-sets='[{"computeId": "string", "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "startupScript": "string", "staticNodeCount": int}]' - network - Sets network value. + File Example: - networks - Sets networks value. + --add-slurm-node-sets=path_to_file.(yaml|json) - initializeParams - Sets initializeParams value. + --add-slurm-partitions=[exclusive=EXCLUSIVE],[id=ID],[nodesetIds=NODESETIDS] + Parameters to define slurm cluster partitions. - description - Sets description value. + For e.g. --add-slurm-partitions + id={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. - network - Sets network value. + Sets add_slurm_partitions value. - network - Sets network value. + exclusive + Sets exclusive value. - networkSource - Sets networkSource value. + id + Required, sets id value. - network - Sets network value. + nodesetIds + Required, sets nodesetIds value. - subnetwork - Sets subnetwork value. + Shorthand Example: - subnetwork - Sets subnetwork value. + --add-slurm-partitions=exclusive=boolean,id=string,nodesetIds=[string] --add-slurm-partitions=exclusive=boolean,id=string,nodesetIds=[string] - orchestrator - Sets orchestrator value. + JSON Example: - slurm - Sets slurm value. + --add-slurm-partitions='[{"exclusive": boolean, "id": "string", "nodesetIds": ["string"]}]' - config - Sets config value. + File Example: - accountingStorageEnforceFlags - Sets accountingStorageEnforceFlags value. + --add-slurm-partitions=path_to_file.(yaml|json) - preemptExemptTime - Sets preemptExemptTime value. + --add-spot-instances=[id=ID],[machineType=MACHINETYPE],[zone=ZONE] + Parameters to define cluster spot instances. - preemptMode - Sets preemptMode value. + For e.g. --add-spot-instances + id={computeId},zone={zone},machineType={machineType}. - preemptType - Sets preemptType value. + Sets add_spot_instances value. - priorityType - Sets priorityType value. + id + Required, sets id value. - priorityWeightAge - Sets priorityWeightAge value. + machineType + Required, sets machineType value. - priorityWeightAssoc - Sets priorityWeightAssoc value. + zone + Required, sets zone value. - priorityWeightFairshare - Sets priorityWeightFairshare value. + Shorthand Example: - priorityWeightJobSize - Sets priorityWeightJobSize value. + --add-spot-instances=id=string,machineType=string,zone=string --add-spot-instances=id=string,machineType=string,zone=string - priorityWeightPartition - Sets priorityWeightPartition value. + JSON Example: - priorityWeightQos - Sets priorityWeightQos value. + --add-spot-instances='[{"id": "string", "machineType": "string", "zone": "string"}]' - priorityWeightTres - Sets priorityWeightTres value. + File Example: - prologEpilogTimeout - Sets prologEpilogTimeout value. + --add-spot-instances=path_to_file.(yaml|json) - prologFlags - Sets prologFlags value. + --description=DESCRIPTION + Description of the cluster. - requeueExitCodes - Sets requeueExitCodes value. + For e.g. --description (ALPHA) Updates a Cluster Director resource. - requeueHoldExitCodes - Sets requeueHoldExitCodes value. + --remove-dws-flex-instances=[REMOVE_DWS_FLEX_INSTANCES,...] + Parameters to remove DWS Flex instance config by compute id. - defaultPartition - Sets defaultPartition value. + For e.g. --remove-dws-flex-instances {computeId1},{computeId2},... - epilogBashScripts - Sets epilogBashScripts value. + --remove-labels=[REMOVE_LABELS,...] + Parameters to remove cluster label by key. - loginNodes - Sets loginNodes value. + For e.g. --remove-labels {key1},{key2},... - count - Sets count value. + --remove-on-demand-instances=[REMOVE_ON_DEMAND_INSTANCES,...] + Parameters to remove on demand instances config by compute id. + + For e.g. --remove-on-demand-instances {computeId1},{computeId2},... + + --remove-reserved-instances=[REMOVE_RESERVED_INSTANCES,...] + Parameters to remove reserved instance config by compute id. + + For e.g. --remove-reserved-instances {computeId1},{computeId2},... + + --remove-slurm-node-sets=[REMOVE_SLURM_NODE_SETS,...] + Parameters to remove slurm nodeset config by nodeset id. + + For e.g. --remove-slurm-node-sets {nodesetId1},{nodesetId2},... + + --remove-slurm-partitions=[REMOVE_SLURM_PARTITIONS,...] + Parameters to remove slurm partition config by partition id. + + For e.g. --remove-slurm-partitions + {partitionId1},{partitionId2},... + + --remove-spot-instances=[REMOVE_SPOT_INSTANCES,...] + Parameters to remove spot instance config by compute id. + + For e.g. --remove-spot-instances {computeId1},{computeId2},... + + --slurm-default-partition=SLURM_DEFAULT_PARTITION + Parameters to define slurm cluster default partition. + + For e.g. --slurm-default-partition {partitionId} + + --update-slurm-node-sets=[id=ID],[maxDynamicNodeCount=MAXDYNAMICNODECOUNT],[staticNodeCount=STATICNODECOUNT] + Parameters to define and update slurm cluster nodeset config. + + For e.g. --update-slurm-node-sets + id={nodesetId},staticNodeCount={staticNodeCount},maxDynamicNodeCount={maxDynamicNodeCount}. + + Sets update_slurm_node_sets value. + + id + Required, sets id value. + + maxDynamicNodeCount + Sets maxDynamicNodeCount value. + + staticNodeCount + Sets staticNodeCount value. + + Shorthand Example: + + --update-slurm-node-sets=id=string,maxDynamicNodeCount=int,staticNodeCount=int --update-slurm-node-sets=id=string,maxDynamicNodeCount=int,staticNodeCount=int + + JSON Example: + + --update-slurm-node-sets='[{"id": "string", "maxDynamicNodeCount": int, "staticNodeCount": int}]' + + File Example: + + --update-slurm-node-sets=path_to_file.(yaml|json) + + --update-slurm-partitions=[exclusive=EXCLUSIVE],[id=ID],[nodesetIds=NODESETIDS] + Parameters to define and update slurm cluster partition config. + + For e.g. --update-slurm-partitions + id={partitionId},nodesetIds=[{nodesetId1},{nodesetId2}],exclusive=false. + + Sets update_slurm_partitions value. + + exclusive + Sets exclusive value. + + id + Required, sets id value. + + nodesetIds + Sets nodesetIds value. + + Shorthand Example: + + --update-slurm-partitions=exclusive=boolean,id=string,nodesetIds=[string] --update-slurm-partitions=exclusive=boolean,id=string,nodesetIds=[string] + + JSON Example: + + --update-slurm-partitions='[{"exclusive": boolean, "id": "string", "nodesetIds": ["string"]}]' + + File Example: + + --update-slurm-partitions=path_to_file.(yaml|json) + + Cluster configuration for updates. + + --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + Configuration of the cluster specs in the form of a JSON object. + Required, sets config value. + + compute + Sets compute value. + + resourceRequests + Sets resourceRequests value. disks Sets disks value. @@ -403,248 +525,265 @@ REQUIRED FLAGS Sets boot value. sizeGb - Sets sizeGb value. + Required, sets sizeGb value. sourceImage Sets sourceImage value. type - Sets type value. + Required, sets type value. - enableOsLogin - Sets enableOsLogin value. + guestAccelerators + Sets guestAccelerators value. - enablePublicIps - Sets enablePublicIps value. + acceleratorType + Sets acceleratorType value. - instances - Sets instances value. + count + Sets count value. - instance - Sets instance value. - - labels - Sets labels value. - - 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. + id + Sets id value. machineType Sets machineType value. - serviceAccount - Sets serviceAccount value. + maxRunDuration + Sets maxRunDuration value. - email - Sets email value. + provisioningModel + Sets provisioningModel value. - scopes - Sets scopes value. + reservationAffinity + Sets reservationAffinity value. - startupScript - Sets startupScript value. - - storageConfigs - Sets storageConfigs value. - - id - Sets id value. - - localMount - Sets localMount value. - - zone - Sets zone value. - - nodeSets - Sets nodeSets value. - - bootDisk - Sets bootDisk value. - - boot - Sets boot value. - - sizeGb - Sets sizeGb value. - - sourceImage - Sets sourceImage value. + key + Sets key value. type Sets type value. - canIpForward - Sets canIpForward value. + values + Sets values value. - computeId - Sets computeId value. + terminationAction + Sets terminationAction value. - computeInstance - Sets computeInstance value. + zone + Sets zone value. + + description + Sets description value. + + labels + Sets labels value. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + name + Sets name value. + + networks + Sets networks value. + + initializeParams + Sets initializeParams value. + + description + Sets description value. + + network + Sets network value. + + networkSource + Sets networkSource value. + + network + Sets network value. + + subnetwork + Sets subnetwork value. + + orchestrator + Sets orchestrator value. + + slurm + Sets slurm value. + + config + Sets config value. + + prologEpilogTimeout + Sets prologEpilogTimeout value. + + prologFlags + Sets prologFlags value. + + requeueExitCodes + Sets requeueExitCodes value. + + requeueHoldExitCodes + Sets requeueHoldExitCodes value. + + defaultPartition + Sets defaultPartition value. + + epilogBashScripts + Sets epilogBashScripts value. + + loginNodes + Sets loginNodes value. + + count + Sets count value. + + disks + Sets disks value. + + boot + Sets boot value. + + sizeGb + Required, sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Required, sets type value. + + enableOsLogin + Sets enableOsLogin value. + + enablePublicIps + Sets enablePublicIps value. labels Sets labels value. KEY - Keys must start with a lowercase character and - contain only hyphens (-), underscores (_), - lowercase characters, and numbers. + Sets KEY value. VALUE - Values must contain only hyphens (-), - underscores (_), lowercase characters, and - numbers. + Sets VALUE value. + + machineType + Sets machineType value. + + serviceAccount + Sets serviceAccount value. + + email + Sets email value. + + scopes + Sets scopes value. startupScript Sets startupScript value. - containerNodePool - Sets containerNodePool value. + storageConfigs + Sets storageConfigs value. - enableOsLogin - Sets enableOsLogin value. + id + Sets id value. - enablePublicIps - Sets enablePublicIps value. + localMount + Sets localMount value. - id - Sets id value. + zone + Sets zone value. - labels - Sets labels value. + nodeSets + Sets nodeSets value. - KEY - Keys must start with a lowercase character and - contain only hyphens (-), underscores (_), - lowercase characters, and numbers. + canIpForward + Sets canIpForward value. - VALUE - Values must contain only hyphens (-), underscores - (_), lowercase characters, and numbers. + enableOsLogin + Sets enableOsLogin value. - maxDynamicNodeCount - Sets maxDynamicNodeCount value. - - resourceRequestId - Sets resourceRequestId value. - - serviceAccount - Sets serviceAccount value. - - email - Sets email value. - - scopes - Sets scopes value. - - startupScript - Sets startupScript value. - - staticNodeCount - Sets staticNodeCount value. - - storageConfigs - Sets storageConfigs value. + enablePublicIps + Sets enablePublicIps value. id Sets id value. - localMount - Sets localMount value. + labels + Sets labels value. - partitions - Sets partitions value. + KEY + Sets KEY value. - exclusive - Sets exclusive value. + VALUE + Sets VALUE value. - id - Sets id value. + maxDynamicNodeCount + Sets maxDynamicNodeCount value. - nodeSetIds - Sets nodeSetIds value. + resourceRequestId + Sets resourceRequestId value. - prologBashScripts - Sets prologBashScripts value. + serviceAccount + Sets serviceAccount value. - taskEpilogBashScripts - Sets taskEpilogBashScripts value. + email + Sets email value. - taskPrologBashScripts - Sets taskPrologBashScripts value. + scopes + Sets scopes value. - reconciling - Sets reconciling value. + startupScript + Sets startupScript value. - storageResources - Sets storageResources value. + staticNodeCount + Sets staticNodeCount value. - KEY - Sets KEY value. + storageConfigs + Sets storageConfigs value. - VALUE - Sets VALUE value. + id + Sets id value. - bucket - Sets bucket value. + localMount + Sets localMount value. - bucket - Sets bucket value. + partitions + Sets partitions value. - config - Sets config value. + exclusive + Sets exclusive value. - existingBucket - Sets existingBucket value. + id + Sets id value. - bucket - Sets bucket value. + nodeSetIds + Sets nodeSetIds value. - existingFilestore - Sets existingFilestore value. + prologBashScripts + Sets prologBashScripts value. - filestore - Sets filestore value. + taskEpilogBashScripts + Sets taskEpilogBashScripts value. - existingLustre - Sets existingLustre value. + taskPrologBashScripts + Sets taskPrologBashScripts value. - lustre - Sets lustre value. + storages + Sets storages value. - newBucket - Sets newBucket value. + id + Sets id value. - autoclass - Sets autoclass value. + initializeParams + Sets initializeParams value. - enabled - Sets enabled value. - - terminalStorageClass - Sets terminalStorageClass value. - - bucket - Sets bucket value. - - hierarchicalNamespace - Sets hierarchicalNamespace value. - - enabled - Sets enabled value. - - storageClass - Sets storageClass value. - - newFilestore - Sets newFilestore value. + filestore + Sets filestore value. description Sets description value. @@ -667,8 +806,32 @@ REQUIRED FLAGS tier Sets tier value. - newLustre - Sets newLustre value. + gcs + Sets gcs value. + + autoclass + Sets autoclass value. + + enabled + Sets enabled value. + + terminalStorageClass + Sets terminalStorageClass value. + + bucket + Sets bucket value. + + hierarchicalNamespace + Sets hierarchicalNamespace value. + + enabled + Sets enabled value. + + storageClass + Sets storageClass value. + + lustre + Sets lustre value. capacityGb Sets capacityGb value. @@ -682,128 +845,50 @@ REQUIRED FLAGS lustre Sets lustre value. - filestore - Sets filestore value. - - filestore - Sets filestore value. - - lustre - Sets lustre value. - - lustre - Sets lustre value. - - storages - Sets storages value. - - id - Sets id value. - - initializeParams - Sets initializeParams value. - - filestore - Sets filestore value. - - description - Sets description value. - - fileShares - Sets fileShares value. - - capacityGb - Sets capacityGb value. - - fileShare - Sets fileShare value. - - filestore - Sets filestore value. - - protocol - Sets protocol value. - - tier - Sets tier value. - - gcs - Sets gcs value. - - autoclass - Sets autoclass value. - - enabled - Sets enabled value. - - terminalStorageClass - Sets terminalStorageClass value. + storageSource + Sets storageSource value. bucket Sets bucket value. - hierarchicalNamespace - Sets hierarchicalNamespace value. - - enabled - Sets enabled value. - - storageClass - Sets storageClass value. - - lustre - Sets lustre value. - - capacityGb - Sets capacityGb value. - - description - Sets description value. - - filesystem - Sets filesystem value. + filestore + Sets filestore value. lustre Sets lustre value. - storage - Sets storage value. + Shorthand Example: - storageSource - Sets storageSource value. + --config=compute={resourceRequests=[{disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],guestAccelerators=[{acceleratorType=string,count=int}],id=string,machineType=string,maxRunDuration=int,provisioningModel=string,reservationAffinity={key=string,type=string,values},terminationAction=string,zone=string}]},description=string,labels={string=string},name=string,networks=[{initializeParams={description=string,network=string},networkSource={network=string,subnetwork=string}}],orchestrator={slurm={config={prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,epilogBashScripts,loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{canIpForward=boolean,enableOsLogin=boolean,enablePublicIps=boolean,id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,serviceAccount={email=string,scopes},startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storages=[{id=string,initializeParams={filestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},gcs={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},lustre={capacityGb=int,description=string,filesystem=string,lustre=string}},storageSource={bucket=string,filestore=string,lustre=string}}] - bucket - Sets bucket value. + JSON Example: - filestore - Sets filestore value. + --config='{"compute": {"resourceRequests": [{"disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "guestAccelerators": [{"acceleratorType": "string", "count": int}], "id": "string", "machineType": "string", "maxRunDuration": int, "provisioningModel": "string", "reservationAffinity": {"key": "string", "type": "string", "values"}, "terminationAction": "string", "zone": "string"}]}, "description": "string", "labels": {"string": "string"}, "name": "string", "networks": [{"initializeParams": {"description": "string", "network": "string"}, "networkSource": {"network": "string", "subnetwork": "string"}}], "orchestrator": {"slurm": {"config": {"prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "epilogBashScripts", "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"canIpForward": boolean, "enableOsLogin": boolean, "enablePublicIps": boolean, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storages": [{"id": "string", "initializeParams": {"filestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "gcs": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "lustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "storageSource": {"bucket": "string", "filestore": "string", "lustre": "string"}}]}' - lustre - Sets lustre value. + File Example: - Shorthand Example: + --config=path_to_file.(yaml|json) - --config=compute={atmTags=[{key=string,value=string}],resourceRequests=[{disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],guestAccelerators=[{acceleratorType=string,count=int}],id=string,machineType=string,maxRunDuration=int,provisioningModel=string,reservationAffinity={key=string,type=string,values=[string]},terminationAction=string,zone=string}]},computeResources={string={newDwsFlexInstances={atmTags={string=string},machineType=string,maxDuration=string,zone=string},newOnDemandInstances={atmTags={string=string},machineType=string,zone=string},newReservedInstances={atmTags={string=string},reservation=string},newSpotInstances={atmTags={string=string},machineType=string,zone=string}}},description=string,labels={string=string},name=string,networkResources={string={computeNetwork={network=string,subnetwork=string},config={existingComputeNetwork={network=string,subnetwork=string},existingNetwork={network=string,subnetwork=string},newComputeNetwork={description=string,network=string},newNetwork={description=string,network=string}}}},networks=[{initializeParams={description=string,network=string},network=string,networkSource={network=string,subnetwork=string},subnetwork=string}],orchestrator={slurm={config={accountingStorageEnforceFlags=[string],preemptExemptTime=string,preemptMode=[string],preemptType=string,priorityType=string,priorityWeightAge=int,priorityWeightAssoc=int,priorityWeightFairshare=int,priorityWeightJobSize=int,priorityWeightPartition=int,priorityWeightQos=int,priorityWeightTres=string,prologEpilogTimeout=string,prologFlags=[string],requeueExitCodes=[int],requeueHoldExitCodes=[int]},defaultPartition=string,epilogBashScripts=[string],loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,instances=[{instance=string}],labels={string=string},machineType=string,serviceAccount={email=string,scopes=[string]},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{bootDisk={boot=boolean,sizeGb=int,sourceImage=string,type=string},canIpForward=boolean,computeId=string,computeInstance={labels={string=string},startupScript=string},containerNodePool,enableOsLogin=boolean,enablePublicIps=boolean,id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,serviceAccount={email=string,scopes=[string]},startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts=[string],taskEpilogBashScripts=[string],taskPrologBashScripts=[string]}},reconciling=boolean,storageResources={string={bucket={bucket=string},config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},newFilestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},newLustre={capacityGb=int,description=string,filesystem=string,lustre=string}},filestore={filestore=string},lustre={lustre=string}}},storages=[{id=string,initializeParams={filestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},gcs={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},lustre={capacityGb=int,description=string,filesystem=string,lustre=string}},storage=string,storageSource={bucket=string,filestore=string,lustre=string}}] + This flag argument must be specified if any of the other arguments + in this group are specified. - JSON Example: + --update-mask=UPDATE_MASK + Update mask to specify the fields to update. - --config='{"compute": {"atmTags": [{"key": "string", "value": "string"}], "resourceRequests": [{"disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "guestAccelerators": [{"acceleratorType": "string", "count": int}], "id": "string", "machineType": "string", "maxRunDuration": int, "provisioningModel": "string", "reservationAffinity": {"key": "string", "type": "string", "values": ["string"]}, "terminationAction": "string", "zone": "string"}]}, "computeResources": {"string": {"newDwsFlexInstances": {"atmTags": {"string": "string"}, "machineType": "string", "maxDuration": "string", "zone": "string"}, "newOnDemandInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}, "newReservedInstances": {"atmTags": {"string": "string"}, "reservation": "string"}, "newSpotInstances": {"atmTags": {"string": "string"}, "machineType": "string", "zone": "string"}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"computeNetwork": {"network": "string", "subnetwork": "string"}, "config": {"existingComputeNetwork": {"network": "string", "subnetwork": "string"}, "existingNetwork": {"network": "string", "subnetwork": "string"}, "newComputeNetwork": {"description": "string", "network": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "networks": [{"initializeParams": {"description": "string", "network": "string"}, "network": "string", "networkSource": {"network": "string", "subnetwork": "string"}, "subnetwork": "string"}], "orchestrator": {"slurm": {"config": {"accountingStorageEnforceFlags": ["string"], "preemptExemptTime": "string", "preemptMode": ["string"], "preemptType": "string", "priorityType": "string", "priorityWeightAge": int, "priorityWeightAssoc": int, "priorityWeightFairshare": int, "priorityWeightJobSize": int, "priorityWeightPartition": int, "priorityWeightQos": int, "priorityWeightTres": "string", "prologEpilogTimeout": "string", "prologFlags": ["string"], "requeueExitCodes": [int], "requeueHoldExitCodes": [int]}, "defaultPartition": "string", "epilogBashScripts": ["string"], "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "instances": [{"instance": "string"}], "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes": ["string"]}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"bootDisk": {"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}, "canIpForward": boolean, "computeId": "string", "computeInstance": {"labels": {"string": "string"}, "startupScript": "string"}, "containerNodePool": {}, "enableOsLogin": boolean, "enablePublicIps": boolean, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "serviceAccount": {"email": "string", "scopes": ["string"]}, "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts": ["string"], "taskEpilogBashScripts": ["string"], "taskPrologBashScripts": ["string"]}}, "reconciling": boolean, "storageResources": {"string": {"bucket": {"bucket": "string"}, "config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "newFilestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "newLustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "filestore": {"filestore": "string"}, "lustre": {"lustre": "string"}}}, "storages": [{"id": "string", "initializeParams": {"filestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "gcs": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "lustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "storage": "string", "storageSource": {"bucket": "string", "filestore": "string", "lustre": "string"}}]}' + For e.g. --update-mask "description,labels". - File Example: + Required, sets update_mask value. - --config=path_to_file.(yaml|json) + Input Example: - --update-mask=UPDATE_MASK - Required, Field mask to be updated in shorthand | JSON string | file - path format. + --update-mask=string - Input Example: + File Example: - --update-mask=string + --update-mask=path_to_file.(yaml|json) - File Example: - - --update-mask=path_to_file.(yaml|json) + This flag argument must be specified if any of the other arguments + in this group are specified. OPTIONAL FLAGS --async @@ -818,11 +903,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the hypercomputecluster/v1alpha API. The full - documentation for this API can be found at: - https://cloud.google.com/ai-hypercomputer/docs/cluster-director - NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index f308cff62..4377ab76c 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -47,6 +47,7 @@ SYNOPSIS [--partner-metadata-from-file=LOCAL_FILE_PATH] [--performance-monitoring-unit=PERFORMANCE_MONITORING_UNIT] [--post-key-revocation-action-type=POLICY] [--preemptible] + [--preemption-notice-duration=PREEMPTION_NOTICE_DURATION] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--private-network-ip=PRIVATE_NETWORK_IP] [--provisioning-model=PROVISIONING_MODEL] [--region=REGION] @@ -853,6 +854,10 @@ FLAGS will only be able to run for a limited amount of time. Preemptible instances can not be restarted and will not migrate. + --preemption-notice-duration=PREEMPTION_NOTICE_DURATION + Specifies the metadata preemption notice duration before the ACPI G2 + soft off signal is triggered for Spot VMs. e.g. 120s. + --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE The private IPv6 Google access type for the VM. PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: @@ -869,8 +874,8 @@ FLAGS run. PROVISIONING_MODEL must be one of: FLEX_START - Instance is provisioned using the Flex Start provisioning model and - has a limited runtime. + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/alpha/compute/instance-templates/create-with-container b/gcloud/alpha/compute/instance-templates/create-with-container index f1ab35dbf..91d176d81 100644 --- a/gcloud/alpha/compute/instance-templates/create-with-container +++ b/gcloud/alpha/compute/instance-templates/create-with-container @@ -713,8 +713,8 @@ FLAGS run. PROVISIONING_MODEL must be one of: FLEX_START - Instance is provisioned using the Flex Start provisioning model and - has a limited runtime. + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index ab24e6825..170529c2c 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -54,6 +54,7 @@ SYNOPSIS [--partner-metadata-from-file=LOCAL_FILE_PATH] [--performance-monitoring-unit=PERFORMANCE_MONITORING_UNIT] [--post-key-revocation-action-type=POLICY] [--preemptible] + [--preemption-notice-duration=PREEMPTION_NOTICE_DURATION] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--private-network-ip=PRIVATE_NETWORK_IP] [--provisioning-model=PROVISIONING_MODEL] @@ -869,6 +870,10 @@ FLAGS will only be able to run for a limited amount of time. Preemptible instances can not be restarted and will not migrate. + --preemption-notice-duration=PREEMPTION_NOTICE_DURATION + Specifies the metadata preemption notice duration before the ACPI G2 + soft off signal is triggered for Spot VMs. e.g. 120s. + --private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE The private IPv6 Google access type for the VM. PRIVATE_IPV6_GOOGLE_ACCESS_TYPE must be one of: @@ -885,8 +890,8 @@ FLAGS run. PROVISIONING_MODEL must be one of: FLEX_START - Instance is provisioned using the Flex Start provisioning model and - has a limited runtime. + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you @@ -909,8 +914,7 @@ FLAGS specify 30m for a duration of 30 minutes, or 1h2m3s for 1 hour, 2 minutes, and 3 seconds. Longer durations give you higher chances that your instance creation request succeeds when resources are in high - demand. If you don't specify a duration, then the default duration is - 90 seconds. + demand. --require-csek-key-create Refuse to create resources not protected by a user managed key in the diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index 5ac64aeef..e9c1a8ae9 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -833,8 +833,8 @@ FLAGS run. PROVISIONING_MODEL must be one of: FLEX_START - Instance is provisioned using the Flex Start provisioning model and - has a limited runtime. + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you @@ -857,8 +857,7 @@ FLAGS specify 30m for a duration of 30 minutes, or 1h2m3s for 1 hour, 2 minutes, and 3 seconds. Longer durations give you higher chances that your instance creation request succeeds when resources are in high - demand. If you don't specify a duration, then the default duration is - 90 seconds. + demand. --resource-policies=[RESOURCE_POLICY,...] A list of resource policy names to be added to the instance. The diff --git a/gcloud/alpha/compute/instances/set-scheduling b/gcloud/alpha/compute/instances/set-scheduling index 3cec6c73d..1a45b93ae 100644 --- a/gcloud/alpha/compute/instances/set-scheduling +++ b/gcloud/alpha/compute/instances/set-scheduling @@ -9,6 +9,7 @@ SYNOPSIS [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] + [--preemption-notice-duration=PREEMPTION_NOTICE_DURATION] [--provisioning-model=PROVISIONING_MODEL] [--[no-]restart-on-failure] [--[no-]skip-guest-os-shutdown] [--zone=ZONE] [--clear-discard-local-ssds-at-termination-timestamp @@ -79,6 +80,10 @@ FLAGS instances can not be restarted and will not migrate. Use --preemptible to enable and --no-preemptible to disable. + --preemption-notice-duration=PREEMPTION_NOTICE_DURATION + Specifies the metadata preemption notice duration before the ACPI G2 + soft off signal is triggered for Spot VMs. e.g. 120s. + --provisioning-model=PROVISIONING_MODEL Specifies the provisioning model for your VM instances. This choice affects the price, availability, and how long your VM instances can diff --git a/gcloud/alpha/compute/networks/peerings/cancel-request-delete b/gcloud/alpha/compute/networks/peerings/cancel-request-delete new file mode 100644 index 000000000..3a5ec40b2 --- /dev/null +++ b/gcloud/alpha/compute/networks/peerings/cancel-request-delete @@ -0,0 +1,51 @@ +NAME + gcloud alpha compute networks peerings cancel-request-delete - cancel + deletion request of a Compute Engine network peering + +SYNOPSIS + gcloud alpha compute networks peerings cancel-request-delete NAME + --network=NETWORK [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute networks peerings cancel-request-delete is + used to cancel a request to delete a consensus network peering connection + between two networks. + +EXAMPLES + To cancel a deletion request of a consensus peering with the name + 'peering-name' between the network 'local-network' and the network + 'peer-network', run: + + $ gcloud alpha compute networks peerings cancel-request-delete \ + peering-name --network=local-network + + $ gcloud alpha compute networks peerings cancel-request-delete \ + peering-name --network=peer-network + +POSITIONAL ARGUMENTS + NAME + The name of the peering. + +REQUIRED FLAGS + --network=NETWORK + The name of the network in the current project containing the peering. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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. + +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. + diff --git a/gcloud/alpha/compute/networks/peerings/help b/gcloud/alpha/compute/networks/peerings/help index 0d7fae302..c108e7fe5 100644 --- a/gcloud/alpha/compute/networks/peerings/help +++ b/gcloud/alpha/compute/networks/peerings/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + cancel-request-delete + (ALPHA) Cancel deletion request of a Compute Engine network peering. + create (ALPHA) Create a Compute Engine network peering. diff --git a/gcloud/alpha/compute/queued-resources/create b/gcloud/alpha/compute/queued-resources/create index 9e84b2285..ad2184259 100644 --- a/gcloud/alpha/compute/queued-resources/create +++ b/gcloud/alpha/compute/queued-resources/create @@ -736,8 +736,8 @@ OPTIONAL FLAGS run. PROVISIONING_MODEL must be one of: FLEX_START - Instance is provisioned using the Flex Start provisioning model and - has a limited runtime. + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/alpha/compute/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index 71e19d336..ca507c354 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -159,8 +159,7 @@ OPTIONAL FLAGS effort' tier. --boot-disk=[KEY=VALUE,...] - Specifies if the boot disk should be created in confidential-compute - mode. + Specifies the boot disk configuration. $ gcloud alpha compute tpus queued-resources create \ --boot-disk confidential-compute=True,kms-key= @@ -168,12 +167,11 @@ OPTIONAL FLAGS The following keys are allowed: confidential-compute - Create the boot disk in confidential compute mode, CMEK layer is - required and only applicable to HyperDisk series. - + Create the boot disk in confidential compute mode. CMEK layer is + required. kms-key - Specifies fully qualified Cloud KMS cryptokey name which will be - used to protect the disk. KMS cryptokey name format: + Specifies the fully qualified Cloud KMS cryptokey name which will + be used to protect the disk. KMS cryptokey name format: projects//locations//keyRings//cryptoKeys/ --data-disk=[mode=MODE],[source=SOURCE] diff --git a/gcloud/alpha/compute/tpus/tpu-vm/create b/gcloud/alpha/compute/tpus/tpu-vm/create index 79842c91a..30713a756 100644 --- a/gcloud/alpha/compute/tpus/tpu-vm/create +++ b/gcloud/alpha/compute/tpus/tpu-vm/create @@ -90,8 +90,7 @@ OPTIONAL FLAGS enabled. --boot-disk=[KEY=VALUE,...] - Specifies if the boot disk should be created in confidential-compute - mode. + Specifies the boot disk configuration. $ gcloud alpha compute tpus tpu-vm create \ --boot-disk confidential-compute=True,kms-key= @@ -99,12 +98,11 @@ OPTIONAL FLAGS The following keys are allowed: confidential-compute - Create the boot disk in confidential compute mode, CMEK layer is - required and only applicable to HyperDisk series. - + Create the boot disk in confidential compute mode. CMEK layer is + required. kms-key - Specifies fully qualified Cloud KMS cryptokey name which will be - used to protect the disk. KMS cryptokey name format: + Specifies the fully qualified Cloud KMS cryptokey name which will + be used to protect the disk. KMS cryptokey name format: projects//locations//keyRings//cryptoKeys/ --data-disk=[mode=MODE],[source=SOURCE] diff --git a/gcloud/alpha/compute/zone-vm-extension-policies/create b/gcloud/alpha/compute/zone-vm-extension-policies/create index abd74bfb5..11e53b510 100644 --- a/gcloud/alpha/compute/zone-vm-extension-policies/create +++ b/gcloud/alpha/compute/zone-vm-extension-policies/create @@ -4,15 +4,10 @@ NAME SYNOPSIS gcloud alpha compute zone-vm-extension-policies create NAME - --extensions=EXTENSIONS [--description=DESCRIPTION] - [--filestore-config=FILESTORE_CONFIG] - [--filestore-version=FILESTORE_VERSION] - [--inclusion-labels=INCLUSION_LABELS] - [--ops-agent-config=OPS_AGENT_CONFIG] - [--ops-agent-version=OPS_AGENT_VERSION] + --extensions=EXTENSION_NAME,[...] [--config=KEY=VALUE,[KEY=VALUE,...]] + [--description=DESCRIPTION] [--inclusion-labels=INCLUSION_LABELS] [--priority=PRIORITY; default=1000] - [--sap-extension-config=SAP_EXTENSION_CONFIG] - [--sap-extension-version=SAP_EXTENSION_VERSION] [--zone=ZONE] + [--version=KEY=VALUE,[KEY=VALUE,...]] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -23,8 +18,10 @@ EXAMPLES $ gcloud alpha compute zone-vm-extension-policies create \ test-policy-name --description="test policy" \ - --extensions=filestore --filestore-version=20250101RC00 \ - --filestore-config=config1 --inclusion-labels=env=prod \ + --extensions=extension1,extension2 \ + --version=extension1=version1,extension2=version2 \ + --config=extension1="config1",extension2="config2" \ + --inclusion-labels=env=prod \ --inclusion-labels=env=preprod,workload=load-test \ --priority=1000 @@ -33,23 +30,21 @@ POSITIONAL ARGUMENTS Name of the zone vm extension policy to create. REQUIRED FLAGS - --extensions=EXTENSIONS - A list of extensions to be added to the policy. EXTENSIONS must be one - of: filestore, ops-agent, sap-extension. + --extensions=EXTENSION_NAME,[...] + One or more extensions to be added to the policy. OPTIONAL FLAGS + --config=KEY=VALUE,[KEY=VALUE,...] + A comma separated key:value list where the key is the extension name + and the value is the desired config for the given extension. The + extension name must be one of the extensions specified in the + --extensions flag. + + E.g. --config=filestore=,ops-agent= + --description=DESCRIPTION An optional textual description for the this extension policy. - --filestore-config=FILESTORE_CONFIG - The config send to the extension when extension starts. - - --filestore-version=FILESTORE_VERSION - The pinned version for filestore. - - If not specified, the latest version will be used, and will be upgraded - automatically. - --inclusion-labels=INCLUSION_LABELS A list of inclusion labels to select the target VMs. @@ -67,15 +62,6 @@ OPTIONAL FLAGS If not specified, ALL VMs in the zone will be selected. - --ops-agent-config=OPS_AGENT_CONFIG - The config send to the extension when extension starts. - - --ops-agent-version=OPS_AGENT_VERSION - The pinned version for ops-agent. - - If not specified, the latest version will be used, and will be upgraded - automatically. - --priority=PRIORITY; default=1000 The priority of the policy. Lower the number, higher the priority. When two policies tries to apply the same extension, the one with the higher @@ -86,14 +72,14 @@ OPTIONAL FLAGS Range from 0 to 65535. Default is 1000. - --sap-extension-config=SAP_EXTENSION_CONFIG - The config send to the extension when extension starts. + --version=KEY=VALUE,[KEY=VALUE,...] + A comma separated key:value list where the key is the extension name + and the value is the desired version for the given extension. The + extension name must be one of the extensions specified in the + --extensions flag. If no version is specified for an extension, the + latest version will be used and will be upgraded automatically. - --sap-extension-version=SAP_EXTENSION_VERSION - The pinned version for sap-extension. - - If not specified, the latest version will be used, and will be upgraded - automatically. + E.g. --version=filestore=123ABC,ops-agent=456DEF --zone=ZONE Zone of the zone vm extension policy to create. If not specified and diff --git a/gcloud/alpha/compute/zone-vm-extension-policies/update b/gcloud/alpha/compute/zone-vm-extension-policies/update index d9371e364..200bc5387 100644 --- a/gcloud/alpha/compute/zone-vm-extension-policies/update +++ b/gcloud/alpha/compute/zone-vm-extension-policies/update @@ -4,15 +4,10 @@ NAME SYNOPSIS gcloud alpha compute zone-vm-extension-policies update NAME - --extensions=EXTENSIONS [--description=DESCRIPTION] - [--filestore-config=FILESTORE_CONFIG] - [--filestore-version=FILESTORE_VERSION] - [--inclusion-labels=INCLUSION_LABELS] - [--ops-agent-config=OPS_AGENT_CONFIG] - [--ops-agent-version=OPS_AGENT_VERSION] + --extensions=EXTENSION_NAME,[...] [--config=KEY=VALUE,[KEY=VALUE,...]] + [--description=DESCRIPTION] [--inclusion-labels=INCLUSION_LABELS] [--priority=PRIORITY; default=1000] - [--sap-extension-config=SAP_EXTENSION_CONFIG] - [--sap-extension-version=SAP_EXTENSION_VERSION] [--zone=ZONE] + [--version=KEY=VALUE,[KEY=VALUE,...]] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -23,8 +18,10 @@ EXAMPLES $ gcloud alpha compute zone-vm-extension-policies update \ test-policy-name --description="test policy" \ - --extensions=filestore --filestore-version=20250101RC00 \ - --filestore-config=config1 --inclusion-labels=env=prod \ + --extensions=extension1,extension2 \ + --version=extension1=version1,extension2=version2 \ + --config=extension1="config1",extension2="config2" \ + --inclusion-labels=env=prod \ --inclusion-labels=env=preprod,workload=load-test \ --priority=1000 @@ -33,23 +30,21 @@ POSITIONAL ARGUMENTS Name of the zone vm extension policy to update. REQUIRED FLAGS - --extensions=EXTENSIONS - A list of extensions to be added to the policy. EXTENSIONS must be one - of: filestore, ops-agent, sap-extension. + --extensions=EXTENSION_NAME,[...] + One or more extensions to be added to the policy. OPTIONAL FLAGS + --config=KEY=VALUE,[KEY=VALUE,...] + A comma separated key:value list where the key is the extension name + and the value is the desired config for the given extension. The + extension name must be one of the extensions specified in the + --extensions flag. + + E.g. --config=filestore=,ops-agent= + --description=DESCRIPTION An optional textual description for the this extension policy. - --filestore-config=FILESTORE_CONFIG - The config send to the extension when extension starts. - - --filestore-version=FILESTORE_VERSION - The pinned version for filestore. - - If not specified, the latest version will be used, and will be upgraded - automatically. - --inclusion-labels=INCLUSION_LABELS A list of inclusion labels to select the target VMs. @@ -67,15 +62,6 @@ OPTIONAL FLAGS If not specified, ALL VMs in the zone will be selected. - --ops-agent-config=OPS_AGENT_CONFIG - The config send to the extension when extension starts. - - --ops-agent-version=OPS_AGENT_VERSION - The pinned version for ops-agent. - - If not specified, the latest version will be used, and will be upgraded - automatically. - --priority=PRIORITY; default=1000 The priority of the policy. Lower the number, higher the priority. When two policies tries to apply the same extension, the one with the higher @@ -86,14 +72,14 @@ OPTIONAL FLAGS Range from 0 to 65535. Default is 1000. - --sap-extension-config=SAP_EXTENSION_CONFIG - The config send to the extension when extension starts. + --version=KEY=VALUE,[KEY=VALUE,...] + A comma separated key:value list where the key is the extension name + and the value is the desired version for the given extension. The + extension name must be one of the extensions specified in the + --extensions flag. If no version is specified for an extension, the + latest version will be used and will be upgraded automatically. - --sap-extension-version=SAP_EXTENSION_VERSION - The pinned version for sap-extension. - - If not specified, the latest version will be used, and will be upgraded - automatically. + E.g. --version=filestore=123ABC,ops-agent=456DEF --zone=ZONE Zone of the zone vm extension policy to update. If not specified and diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 81eaef5a3..63c765a19 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -1427,6 +1427,10 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1669,6 +1673,46 @@ FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the node's + boot disk + ephemeralLocalSsdProfile specify swap on the local + SSD shared with pod + ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. @@ -1749,8 +1793,11 @@ FLAGS disable simultaneous multithreading (SMT) set this to 1. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --workload-metadata=WORKLOAD_METADATA Type of metadata server available to pods running in the node pool. diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index 5b002b338..d2e80a673 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -509,8 +509,11 @@ FLAGS Cannot be used with the "--create-subnetwork" option. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --workload-policies=WORKLOAD_POLICIES Add Autopilot workload policies to the cluster. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index c1ec5e903..f609cf543 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -782,8 +782,11 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/ip-rotation. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --update-addons=[ADDON=ENABLED|DISABLED,...] Cluster addons to enable or disable. Options are diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 14d6e0deb..cc8b6e78b 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -805,6 +805,10 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1047,6 +1051,46 @@ FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the node's + boot disk + ephemeralLocalSsdProfile specify swap on the local + SSD shared with pod + ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index 2f6b0ae11..98d420355 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -306,6 +306,10 @@ REQUIRED FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -563,6 +567,46 @@ REQUIRED FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the + node's boot disk + ephemeralLocalSsdProfile specify swap on the + local SSD shared with + pod ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. diff --git a/gcloud/alpha/design-center/help b/gcloud/alpha/design-center/help new file mode 100644 index 000000000..3d1fff769 --- /dev/null +++ b/gcloud/alpha/design-center/help @@ -0,0 +1,32 @@ +NAME + gcloud alpha design-center - manage Application Design Center resources + +SYNOPSIS + gcloud alpha design-center GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Application Design Center resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + locations + (ALPHA) Manage Design Center Locations. + + operations + (ALPHA) Manage Operation resources. + + spaces + (ALPHA) Manage space resources. + +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. + diff --git a/gcloud/alpha/design-center/locations/describe b/gcloud/alpha/design-center/locations/describe new file mode 100644 index 000000000..493f93732 --- /dev/null +++ b/gcloud/alpha/design-center/locations/describe @@ -0,0 +1,56 @@ +NAME + gcloud alpha design-center locations describe - describe a Design Center + location + +SYNOPSIS + gcloud alpha design-center locations describe LOCATION + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Design Center location. + +EXAMPLES + To describe a specific design center location with the name my-location in + project my-project, run: + + $ gcloud alpha design-center locations describe my-location \ + --project=my-project + + Or run: + + $ gcloud alpha design-center locations describe \ + projects/my-project/locations/my-location + +POSITIONAL ARGUMENTS + Location resource - Location. 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 location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument location 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. + +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. + diff --git a/gcloud/alpha/design-center/locations/help b/gcloud/alpha/design-center/locations/help new file mode 100644 index 000000000..5f36b1fdd --- /dev/null +++ b/gcloud/alpha/design-center/locations/help @@ -0,0 +1,30 @@ +NAME + gcloud alpha design-center locations - manage Design Center Locations + +SYNOPSIS + gcloud alpha design-center locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for getting and listing locations where Design Center is + available. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe a Design Center location. + + list + (ALPHA) List Design Center locations. + +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. + diff --git a/gcloud/alpha/run/presets/list b/gcloud/alpha/design-center/locations/list similarity index 83% rename from gcloud/alpha/run/presets/list rename to gcloud/alpha/design-center/locations/list index 8ea8d20b6..50613cd12 100644 --- a/gcloud/alpha/run/presets/list +++ b/gcloud/alpha/design-center/locations/list @@ -1,25 +1,18 @@ NAME - gcloud alpha run presets list - list available Cloud Run presets. Currently - only available in alpha + gcloud alpha design-center locations list - list Design Center locations SYNOPSIS - gcloud alpha run presets list [--region=REGION] [--filter=EXPRESSION] + gcloud alpha design-center locations list [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List available Cloud Run presets. Currently only available in - alpha. + (ALPHA) List Design Center locations. EXAMPLES - To list all available presets, run: + To list all design center locations in project my-project, run: - $ gcloud alpha run presets list - -FLAGS - --region=REGION - Region in which the resource can be found. Alternatively, set the - property [run/region]. + $ gcloud alpha design-center locations list --project=my-project LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/design-center/operations/cancel b/gcloud/alpha/design-center/operations/cancel new file mode 100644 index 000000000..9d4b33468 --- /dev/null +++ b/gcloud/alpha/design-center/operations/cancel @@ -0,0 +1,65 @@ +NAME + gcloud alpha design-center operations cancel - cancel operations + +SYNOPSIS + gcloud alpha design-center operations cancel + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Cancel an operation + +EXAMPLES + To cancel the operation, run: + + $ gcloud alpha design-center operations cancel + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be cancelled. + The arguments in this group can be used to specify the attributes of this + 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 operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/operations/delete b/gcloud/alpha/design-center/operations/delete new file mode 100644 index 000000000..251e04b59 --- /dev/null +++ b/gcloud/alpha/design-center/operations/delete @@ -0,0 +1,65 @@ +NAME + gcloud alpha design-center operations delete - delete operations + +SYNOPSIS + gcloud alpha design-center operations delete + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an operation + +EXAMPLES + To delete the operation, run: + + $ gcloud alpha design-center operations delete + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to be deleted. The + arguments in this group can be used to specify the attributes of this + 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 operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/operations/describe b/gcloud/alpha/design-center/operations/describe new file mode 100644 index 000000000..0d5a3b1b2 --- /dev/null +++ b/gcloud/alpha/design-center/operations/describe @@ -0,0 +1,65 @@ +NAME + gcloud alpha design-center operations describe - describe operations + +SYNOPSIS + gcloud alpha design-center operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an operation + +EXAMPLES + To describe the operation, run: + + $ gcloud alpha design-center operations describe + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource. The arguments in + this group can be used to specify the attributes of this 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 operation on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the operation resource. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/operations/help b/gcloud/alpha/design-center/operations/help new file mode 100644 index 000000000..dd7bd3819 --- /dev/null +++ b/gcloud/alpha/design-center/operations/help @@ -0,0 +1,35 @@ +NAME + gcloud alpha design-center operations - manage Operation resources + +SYNOPSIS + gcloud alpha design-center operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Operation resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + cancel + (ALPHA) Cancel operations. + + delete + (ALPHA) Delete operations. + + describe + (ALPHA) Describe operations. + + list + (ALPHA) List operations. + +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. + diff --git a/gcloud/alpha/design-center/operations/list b/gcloud/alpha/design-center/operations/list new file mode 100644 index 000000000..b248de0b5 --- /dev/null +++ b/gcloud/alpha/design-center/operations/list @@ -0,0 +1,86 @@ +NAME + gcloud alpha design-center operations list - list operations + +SYNOPSIS + gcloud alpha design-center operations list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List operations + +EXAMPLES + To list all operations, run: + + $ gcloud alpha design-center operations list + +REQUIRED FLAGS + Location resource - The name of the operation's parent 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/commit b/gcloud/alpha/design-center/spaces/application-templates/commit new file mode 100644 index 000000000..46b623843 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/commit @@ -0,0 +1,85 @@ +NAME + gcloud alpha design-center spaces application-templates commit - commit an + application template + +SYNOPSIS + gcloud alpha design-center spaces application-templates commit + (APPLICATION_TEMPLATE : --location=LOCATION --space=SPACE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commits an application template to create a new revision. + +EXAMPLES + To commit the application template my-app-template in space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates commit \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates commit \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template + +POSITIONAL ARGUMENTS + ApplicationTemplate resource - The name of the application template. The + arguments in this group can be used to specify the attributes of this + 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 application_template on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application_template attribute: + ▸ provide the argument application_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the applicationTemplate resource. + + To set the location attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/connections/create b/gcloud/alpha/design-center/spaces/application-templates/components/connections/create new file mode 100644 index 000000000..4c24d75b6 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/connections/create @@ -0,0 +1,250 @@ +NAME + gcloud alpha design-center spaces application-templates components + connections create - create a connection + +SYNOPSIS + gcloud alpha design-center spaces application-templates components + connections create (CONNECTION : --component=COMPONENT) + --destination-component-uri=DESTINATION_COMPONENT_URI + [--application-template=APPLICATION_TEMPLATE] + [--destination-component-parameters=[key=KEY],[value=VALUE]] + [--location=LOCATION] + [--source-component-parameters=[key=KEY],[value=VALUE]] [--space=SPACE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a connection between components in an application template. + +EXAMPLES + To create the connection my-connection in component my-component of + application template my-app-template, space my-space, project my-project + and location us-central1 with a destination component other-component, run: + + $ gcloud alpha design-center spaces application-templates \ + components connections create my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-component-uri=other-component + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components connections create my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-component-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/applicationTemplates/my-app-template/\ + components/other-component + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components connections create \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component/\ + connections/my-connection \ + --destination-component-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/applicationTemplates/my-app-template/\ + components/other-component + + To create the connection my-connection with a parameter key-value pair of + type:connection-type in component my-component of application template + my-app-template, space my-space, project my-project and location + us-central1 with a destination component other-component, run the following + shorthand example: + + $ gcloud alpha design-center spaces application-templates \ + components connections create my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-component-uri=other-component \ + --parameters=key=type,value=connection-type + + Or run the following JSON example: + + $ gcloud alpha design-center spaces application-templates \ + components connections create my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-component-uri=other-component \ + --parameters='[{"key": "type", "value": "connection-type"}]' + + Or create a YAML or JSON file with the parameters and run the following + file example: + + $ gcloud alpha design-center spaces application-templates \ + components connections create my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-component-uri=other-component \ + --parameters=my-parameters.yaml + +POSITIONAL ARGUMENTS + Connection resource - Identifier. The connection name. The arguments in + this group can be used to specify the attributes of this 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 connection 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 connection on the command line with a fully + specified name; + ◆ provide the argument --location on the command line. + + To set the space attribute: + ◆ provide the argument connection on the command line with a fully + specified name; + ◆ provide the argument --space on the command line. + + To set the application-template attribute: + ◆ provide the argument connection on the command line with a fully + specified name; + ◆ provide the argument --application-template on the command line. + + This must be specified. + + CONNECTION + ID of the connection or fully qualified identifier for the + connection. + + To set the connection attribute: + ▸ provide the argument connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --component=COMPONENT + The component id of the connection resource. + + To set the component attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --component on the command line. + +REQUIRED FLAGS + Component resource - The destination component URI used to generate the + connection. Format is + projects/$project/locations/$location/spaces/$space/applicationTemplates/$application_template/components/$component + 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 --destination-component-uri 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 --destination-component-uri on the command line + with a fully specified name; + ◆ provide the argument --location on the command line. + + To set the space attribute: + ◆ provide the argument --destination-component-uri on the command line + with a fully specified name; + ◆ provide the argument --space on the command line. + + To set the application-template attribute: + ◆ provide the argument --destination-component-uri on the command line + with a fully specified name; + ◆ provide the argument --application-template on the command line. + + This must be specified. + + --destination-component-uri=DESTINATION_COMPONENT_URI + ID of the component or fully qualified identifier for the component. + + To set the component attribute: + ▸ provide the argument --destination-component-uri on the command + line. + +OPTIONAL FLAGS + --application-template=APPLICATION_TEMPLATE + For resources [connection, destination-component-uri], provides + fallback value for resource application-template attribute. When the + resource's full URI path is not provided, application-template will + fallback to this flag value. + + --destination-component-parameters=[key=KEY],[value=VALUE] + The parameters of the connection associated with the destination + component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --destination-component-parameters=key=string,value={...} --destination-component-parameters=key=string,value={...} + + JSON Example: + + --destination-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --destination-component-parameters=path_to_file.(yaml|json) + + --location=LOCATION + For resources [connection, destination-component-uri], provides + fallback value for resource location attribute. When the resource's + full URI path is not provided, location will fallback to this flag + value. + + --source-component-parameters=[key=KEY],[value=VALUE] + The parameters of the connection associated with the source component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --source-component-parameters=key=string,value={...} --source-component-parameters=key=string,value={...} + + JSON Example: + + --source-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --source-component-parameters=path_to_file.(yaml|json) + + --space=SPACE + For resources [connection, destination-component-uri], provides + fallback value for resource space attribute. When the resource's full + URI path is not provided, space will fallback to this flag value. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/connections/delete b/gcloud/alpha/design-center/spaces/application-templates/components/connections/delete new file mode 100644 index 000000000..002b8c98c --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/connections/delete @@ -0,0 +1,107 @@ +NAME + gcloud alpha design-center spaces application-templates components + connections delete - delete a connection + +SYNOPSIS + gcloud alpha design-center spaces application-templates components + connections delete + (CONNECTION : --application-template=APPLICATION_TEMPLATE + --component=COMPONENT --location=LOCATION --space=SPACE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a connection between components in an application template. + +EXAMPLES + To delete the connection my-connection in component my-component of + application template my-app-template, space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components connections delete my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components connections delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component/\ + connections/my-connection + +POSITIONAL ARGUMENTS + Connection resource - The connection name. The arguments in this group can + be used to specify the attributes of this 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 connection on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONNECTION + ID of the connection or fully qualified identifier for the + connection. + + To set the connection attribute: + ▸ provide the argument connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the connection resource. + + To set the application-template attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --component=COMPONENT + The component id of the connection resource. + + To set the component attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --component on the command line. + + --location=LOCATION + The location id of the connection resource. + + To set the location attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the connection resource. + + To set the space attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/connections/describe b/gcloud/alpha/design-center/spaces/application-templates/components/connections/describe new file mode 100644 index 000000000..375034c11 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/connections/describe @@ -0,0 +1,108 @@ +NAME + gcloud alpha design-center spaces application-templates components + connections describe - describe a connection + +SYNOPSIS + gcloud alpha design-center spaces application-templates components + connections describe + (CONNECTION : --application-template=APPLICATION_TEMPLATE + --component=COMPONENT --location=LOCATION --space=SPACE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a connection between components in an application + template. + +EXAMPLES + To describe the connection my-connection in component my-component of + application template my-app-template, space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components connections describe my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components connections describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component/\ + connections/my-connection + +POSITIONAL ARGUMENTS + Connection resource - Name of the resource The arguments in this group can + be used to specify the attributes of this 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 connection on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CONNECTION + ID of the connection or fully qualified identifier for the + connection. + + To set the connection attribute: + ▸ provide the argument connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the connection resource. + + To set the application-template attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --component=COMPONENT + The component id of the connection resource. + + To set the component attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --component on the command line. + + --location=LOCATION + The location id of the connection resource. + + To set the location attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the connection resource. + + To set the space attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/connections/help b/gcloud/alpha/design-center/spaces/application-templates/components/connections/help new file mode 100644 index 000000000..1eb6a32fb --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/connections/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha design-center spaces application-templates components + connections - manage connection resources + +SYNOPSIS + gcloud alpha design-center spaces application-templates components + connections COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage connection resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a connection. + + delete + (ALPHA) Delete a connection. + + describe + (ALPHA) Describe a connection. + + list + (ALPHA) List connections. + + update + (ALPHA) Update a connection. + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/connections/list b/gcloud/alpha/design-center/spaces/application-templates/components/connections/list new file mode 100644 index 000000000..706aa5f51 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/connections/list @@ -0,0 +1,131 @@ +NAME + gcloud alpha design-center spaces application-templates components + connections list - list connections + +SYNOPSIS + gcloud alpha design-center spaces application-templates components + connections list + (--component=COMPONENT : --application-template=APPLICATION_TEMPLATE + --location=LOCATION --space=SPACE) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List connections in a component of an application template. + +EXAMPLES + To list all connections in component my-component of application template + my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components connections list --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components connections list \ + --component=projects/my-project/locations/us-central1/spaces/\ + my-space/applicationTemplates/my-app-template/components/\ + my-component + +REQUIRED FLAGS + Component resource - The parent resource from which to request a list of + connections. The arguments in this group can be used to specify the + attributes of this 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 --component on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --component=COMPONENT + ID of the component or fully qualified identifier for the component. + + To set the component attribute: + ▸ provide the argument --component on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the component resource. + + To set the application-template attribute: + ▸ provide the argument --component on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --location=LOCATION + The location id of the component resource. + + To set the location attribute: + ▸ provide the argument --component on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the component resource. + + To set the space attribute: + ▸ provide the argument --component on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/connections/update b/gcloud/alpha/design-center/spaces/application-templates/components/connections/update new file mode 100644 index 000000000..16dc52f8b --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/connections/update @@ -0,0 +1,384 @@ +NAME + gcloud alpha design-center spaces application-templates components + connections update - update a connection + +SYNOPSIS + gcloud alpha design-center spaces application-templates components + connections update (CONNECTION : --component=COMPONENT) + [--application-template=APPLICATION_TEMPLATE] + [--destination-component-uri=DESTINATION_COMPONENT_URI] + [--location=LOCATION] [--space=SPACE] + [--destination-component-parameters=[key=KEY],[value=VALUE] + | --add-destination-component-parameters=[key=KEY],[value=VALUE] + --clear-destination-component-parameters + | --remove-destination-component-parameters=[key=KEY],[value=VALUE]] + [--source-component-parameters=[key=KEY],[value=VALUE] + | --add-source-component-parameters=[key=KEY],[value=VALUE] + --clear-source-component-parameters + | --remove-source-component-parameters=[key=KEY],[value=VALUE]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a connection between components in an application template. + +EXAMPLES + To update the destination component URI to + projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/components/other-new-component + in the connection my-connection in component my-component of application + template my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components connections update my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-component-uri=other-new-component + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components connections update my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-component-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/applicationTemplates/my-app-template/\ + components/other-new-component + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components connections update \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component/\ + connections/my-connection \ + --destination-component-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/applicationTemplates/my-app-template/\ + components/other-new-component + + To add a new parameter key-value pair of new_parameter_key:new-parameter to + the connection my-connection in component my-component of application + template my-app-template, space my-space, project my-project and location + us-central1, run the following shorthand example: + + $ gcloud alpha design-center spaces application-templates \ + components connections update my-connection \ + --application-template=my-app-template \ + --component=my-component --space=my-space --project=my-project \ + --location=us-central1 \ + --add-parameters=key=project_id,value=new-project \ + --add-parameters=key=new_parameter_key,value=new-parameter + + Or run the following JSON example: + + $ gcloud alpha design-center spaces application-templates \ + components connections update my-connection \ + --application-template=my-app-template \ + --component=my-component --space=my-space --project=my-project \ + --location=us-central1 \ + --add-parameters='[{"key": "project_id", "value": + "new-project"}, {"key": "new_parameter_key", "value": + "new-parameter"}]' + + Or create a YAML or JSON file with the parameters and run the following + file example: + + $ gcloud alpha design-center spaces application-templates \ + components connections update my-connection \ + --application-template=my-app-template \ + --component=my-component --space=my-space --project=my-project \ + --location=us-central1 --add-parameters=my-parameters.yaml + + To clear all parameters from the connection my-connection in component + my-component of application template my-app-template, space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components connections update my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 --clear-parameters + + To remove an existing parameter key-value pair of type:connection-type from + the connection my-connection in component my-component of application + template my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components connections update my-connection \ + --component=my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --remove-parameters=key=type,value=connection-type + +POSITIONAL ARGUMENTS + Connection resource - Identifier. The connection name. The arguments in + this group can be used to specify the attributes of this 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 connection 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 connection on the command line with a fully + specified name; + ◆ provide the argument --location on the command line. + + To set the space attribute: + ◆ provide the argument connection on the command line with a fully + specified name; + ◆ provide the argument --space on the command line. + + To set the application-template attribute: + ◆ provide the argument connection on the command line with a fully + specified name; + ◆ provide the argument --application-template on the command line. + + This must be specified. + + CONNECTION + ID of the connection or fully qualified identifier for the + connection. + + To set the connection attribute: + ▸ provide the argument connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --component=COMPONENT + The component id of the connection resource. + + To set the component attribute: + ▸ provide the argument connection on the command line with a fully + specified name; + ▸ provide the argument --component on the command line. + +FLAGS + --application-template=APPLICATION_TEMPLATE + For resources [connection, destination-component-uri], provides + fallback value for resource application-template attribute. When the + resource's full URI path is not provided, application-template will + fallback to this flag value. + + Component resource - The destination component URI used to generate the + connection. Format is + projects/$project/locations/$location/spaces/$space/applicationTemplates/$application_template/components/$component + 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 --destination-component-uri 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 --destination-component-uri on the command line + with a fully specified name; + ◆ provide the argument --location on the command line. + + To set the space attribute: + ◆ provide the argument --destination-component-uri on the command line + with a fully specified name; + ◆ provide the argument --space on the command line. + + To set the application-template attribute: + ◆ provide the argument --destination-component-uri on the command line + with a fully specified name; + ◆ provide the argument --application-template on the command line. + + --destination-component-uri=DESTINATION_COMPONENT_URI + ID of the component or fully qualified identifier for the component. + + To set the component attribute: + ▸ provide the argument --destination-component-uri on the command + line. + + --location=LOCATION + For resources [connection, destination-component-uri], provides + fallback value for resource location attribute. When the resource's + full URI path is not provided, location will fallback to this flag + value. + + --space=SPACE + For resources [connection, destination-component-uri], provides + fallback value for resource space attribute. When the resource's full + URI path is not provided, space will fallback to this flag value. + + Update destination_component_parameters. + + At most one of these can be specified: + + --destination-component-parameters=[key=KEY],[value=VALUE] + Set destination_component_parameters to new value. The parameters of + the connection associated with the destination component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --destination-component-parameters=key=string,value={...} --destination-component-parameters=key=string,value={...} + + JSON Example: + + --destination-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --destination-component-parameters=path_to_file.(yaml|json) + + --add-destination-component-parameters=[key=KEY],[value=VALUE] + Add new value to destination_component_parameters list. The + parameters of the connection associated with the destination + component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --add-destination-component-parameters=key=string,value={...} --add-destination-component-parameters=key=string,value={...} + + JSON Example: + + --add-destination-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --add-destination-component-parameters=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-destination-component-parameters + Clear destination_component_parameters value and set to empty list. + + --remove-destination-component-parameters=[key=KEY],[value=VALUE] + Remove existing value from destination_component_parameters list. + The parameters of the connection associated with the destination + component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --remove-destination-component-parameters=key=string,value={...} --remove-destination-component-parameters=key=string,value={...} + + JSON Example: + + --remove-destination-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --remove-destination-component-parameters=path_to_file.(yaml|json) + + Update source_component_parameters. + + At most one of these can be specified: + + --source-component-parameters=[key=KEY],[value=VALUE] + Set source_component_parameters to new value. The parameters of the + connection associated with the source component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --source-component-parameters=key=string,value={...} --source-component-parameters=key=string,value={...} + + JSON Example: + + --source-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --source-component-parameters=path_to_file.(yaml|json) + + --add-source-component-parameters=[key=KEY],[value=VALUE] + Add new value to source_component_parameters list. The parameters of + the connection associated with the source component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --add-source-component-parameters=key=string,value={...} --add-source-component-parameters=key=string,value={...} + + JSON Example: + + --add-source-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --add-source-component-parameters=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-source-component-parameters + Clear source_component_parameters value and set to empty list. + + --remove-source-component-parameters=[key=KEY],[value=VALUE] + Remove existing value from source_component_parameters list. The + parameters of the connection associated with the source component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --remove-source-component-parameters=key=string,value={...} --remove-source-component-parameters=key=string,value={...} + + JSON Example: + + --remove-source-component-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --remove-source-component-parameters=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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/create b/gcloud/alpha/design-center/spaces/application-templates/components/create new file mode 100644 index 000000000..8e71af03f --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/create @@ -0,0 +1,215 @@ +NAME + gcloud alpha design-center spaces application-templates components create - + create a component + +SYNOPSIS + gcloud alpha design-center spaces application-templates components create + (COMPONENT : --application-template=APPLICATION_TEMPLATE + --location=LOCATION --space=SPACE) + --shared-template-revision-uri=SHARED_TEMPLATE_REVISION_URI + [--display-name=DISPLAY_NAME] [--parameters=[key=KEY],[value=VALUE]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a component in an application template. + +EXAMPLES + To create the component my-component in application template + my-app-template, space my-space, project my-project and location + us-central1 using a shared template revision, run: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/sharedTemplates/my-shared-template/\ + revisions/rev1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ components create \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component \ + --shared-template-revision-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/sharedTemplates/my-shared-template/\ + revisions/rev1 + + To create the component my-component in application template + my-app-template, space my-space, project my-project and location + us-central1 using a google shared template google-shared-template and + revision rev1, run: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=google/google-shared-template/\ + revisions/rev1 + + To create the component my-component in application template + my-app-template, space my-space, project my-project and location + us-central1 using a google shared template google-shared-template with its + latest revision, run: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=google/google-shared-template + + To create the component my-component in application template + my-app-template, space my-space, project my-project and location + us-central1 using a shared template my-shared-template and revision rev1 + present in the same space, run: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=my-shared-template/revisions/rev1 + + To create the component my-component in application template + my-app-template, space my-space, project my-project and location + us-central1 using a shared template my-shared-template with its latest + revision present in the same space, run: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=my-shared-template + + To create the component my-component with a display name My Component in + application template my-app-template, space my-space, project my-project + and location us-central1 using a shared template revision, run: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/sharedTemplates/my-shared-template/\ + revisions/rev1 --display-name="My Component" + + To create the component my-component with parameter key value pair of + region:us-central1 in application template my-app-template, space my-space, + project my-project and location us-central1, run the following shorthand + example: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/sharedTemplates/my-shared-template/\ + revisions/rev1 --parameters=key=region,value=us-central1 + + Or run the following JSON example: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/sharedTemplates/my-shared-template/\ + revisions/rev1 \ + --parameters='[{"key": "region", "value": "us-central1"}]' + + Or create a YAML or JSON file with the parameters and run the following + file example: + + $ gcloud alpha design-center spaces application-templates \ components create my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/sharedTemplates/my-shared-template/\ + revisions/rev1 --parameters=my-parameters.yaml + +POSITIONAL ARGUMENTS + Component resource - Identifier. The component name. The arguments in this + group can be used to specify the attributes of this 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 component on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + COMPONENT + ID of the component or fully qualified identifier for the component. + + To set the component attribute: + ▸ provide the argument component on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the component resource. + + To set the application-template attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --location=LOCATION + The location id of the component resource. + + To set the location attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the component resource. + + To set the space attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +REQUIRED FLAGS + --shared-template-revision-uri=SHARED_TEMPLATE_REVISION_URI + The shared template used to generate the component. + +OPTIONAL FLAGS + --display-name=DISPLAY_NAME + The component display name. + + --parameters=[key=KEY],[value=VALUE] + The component parameters. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --parameters=key=string,value={...} --parameters=key=string,value={...} + + JSON Example: + + --parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --parameters=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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/delete b/gcloud/alpha/design-center/spaces/application-templates/components/delete new file mode 100644 index 000000000..01fa9129a --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/delete @@ -0,0 +1,109 @@ +NAME + gcloud alpha design-center spaces application-templates components delete - + delete a component + +SYNOPSIS + gcloud alpha design-center spaces application-templates components delete + (COMPONENT : --application-template=APPLICATION_TEMPLATE + --location=LOCATION --space=SPACE) [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a component in an application template. + +EXAMPLES + To delete the component my-component in application template + my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components delete my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component + + If your component contains child resources such as connections, force + delete the component. To force delete the component my-component in + application template my-app-template, space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components delete my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 --force + +POSITIONAL ARGUMENTS + Component resource - The component name. The arguments in this group can + be used to specify the attributes of this 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 component on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + COMPONENT + ID of the component or fully qualified identifier for the component. + + To set the component attribute: + ▸ provide the argument component on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the component resource. + + To set the application-template attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --location=LOCATION + The location id of the component resource. + + To set the location attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the component resource. + + To set the space attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --force + If set to true, the component's children are also deleted. If false, + the component is only deleted if it has no children. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/describe b/gcloud/alpha/design-center/spaces/application-templates/components/describe new file mode 100644 index 000000000..cf48ef8a8 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/describe @@ -0,0 +1,94 @@ +NAME + gcloud alpha design-center spaces application-templates components describe + - describe a component + +SYNOPSIS + gcloud alpha design-center spaces application-templates components describe + (COMPONENT : --application-template=APPLICATION_TEMPLATE + --location=LOCATION --space=SPACE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a component in an application template. + +EXAMPLES + To describe the component my-component in application template + my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components describe my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component + +POSITIONAL ARGUMENTS + Component resource - The component name. The arguments in this group can + be used to specify the attributes of this 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 component on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + COMPONENT + ID of the component or fully qualified identifier for the component. + + To set the component attribute: + ▸ provide the argument component on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the component resource. + + To set the application-template attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --location=LOCATION + The location id of the component resource. + + To set the location attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the component resource. + + To set the space attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/help b/gcloud/alpha/design-center/spaces/application-templates/components/help new file mode 100644 index 000000000..95a40df52 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/help @@ -0,0 +1,46 @@ +NAME + gcloud alpha design-center spaces application-templates components - manage + component resources + +SYNOPSIS + gcloud alpha design-center spaces application-templates components + GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage component resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + connections + (ALPHA) Manage connection resources. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a component. + + delete + (ALPHA) Delete a component. + + describe + (ALPHA) Describe a component. + + list + (ALPHA) List components. + + update + (ALPHA) Update a component. + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/list b/gcloud/alpha/design-center/spaces/application-templates/components/list new file mode 100644 index 000000000..9984b5dcf --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/list @@ -0,0 +1,146 @@ +NAME + gcloud alpha design-center spaces application-templates components list - + list components + +SYNOPSIS + gcloud alpha design-center spaces application-templates components list + (--application-template=APPLICATION_TEMPLATE + : --location=LOCATION --space=SPACE) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List components in an application template. + +EXAMPLES + To list all components in application template my-app-template, space + my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components list --application-template=my-app-template \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components list \ + --application-template=projects/my-project/locations/\ + us-central1/spaces/my-space/applicationTemplates/my-app-template + + To filter and list components that contain a my-component prefix in the + display name in application template my-app-template, space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components list --application-template=my-app-template \ + --space=my-space --project=my-project --location=us-central1 \ + --filter="displayName:my-component*" + + To list up to 10 components in application template my-app-template, space + my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components list --application-template=my-app-template \ + --space=my-space --project=my-project --location=us-central1 \ + --limit=10 + + To list components sorted by display name in application template + my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components list --application-template=my-app-template \ + --space=my-space --project=my-project --location=us-central1 \ + --sort-by=displayName + +REQUIRED FLAGS + ApplicationTemplate resource - The parent resource from which the list of + components is requested. The arguments in this group can be used to + specify the attributes of this 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 --application-template on the command line with + a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --application-template=APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application-template attribute: + ▸ provide the argument --application-template on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the applicationTemplate resource. + + To set the location attribute: + ▸ provide the argument --application-template on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument --application-template on the command line + with a fully specified name; + ▸ provide the argument --space on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/components/update b/gcloud/alpha/design-center/spaces/application-templates/components/update new file mode 100644 index 000000000..53e470f52 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/components/update @@ -0,0 +1,256 @@ +NAME + gcloud alpha design-center spaces application-templates components update - + update a component + +SYNOPSIS + gcloud alpha design-center spaces application-templates components update + (COMPONENT : --application-template=APPLICATION_TEMPLATE + --location=LOCATION --space=SPACE) [--display-name=DISPLAY_NAME] + [--parameters=[key=KEY],[value=VALUE] + | --add-parameters=[key=KEY],[value=VALUE] --clear-parameters + | --remove-parameters=[key=KEY],[value=VALUE]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a component in an application template. + +EXAMPLES + To update the display name to My New Component Name in the component + my-component in application template my-app-template, space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --display-name="My New Component Name" + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + components update \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/components/my-component \ + --display-name="My New Component Name" + + To update the parameters with new key-value pairs of project_id:new-project + and service_name:new-service for the component my-component in application + template my-app-template, space my-space, project my-project and location + us-central1, run the following shorthand example: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --parameters=key=project_id,value=new-project \ + --add-parameters=key=service_name,value=new-service + + Or run the following JSON example: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --parameters='[{"key": "project_id", "value": "new-project"}, + {"key": "service_name", "value": "new-service"}]' + + Or create a YAML or JSON file with the parameters and run the following + file example: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --parameters=my-parameters.yaml + + To add new parameters key-value pair of project_id:new-project and + service_name:new-service to the component my-component in application + template my-app-template, space my-space, project my-project and location + us-central1, run the following shorthand example: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --add-parameters=key=project_id,value=new-project \ + --add-parameters=key=service_name,value=new-service + + Or run the following JSON example: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --add-parameters='[{"key": "project_id", "value": + "new-project"}, {"key": "service_name", "value": "new-service"}]' + + Or create a YAML or JSON file with the parameters and run the following + file example: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --add-parameters=my-parameters.yaml + + To clear all parameters from the component my-component in application + template my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 --clear-parameters + + To remove an existing parameter key-value pair of project_id:new-project + from the component my-component in application template my-app-template, + space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + components update my-component \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --remove-parameters=key=project_id,value=my-project + +POSITIONAL ARGUMENTS + Component resource - Identifier. The component name. The arguments in this + group can be used to specify the attributes of this 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 component on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + COMPONENT + ID of the component or fully qualified identifier for the component. + + To set the component attribute: + ▸ provide the argument component on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the component resource. + + To set the application-template attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --location=LOCATION + The location id of the component resource. + + To set the location attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the component resource. + + To set the space attribute: + ▸ provide the argument component on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --display-name=DISPLAY_NAME + The component display name. + + Update parameters. + + At most one of these can be specified: + + --parameters=[key=KEY],[value=VALUE] + Set parameters to new value. The component parameters. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --parameters=key=string,value={...} --parameters=key=string,value={...} + + JSON Example: + + --parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --parameters=path_to_file.(yaml|json) + + --add-parameters=[key=KEY],[value=VALUE] + Add new value to parameters list. The component parameters. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --add-parameters=key=string,value={...} --add-parameters=key=string,value={...} + + JSON Example: + + --add-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --add-parameters=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-parameters + Clear parameters value and set to empty list. + + --remove-parameters=[key=KEY],[value=VALUE] + Remove existing value from parameters list. The component + parameters. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --remove-parameters=key=string,value={...} --remove-parameters=key=string,value={...} + + JSON Example: + + --remove-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --remove-parameters=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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/create b/gcloud/alpha/design-center/spaces/application-templates/create new file mode 100644 index 000000000..ea9d1da40 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/create @@ -0,0 +1,150 @@ +NAME + gcloud alpha design-center spaces application-templates create - create an + application template + +SYNOPSIS + gcloud alpha design-center spaces application-templates create + (APPLICATION_TEMPLATE : --location=LOCATION --space=SPACE) + [--application-parameters=[key=KEY],[value=VALUE]] + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an application template. + +EXAMPLES + To create the application template my-app-template in space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates create \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates create \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template + + To create the application template my-app-template with a display name of + My App Template and description of My app template description, run: + + $ gcloud alpha design-center spaces application-templates create \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 --display-name="My App Template" \ + --description="My app template description" + + To create the application template my-app-template with application + parameters key-value pair of project_id:my-project and region:us-central1, + run the following shorthand example: + + $ gcloud alpha design-center spaces application-templates create \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 \ + --application-parameters=key=project_id,value=my-project \ + --application-parameters=key=region,value=us-central1 + + Or run the following JSON example: + + $ gcloud alpha design-center spaces application-templates create \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 \ + --application-parameters='[{"key": "project_id", "value": + "my-project"}, {"key": "region", "value": "us-central1"}]' + + Or create a YAML or JSON file with the parameters and run the following + file example: + + $ gcloud alpha design-center spaces application-templates create \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 \ + --application-parameters=my-parameters.yaml + +POSITIONAL ARGUMENTS + ApplicationTemplate resource - Identifier. Application template name. The + arguments in this group can be used to specify the attributes of this + 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 application_template on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application_template attribute: + ▸ provide the argument application_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the applicationTemplate resource. + + To set the location attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --application-parameters=[key=KEY],[value=VALUE] + Parameters to apply to all components in an application. You can + specify projectID and region. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --application-parameters=key=string,value={...} --application-parameters=key=string,value={...} + + JSON Example: + + --application-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --application-parameters=path_to_file.(yaml|json) + + --description=DESCRIPTION + Application template description. + + --display-name=DISPLAY_NAME + Application template display name. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/delete b/gcloud/alpha/design-center/spaces/application-templates/delete new file mode 100644 index 000000000..8a3848b33 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/delete @@ -0,0 +1,100 @@ +NAME + gcloud alpha design-center spaces application-templates delete - delete an + application template + +SYNOPSIS + gcloud alpha design-center spaces application-templates delete + (APPLICATION_TEMPLATE : --location=LOCATION --space=SPACE) [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an application template. + +EXAMPLES + To delete the application template my-app-template in space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates delete \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template + + If your application template contains child resources such as revisions, + components, force delete the application template. To force delete the + application template my-app-template in space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates delete \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 --force + +POSITIONAL ARGUMENTS + ApplicationTemplate resource - The application template name. The + arguments in this group can be used to specify the attributes of this + 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 application_template on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application_template attribute: + ▸ provide the argument application_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the applicationTemplate resource. + + To set the location attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --force + If set to true, the application template's children are also deleted. + If false, the application template is only deleted if it has no + children. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/describe b/gcloud/alpha/design-center/spaces/application-templates/describe new file mode 100644 index 000000000..3e25db5df --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/describe @@ -0,0 +1,85 @@ +NAME + gcloud alpha design-center spaces application-templates describe - describe + an application template + +SYNOPSIS + gcloud alpha design-center spaces application-templates describe + (APPLICATION_TEMPLATE : --location=LOCATION --space=SPACE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an application template. + +EXAMPLES + To describe the application template my-app-template in space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates describe \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template + +POSITIONAL ARGUMENTS + ApplicationTemplate resource - The application template name. The + arguments in this group can be used to specify the attributes of this + 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 application_template on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application_template attribute: + ▸ provide the argument application_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the applicationTemplate resource. + + To set the location attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/generate b/gcloud/alpha/design-center/spaces/application-templates/generate new file mode 100644 index 000000000..21028de5c --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/generate @@ -0,0 +1,184 @@ +NAME + gcloud alpha design-center spaces application-templates generate - generate + IaC for an application template + +SYNOPSIS + gcloud alpha design-center spaces application-templates generate + (APPLICATION_TEMPLATE : --space=SPACE) [--gcs-uri=GCS_URI] + [--iac-format=IAC_FORMAT] [--location=LOCATION] + [--artifact-location-gcs-uri=ARTIFACT_LOCATION_GCS_URI + | [--developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR (--developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI : --connection=CONNECTION) : --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Generates Terraform files for an application template. + +EXAMPLES + To generate IaC for the application template my-app-template in space + my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates generate \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates generate \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template + + To generate IaC for the application template my-app-template in space + my-space, project my-project and location us-central1 and save to cloud + storage bucket my-bucket, run: + + $ gcloud alpha design-center spaces application-templates generate \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 --gcs-uri=gs://my-bucket + + To generate IaC for the application template my-app-template in Terraform + format in space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates generate \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 --iac-format=terraform + +POSITIONAL ARGUMENTS + ApplicationTemplate resource - The name of the application template. The + arguments in this group can be used to specify the attributes of this + 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 application_template 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 application_template on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application_template attribute: + ▸ provide the argument application_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --gcs-uri=GCS_URI + The Cloud Storage URI to write the generated IaC to. + + DEPRECATED: Use the 'artifact_location' field instead. + + --iac-format=IAC_FORMAT + The IaC format to generate. IAC_FORMAT must be one of: + + helm + IaC format is HELM. + terraform + IaC format is Terraform. + + --location=LOCATION + For resources [application_template, + developer-connect-export-config-repo-uri], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. + + Arguments for the location. + + At most one of these can be specified: + + --artifact-location-gcs-uri=ARTIFACT_LOCATION_GCS_URI + The Cloud Storage URI for storing the generated IaC. + + Through Developer Connect, defines a location where content such as + Infrastructure as Code (IaC) is stored. + + --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR + Directory, relative to the source repo, where content such as + Infrastructure as Code (IaC) will be stored. This must be a + relative path.To specify the root directory, use '/'. If the path + or any subdirectories do not exist, they will be created. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH + The branch in repo to which the content such as Infrastructure as + Code (IaC) should be written to. If empty, ADC will create a branch + and push the changes. + + GitRepositoryLink resource - The Developer Connect Git repository + link, formatted as + projects/*/locations/*/connections/*/gitRepositoryLinks/*. The + arguments in this group can be used to specify the attributes of this + 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 --developer-connect-export-config-repo-uri + 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 --developer-connect-export-config-repo-uri + on the command line with a fully specified name; + ▫ provide the argument --location on the command line. + + This must be specified. + + --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git-repository-link attribute: + ◇ provide the argument + --developer-connect-export-config-repo-uri on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --connection=CONNECTION + The connection id of the gitRepositoryLink resource. + + To set the connection attribute: + ◇ provide the argument + --developer-connect-export-config-repo-uri on the command line + with a fully specified name; + ◇ provide the argument --connection 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/help b/gcloud/alpha/design-center/spaces/application-templates/help new file mode 100644 index 000000000..f672c397f --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/help @@ -0,0 +1,58 @@ +NAME + gcloud alpha design-center spaces application-templates - manage + application template resources + +SYNOPSIS + gcloud alpha design-center spaces application-templates GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage application template resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + components + (ALPHA) Manage component resources. + + revisions + (ALPHA) Manage application template revision resources. + +COMMANDS + COMMAND is one of the following: + + commit + (ALPHA) Commit an application template. + + create + (ALPHA) Create an application template. + + delete + (ALPHA) Delete an application template. + + describe + (ALPHA) Describe an application template. + + generate + (ALPHA) Generate IaC for an application template. + + import + (ALPHA) Import to an application template. + + list + (ALPHA) List application templates. + + update + (ALPHA) Update an application template. + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/import b/gcloud/alpha/design-center/spaces/application-templates/import new file mode 100644 index 000000000..761c6fcad --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/import @@ -0,0 +1,148 @@ +NAME + gcloud alpha design-center spaces application-templates import - import to + an application template + +SYNOPSIS + gcloud alpha design-center spaces application-templates import + [--application-template=APPLICATION_TEMPLATE] + [--application-template-revision-uri=APPLICATION_TEMPLATE_REVISION_URI] + [--location=LOCATION] [--space=SPACE] + [--shared-template-revision-uri=SHARED_TEMPLATE_REVISION_URI + : --shared-template=SHARED_TEMPLATE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Imports to an existing application template from a given shared + template or application template revision. + +EXAMPLES + To import from a shared template revision to the application template + my-app-template in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates import \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --shared-template-revision-uri=projects/my-project/locations/\ + us-central1/spaces/my-space/sharedTemplates/my-shared-template/\ + revisions/rev1 + + To import from an application template revision to the application template + my-app-template in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates import \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 \ + --application-template-revision-uri=projects/my-project/\ + locations/us-central1/spaces/my-space/applicationTemplates/\ + another-app-template/revisions/rev2 + +FLAGS + --application-template=APPLICATION_TEMPLATE + For resources [application-template-revision-uri, + application_template], provides fallback value for resource + application-template attribute. When the resource's full URI path is + not provided, application-template will fallback to this flag value. + + Revision resource - The source URI for application template revision. 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 --application-template-revision-uri 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 --application-template-revision-uri on the + command line with a fully specified name; + ◆ provide the argument --location on the command line. + + To set the space attribute: + ◆ provide the argument --application-template-revision-uri on the + command line with a fully specified name; + ◆ provide the argument --space on the command line. + + To set the application-template attribute: + ◆ provide the argument --application-template-revision-uri on the + command line with a fully specified name; + ◆ provide the argument --application-template on the command line. + + --application-template-revision-uri=APPLICATION_TEMPLATE_REVISION_URI + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument --application-template-revision-uri on the + command line. + + --location=LOCATION + For resources [application-template-revision-uri, application_template, + shared-template-revision-uri], provides fallback value for resource + location attribute. When the resource's full URI path is not provided, + location will fallback to this flag value. + + --space=SPACE + For resources [application-template-revision-uri, application_template, + shared-template-revision-uri], provides fallback value for resource + space attribute. When the resource's full URI path is not provided, + space will fallback to this flag value. + + Revision resource - The source URI for catalog template. The arguments in + this group can be used to specify the attributes of this 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 --shared-template-revision-uri 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 --shared-template-revision-uri on the command + line with a fully specified name; + ◆ provide the argument --location on the command line. + + To set the space attribute: + ◆ provide the argument --shared-template-revision-uri on the command + line with a fully specified name; + ◆ provide the argument --space on the command line. + + --shared-template-revision-uri=SHARED_TEMPLATE_REVISION_URI + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument --shared-template-revision-uri on the + command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --shared-template=SHARED_TEMPLATE + The sharedTemplate id of the revision resource. + + To set the shared-template attribute: + ▸ provide the argument --shared-template-revision-uri on the + command line with a fully specified name; + ▸ provide the argument --shared-template 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/list b/gcloud/alpha/design-center/spaces/application-templates/list new file mode 100644 index 000000000..20631c2d5 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/list @@ -0,0 +1,123 @@ +NAME + gcloud alpha design-center spaces application-templates list - list + application templates + +SYNOPSIS + gcloud alpha design-center spaces application-templates list + (--space=SPACE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List application templates in a given space. + +EXAMPLES + To list all application templates in space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces application-templates list \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates list \ + --space=projects/my-project/locations/us-central1/spaces/\ + my-space + + To filter and list application templates with a display name of + my-app-template prefix in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates list \ + --space=my-space --project=my-project --location=us-central1 \ + --filter="displayName:my-app-template*" + + To list up to 10 application templates in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates list \ + --space=my-space --project=my-project --location=us-central1 \ + --limit=10 + +REQUIRED FLAGS + Space resource - The parent resource from which to list application + templates. The arguments in this group can be used to specify the + attributes of this 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 --space on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --space=SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument --space on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ▸ provide the argument --space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/revisions/delete b/gcloud/alpha/design-center/spaces/application-templates/revisions/delete new file mode 100644 index 000000000..b51257c47 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/revisions/delete @@ -0,0 +1,95 @@ +NAME + gcloud alpha design-center spaces application-templates revisions delete - + delete an application template revision + +SYNOPSIS + gcloud alpha design-center spaces application-templates revisions delete + (REVISION : --application-template=APPLICATION_TEMPLATE + --location=LOCATION --space=SPACE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an application template revision. + +EXAMPLES + To delete the application template revision my-revision in application + template my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + revisions delete my-revision \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + revisions delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/revisions/my-revision + +POSITIONAL ARGUMENTS + Revision resource - The application template revision name. The arguments + in this group can be used to specify the attributes of this 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 revision on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the revision resource. + + To set the application-template attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --location=LOCATION + The location id of the revision resource. + + To set the location attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the revision resource. + + To set the space attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/revisions/describe b/gcloud/alpha/design-center/spaces/application-templates/revisions/describe new file mode 100644 index 000000000..1003c7845 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/revisions/describe @@ -0,0 +1,95 @@ +NAME + gcloud alpha design-center spaces application-templates revisions describe + - describe an application template revision + +SYNOPSIS + gcloud alpha design-center spaces application-templates revisions describe + (REVISION : --application-template=APPLICATION_TEMPLATE + --location=LOCATION --space=SPACE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an application template revision. + +EXAMPLES + To describe the application template revision my-revision in application + template my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + revisions describe my-revision \ + --application-template=my-app-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + revisions describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template/revisions/my-revision + +POSITIONAL ARGUMENTS + Revision resource - The application template revision name. The arguments + in this group can be used to specify the attributes of this 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 revision on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --application-template=APPLICATION_TEMPLATE + The applicationTemplate id of the revision resource. + + To set the application-template attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --application-template on the command line. + + --location=LOCATION + The location id of the revision resource. + + To set the location attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the revision resource. + + To set the space attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/revisions/help b/gcloud/alpha/design-center/spaces/application-templates/revisions/help new file mode 100644 index 000000000..544628e25 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/revisions/help @@ -0,0 +1,34 @@ +NAME + gcloud alpha design-center spaces application-templates revisions - manage + application template revision resources + +SYNOPSIS + gcloud alpha design-center spaces application-templates revisions COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage application template revision resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (ALPHA) Delete an application template revision. + + describe + (ALPHA) Describe an application template revision. + + list + (ALPHA) List application template revisions. + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/revisions/list b/gcloud/alpha/design-center/spaces/application-templates/revisions/list new file mode 100644 index 000000000..3e9dc0bdb --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/revisions/list @@ -0,0 +1,139 @@ +NAME + gcloud alpha design-center spaces application-templates revisions list - + list application template revisions + +SYNOPSIS + gcloud alpha design-center spaces application-templates revisions list + (--application-template=APPLICATION_TEMPLATE + : --location=LOCATION --space=SPACE) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List application template revisions in an application template. + +EXAMPLES + To list all application template revisions in application template + my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + revisions list --application-template=my-app-template \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces application-templates \ + revisions list \ + --application-template=projects/my-project/locations/\ + us-central1/spaces/my-space/applicationTemplates/my-app-template + + To list up to 10 application template revisions in application template + my-app-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + revisions list --application-template=my-app-template \ + --space=my-space --project=my-project --location=us-central1 \ + --limit=10 + + To list application template revisions sorted by creation time in + application template my-app-template, space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates \ + revisions list --application-template=my-app-template \ + --space=my-space --project=my-project --location=us-central1 \ + --sort-by=createTime + +REQUIRED FLAGS + ApplicationTemplate resource - The parent from which to list application + template revisions. The arguments in this group can be used to specify the + attributes of this 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 --application-template on the command line with + a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --application-template=APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application-template attribute: + ▸ provide the argument --application-template on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the applicationTemplate resource. + + To set the location attribute: + ▸ provide the argument --application-template on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument --application-template on the command line + with a fully specified name; + ▸ provide the argument --space on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/application-templates/update b/gcloud/alpha/design-center/spaces/application-templates/update new file mode 100644 index 000000000..36ba9f97c --- /dev/null +++ b/gcloud/alpha/design-center/spaces/application-templates/update @@ -0,0 +1,202 @@ +NAME + gcloud alpha design-center spaces application-templates update - update an + application template + +SYNOPSIS + gcloud alpha design-center spaces application-templates update + (APPLICATION_TEMPLATE : --location=LOCATION --space=SPACE) + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [--application-parameters=[key=KEY],[value=VALUE] + | --add-application-parameters=[key=KEY],[value=VALUE] + --clear-application-parameters + | --remove-application-parameters=[key=KEY],[value=VALUE]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update an application template. + +EXAMPLES + To update the display name to My New App Template Name for the application + template my-app-template in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates update \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 --display-name="My New App Template Name" + + Or run: + + $ gcloud alpha design-center spaces application-templates update \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applicationTemplates/my-app-template \ + --display-name="My New App Template Name" + + To clear the application parameters for the application template + my-app-template in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces application-templates update \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 --clear-application-parameters + + To add an application parameter key-value pair of project_id:new-project to + the application template my-app-template in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates update \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 \ + --add-application-parameters=key=project_id,value=new-project + + To remove an application parameter key-value pair of project_id:new-project + from the application template my-app-template in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces application-templates update \ + my-app-template --space=my-space --project=my-project \ + --location=us-central1 \ + --remove-application-parameters=key=project_id,value=my-project + +POSITIONAL ARGUMENTS + ApplicationTemplate resource - Identifier. Application template name. The + arguments in this group can be used to specify the attributes of this + 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 application_template on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION_TEMPLATE + ID of the applicationTemplate or fully qualified identifier for the + applicationTemplate. + + To set the application_template attribute: + ▸ provide the argument application_template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the applicationTemplate resource. + + To set the location attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the applicationTemplate resource. + + To set the space attribute: + ▸ provide the argument application_template on the command line + with a fully specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --description=DESCRIPTION + Application template description. + + --display-name=DISPLAY_NAME + Application template display name. + + Update application_parameters. + + At most one of these can be specified: + + --application-parameters=[key=KEY],[value=VALUE] + Set application_parameters to new value. Parameters to apply to all + components in an application. You can specify projectID and region. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --application-parameters=key=string,value={...} --application-parameters=key=string,value={...} + + JSON Example: + + --application-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --application-parameters=path_to_file.(yaml|json) + + --add-application-parameters=[key=KEY],[value=VALUE] + Add new value to application_parameters list. Parameters to apply to + all components in an application. You can specify projectID and + region. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --add-application-parameters=key=string,value={...} --add-application-parameters=key=string,value={...} + + JSON Example: + + --add-application-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --add-application-parameters=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-application-parameters + Clear application_parameters value and set to empty list. + + --remove-application-parameters=[key=KEY],[value=VALUE] + Remove existing value from application_parameters list. Parameters + to apply to all components in an application. You can specify + projectID and region. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --remove-application-parameters=key=string,value={...} --remove-application-parameters=key=string,value={...} + + JSON Example: + + --remove-application-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --remove-application-parameters=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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/create b/gcloud/alpha/design-center/spaces/applications/create new file mode 100644 index 000000000..96c07ad70 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/create @@ -0,0 +1,383 @@ +NAME + gcloud alpha design-center spaces applications create - create an + application + +SYNOPSIS + gcloud alpha design-center spaces applications create + (APPLICATION : --location=LOCATION --space=SPACE) + (--source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION | --source-shared-template-revision-uri=SOURCE_SHARED_TEMPLATE_REVISION_URI) + [--app-parameters=[key=KEY],[value=VALUE]] + [--component-parameters=[component=COMPONENT],[parameters=PARAMETERS]] + [--connection-configs=[connectionUri=CONNECTIONURI], + [destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS], + [sourceComponentParameters=SOURCECOMPONENTPARAMETERS]] + [--deployment-project=DEPLOYMENT_PROJECT] + [--deployment-region=DEPLOYMENT_REGION] [--description=DESCRIPTION] + [--display-name=DISPLAY_NAME] [--import-existing-resources] + [--scope-type=SCOPE_TYPE] [--service-account=SERVICE_ACCOUNT] + [--attributes-business-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --attributes-developer-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --attributes-operator-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + [--criticality-type=CRITICALITY_TYPE + : --criticality-level=CRITICALITY_LEVEL + --criticality-mission-critical] [--environment-type=ENVIRONMENT_TYPE + : --environment=ENVIRONMENT]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an application in a space. + +EXAMPLES + To create the application my-application with a display name of My + Application, description of My application description and source + application template revision + projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/rev1 + in space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications create \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --display-name="My Application" \ + --description="My application description" \ + --source-application-template-revision=projects/my-project/\ + locations/us-central1/spaces/my-space/applicationTemplates/\ + my-app-template/revisions/rev1 + + To create the application my-application with a deployment project + my-deployment-project, deployment region us-east1, scope type regional and + source application template revision + projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/rev1 + in space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications create \ + my-application --space=my-space --project=my-project \ + --location=us-central1 \ + --deployment-project=my-deployment-project \ + --deployment-region=us-east1 --scope-type=regional \ + --source-application-template-revision=projects/my-project/\ + locations/us-central1/spaces/my-space/applicationTemplates/\ + my-app-template/revisions/rev1 + +POSITIONAL ARGUMENTS + Application resource - Identifier. The name of the application. Format: + projects/{project}/locations/{location}/spaces/{space}/applications/{application} + The arguments in this group can be used to specify the attributes of this + 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the application resource. + + To set the space attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +REQUIRED FLAGS + Source template information for the deployment. + + This must be specified. + + Arguments for the source. + + At most one of these can be specified: + + --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION + Application template revision URI. + + --source-shared-template-revision-uri=SOURCE_SHARED_TEMPLATE_REVISION_URI + Shared template revision URI. + +OPTIONAL FLAGS + --app-parameters=[key=KEY],[value=VALUE] + A list of parameters to attach to the deployment source object, which + is a catalog entry or application template snapshot. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --app-parameters=key=string,value={...} --app-parameters=key=string,value={...} + + JSON Example: + + --app-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --app-parameters=path_to_file.(yaml|json) + + --component-parameters=[component=COMPONENT],[parameters=PARAMETERS] + A list of component parameters to associate with the application. + + component + The name of the component parameter. + + parameters + A list of parameters associated with the component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --component-parameters=component=string,parameters=[{key=string,value={...}}] --component-parameters=component=string,parameters=[{key=string,value={...}}] + + JSON Example: + + --component-parameters='[{"component": "string", "parameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --component-parameters=path_to_file.(yaml|json) + + --connection-configs=[connectionUri=CONNECTIONURI],[destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS],[sourceComponentParameters=SOURCECOMPONENTPARAMETERS] + Connection configuration for the application. + + connectionUri + The connection URI. + + destinationComponentParameters + The parameters of the connection associated with the destination + component. + + key + The key of the parameter. + + value + The value of the parameter. + + sourceComponentParameters + The parameters of the connection associated with the source + component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] --connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] + + JSON Example: + + --connection-configs='[{"connectionUri": "string", "destinationComponentParameters": [{"key": "string", "value": {...}}], "sourceComponentParameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --connection-configs=path_to_file.(yaml|json) + + --deployment-project=DEPLOYMENT_PROJECT + Deployment project of the application. + + --deployment-region=DEPLOYMENT_REGION + The region where the application is deployed. + + --description=DESCRIPTION + Description of the application. + + --display-name=DISPLAY_NAME + Display name of the application. + + --import-existing-resources + Import existing resources into the application. + + Scope of an application. + + --scope-type=SCOPE_TYPE + Scope Type. SCOPE_TYPE must be one of: + + global + Global type. + regional + Regional type. + + --service-account=SERVICE_ACCOUNT + Your own service account that you use to deploy an application. + + Consumer provided attributes. + + --attributes-business-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Business team that ensures user needs are met and value is delivered. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --attributes-business-owners=channel={uri=string},displayName=string,email=string --attributes-business-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --attributes-business-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --attributes-business-owners=path_to_file.(yaml|json) + + --attributes-developer-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Developer team that owns development and coding. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --attributes-developer-owners=channel={uri=string},displayName=string,email=string --attributes-developer-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --attributes-developer-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --attributes-developer-owners=path_to_file.(yaml|json) + + --attributes-operator-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Operator team that ensures runtime and operations. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --attributes-operator-owners=channel={uri=string},displayName=string,email=string --attributes-operator-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --attributes-operator-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --attributes-operator-owners=path_to_file.(yaml|json) + + Criticality of the Application, Service, or Workload + + --criticality-type=CRITICALITY_TYPE + Criticality Type. CRITICALITY_TYPE must be one of: + + high + High impact. + low + Low impact. + medium + Medium impact. + mission-critical + Mission critical service, application or workload. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --criticality-level=CRITICALITY_LEVEL + Criticality level. Can contain only lowercase letters, numeric + characters, underscores, and dashes. Can have a maximum length of + 63 characters. Deprecated: Please refer to type instead. + + --criticality-mission-critical + Indicates mission-critical Application, Service, or Workload. + Deprecated: Please refer to type instead. + + Environment of the Application, Service, or Workload + + --environment-type=ENVIRONMENT_TYPE + Environment Type. ENVIRONMENT_TYPE must be one of: + + development + Development environment. + production + Production environment. + staging + Staging environment. + test + Test environment. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --environment=ENVIRONMENT + Environment name. Can contain only lowercase letters, numeric + characters, underscores, and dashes. Can have a maximum length of + 63 characters. Deprecated: Please refer to type instead. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/delete b/gcloud/alpha/design-center/spaces/applications/delete new file mode 100644 index 000000000..60d8281c4 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/delete @@ -0,0 +1,103 @@ +NAME + gcloud alpha design-center spaces applications delete - delete an + application + +SYNOPSIS + gcloud alpha design-center spaces applications delete + (APPLICATION : --location=LOCATION --space=SPACE) [--async] [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete an application in a space. + +EXAMPLES + To delete the application my-application in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications delete \ + my-application --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces applications delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applications/my-application + + If your application contains child resources, force delete the application. + To force delete the application my-application in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications delete \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --force + +POSITIONAL ARGUMENTS + Application resource - The application name. Format: + projects/$project/locations/$location/spaces/$space/applications/$application + The arguments in this group can be used to specify the attributes of this + 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the application resource. + + To set the space attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set to true, the application's children are also deleted. If false, + the application is only deleted if it has no children. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/deploy b/gcloud/alpha/design-center/spaces/applications/deploy new file mode 100644 index 000000000..68f6c9862 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/deploy @@ -0,0 +1,144 @@ +NAME + gcloud alpha design-center spaces applications deploy - deploy an + application + +SYNOPSIS + gcloud alpha design-center spaces applications deploy + (APPLICATION : --location=LOCATION --space=SPACE) [--async] [--replace] + [--service-account=SERVICE_ACCOUNT] [--worker-pool=WORKER_POOL] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Deploy an application in a space. + +EXAMPLES + To deploy the application my-application in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications deploy \ + my-application --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces applications deploy \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applications/my-application + + To deploy the application my-application in space my-space, project + my-project and location us-central1 and replace the existing deployment, + run: + + $ gcloud alpha design-center spaces applications deploy \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --replace + + To deploy the application my-application in space my-space, project + my-project and location us-central1 using a worker pool + projects/my-project/locations/us-central1/workerPools/my-worker-pool, run: + + $ gcloud alpha design-center spaces applications deploy \ + my-application --space=my-space --project=my-project \ + --location=us-central1 \ + --worker-pool=projects/my-project/locations/us-central1/\ + workerPools/my-worker-pool + + To deploy the application my-application in space my-space, project + my-project and location us-central1 asynchronously, run: + + $ gcloud alpha design-center spaces applications deploy \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --async + +POSITIONAL ARGUMENTS + Application resource - The application name. Format: + projects/$project/locations/$location/spaces/$space/applications/$application + The arguments in this group can be used to specify the attributes of this + 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the application resource. + + To set the space attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --replace + Flag to update the existing deployment. If not set or false, deploy + will fail if application state is in the DEPLOYED state. + + --service-account=SERVICE_ACCOUNT + The email address of the service account to use for this deployment. + + ◆ If provided, this service account will be used to execute the + deployment process, taking precedence over any service_account + specified on the Application resource. + ◆ The caller must have the 'iam.serviceAccounts.actAs' permission on + this service account. + ◆ If this field is omitted, the system will use the 'service_account' + defined within the Application resource. + ◆ We recommend that you provide a service account here or on the + Application resource. If you don't provide a service account, the + deployment will fail. Format: + projects/{PROJECT}/serviceAccounts/{EMAIL_ADDRESS} + + --worker-pool=WORKER_POOL + The user-specified Worker Pool resource in which the Cloud Build job + will execute, in the following format: + projects/{project}/locations/{location}/workerPools/{workerPoolId} If + this field is unspecified, the default Cloud Build worker pool will be + used. If omitted and application resource ref provided has worker_pool + defined, that worker pool is used. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/describe b/gcloud/alpha/design-center/spaces/applications/describe new file mode 100644 index 000000000..1075f3cc9 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/describe @@ -0,0 +1,86 @@ +NAME + gcloud alpha design-center spaces applications describe - describe an + application + +SYNOPSIS + gcloud alpha design-center spaces applications describe + (APPLICATION : --location=LOCATION --space=SPACE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe an application in a space. + +EXAMPLES + To describe the application my-application in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications describe \ + my-application --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces applications describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applications/my-application + +POSITIONAL ARGUMENTS + Application resource - The application name. Format: + projects/$project/locations/$location/spaces/$space/applications/$application + The arguments in this group can be used to specify the attributes of this + 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the application resource. + + To set the space attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/generate b/gcloud/alpha/design-center/spaces/applications/generate new file mode 100644 index 000000000..dab2852a4 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/generate @@ -0,0 +1,184 @@ +NAME + gcloud alpha design-center spaces applications generate - generate IaC for + an application + +SYNOPSIS + gcloud alpha design-center spaces applications generate + (APPLICATION : --space=SPACE) [--gcs-uri=GCS_URI] + [--iac-format=IAC_FORMAT] [--location=LOCATION] + [--artifact-location-gcs-uri=ARTIFACT_LOCATION_GCS_URI + | [--developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR (--developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI : --connection=CONNECTION) : --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Generates Terraform files for an application in a space. + +EXAMPLES + To generate IaC for the application my-application in space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications generate \ + my-application --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces applications generate \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applications/my-application + + To generate IaC for the application my-application in space my-space, + project my-project and location us-central1 and save to Cloud Storage + bucket my-bucket, run: + + $ gcloud alpha design-center spaces applications generate \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --gcs-uri=gs://my-bucket + + To generate IaC for the application my-application in Terraform format in + space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications generate \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --iac-format=terraform + +POSITIONAL ARGUMENTS + Application resource - The name of the application. The arguments in this + group can be used to specify the attributes of this 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 application 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 application on the command line with a fully + specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --space=SPACE + The space id of the application resource. + + To set the space attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --gcs-uri=GCS_URI + The Cloud Storage URI to write the generated IaC to. + + DEPRECATED: Use the 'artifact_location' field instead. + + --iac-format=IAC_FORMAT + The IaC format to generate. IAC_FORMAT must be one of: + + helm + IaC format is HELM. + terraform + IaC format is Terraform. + + --location=LOCATION + For resources [application, developer-connect-export-config-repo-uri], + provides fallback value for resource location attribute. When the + resource's full URI path is not provided, location will fallback to + this flag value. + + Arguments for the location. + + At most one of these can be specified: + + --artifact-location-gcs-uri=ARTIFACT_LOCATION_GCS_URI + The Cloud Storage URI for storing the generated IaC. + + Through Developer Connect, defines a location where content such as + Infrastructure as Code (IaC) is stored. + + --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR + Directory, relative to the source repo, where content such as + Infrastructure as Code (IaC) will be stored. This must be a + relative path.To specify the root directory, use '/'. If the path + or any subdirectories do not exist, they will be created. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH + The branch in repo to which the content such as Infrastructure as + Code (IaC) should be written to. If empty, ADC will create a branch + and push the changes. + + GitRepositoryLink resource - The Developer Connect Git repository + link, formatted as + projects/*/locations/*/connections/*/gitRepositoryLinks/*. The + arguments in this group can be used to specify the attributes of this + 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 --developer-connect-export-config-repo-uri + 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 --developer-connect-export-config-repo-uri + on the command line with a fully specified name; + ▫ provide the argument --location on the command line. + + This must be specified. + + --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git-repository-link attribute: + ◇ provide the argument + --developer-connect-export-config-repo-uri on the command line. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --connection=CONNECTION + The connection id of the gitRepositoryLink resource. + + To set the connection attribute: + ◇ provide the argument + --developer-connect-export-config-repo-uri on the command line + with a fully specified name; + ◇ provide the argument --connection 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/help b/gcloud/alpha/design-center/spaces/applications/help new file mode 100644 index 000000000..1e9bb6331 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/help @@ -0,0 +1,49 @@ +NAME + gcloud alpha design-center spaces applications - manage application + resources + +SYNOPSIS + gcloud alpha design-center spaces applications COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage application resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create an application. + + delete + (ALPHA) Delete an application. + + deploy + (ALPHA) Deploy an application. + + describe + (ALPHA) Describe an application. + + generate + (ALPHA) Generate IaC for an application. + + list + (ALPHA) List applications. + + preview + (ALPHA) Preview an application. + + update + (ALPHA) Update an application. + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/list b/gcloud/alpha/design-center/spaces/applications/list new file mode 100644 index 000000000..2eee7a604 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/list @@ -0,0 +1,129 @@ +NAME + gcloud alpha design-center spaces applications list - list applications + +SYNOPSIS + gcloud alpha design-center spaces applications list + (--space=SPACE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List applications in a space. + +EXAMPLES + To list all applications in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces applications list \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces applications list \ + --space=projects/my-project/locations/us-central1/spaces/\ + my-space + + To filter and list applications that contain a my-application prefix in the + display name in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces applications list \ + --space=my-space --project=my-project --location=us-central1 \ + --filter="displayName:my-application*" + + To list up to 10 applications in space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces applications list \ + --space=my-space --project=my-project --location=us-central1 \ + --limit=10 + + To list applications sorted by display name in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications list \ + --space=my-space --project=my-project --location=us-central1 \ + --sort-by=displayName + +REQUIRED FLAGS + Space resource - The parent resource from which to request a list of + applications. The arguments in this group can be used to specify the + attributes of this 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 --space on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --space=SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument --space on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ▸ provide the argument --space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/preview b/gcloud/alpha/design-center/spaces/applications/preview new file mode 100644 index 000000000..b4ff4967e --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/preview @@ -0,0 +1,133 @@ +NAME + gcloud alpha design-center spaces applications preview - preview an + application + +SYNOPSIS + gcloud alpha design-center spaces applications preview + (APPLICATION : --location=LOCATION --space=SPACE) [--async] + [--service-account=SERVICE_ACCOUNT] [--worker-pool=WORKER_POOL] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Preview an application in a space. + +EXAMPLES + To preview the application my-application in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces applications preview \ + my-application --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces applications preview \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applications/my-application + + To preview the application my-application in space my-space, project + my-project and location us-central1 using a worker pool + projects/my-project/locations/us-central1/workerPools/my-worker-pool, run: + + $ gcloud alpha design-center spaces applications preview \ + my-application --space=my-space --project=my-project \ + --location=us-central1 \ + --worker-pool=projects/my-project/locations/us-central1/\ + workerPools/my-worker-pool + + To preview the application my-application in space my-space, project + my-project and location us-central1 asynchronously, run: + + $ gcloud alpha design-center spaces applications preview \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --async + +POSITIONAL ARGUMENTS + Application resource - The application name in the following format: + projects/$project/locations/$location/spaces/$space/applications/$application + The arguments in this group can be used to specify the attributes of this + 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the application resource. + + To set the space attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --service-account=SERVICE_ACCOUNT + The email address of the service account to use for this preview + operation. + + ◆ If provided, this service account will be used to execute the + preview process, taking precedence over any service_account specified + on the Application resource. + ◆ The caller must have the 'iam.serviceAccounts.actAs' permission on + this service account. + ◆ If this field is omitted, the system will use the 'service_account' + defined within the Application resource. + ◆ We recommend that you provide a service account here or on the + Application resource. If you don't provide a service account, the + preview will fail. Format: + projects/{PROJECT}/serviceAccounts/{EMAIL_ADDRESS} + + --worker-pool=WORKER_POOL + The user-specified Worker Pool resource in which the Cloud Build job + will execute. Format + projects/{project}/locations/{location}/workerPools/{workerPoolId} If + this field is unspecified, the default Cloud Build worker pool will be + used. If omitted and application resource ref provided has worker_pool + defined, that worker pool is used. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/applications/update b/gcloud/alpha/design-center/spaces/applications/update new file mode 100644 index 000000000..3fec02e22 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/applications/update @@ -0,0 +1,858 @@ +NAME + gcloud alpha design-center spaces applications update - update an + application + +SYNOPSIS + gcloud alpha design-center spaces applications update + (APPLICATION : --location=LOCATION --space=SPACE) + [--deployment-project=DEPLOYMENT_PROJECT] + [--deployment-region=DEPLOYMENT_REGION] [--description=DESCRIPTION] + [--display-name=DISPLAY_NAME] [--[no-]import-existing-resources] + [--service-account=SERVICE_ACCOUNT] + [--app-parameters=[key=KEY],[value=VALUE] + | --add-app-parameters=[key=KEY],[value=VALUE] --clear-app-parameters + | --remove-app-parameters=[key=KEY],[value=VALUE]] + [--clear-attributes + --attributes-business-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + | --add-attributes-business-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --clear-attributes-business-owners + | --remove-attributes-business-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --attributes-developer-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + | --add-attributes-developer-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --clear-attributes-developer-owners + | --remove-attributes-developer-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --attributes-operator-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + | --add-attributes-operator-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --clear-attributes-operator-owners + | --remove-attributes-operator-owners=[channel=CHANNEL], + [displayName=DISPLAYNAME],[email=EMAIL] + --criticality-level=CRITICALITY_LEVEL + --[no-]criticality-mission-critical + --criticality-type=CRITICALITY_TYPE + --environment=ENVIRONMENT --environment-type=ENVIRONMENT_TYPE] + [--clear-scope --scope-type=SCOPE_TYPE] + [--clear-source + --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION | --source-shared-template-revision-uri=SOURCE_SHARED_TEMPLATE_REVISION_URI] + [--component-parameters=[component=COMPONENT],[parameters=PARAMETERS] + | --add-component-parameters=[component=COMPONENT], + [parameters=PARAMETERS] --clear-component-parameters + | --remove-component-parameters=[component=COMPONENT], + [parameters=PARAMETERS]] + [--connection-configs=[connectionUri=CONNECTIONURI], + [destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS], + [sourceComponentParameters=SOURCECOMPONENTPARAMETERS] + | --add-connection-configs=[connectionUri=CONNECTIONURI], + [destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS], + [sourceComponentParameters=SOURCECOMPONENTPARAMETERS] + --clear-connection-configs + | --remove-connection-configs=[connectionUri=CONNECTIONURI], + [destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS], + [sourceComponentParameters=SOURCECOMPONENTPARAMETERS]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update an application in a space. + +EXAMPLES + To update the display name to My New Application Name for the application + my-application in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces applications update \ + my-application --space=my-space --project=my-project \ + --location=us-central1 --display-name="My New Application Name" + + Or run: + + $ gcloud alpha design-center spaces applications update \ + projects/my-project/locations/us-central1/spaces/my-space/\ + applications/my-application --display-name="My New Application Name" + + To update the source application template revision to + projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/revisions/rev2 + for the application my-application in space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces applications update \ + my-application --space=my-space --project=my-project \ + --location=us-central1 \ + --source-application-template-revision=projects/my-project/\ + locations/us-central1/spaces/my-space/applicationTemplates/\ + my-app-template/revisions/rev2 + + To update the component parameters with new key-value pairs of + project_id:new-project and service_name:new-service for the component + projects/my-project/locations/us-central1/spaces/my-space/applicationTemplates/my-app-template/components/my-component + in application my-application, space my-space, project my-project and + location us-central1, run the following shorthand example: + + $ gcloud alpha design-center spaces applications update \ + my-application --space=my-space --project=my-project \ + --location=us-central1 \ + --component-parameters=component=projects/my-project/locations/\ + us-central1/spaces/my-space/applicationTemplates/my-app-template/\ + components/my-component,parameters='[{"key": "project_id", "value": + "new-project"}, {"key": "service_name", "value": "new-service"}]' + + Or run the following JSON example: + + $ gcloud alpha design-center spaces applications update \ + my-application --space=my-space --project=my-project \ + --location=us-central1 \ + --component-parameters='[{"component": + "projects/my-project/locations/us-central1/spaces/my-space/applicat\ + ionTemplates/my-app-template/components/my-component", + "parameters": [{"key": "project_id", "value": "new-project"}, + {"key": "service_name", "value": "new-service"}]}]' + + Or create a YAML or JSON file with the parameters and run the following + file example: + + $ gcloud alpha design-center spaces applications update \ + my-application --space=my-space --project=my-project \ + --location=us-central1 \ + --component-parameters=component-parameters.json + +POSITIONAL ARGUMENTS + Application resource - Identifier. The name of the application. Format: + projects/{project}/locations/{location}/spaces/{space}/applications/{application} + The arguments in this group can be used to specify the attributes of this + 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the application resource. + + To set the space attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --deployment-project=DEPLOYMENT_PROJECT + Deployment project of the application. + + --deployment-region=DEPLOYMENT_REGION + The region where the application is deployed. + + --description=DESCRIPTION + Description of the application. + + --display-name=DISPLAY_NAME + Display name of the application. + + --[no-]import-existing-resources + Import existing resources into the application. Use + --import-existing-resources to enable and + --no-import-existing-resources to disable. + + --service-account=SERVICE_ACCOUNT + Your own service account that you use to deploy an application. + + Update app_parameters. + + At most one of these can be specified: + + --app-parameters=[key=KEY],[value=VALUE] + Set app_parameters to new value. A list of parameters to attach to + the deployment source object, which is a catalog entry or application + template snapshot. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --app-parameters=key=string,value={...} --app-parameters=key=string,value={...} + + JSON Example: + + --app-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --app-parameters=path_to_file.(yaml|json) + + --add-app-parameters=[key=KEY],[value=VALUE] + Add new value to app_parameters list. A list of parameters to attach + to the deployment source object, which is a catalog entry or + application template snapshot. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --add-app-parameters=key=string,value={...} --add-app-parameters=key=string,value={...} + + JSON Example: + + --add-app-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --add-app-parameters=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-app-parameters + Clear app_parameters value and set to empty list. + + --remove-app-parameters=[key=KEY],[value=VALUE] + Remove existing value from app_parameters list. A list of + parameters to attach to the deployment source object, which is a + catalog entry or application template snapshot. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --remove-app-parameters=key=string,value={...} --remove-app-parameters=key=string,value={...} + + JSON Example: + + --remove-app-parameters='[{"key": "string", "value": {...}}]' + + File Example: + + --remove-app-parameters=path_to_file.(yaml|json) + + Consumer provided attributes. + + --clear-attributes + Set application.attributes back to default value. + + Update attributes_business_owners. + + At most one of these can be specified: + + --attributes-business-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Set attributes_business_owners to new value. Business team that + ensures user needs are met and value is delivered. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --attributes-business-owners=channel={uri=string},displayName=string,email=string --attributes-business-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --attributes-business-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --attributes-business-owners=path_to_file.(yaml|json) + + --add-attributes-business-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Add new value to attributes_business_owners list. Business team + that ensures user needs are met and value is delivered. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --add-attributes-business-owners=channel={uri=string},displayName=string,email=string --add-attributes-business-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --add-attributes-business-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --add-attributes-business-owners=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-attributes-business-owners + Clear attributes_business_owners value and set to empty list. + + --remove-attributes-business-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Remove existing value from attributes_business_owners list. + Business team that ensures user needs are met and value is + delivered. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --remove-attributes-business-owners=channel={uri=string},displayName=string,email=string --remove-attributes-business-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --remove-attributes-business-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --remove-attributes-business-owners=path_to_file.(yaml|json) + + Update attributes_developer_owners. + + At most one of these can be specified: + + --attributes-developer-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Set attributes_developer_owners to new value. Developer team that + owns development and coding. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --attributes-developer-owners=channel={uri=string},displayName=string,email=string --attributes-developer-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --attributes-developer-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --attributes-developer-owners=path_to_file.(yaml|json) + + --add-attributes-developer-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Add new value to attributes_developer_owners list. Developer team + that owns development and coding. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --add-attributes-developer-owners=channel={uri=string},displayName=string,email=string --add-attributes-developer-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --add-attributes-developer-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --add-attributes-developer-owners=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-attributes-developer-owners + Clear attributes_developer_owners value and set to empty list. + + --remove-attributes-developer-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Remove existing value from attributes_developer_owners list. + Developer team that owns development and coding. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --remove-attributes-developer-owners=channel={uri=string},displayName=string,email=string --remove-attributes-developer-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --remove-attributes-developer-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --remove-attributes-developer-owners=path_to_file.(yaml|json) + + Update attributes_operator_owners. + + At most one of these can be specified: + + --attributes-operator-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Set attributes_operator_owners to new value. Operator team that + ensures runtime and operations. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --attributes-operator-owners=channel={uri=string},displayName=string,email=string --attributes-operator-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --attributes-operator-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --attributes-operator-owners=path_to_file.(yaml|json) + + --add-attributes-operator-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Add new value to attributes_operator_owners list. Operator team + that ensures runtime and operations. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --add-attributes-operator-owners=channel={uri=string},displayName=string,email=string --add-attributes-operator-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --add-attributes-operator-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --add-attributes-operator-owners=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-attributes-operator-owners + Clear attributes_operator_owners value and set to empty list. + + --remove-attributes-operator-owners=[channel=CHANNEL],[displayName=DISPLAYNAME],[email=EMAIL] + Remove existing value from attributes_operator_owners list. + Operator team that ensures runtime and operations. + + channel + Communication channel of the contacts. + + uri + URI of the channel. + + displayName + Contact's name. Can have a maximum length of 63 characters. + + email + Email address of the contacts. + + Shorthand Example: + + --remove-attributes-operator-owners=channel={uri=string},displayName=string,email=string --remove-attributes-operator-owners=channel={uri=string},displayName=string,email=string + + JSON Example: + + --remove-attributes-operator-owners='[{"channel": {"uri": "string"}, "displayName": "string", "email": "string"}]' + + File Example: + + --remove-attributes-operator-owners=path_to_file.(yaml|json) + + Criticality of the Application, Service, or Workload + + --criticality-level=CRITICALITY_LEVEL + Criticality level. Can contain only lowercase letters, numeric + characters, underscores, and dashes. Can have a maximum length of + 63 characters. Deprecated: Please refer to type instead. + + --[no-]criticality-mission-critical + Indicates mission-critical Application, Service, or Workload. + Deprecated: Please refer to type instead. Use + --criticality-mission-critical to enable and + --no-criticality-mission-critical to disable. + + --criticality-type=CRITICALITY_TYPE + Criticality Type. CRITICALITY_TYPE must be one of: + + high + High impact. + low + Low impact. + medium + Medium impact. + mission-critical + Mission critical service, application or workload. + + Environment of the Application, Service, or Workload + + --environment=ENVIRONMENT + Environment name. Can contain only lowercase letters, numeric + characters, underscores, and dashes. Can have a maximum length of + 63 characters. Deprecated: Please refer to type instead. + + --environment-type=ENVIRONMENT_TYPE + Environment Type. ENVIRONMENT_TYPE must be one of: + + development + Development environment. + production + Production environment. + staging + Staging environment. + test + Test environment. + + Scope of an application. + + --clear-scope + Set application.scope back to default value. + + --scope-type=SCOPE_TYPE + Scope Type. SCOPE_TYPE must be one of: + + global + Global type. + regional + Regional type. + + Source template information for the deployment. + + --clear-source + Set application.source back to default value. + + Arguments for the source. + + At most one of these can be specified: + + --source-application-template-revision=SOURCE_APPLICATION_TEMPLATE_REVISION + Application template revision URI. + + --source-shared-template-revision-uri=SOURCE_SHARED_TEMPLATE_REVISION_URI + Shared template revision URI. + + Update component_parameters. + + At most one of these can be specified: + + --component-parameters=[component=COMPONENT],[parameters=PARAMETERS] + Set component_parameters to new value. A list of component parameters + to associate with the application. + + component + The name of the component parameter. + + parameters + A list of parameters associated with the component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --component-parameters=component=string,parameters=[{key=string,value={...}}] --component-parameters=component=string,parameters=[{key=string,value={...}}] + + JSON Example: + + --component-parameters='[{"component": "string", "parameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --component-parameters=path_to_file.(yaml|json) + + --add-component-parameters=[component=COMPONENT],[parameters=PARAMETERS] + Add new value to component_parameters list. A list of component + parameters to associate with the application. + + component + The name of the component parameter. + + parameters + A list of parameters associated with the component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --add-component-parameters=component=string,parameters=[{key=string,value={...}}] --add-component-parameters=component=string,parameters=[{key=string,value={...}}] + + JSON Example: + + --add-component-parameters='[{"component": "string", "parameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --add-component-parameters=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-component-parameters + Clear component_parameters value and set to empty list. + + --remove-component-parameters=[component=COMPONENT],[parameters=PARAMETERS] + Remove existing value from component_parameters list. A list of + component parameters to associate with the application. + + component + The name of the component parameter. + + parameters + A list of parameters associated with the component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --remove-component-parameters=component=string,parameters=[{key=string,value={...}}] --remove-component-parameters=component=string,parameters=[{key=string,value={...}}] + + JSON Example: + + --remove-component-parameters='[{"component": "string", "parameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --remove-component-parameters=path_to_file.(yaml|json) + + Update connection_configs. + + At most one of these can be specified: + + --connection-configs=[connectionUri=CONNECTIONURI],[destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS],[sourceComponentParameters=SOURCECOMPONENTPARAMETERS] + Set connection_configs to new value. Connection configuration for the + application. + + connectionUri + The connection URI. + + destinationComponentParameters + The parameters of the connection associated with the destination + component. + + key + The key of the parameter. + + value + The value of the parameter. + + sourceComponentParameters + The parameters of the connection associated with the source + component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] --connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] + + JSON Example: + + --connection-configs='[{"connectionUri": "string", "destinationComponentParameters": [{"key": "string", "value": {...}}], "sourceComponentParameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --connection-configs=path_to_file.(yaml|json) + + --add-connection-configs=[connectionUri=CONNECTIONURI],[destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS],[sourceComponentParameters=SOURCECOMPONENTPARAMETERS] + Add new value to connection_configs list. Connection configuration + for the application. + + connectionUri + The connection URI. + + destinationComponentParameters + The parameters of the connection associated with the destination + component. + + key + The key of the parameter. + + value + The value of the parameter. + + sourceComponentParameters + The parameters of the connection associated with the source + component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --add-connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] --add-connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] + + JSON Example: + + --add-connection-configs='[{"connectionUri": "string", "destinationComponentParameters": [{"key": "string", "value": {...}}], "sourceComponentParameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --add-connection-configs=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-connection-configs + Clear connection_configs value and set to empty list. + + --remove-connection-configs=[connectionUri=CONNECTIONURI],[destinationComponentParameters=DESTINATIONCOMPONENTPARAMETERS],[sourceComponentParameters=SOURCECOMPONENTPARAMETERS] + Remove existing value from connection_configs list. Connection + configuration for the application. + + connectionUri + The connection URI. + + destinationComponentParameters + The parameters of the connection associated with the + destination component. + + key + The key of the parameter. + + value + The value of the parameter. + + sourceComponentParameters + The parameters of the connection associated with the source + component. + + key + The key of the parameter. + + value + The value of the parameter. + + Shorthand Example: + + --remove-connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] --remove-connection-configs=connectionUri=string,destinationComponentParameters=[{key=string,value={...}}],sourceComponentParameters=[{key=string,value={...}}] + + JSON Example: + + --remove-connection-configs='[{"connectionUri": "string", "destinationComponentParameters": [{"key": "string", "value": {...}}], "sourceComponentParameters": [{"key": "string", "value": {...}}]}]' + + File Example: + + --remove-connection-configs=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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/create b/gcloud/alpha/design-center/spaces/catalogs/create new file mode 100644 index 000000000..715c3827e --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/create @@ -0,0 +1,100 @@ +NAME + gcloud alpha design-center spaces catalogs create - create a catalog + +SYNOPSIS + gcloud alpha design-center spaces catalogs create + (CATALOG : --location=LOCATION --space=SPACE) + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a catalog in a space. + +EXAMPLES + To create the catalog my-catalog in space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces catalogs create my-catalog \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs create \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog + + To create the catalog my-catalog with a display name of My Catalog and + description of My catalog description in space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs create my-catalog \ + --space=my-space --project=my-project --location=us-central1 \ + --display-name="My Catalog" \ + --description="My catalog description" + +POSITIONAL ARGUMENTS + Catalog resource - Identifier. The catalog name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog The + arguments in this group can be used to specify the attributes of this + 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 catalog on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CATALOG + ID of the catalog or fully qualified identifier for the catalog. + + To set the catalog attribute: + ▸ provide the argument catalog on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the catalog resource. + + To set the location attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the catalog resource. + + To set the space attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --description=DESCRIPTION + The catalog description. + + --display-name=DISPLAY_NAME + The catalog display name. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/delete b/gcloud/alpha/design-center/spaces/catalogs/delete new file mode 100644 index 000000000..816442a88 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/delete @@ -0,0 +1,107 @@ +NAME + gcloud alpha design-center spaces catalogs delete - delete a catalog + +SYNOPSIS + gcloud alpha design-center spaces catalogs delete + (CATALOG : --location=LOCATION --space=SPACE) [--async] [--force] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a catalog in a space. + +EXAMPLES + To delete the catalog my-catalog in space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces catalogs delete my-catalog \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog + + If your catalog contains child resources such as catalog templates, shares, + force delete the catalog. To force delete the catalog my-catalog in space + my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs delete my-catalog \ + --space=my-space --project=my-project --location=us-central1 \ + --force + + To delete the catalog my-catalog in space my-space, project my-project and + location us-central1 asynchronously, run: + + $ gcloud alpha design-center spaces catalogs delete my-catalog \ + --space=my-space --project=my-project --location=us-central1 \ + --async + +POSITIONAL ARGUMENTS + Catalog resource - The catalog name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog The + arguments in this group can be used to specify the attributes of this + 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 catalog on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CATALOG + ID of the catalog or fully qualified identifier for the catalog. + + To set the catalog attribute: + ▸ provide the argument catalog on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the catalog resource. + + To set the location attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the catalog resource. + + To set the space attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set to true, the catalog's children are also deleted. If false, the + catalog is only deleted if it has no children. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/describe b/gcloud/alpha/design-center/spaces/catalogs/describe new file mode 100644 index 000000000..4dcee506c --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/describe @@ -0,0 +1,82 @@ +NAME + gcloud alpha design-center spaces catalogs describe - describe a catalog + +SYNOPSIS + gcloud alpha design-center spaces catalogs describe + (CATALOG : --location=LOCATION --space=SPACE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a catalog in a space. + +EXAMPLES + To describe the catalog my-catalog in space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs describe my-catalog \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog + +POSITIONAL ARGUMENTS + Catalog resource - The catalog name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog The + arguments in this group can be used to specify the attributes of this + 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 catalog on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CATALOG + ID of the catalog or fully qualified identifier for the catalog. + + To set the catalog attribute: + ▸ provide the argument catalog on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the catalog resource. + + To set the location attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the catalog resource. + + To set the space attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/help b/gcloud/alpha/design-center/spaces/catalogs/help new file mode 100644 index 000000000..2f18e2344 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/help @@ -0,0 +1,48 @@ +NAME + gcloud alpha design-center spaces catalogs - manage catalog resources + +SYNOPSIS + gcloud alpha design-center spaces catalogs GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage catalog resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + shares + (ALPHA) Manage share resources. + + templates + (ALPHA) Manage catalog template resources. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a catalog. + + delete + (ALPHA) Delete a catalog. + + describe + (ALPHA) Describe a catalog. + + list + (ALPHA) List catalogs. + + update + (ALPHA) Update a catalog. + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/list b/gcloud/alpha/design-center/spaces/catalogs/list new file mode 100644 index 000000000..9c4f28d48 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/list @@ -0,0 +1,116 @@ +NAME + gcloud alpha design-center spaces catalogs list - list catalogs + +SYNOPSIS + gcloud alpha design-center spaces catalogs list + (--space=SPACE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List catalogs in a space. + +EXAMPLES + To list all catalogs in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces catalogs list --space=my-space \ + --project=my-project --location=us-central1 + + To filter and list catalogs that contain a my-catalog prefix in the display + name in space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs list --space=my-space \ + --project=my-project --location=us-central1 \ + --filter="displayName:my-catalog*" + + To list catalogs sorted by display name in space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs list --space=my-space \ + --project=my-project --location=us-central1 \ + --sort-by=displayName + +REQUIRED FLAGS + Space resource - The parent space from which catalogs are listed. Format: + projects/$project/locations/$location/spaces/$space The arguments in this + group can be used to specify the attributes of this 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 --space on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --space=SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument --space on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ▸ provide the argument --space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/shares/create b/gcloud/alpha/design-center/spaces/catalogs/shares/create new file mode 100644 index 000000000..8ca1ae7e8 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/shares/create @@ -0,0 +1,139 @@ +NAME + gcloud alpha design-center spaces catalogs shares create - create a share + +SYNOPSIS + gcloud alpha design-center spaces catalogs shares create + (SHARE : --catalog=CATALOG --space=SPACE) + --destination-space=DESTINATION_SPACE [--async] [--location=LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a share in a catalog. + +EXAMPLES + To create a share my-share in catalog my-catalog to destination space + my-destination-space, in space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces catalogs shares create \ + my-share --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-space=my-destination-space + + Or run: + + $ gcloud alpha design-center spaces catalogs shares create \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/shares/my-share \ + --destination-space=my-destination-space + + To create the share my-share in catalog my-catalog to destination space + projects/my-descendant-project/locations/us-central1/spaces/my-destination-space + present in a descendant management project my-descendant-project, in the + space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs shares create \ + my-share --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 \ + --destination-space=projects/my-descendant-project/locations/\ + us-central1/spaces/my-destination-space + +POSITIONAL ARGUMENTS + Share resource - Identifier. The share name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/shares/$share + The arguments in this group can be used to specify the attributes of this + 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 share 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 share on the command line with a fully specified + name; + ◆ provide the argument --location on the command line. + + This must be specified. + + SHARE + ID of the share or fully qualified identifier for the share. + + To set the share attribute: + ▸ provide the argument share on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the share resource. + + To set the catalog attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --space=SPACE + The space id of the share resource. + + To set the space attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +REQUIRED FLAGS + Space resource - The space resource path to which the catalog is shared. + Format is projects/$project/locations/$location/spaces/$space 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 --destination-space 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 --destination-space on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + --destination-space=DESTINATION_SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument --destination-space on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --location=LOCATION + For resources [share, destination-space], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/shares/delete b/gcloud/alpha/design-center/spaces/catalogs/shares/delete new file mode 100644 index 000000000..305c7bcde --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/shares/delete @@ -0,0 +1,104 @@ +NAME + gcloud alpha design-center spaces catalogs shares delete - delete a share + +SYNOPSIS + gcloud alpha design-center spaces catalogs shares delete + (SHARE : --catalog=CATALOG --location=LOCATION --space=SPACE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a share in a catalog. + +EXAMPLES + To delete the share my-share in catalog my-catalog, space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs shares delete \ + my-share --catalog=my-catalog --space=my-space \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs shares delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/shares/my-share + + To delete the share my-share in catalog my-catalog, space my-space, project + my-project and location us-central1 asynchronously, run: + + $ gcloud alpha design-center spaces catalogs shares delete \ + my-share --catalog=my-catalog --space=my-space \ + --location=us-central1 --async + +POSITIONAL ARGUMENTS + Share resource - The share name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/shares/$share + The arguments in this group can be used to specify the attributes of this + 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 share on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SHARE + ID of the share or fully qualified identifier for the share. + + To set the share attribute: + ▸ provide the argument share on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the share resource. + + To set the catalog attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the share resource. + + To set the location attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the share resource. + + To set the space attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/shares/describe b/gcloud/alpha/design-center/spaces/catalogs/shares/describe new file mode 100644 index 000000000..7dfdc7d98 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/shares/describe @@ -0,0 +1,93 @@ +NAME + gcloud alpha design-center spaces catalogs shares describe - describe a + share + +SYNOPSIS + gcloud alpha design-center spaces catalogs shares describe + (SHARE : --catalog=CATALOG --location=LOCATION --space=SPACE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a share in a catalog. + +EXAMPLES + To describe the share my-share in catalog my-catalog, space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs shares describe \ + my-share --catalog=my-catalog --space=my-space \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs shares describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/shares/my-share + +POSITIONAL ARGUMENTS + Share resource - The share name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/shares/$share + The arguments in this group can be used to specify the attributes of this + 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 share on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SHARE + ID of the share or fully qualified identifier for the share. + + To set the share attribute: + ▸ provide the argument share on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the share resource. + + To set the catalog attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the share resource. + + To set the location attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the share resource. + + To set the space attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/shares/help b/gcloud/alpha/design-center/spaces/catalogs/shares/help new file mode 100644 index 000000000..0c3f51bdf --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/shares/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha design-center spaces catalogs shares - manage share resources + +SYNOPSIS + gcloud alpha design-center spaces catalogs shares COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage share resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a share. + + delete + (ALPHA) Delete a share. + + describe + (ALPHA) Describe a share. + + list + (ALPHA) List shares. + + sync + (ALPHA) Sync a share. + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/shares/list b/gcloud/alpha/design-center/spaces/catalogs/shares/list new file mode 100644 index 000000000..777fb51e1 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/shares/list @@ -0,0 +1,116 @@ +NAME + gcloud alpha design-center spaces catalogs shares list - list shares + +SYNOPSIS + gcloud alpha design-center spaces catalogs shares list + (--catalog=CATALOG : --location=LOCATION --space=SPACE) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List shares in a catalog. + +EXAMPLES + To list all shares in catalog my-catalog, space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs shares list \ + --catalog=my-catalog --space=my-space --location=us-central1 + + To list up to 10 shares in catalog my-catalog, space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs shares list \ + --catalog=my-catalog --space=my-space --location=us-central1 \ + --limit=10 + +REQUIRED FLAGS + Catalog resource - The parent resource from which a list of shares is + requested. The arguments in this group can be used to specify the + attributes of this 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 --catalog on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --catalog=CATALOG + ID of the catalog or fully qualified identifier for the catalog. + + To set the catalog attribute: + ▸ provide the argument --catalog on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the catalog resource. + + To set the location attribute: + ▸ provide the argument --catalog on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the catalog resource. + + To set the space attribute: + ▸ provide the argument --catalog on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/shares/sync b/gcloud/alpha/design-center/spaces/catalogs/shares/sync new file mode 100644 index 000000000..68d22d8e7 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/shares/sync @@ -0,0 +1,103 @@ +NAME + gcloud alpha design-center spaces catalogs shares sync - sync a share + +SYNOPSIS + gcloud alpha design-center spaces catalogs shares sync + (SHARE : --catalog=CATALOG --location=LOCATION --space=SPACE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Sync a share in a catalog. + +EXAMPLES + To sync the share my-share in catalog my-catalog, space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs shares sync my-share \ + --catalog=my-catalog --space=my-space --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs shares sync \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/shares/my-share + + To sync the share my-share in catalog my-catalog, space my-space, project + my-project and location us-central1 asynchronously, run: + + $ gcloud alpha design-center spaces catalogs shares sync \ + --catalog=my-catalog --space=my-space --location=us-central1 \ + --async + +POSITIONAL ARGUMENTS + Share resource - The share name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/shares/$share + The arguments in this group can be used to specify the attributes of this + 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 share on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SHARE + ID of the share or fully qualified identifier for the share. + + To set the share attribute: + ▸ provide the argument share on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the share resource. + + To set the catalog attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the share resource. + + To set the location attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the share resource. + + To set the space attribute: + ▸ provide the argument share on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/create b/gcloud/alpha/design-center/spaces/catalogs/templates/create new file mode 100644 index 000000000..3baf8d4a5 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/create @@ -0,0 +1,145 @@ +NAME + gcloud alpha design-center spaces catalogs templates create - create a + catalog template + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates create + (TEMPLATE : --catalog=CATALOG --location=LOCATION --space=SPACE) + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [--template-category=TEMPLATE_CATEGORY] [--type=TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a catalog template. + +EXAMPLES + To create the catalog template my-template in catalog my-catalog, space + my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates create \ + my-template --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs templates create \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/templates/my-template + + To create the catalog template my-template with a display name of My + Template and description of My template description in catalog my-catalog, + space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates create \ + my-template --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 \ + --display-name="My Template" \ + --description="My template description" + +POSITIONAL ARGUMENTS + Template resource - Identifier. The catalog template name in following + format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/templates/$template + The arguments in this group can be used to specify the attributes of this + 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 template on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TEMPLATE + ID of the template or fully qualified identifier for the template. + + To set the template attribute: + ▸ provide the argument template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the template resource. + + To set the catalog attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the template resource. + + To set the location attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the template resource. + + To set the space attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --description=DESCRIPTION + The catalog template description. + + --display-name=DISPLAY_NAME + The display name of a catalog template. + + --template-category=TEMPLATE_CATEGORY + The category of the ADC template. TEMPLATE_CATEGORY must be one of: + + application-template + ADC application. + component-template + ADC component. + composite-solution-template + Imported as a single, complex unit without disassembling into + components. + + --type=TYPE + The Application Design Center assembly template type. TYPE must be one + of: + + application + An application template is a composition of workload/service/asset + templates. + asset + An asset template can be used to provision resources that are not + services or workloads. + helm-application + A helm chart based template. + jss-solution + A Jumpstart Solution template. + service + A service template is an App Hub service. + service-data-source + A service data source template. + workload + A workload template is an App Hub workload. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/delete b/gcloud/alpha/design-center/spaces/catalogs/templates/delete new file mode 100644 index 000000000..19a02ae15 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/delete @@ -0,0 +1,118 @@ +NAME + gcloud alpha design-center spaces catalogs templates delete - delete a + catalog template + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates delete + (TEMPLATE : --catalog=CATALOG --location=LOCATION --space=SPACE) + [--async] [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a catalog template. + +EXAMPLES + To delete the catalog template my-template in catalog my-catalog, space + my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates delete \ + my-template --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs templates delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/templates/my-template + + If your catalog template contains child resources such as catalog template + revisions, force delete the catalog template. To force delete the catalog + template my-template in catalog my-catalog, space my-space, project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates delete \ + my-template --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 --force + + To delete the catalog template my-template in catalog my-catalog, space + my-space, project my-project and location us-central1 asynchronously, run: + + $ gcloud alpha design-center spaces catalogs templates delete \ + my-template --catalog=my-catalog --space=my-space \ + --location=us-central1 --async + +POSITIONAL ARGUMENTS + Template resource - The catalog template name. Format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/templates/$template + The arguments in this group can be used to specify the attributes of this + 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 template on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TEMPLATE + ID of the template or fully qualified identifier for the template. + + To set the template attribute: + ▸ provide the argument template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the template resource. + + To set the catalog attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the template resource. + + To set the location attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the template resource. + + To set the space attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set to true, the catalog template's children are also deleted. If + false, the catalog template is only deleted if it has no children. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/describe b/gcloud/alpha/design-center/spaces/catalogs/templates/describe new file mode 100644 index 000000000..8ccf967b0 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/describe @@ -0,0 +1,93 @@ +NAME + gcloud alpha design-center spaces catalogs templates describe - describe a + catalog template + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates describe + (TEMPLATE : --catalog=CATALOG --location=LOCATION --space=SPACE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a catalog template. + +EXAMPLES + To describe the catalog template my-template in catalog my-catalog, space + my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates describe \ + my-template --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs templates describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/templates/my-template + +POSITIONAL ARGUMENTS + Template resource - The catalog template name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/templates/$template + The arguments in this group can be used to specify the attributes of this + 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 template on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TEMPLATE + ID of the template or fully qualified identifier for the template. + + To set the template attribute: + ▸ provide the argument template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the template resource. + + To set the catalog attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the template resource. + + To set the location attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the template resource. + + To set the space attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/help b/gcloud/alpha/design-center/spaces/catalogs/templates/help new file mode 100644 index 000000000..948c55852 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/help @@ -0,0 +1,46 @@ +NAME + gcloud alpha design-center spaces catalogs templates - manage catalog + template resources + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage catalog template resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + revisions + (ALPHA) Manage catalog template revision resources. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a catalog template. + + delete + (ALPHA) Delete a catalog template. + + describe + (ALPHA) Describe a catalog template. + + list + (ALPHA) List catalog templates. + + update + (ALPHA) Update a catalog template. + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/list b/gcloud/alpha/design-center/spaces/catalogs/templates/list new file mode 100644 index 000000000..7b275b89e --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/list @@ -0,0 +1,128 @@ +NAME + gcloud alpha design-center spaces catalogs templates list - list catalog + templates + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates list + (--catalog=CATALOG : --location=LOCATION --space=SPACE) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List catalog templates in a given catalog. + +EXAMPLES + To list all catalog templates in catalog my-catalog, space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates list \ + --catalog=my-catalog --space=my-space --project=my-project \ + --location=us-central1 + + To filter and list catalog templates that contain a my-template prefix in + the display name in catalog my-catalog, space my-space, project my-project + and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates list \ + --catalog=my-catalog --space=my-space --project=my-project \ + --location=us-central1 --filter="displayName:my-template*" + + To list up to 10 catalog templates in catalog my-catalog, space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates list \ + --catalog=my-catalog --space=my-space --project=my-project \ + --location=us-central1 --limit=10 + +REQUIRED FLAGS + Catalog resource - The parent from which the catalog templates are listed + in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog The + arguments in this group can be used to specify the attributes of this + 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 --catalog on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --catalog=CATALOG + ID of the catalog or fully qualified identifier for the catalog. + + To set the catalog attribute: + ▸ provide the argument --catalog on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the catalog resource. + + To set the location attribute: + ▸ provide the argument --catalog on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the catalog resource. + + To set the space attribute: + ▸ provide the argument --catalog on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/create b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/create new file mode 100644 index 000000000..df54ffd84 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/create @@ -0,0 +1,154 @@ +NAME + gcloud alpha design-center spaces catalogs templates revisions create - + create a new catalog template revision + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates revisions create + (REVISION : --catalog=CATALOG + --location=LOCATION --space=SPACE --template=TEMPLATE) + --developer-connect-repo=DEVELOPER_CONNECT_REPO + --developer-connect-repo-dir=DEVELOPER_CONNECT_REPO_DIR + --developer-connect-repo-ref=DEVELOPER_CONNECT_REPO_REF [--async] + [--description=DESCRIPTION] [--metadata=METADATA] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new catalog template revision. + +EXAMPLES + To create a new catalog template revision named my-revision for the + template my-template, within the catalog my-catalog and space my-space, in + location us-central1 and project my-project, using a Developer Connect + repository as the source, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create my-revision --project=my-project --location=us-central1 \ + --space=my-space --catalog=my-catalog --template=my-template \ + --description="My test revision description" \ + --developer-connect-repo=projects/my-project/locations/\ + us-central1/connections/my-connection/gitRepositoryLinks/my-repo \ + --developer-connect-repo-ref=refs/tags/v1.0.0 \ + --developer-connect-repo-dir=modules/my-product + + Or run using the full resource name: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/templates/my-template/revisions/my-revision \ + --description="My test revision description" \ + --developer-connect-repo=projects/my-project/locations/\ + us-central1/connections/my-connection/gitRepositoryLinks/my-repo \ + --developer-connect-repo-ref=refs/tags/v1.0.0 \ + --developer-connect-repo-dir=modules/my-product + + To create a revision using a metadata file from a local path, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create my-revision --project=my-project --location=us-central1 \ + --space=my-space --catalog=my-catalog --template=my-template \ + --developer-connect-repo=projects/my-project/locations/\ + us-central1/connections/my-connection/gitRepositoryLinks/my-repo \ + --developer-connect-repo-ref=refs/tags/v1.0.0 \ + --developer-connect-repo-dir=modules/my-product \ + --metadata=/path/to/metadata.yaml + +POSITIONAL ARGUMENTS + Revision resource - The revision to create. The arguments in this group + can be used to specify the attributes of this 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 revision on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The ID of the catalog. + + To set the catalog attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The Cloud location for the revision. + + To set the location attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The ID of the space. + + To set the space attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + + --template=TEMPLATE + The ID of the template. + + To set the template attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --template on the command line. + +REQUIRED FLAGS + --developer-connect-repo=DEVELOPER_CONNECT_REPO + The Developer Connect repository to use as a source. Example: + projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo + + --developer-connect-repo-dir=DEVELOPER_CONNECT_REPO_DIR + The directory within the repository to use. Example: + "modules/my-product" + + --developer-connect-repo-ref=DEVELOPER_CONNECT_REPO_REF + The Git ref (branch or tag) within the repository to use. Example: + "refs/tags/v1.0.0" or "refs/heads/main" or + "refs/commits/269b518b99d06b31ff938a2d182e75f5e41941c7". + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description for the revision. + + --metadata=METADATA + Path to a local YAML file containing the template metadata. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/delete b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/delete new file mode 100644 index 000000000..74c1385ce --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/delete @@ -0,0 +1,116 @@ +NAME + gcloud alpha design-center spaces catalogs templates revisions delete - + delete a catalog template revision + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates revisions delete + (REVISION : --catalog=CATALOG + --location=LOCATION --space=SPACE --template=TEMPLATE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a catalog template revision. + +EXAMPLES + To delete the catalog template revision my-revision in template + my-template, catalog my-catalog, space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + delete my-revision --template=my-template --catalog=my-catalog \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + delete \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/templates/my-template/revisions/my-revision + + To delete the catalog template revision my-revision in template + my-template, catalog my-catalog, space my-space, project my-project and + location us-central1 asynchronously, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + delete my-revision --template=my-template --catalog=my-catalog \ + --space=my-space --location=us-central1 --async + +POSITIONAL ARGUMENTS + Revision resource - The template revision name. The arguments in this + group can be used to specify the attributes of this 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 revision on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the revision resource. + + To set the catalog attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the revision resource. + + To set the location attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the revision resource. + + To set the space attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + + --template=TEMPLATE + The template id of the revision resource. + + To set the template attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --template on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/describe b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/describe new file mode 100644 index 000000000..8a165fb3b --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/describe @@ -0,0 +1,104 @@ +NAME + gcloud alpha design-center spaces catalogs templates revisions describe - + describe a catalog template revision + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates revisions describe + (REVISION : --catalog=CATALOG + --location=LOCATION --space=SPACE --template=TEMPLATE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a catalog template revision. + +EXAMPLES + To describe the catalog template revision my-revision in template + my-template, catalog my-catalog, space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + describe my-revision --template=my-template \ + --catalog=my-catalog --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog/templates/my-template/revisions/my-revision + +POSITIONAL ARGUMENTS + Revision resource - The catalog template revisions name. The arguments in + this group can be used to specify the attributes of this 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 revision on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + REVISION + ID of the revision or fully qualified identifier for the revision. + + To set the revision attribute: + ▸ provide the argument revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the revision resource. + + To set the catalog attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the revision resource. + + To set the location attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the revision resource. + + To set the space attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + + --template=TEMPLATE + The template id of the revision resource. + + To set the template attribute: + ▸ provide the argument revision on the command line with a fully + specified name; + ▸ provide the argument --template 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/help b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/help new file mode 100644 index 000000000..252fdd857 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha design-center spaces catalogs templates revisions - manage + catalog template revision resources + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates revisions COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage catalog template revision resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a new catalog template revision. + + delete + (ALPHA) Delete a catalog template revision. + + describe + (ALPHA) Describe a catalog template revision. + + list + (ALPHA) List catalog template revisions. + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/list b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/list new file mode 100644 index 000000000..8ed3dd6f7 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/list @@ -0,0 +1,130 @@ +NAME + gcloud alpha design-center spaces catalogs templates revisions list - list + catalog template revisions + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates revisions list + (--template=TEMPLATE + : --catalog=CATALOG --location=LOCATION --space=SPACE) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List catalog template revisions in a given template. + +EXAMPLES + To list all catalog template revisions in template my-template, catalog + my-catalog, space my-space, project my-project and location us-central1, + run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + list --template=my-template --catalog=my-catalog \ + --space=my-space --project=my-project --location=us-central1 + + To list up to 10 catalog template revisions in template my-template, + catalog my-catalog, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + list --template=my-template --catalog=my-catalog \ + --space=my-space --project=my-project --location=us-central1 \ + --limit=10 + +REQUIRED FLAGS + Template resource - The parent resource from which a list of catalog + template revisions is requested. The arguments in this group can be used + to specify the attributes of this 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 --template on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --template=TEMPLATE + ID of the template or fully qualified identifier for the template. + + To set the template attribute: + ▸ provide the argument --template on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --catalog=CATALOG + The catalog id of the template resource. + + To set the catalog attribute: + ▸ provide the argument --template on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the template resource. + + To set the location attribute: + ▸ provide the argument --template on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the template resource. + + To set the space attribute: + ▸ provide the argument --template on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/update b/gcloud/alpha/design-center/spaces/catalogs/templates/update new file mode 100644 index 000000000..1f44df9ca --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/update @@ -0,0 +1,131 @@ +NAME + gcloud alpha design-center spaces catalogs templates update - update a + catalog template + +SYNOPSIS + gcloud alpha design-center spaces catalogs templates update + (TEMPLATE : --catalog=CATALOG --location=LOCATION --space=SPACE) + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [--template-category=TEMPLATE_CATEGORY] [--type=TYPE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a catalog template. + +EXAMPLES + To update the display name to My New Template Name for the catalog template + my-template in catalog my-catalog, space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces catalogs templates update \ + my-template --catalog=my-catalog --space=my-space \ + --project=my-project --location=us-central1 \ + --display-name="My New Template Name" + +POSITIONAL ARGUMENTS + Template resource - Identifier. The catalog template name in following + format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog/templates/$template + The arguments in this group can be used to specify the attributes of this + 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 template on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + TEMPLATE + ID of the template or fully qualified identifier for the template. + + To set the template attribute: + ▸ provide the argument template on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --catalog=CATALOG + The catalog id of the template resource. + + To set the catalog attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --catalog on the command line. + + --location=LOCATION + The location id of the template resource. + + To set the location attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the template resource. + + To set the space attribute: + ▸ provide the argument template on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --description=DESCRIPTION + The catalog template description. + + --display-name=DISPLAY_NAME + The display name of a catalog template. + + --template-category=TEMPLATE_CATEGORY + The category of the ADC template. TEMPLATE_CATEGORY must be one of: + + application-template + ADC application. + component-template + ADC component. + composite-solution-template + Imported as a single, complex unit without disassembling into + components. + + --type=TYPE + The Application Design Center assembly template type. TYPE must be one + of: + + application + An application template is a composition of workload/service/asset + templates. + asset + An asset template can be used to provision resources that are not + services or workloads. + helm-application + A helm chart based template. + jss-solution + A Jumpstart Solution template. + service + A service template is an App Hub service. + service-data-source + A service data source template. + workload + A workload template is an App Hub workload. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/catalogs/update b/gcloud/alpha/design-center/spaces/catalogs/update new file mode 100644 index 000000000..52362d13b --- /dev/null +++ b/gcloud/alpha/design-center/spaces/catalogs/update @@ -0,0 +1,100 @@ +NAME + gcloud alpha design-center spaces catalogs update - update a catalog + +SYNOPSIS + gcloud alpha design-center spaces catalogs update + (CATALOG : --location=LOCATION --space=SPACE) + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a catalog in a space. + +EXAMPLES + To update the display name to My New Catalog Name for the catalog + my-catalog in space my-space, project my-project and location us-central1, + run: + + $ gcloud alpha design-center spaces catalogs update my-catalog \ + --space=my-space --project=my-project --location=us-central1 \ + --display-name="My New Catalog Name" + + Or run: + + $ gcloud alpha design-center spaces catalogs update \ + projects/my-project/locations/us-central1/spaces/my-space/\ + catalogs/my-catalog --display-name="My New Catalog Name" + + To update the description to My new description for the catalog my-catalog + in space my-space, project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces catalogs update my-catalog \ + --space=my-space --project=my-project --location=us-central1 \ + --description="My new description" + +POSITIONAL ARGUMENTS + Catalog resource - Identifier. The catalog name in the following format: + projects/$project/locations/$location/spaces/$space/catalogs/$catalog The + arguments in this group can be used to specify the attributes of this + 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 catalog on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CATALOG + ID of the catalog or fully qualified identifier for the catalog. + + To set the catalog attribute: + ▸ provide the argument catalog on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the catalog resource. + + To set the location attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --space=SPACE + The space id of the catalog resource. + + To set the space attribute: + ▸ provide the argument catalog on the command line with a fully + specified name; + ▸ provide the argument --space on the command line. + +FLAGS + --description=DESCRIPTION + The catalog description. + + --display-name=DISPLAY_NAME + The catalog display name. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/create b/gcloud/alpha/design-center/spaces/create new file mode 100644 index 000000000..8c7785b84 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/create @@ -0,0 +1,105 @@ +NAME + gcloud alpha design-center spaces create - create a space + +SYNOPSIS + gcloud alpha design-center spaces create (SPACE : --location=LOCATION) + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [--enable-gcp-shared-templates] [--gcs-bucket=GCS_BUCKET] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a space. + +EXAMPLES + To create the space my-space in project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces create my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces create \ + projects/my-project/locations/us-central1/spaces/my-space + + To create the space my-space in project my-project and location us-central1 + with display name, description, and enable google templates, run: + + $ gcloud alpha design-center spaces create my-space \ + --project=my-project --location=us-central1 \ + --display-name=my-display-name --description=my-description \ + --enable-gcp-shared-templates + +POSITIONAL ARGUMENTS + Space resource - Identifier. The space name. The arguments in this group + can be used to specify the attributes of this 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 space on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument space on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ▸ provide the argument space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --description=DESCRIPTION + Description for the space. + + --display-name=DISPLAY_NAME + Display name for the space. + + Arguments for the enable gcp shared templates. + + --enable-gcp-shared-templates + Flag to enable Google opinionated shared templates. + + --gcs-bucket=GCS_BUCKET + An existing Google Cloud Storage bucket that you want to use instead of + creating a new bucket during ADC setup. If not provided, a default + bucket is created during setup. The bucket must exist in the same + project as the space. If the bucket name does not exist in the same + project as the space, the request fails with an INVALID_ARGUMENT error. + If you do not have access to the bucket, the request fails with a + PERMISSION_DENIED error. Format: {$bucket_name} For example, if the + Cloud Storage bucket URI is gs:\/\/{$bucket_name}, the format is + {$bucket_name}. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/delete b/gcloud/alpha/design-center/spaces/delete new file mode 100644 index 000000000..ac9642af4 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/delete @@ -0,0 +1,84 @@ +NAME + gcloud alpha design-center spaces delete - delete a space + +SYNOPSIS + gcloud alpha design-center spaces delete (SPACE : --location=LOCATION) + [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a space. + +EXAMPLES + To delete the space my-space in project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces delete my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces delete \ + projects/my-project/locations/us-central1/spaces/my-space + + If your space contains child resources such as application templates, + applications, catalogs, shared templates, force delete the space. To force + delete the space my-space in project my-project and location us-central1, + run: + + $ gcloud alpha design-center spaces delete my-space \ + --project=my-project --location=us-central1 --force + +POSITIONAL ARGUMENTS + Space resource - The space name. The arguments in this group can be used + to specify the attributes of this 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 space on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument space on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ▸ provide the argument space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --force + If set to true, the space's children are also deleted. If false, the + space is only deleted if it has no children. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/describe b/gcloud/alpha/design-center/spaces/describe new file mode 100644 index 000000000..0b1b83ff1 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/describe @@ -0,0 +1,71 @@ +NAME + gcloud alpha design-center spaces describe - describe a space + +SYNOPSIS + gcloud alpha design-center spaces describe (SPACE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a space. + +EXAMPLES + To describe the space my-space in project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces describe my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces describe \ + projects/my-project/locations/us-central1/spaces/my-space + +POSITIONAL ARGUMENTS + Space resource - The space name. The arguments in this group can be used + to specify the attributes of this 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 space on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument space on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ▸ provide the argument space on the command line with a fully + specified name; + ▸ provide the argument --location 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/get-iam-policy b/gcloud/alpha/design-center/spaces/get-iam-policy new file mode 100644 index 000000000..3dd114ec7 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/get-iam-policy @@ -0,0 +1,97 @@ +NAME + gcloud alpha design-center spaces get-iam-policy - get the IAM policy for a + Design Center space + +SYNOPSIS + gcloud alpha design-center spaces get-iam-policy + (SPACE : --location=LOCATION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get the IAM policy for a Design Center space. + + Returns an empty policy if the space does not have an existing IAM policy + set. + +EXAMPLES + To get the space IAM policy for the Space my-space in project my-project in + location us-central1, run: + + $ gcloud alpha design-center spaces get-iam-policy my-space \ + --location=us-central1 --project=my-project + +POSITIONAL ARGUMENTS + Space resource - The Space ID. The arguments in this group can be used to + specify the attributes of this 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 space on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument space on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the space. + + To set the location attribute: + ▸ provide the argument space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/help b/gcloud/alpha/design-center/spaces/help new file mode 100644 index 000000000..660efeee9 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/help @@ -0,0 +1,63 @@ +NAME + gcloud alpha design-center spaces - manage space resources + +SYNOPSIS + gcloud alpha design-center spaces GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage space resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + application-templates + (ALPHA) Manage application template resources. + + applications + (ALPHA) Manage application resources. + + catalogs + (ALPHA) Manage catalog resources. + + shared-templates + (ALPHA) Manage shared template resources. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a space. + + delete + (ALPHA) Delete a space. + + describe + (ALPHA) Describe a space. + + get-iam-policy + (ALPHA) Get the IAM policy for a Design Center space. + + list + (ALPHA) List spaces. + + set-iam-policy + (ALPHA) Set the IAM policy for a Design Center space as defined in a + JSON/YAML file. + + test-iam-permissions + (ALPHA) Test IAM permissions for a Design Center space. + + update + (ALPHA) Update a space. + +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. + diff --git a/gcloud/alpha/design-center/spaces/list b/gcloud/alpha/design-center/spaces/list new file mode 100644 index 000000000..577252a61 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/list @@ -0,0 +1,116 @@ +NAME + gcloud alpha design-center spaces list - list spaces + +SYNOPSIS + gcloud alpha design-center spaces list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List spaces. + +EXAMPLES + To list all spaces in project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces list --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces list \ + --location=projects/my-project/locations/us-central1 + + To filter and list spaces that contains my-space prefix in the display name + in project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces list --project=my-project \ + --location=us-central1 --filter="displayName:my-space*" + + To list up to 10 spaces in project my-project and location us-central1, + run: + + $ gcloud alpha design-center spaces list --project=my-project \ + --location=us-central1 --limit=10 + + To list up to 5 pages of spaces in project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces list --project=my-project \ + --location=us-central1 --page-size=5 + + To list spaces sorted by display name in project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces list --project=my-project \ + --location=us-central1 --sort-by=displayName + +REQUIRED FLAGS + Location resource - The name of the parent resource, for which spaces are + listed. 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/set-iam-policy b/gcloud/alpha/design-center/spaces/set-iam-policy new file mode 100644 index 000000000..bc0ef17e6 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/set-iam-policy @@ -0,0 +1,86 @@ +NAME + gcloud alpha design-center spaces set-iam-policy - set the IAM policy for a + Design Center space as defined in a JSON/YAML file + +SYNOPSIS + gcloud alpha design-center spaces set-iam-policy + (SPACE : --location=LOCATION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Set the IAM policy for a Design Center space as defined in a + JSON/YAML file. + + See https://cloud.google.com/iam/docs/managing-policies for details of the + policy file format and contents. + +EXAMPLES + To set the space IAM policy using a json file 'my_policy.json' for the + Space my-space in project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces set-iam-policy my-space \ + --location=us-central1 --project=my-project \ + /path/to/my_policy.json + + To set the space IAM policy using a yaml file 'my_policy.yaml for the Space + my-space in project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces set-iam-policy my-space \ + --location=us-central1 --project=my-project \ + /path/to/my_policy.yaml + +POSITIONAL ARGUMENTS + Space resource - The Space ID. The arguments in this group can be used to + specify the attributes of this 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 space on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument space on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the space. + + To set the location attribute: + ▸ provide the argument space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/shared-templates/describe b/gcloud/alpha/design-center/spaces/shared-templates/describe new file mode 100644 index 000000000..80031b0d7 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/shared-templates/describe @@ -0,0 +1,99 @@ +NAME + gcloud alpha design-center spaces shared-templates describe - describe a + shared template + +SYNOPSIS + gcloud alpha design-center spaces shared-templates describe SHARED_TEMPLATE + [--location=LOCATION] + [--google-catalog | --project=PROJECT --space=SPACE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a shared template. + +EXAMPLES + To describe the shared template my-shared-template in space my-space, + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces shared-templates describe \ + my-shared-template --space=my-space --project=my-project \ + --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces shared-templates describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + sharedTemplates/my-shared-template + + To describe a shared template google-template from the Google Catalog and + location us-central1, run: + + $ gcloud alpha design-center spaces shared-templates describe \ + google-template --google-catalog --location=us-central1 + +POSITIONAL ARGUMENTS + SHARED_TEMPLATE + ID of the sharedTemplate or fully qualified identifier for the + sharedTemplate. Format: + projects/$project/locations/$location/spaces/$space/sharedTemplates/$sharedTemplate + To set the shared_template attribute: + ◆ provide the fully qualified identifier shared_template on the + command line; + ◆ provide the argument shared_template which represents the shared + template id and the other arguments --location, --project, --space or + --google-catalog on the command line. + +FLAGS + --location=LOCATION + The location id of the sharedTemplate resource. + + To set the location attribute: + ◆ provide the argument shared_template on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + At most one of these can be specified: + + --google-catalog + If provided, describes a shared template from the Google Catalog. + This sets the project to "gcpdesigncenter" and space to + "googlespace". + + Specify --project and --space for custom shared templates. + + --project=PROJECT + The project id of the sharedTemplate resource. + + To set the project attribute: + ▫ provide the argument shared_template on the command line with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --space=SPACE + The space id of the sharedTemplate resource. + + To set the space attribute: + ▫ provide the argument shared_template on the command line with a + fully specified name; + ▫ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/shared-templates/help b/gcloud/alpha/design-center/spaces/shared-templates/help new file mode 100644 index 000000000..d9bd40f83 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/shared-templates/help @@ -0,0 +1,37 @@ +NAME + gcloud alpha design-center spaces shared-templates - manage shared template + resources + +SYNOPSIS + gcloud alpha design-center spaces shared-templates GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage shared template resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + revisions + (ALPHA) Manage shared template revision resources. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe a shared template. + + list + (ALPHA) List shared templates. + +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. + diff --git a/gcloud/alpha/design-center/spaces/shared-templates/list b/gcloud/alpha/design-center/spaces/shared-templates/list new file mode 100644 index 000000000..2a09c6795 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/shared-templates/list @@ -0,0 +1,140 @@ +NAME + gcloud alpha design-center spaces shared-templates list - list shared + templates + +SYNOPSIS + gcloud alpha design-center spaces shared-templates list + (--google-catalog | [--space=SPACE : --project=PROJECT]) + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List shared templates in a given space. + +EXAMPLES + To list all shared templates in space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces shared-templates list \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces shared-templates list \ + --space=projects/my-project/locations/us-central1/spaces/\ + my-space + + To list all shared templates from the Google Catalog in location + us-central1, run: + + $ gcloud alpha design-center spaces shared-templates list \ + --google-catalog --location=us-central1 + + To filter and list shared templates that contain a my-shared-template + prefix in the display name in space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces shared-templates list \ + --space=my-space --project=my-project --location=us-central1 \ + --filter="displayName:my-shared-template*" + + To list up to 10 shared templates in space my-space, project my-project and + location us-central1, run: + + $ gcloud alpha design-center spaces shared-templates list \ + --space=my-space --project=my-project --location=us-central1 \ + --limit=10 + +REQUIRED FLAGS + Space resource - The parent space for which shared templates are listed in + the following format: projects/$project/locations/$location/spaces/$space + The following arguments in this group can be used to specify the + attributes of this resource. + + Exactly one of these must be specified: + + --google-catalog + If provided, lists all shared template from the Google Catalog. This + sets the project to "gcpdesigncenter" and space to "googlespace". + + Specify --project and/or --space for custom shared templates. + + --space=SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▫ provide the argument --space on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --project=PROJECT + The project id of the space resource. + + To set the project attribute: + ▫ provide the argument --space on the command line with a fully + specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + +FLAGS + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ◆ provide the argument --space on the command line with a fully + specified name; + ◆ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/shared-templates/revisions/describe b/gcloud/alpha/design-center/spaces/shared-templates/revisions/describe new file mode 100644 index 000000000..b8a5e9adc --- /dev/null +++ b/gcloud/alpha/design-center/spaces/shared-templates/revisions/describe @@ -0,0 +1,110 @@ +NAME + gcloud alpha design-center spaces shared-templates revisions describe - + describe a shared template revision + +SYNOPSIS + gcloud alpha design-center spaces shared-templates revisions describe + REVISION [--location=LOCATION] [--shared-template=SHARED_TEMPLATE] + [--google-catalog | --project=PROJECT --space=SPACE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a shared template revision. + +EXAMPLES + To describe the shared template revision my-revision in shared template + my-shared-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces shared-templates revisions \ + describe my-revision --shared-template=my-shared-template \ + --space=my-space --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces shared-templates revisions \ + describe \ + projects/my-project/locations/us-central1/spaces/my-space/\ + sharedTemplates/my-shared-template/revisions/my-revision + + To describe a shared template revision my-revision in shared template + google-template from the Google Catalog and location us-central1, run: + + $ gcloud alpha design-center spaces shared-templates revisions \ + describe my-revision --shared-template=google-template \ + --google-catalog --location=us-central1 + +POSITIONAL ARGUMENTS + REVISION + ID of the revision or fully qualified identifier for the + sharedTemplateRevision. Format: + projects/$project/locations/$location/spaces/$space/sharedTemplates/$sharedTemplate/revisions/$revision + To set the revision attribute: + ◆ provide the fully qualified identifier revision on the command + line; + ◆ provide the argument revision which represents the revision id and + the other arguments --shared-template, --location, --project, --space + or --google-catalog on the command line. + +FLAGS + --location=LOCATION + The location id of the revision resource. + + To set the location attribute: + ◆ provide the argument revision on the command line with a fully + specified name; + ◆ provide the argument --location on the command line. + + --shared-template=SHARED_TEMPLATE + The sharedTemplate id of the revision resource. + + To set the shared-template attribute: + ◆ provide the argument revision on the command line with a fully + specified name; + ◆ provide the argument --shared-template on the command line. + + At most one of these can be specified: + + --google-catalog + If provided, describes a shared template revision from the Google + Catalog. This sets the project to "gcpdesigncenter" and space to + "googlespace". + + Specify --project and --space for custom shared templates. + + --project=PROJECT + The project id of the revision resource. + + To set the project attribute: + ▫ provide the argument revision on the command line with a fully + specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --space=SPACE + The space id of the revision resource. + + To set the space attribute: + ▫ provide the argument revision on the command line with a fully + specified name; + ▫ provide the argument --space 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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/shared-templates/revisions/help b/gcloud/alpha/design-center/spaces/shared-templates/revisions/help new file mode 100644 index 000000000..2fc6fc974 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/shared-templates/revisions/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha design-center spaces shared-templates revisions - manage + shared template revision resources + +SYNOPSIS + gcloud alpha design-center spaces shared-templates revisions COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage shared template revision resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe a shared template revision. + + list + (ALPHA) List shared template revisions. + +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. + diff --git a/gcloud/alpha/design-center/spaces/shared-templates/revisions/list b/gcloud/alpha/design-center/spaces/shared-templates/revisions/list new file mode 100644 index 000000000..0b707035e --- /dev/null +++ b/gcloud/alpha/design-center/spaces/shared-templates/revisions/list @@ -0,0 +1,139 @@ +NAME + gcloud alpha design-center spaces shared-templates revisions list - list + shared template revisions + +SYNOPSIS + gcloud alpha design-center spaces shared-templates revisions list + --shared-template=SHARED_TEMPLATE [--location=LOCATION] + [--google-catalog | --project=PROJECT --space=SPACE] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List shared template revisions in a given shared template. + +EXAMPLES + To list all shared template revisions in shared template + my-shared-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces shared-templates revisions \ + list --shared-template=my-shared-template --space=my-space \ + --project=my-project --location=us-central1 + + Or run: + + $ gcloud alpha design-center spaces shared-templates revisions \ + list \ + --shared-template=projects/my-project/locations/us-central1/\ + spaces/my-space/sharedTemplates/my-shared-template + + To list all shared template revisions for shared template google-template + from the Google Catalog in location us-central1, run: + + $ gcloud alpha design-center spaces shared-templates revisions \ + list --shared-template=google-template --google-catalog \ + --location=us-central1 + + To list up to 10 shared template revisions in shared template + my-shared-template, space my-space, project my-project and location + us-central1, run: + + $ gcloud alpha design-center spaces shared-templates revisions \ + list --shared-template=my-shared-template --space=my-space \ + --project=my-project --location=us-central1 --limit=10 + +REQUIRED FLAGS + --shared-template=SHARED_TEMPLATE + ID of the sharedTemplate or fully qualified identifier for the + sharedTemplate. + + To set the shared-template attribute: + ◆ provide the argument --shared-template on the command line. + +FLAGS + --location=LOCATION + The location id of the sharedTemplate resource. + + To set the location attribute: + ◆ provide the argument --shared-template on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + At most one of these can be specified: + + --google-catalog + If provided, lists revisions for a shared template from the Google + Catalog. This sets the project to "gcpdesigncenter" and space to + "googlespace". + + Specify --project and --space for custom shared templates. + + --project=PROJECT + The project id of the sharedTemplate resource. + + To set the project attribute: + ▫ provide the argument --shared-template on the command line with + a fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --space=SPACE + The space id of the sharedTemplate resource. + + To set the space attribute: + ▫ provide the argument --shared-template on the command line with + a fully specified name; + ▫ provide the argument --space on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/test-iam-permissions b/gcloud/alpha/design-center/spaces/test-iam-permissions new file mode 100644 index 000000000..e32c47c53 --- /dev/null +++ b/gcloud/alpha/design-center/spaces/test-iam-permissions @@ -0,0 +1,81 @@ +NAME + gcloud alpha design-center spaces test-iam-permissions - test IAM + permissions for a Design Center space + +SYNOPSIS + gcloud alpha design-center spaces test-iam-permissions + (SPACE : --location=LOCATION) --permissions=[PERMISSION,...] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Tests the IAM permissions that a caller has on a Design Center + space. + + Returns an empty set of permissions if the space does not exist. + + Note: This operation is designed to be used for building permission-aware + UIs and command-line tools, not for authorization checking. This operation + may "fail open" without warning. + +EXAMPLES + To test if the caller has the designcenter.spaces.get and + designcenter.spaces.update permissions on the Space my-space in project + my-project and location us-central1, run: + + $ gcloud alpha design-center spaces test-iam-permissions my-space \ + --location=us-central1 --project=my-project \ + --permissions=designcenter.spaces.get,designcenter.spaces.update + +POSITIONAL ARGUMENTS + Space resource - The Space ID. The arguments in this group can be used to + specify the attributes of this 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 space on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument space on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Cloud location for the space. + + To set the location attribute: + ▸ provide the argument space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --permissions=[PERMISSION,...] + The set of permissions to check for the resource. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/design-center/spaces/update b/gcloud/alpha/design-center/spaces/update new file mode 100644 index 000000000..5c16f676b --- /dev/null +++ b/gcloud/alpha/design-center/spaces/update @@ -0,0 +1,117 @@ +NAME + gcloud alpha design-center spaces update - update a space + +SYNOPSIS + gcloud alpha design-center spaces update (SPACE : --location=LOCATION) + [--description=DESCRIPTION] [--display-name=DISPLAY_NAME] + [--[no-]enable-gcp-shared-templates] [--gcs-bucket=GCS_BUCKET] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a space. + +EXAMPLES + To update the display name to My New Space Name in the space my-space in + project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces update my-space \ + --project=my-project --location=us-central1 \ + --display-name="My New Space Name" + + Or run: + + $ gcloud alpha design-center spaces update \ + projects/my-project/locations/us-central1/spaces/my-space \ + --display-name="My New Space Name" + + To disable google templates in the space my-space in project my-project and + location us-central1 , run: + + $ gcloud alpha design-center spaces update my-space \ + --project=my-project --location=us-central1 \ + --no-enable-gcp-shared-templates + + To update the display name, description, and enable google templates in the + space my-space in project my-project and location us-central1, run: + + $ gcloud alpha design-center spaces update my-space \ + --project=my-project --location=us-central1 \ + --display-name="My Updated Space" \ + --description="Updated description" \ + --enable-gcp-shared-templates + +POSITIONAL ARGUMENTS + Space resource - Identifier. The space name. The arguments in this group + can be used to specify the attributes of this 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 space on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SPACE + ID of the space or fully qualified identifier for the space. + + To set the space attribute: + ▸ provide the argument space on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the space resource. + + To set the location attribute: + ▸ provide the argument space on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --description=DESCRIPTION + Description for the space. + + --display-name=DISPLAY_NAME + Display name for the space. + + Arguments for the enable gcp shared templates. + + --[no-]enable-gcp-shared-templates + Flag to enable Google opinionated shared templates. Use + --enable-gcp-shared-templates to enable and + --no-enable-gcp-shared-templates to disable. + + --gcs-bucket=GCS_BUCKET + An existing Google Cloud Storage bucket that you want to use instead of + creating a new bucket during ADC setup. If not provided, a default + bucket is created during setup. The bucket must exist in the same + project as the space. If the bucket name does not exist in the same + project as the space, the request fails with an INVALID_ARGUMENT error. + If you do not have access to the bucket, the request fails with a + PERMISSION_DENIED error. Format: {$bucket_name} For example, if the + Cloud Storage bucket URI is gs:\/\/{$bucket_name}, the format is + {$bucket_name}. + +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 designcenter/v1alpha API. The full documentation for + this API can be found at: + http://cloud.google.com/application-design-center/docs + +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. + diff --git a/gcloud/alpha/kms/decapsulate b/gcloud/alpha/kms/decapsulate new file mode 100644 index 000000000..4432c0ac7 --- /dev/null +++ b/gcloud/alpha/kms/decapsulate @@ -0,0 +1,70 @@ +NAME + gcloud alpha kms decapsulate - decapsulate an input file using a + key-encapsulation key version + +SYNOPSIS + gcloud alpha kms decapsulate --ciphertext-file=CIPHERTEXT_FILE + --shared-secret-file=SHARED_SECRET_FILE [--key=KEY] [--keyring=KEYRING] + [--location=LOCATION] [--skip-integrity-verification] + [--version=VERSION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Decapsulates the given ciphertext file using the provided + key-encapsulation key version and saves the decapsulated shared secret to + the shared secret file. + + By default, the command performs integrity verification on data sent to and + received from Cloud KMS. Use --skip-integrity-verification to disable + integrity verification. + +EXAMPLES + The following command will read the file '/tmp/my/secret.file.enc', + decapsulate it using the key encapsulation CryptoKey my-key Version 3 and + write the shared secret to '/tmp/my/secret.file.dec'. + + $ gcloud alpha kms decapsulate --location=us-central1 \ + --keyring=my-keyring --key=my-key --version=3 \ + --ciphertext-file=/tmp/my/secret.file.enc \ + --shared-secret-file=/tmp/my/secret.file.dec + +REQUIRED FLAGS + --ciphertext-file=CIPHERTEXT_FILE + File path of the ciphertext file to decapsulate. + + --shared-secret-file=SHARED_SECRET_FILE + File path of the shared secret file to output. + +OPTIONAL FLAGS + --key=KEY + to use for decapsulation. + + --keyring=KEYRING + Key ring of the key. + + --location=LOCATION + Location of the keyring. + + --skip-integrity-verification + Skip integrity verification on request and response API fields. + + --version=VERSION + Version to use for decapsulation. + +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. + +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. These variants are also available: + + $ gcloud kms decapsulate + + $ gcloud beta kms decapsulate + diff --git a/gcloud/alpha/kms/help b/gcloud/alpha/kms/help index eadca03dd..8186f6c8b 100644 --- a/gcloud/alpha/kms/help +++ b/gcloud/alpha/kms/help @@ -65,6 +65,10 @@ COMMANDS asymmetric-sign (ALPHA) Sign a user input file using an asymmetric-signing key version. + decapsulate + (ALPHA) Decapsulate an input file using a key-encapsulation key + version. + decrypt (ALPHA) Decrypt a ciphertext file using a Cloud KMS key. diff --git a/gcloud/alpha/kms/keys/create b/gcloud/alpha/kms/keys/create index 0ddd88145..d09ebfbfe 100644 --- a/gcloud/alpha/kms/keys/create +++ b/gcloud/alpha/kms/keys/create @@ -171,8 +171,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --purpose=PURPOSE The "purpose" of the key. PURPOSE must be one of: - asymmetric-encryption, asymmetric-signing, encryption, mac, - raw-encryption. + asymmetric-encryption, asymmetric-signing, encryption, + key-encapsulation, mac, raw-encryption. OPTIONAL FLAGS --allowed-access-reasons=[ALLOWED_ACCESS_REASONS,...] @@ -204,18 +204,18 @@ OPTIONAL FLAGS aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, external-symmetric-encryption, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --destroy-scheduled-duration=DESTROY_SCHEDULED_DURATION The amount of time that versions of the key should spend in the diff --git a/gcloud/alpha/kms/keys/update b/gcloud/alpha/kms/keys/update index 341259cff..e249e20b4 100644 --- a/gcloud/alpha/kms/keys/update +++ b/gcloud/alpha/kms/keys/update @@ -175,18 +175,18 @@ FLAGS aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, external-symmetric-encryption, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --next-rotation-time=NEXT_ROTATION_TIME Next automatic rotation time of the key. See $ gcloud topic datetimes diff --git a/gcloud/alpha/kms/keys/versions/get-public-key b/gcloud/alpha/kms/keys/versions/get-public-key index f887bc21c..5009e33df 100644 --- a/gcloud/alpha/kms/keys/versions/get-public-key +++ b/gcloud/alpha/kms/keys/versions/get-public-key @@ -15,11 +15,13 @@ DESCRIPTION If not specified, the public key will be printed to stdout. The optional flag public-key-format indicates the format in which the - public key will be returned. For the PQC algorithms, this must be specified - and set to nist-pqc. For all other algorithms, this flag is optional and - defaults to pem. See "Retrieve a public key" in the Cloud KMS documentation - (https://cloud.google.com/kms/docs/retrieve-public-key) for more - information about the supported formats. + public key will be returned. For the NIST PQC algorithms, this must be + specified and set to nist-pqc. For kem-xwing this must be specified and set + to xwing-raw-bytes. For all other algorithms, this flag is optional and can + be either pem or der; the default value is pem. See "Retrieve a public key" + in the Cloud KMS documentation + (https://cloud.google.com/kms/help/get-public-key) for more information + about the supported formats. EXAMPLES The following command saves the public key for CryptoKey frodo Version 2 to diff --git a/gcloud/alpha/kms/keys/versions/import b/gcloud/alpha/kms/keys/versions/import index 73ca2ec9f..b7a5c051d 100644 --- a/gcloud/alpha/kms/keys/versions/import +++ b/gcloud/alpha/kms/keys/versions/import @@ -34,18 +34,18 @@ REQUIRED FLAGS aes-128-cbc, aes-128-ctr, aes-128-gcm, aes-256-cbc, aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --import-job=IMPORT_JOB Name of the import job to import from. diff --git a/gcloud/alpha/managed-kafka/connectors/create b/gcloud/alpha/managed-kafka/connectors/create index 95d5c8181..1e54b3c0d 100644 --- a/gcloud/alpha/managed-kafka/connectors/create +++ b/gcloud/alpha/managed-kafka/connectors/create @@ -6,6 +6,8 @@ SYNOPSIS gcloud alpha managed-kafka connectors create (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) (--config-file=JSON|YAML|FILE | --configs=[KEY=VALUE,...]) + [--task-restart-max-backoff=TASK_RESTART_MAX_BACKOFF + --task-restart-min-backoff=TASK_RESTART_MIN_BACKOFF] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -17,10 +19,14 @@ EXAMPLES $ gcloud alpha managed-kafka connectors create myconnector \ --location=us-central1 --connect-cluster=mycluster \ --configs=connector.class="com.google.pubsub.kafka.source.CloudP\ - ubSubSourceConnector",cps.subscription="my-subscription",... OR + ubSubSourceConnector",cps.subscription="my-subscription",... \ + [--task-restart-min-backoff=60s] \ + [--task-restart-max-backoff=30m] OR $ gcloud alpha managed-kafka connectors create myconnector \ --location=us-central1 --connect-cluster=mycluster \ - --config-file=my-config-file.yaml + --config-file=my-config-file.yaml \ + [--task-restart-min-backoff=60s] \ + [--task-restart-max-backoff=30m] POSITIONAL ARGUMENTS Connector resource - Identifies the connector for which the command runs. @@ -85,6 +91,19 @@ REQUIRED FLAGS connector defaults. The key of the map is a Kafka topic property name, for example: cleanup.policy=compact,compression.type=producer. +OPTIONAL FLAGS + --task-restart-max-backoff=TASK_RESTART_MAX_BACKOFF + The maximum amount of time to wait before retrying a failed task in + seconds. This sets an upper bound for the backoff delay. The default + value is 1800s (30 minutes). See $ gcloud topic datetimes for + information on duration formats. + + --task-restart-min-backoff=TASK_RESTART_MIN_BACKOFF + The minimum amount of time to wait before retrying a failed task in + seconds. This sets a lower bound for the backoff delay. The default + value is 60s. See $ gcloud topic datetimes for information on duration + formats. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/managed-kafka/connectors/update b/gcloud/alpha/managed-kafka/connectors/update index a909cc304..134d688f8 100644 --- a/gcloud/alpha/managed-kafka/connectors/update +++ b/gcloud/alpha/managed-kafka/connectors/update @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors update (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) - (--config-file=JSON|YAML|FILE | --configs=[KEY=VALUE,...]) + [--config-file=JSON|YAML|FILE | --configs=[KEY=VALUE,...]] + [--task-restart-max-backoff=TASK_RESTART_MAX_BACKOFF + --task-restart-min-backoff=TASK_RESTART_MIN_BACKOFF] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -16,10 +18,12 @@ EXAMPLES $ gcloud alpha managed-kafka connectors update myconnector \ --location=us-central1 --configs=KEY1=VALUE1,KEY2=VALUE2... \ - --connect-cluster=mycluster OR + --connect-cluster=mycluster [--task-restart-min-backoff=60s] \ + [--task-restart-max-backoff=30m] OR $ gcloud alpha managed-kafka connectors update myconnector \ --location=us-central1 --config-file=my-config-file.yaml \ - --connect-cluster=mycluster + --connect-cluster=mycluster [--task-restart-min-backoff=60s] \ + [--task-restart-max-backoff=30m] POSITIONAL ARGUMENTS Connector resource - Identifies the connector for which the command runs. @@ -63,8 +67,8 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --location on the command line. -REQUIRED FLAGS - Exactly one of these must be specified: +FLAGS + At most one of these can be specified: --config-file=JSON|YAML|FILE The path to the JSON or YAML file containing the configuration that @@ -84,6 +88,18 @@ REQUIRED FLAGS connector defaults. The key of the map is a Kafka topic property name, for example: cleanup.policy=compact,compression.type=producer. + --task-restart-max-backoff=TASK_RESTART_MAX_BACKOFF + The maximum amount of time to wait before retrying a failed task in + seconds. This sets an upper bound for the backoff delay. The default + value is 1800s (30 minutes). See $ gcloud topic datetimes for + information on duration formats. + + --task-restart-min-backoff=TASK_RESTART_MIN_BACKOFF + The minimum amount of time to wait before retrying a failed task in + seconds. This sets a lower bound for the backoff delay. The default + value is 60s. See $ gcloud topic datetimes for information on duration + formats. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/recommender/insights/list b/gcloud/alpha/recommender/insights/list index 45eb0fe54..aa2ac0515 100644 --- a/gcloud/alpha/recommender/insights/list +++ b/gcloud/alpha/recommender/insights/list @@ -71,9 +71,10 @@ FLAGS projects. The maximum number of resources (organization, folders, projects, and descendant resources) that can be accessed at once with the --recursive flag is 100. For a larger number of nested resources, - use BigQuery Export. Using --recursive can add 15-20 seconds per - resource to the runtime. Use --recursive to enable and --no-recursive - to disable. + use BigQuery export + (https://cloud.google.com/recommender/docs/bq-export/export-recommendations-to-bq). + Using --recursive can add 15-20 seconds per resource to the runtime. + Use --recursive to enable and --no-recursive to disable. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/recommender/recommendations/list b/gcloud/alpha/recommender/recommendations/list index 280b93e31..0d61b8f6e 100644 --- a/gcloud/alpha/recommender/recommendations/list +++ b/gcloud/alpha/recommender/recommendations/list @@ -70,8 +70,10 @@ FLAGS The maximum number of resources (organization, folders, projects, and descendant resources) that can be accessed at once with the --recursive flag is 100. For a larger number of nested resources, use BigQuery - Export. Using --recursive can add 15-20 seconds per resource to the - runtime. Use --recursive to enable and --no-recursive to disable. + export + (https://cloud.google.com/recommender/docs/bq-export/export-recommendations-to-bq). + Using --recursive can add 15-20 seconds per resource to the runtime. + Use --recursive to enable and --no-recursive to disable. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/run/help b/gcloud/alpha/run/help index 0918cb5d4..5d17bc79c 100644 --- a/gcloud/alpha/run/help +++ b/gcloud/alpha/run/help @@ -35,9 +35,6 @@ GROUPS multi-region-services (ALPHA) Manage your Cloud Run multi-region services. - presets - (ALPHA) View available Cloud Run service presets. - regions (ALPHA) View available Cloud Run (fully managed) regions. diff --git a/gcloud/alpha/run/presets/describe b/gcloud/alpha/run/presets/describe deleted file mode 100644 index 4f8e2a45e..000000000 --- a/gcloud/alpha/run/presets/describe +++ /dev/null @@ -1,39 +0,0 @@ -NAME - gcloud alpha run presets describe - describe a Cloud Run preset. Currently - only available in alpha - -SYNOPSIS - gcloud alpha run presets describe NAME [--region=REGION] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Describe a Cloud Run preset. Currently only available in alpha. - -EXAMPLES - To describe a preset, run: - - $ gcloud alpha run presets describe - -POSITIONAL ARGUMENTS - NAME - The name of the preset to describe. - -FLAGS - --region=REGION - Region in which the resource can be found. Alternatively, set the - property [run/region]. - -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. - -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. - diff --git a/gcloud/alpha/run/presets/help b/gcloud/alpha/run/presets/help deleted file mode 100644 index a9b46c6eb..000000000 --- a/gcloud/alpha/run/presets/help +++ /dev/null @@ -1,45 +0,0 @@ -NAME - gcloud alpha run presets - view available Cloud Run service presets - -SYNOPSIS - gcloud alpha run presets COMMAND [--region=REGION] [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) This command group allows you to list and describe presets for your - Cloud Run services. - -EXAMPLES - To list all available presets, run: - - $ gcloud alpha run presets list - - To get detailed information about a specific preset, run: - - $ gcloud alpha run presets describe - -FLAGS - --region=REGION - Region in which the resource can be found. Alternatively, set the - property [run/region]. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --help. - - Run $ gcloud help for details. - -COMMANDS - COMMAND is one of the following: - - describe - (ALPHA) Describe a Cloud Run preset. Currently only available in alpha. - - list - (ALPHA) List available Cloud Run presets. Currently only available in - alpha. - -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. - diff --git a/gcloud/alpha/spanner/instances/create b/gcloud/alpha/spanner/instances/create index 21f5c925a..422ac31a5 100644 --- a/gcloud/alpha/spanner/instances/create +++ b/gcloud/alpha/spanner/instances/create @@ -107,20 +107,22 @@ OPTIONAL FLAGS Autoscaling - Specify both or only one of the CPU targets: + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. - At least one of these must be specified: - - --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET - Specifies the target percentage of high-priority CPU the - autoscaled instance can utilize. + This flag argument must be specified if any of the other arguments + in this group are specified. --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET Specifies the target percentage of storage the autoscaled instance can utilize. + This flag argument must be specified if any of the other arguments + in this group are specified. + --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING],[disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING],[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS],[total_cpu_target=TOTAL_CPU_TARGET] - Specify the asymmetric autoscaling option for the instance. + Specifies the asymmetric autoscaling option for the instance. Autoscaling limits can be defined in either nodes or processing units. diff --git a/gcloud/alpha/spanner/instances/update b/gcloud/alpha/spanner/instances/update index a8512938f..1f3910ca6 100644 --- a/gcloud/alpha/spanner/instances/update +++ b/gcloud/alpha/spanner/instances/update @@ -106,11 +106,9 @@ FLAGS Autoscaling - Specify both or only one of the CPU targets: - - --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET - Specifies the target percentage of high-priority CPU the - autoscaled instance can utilize. + --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET + Specifies the target percentage of high-priority CPU the autoscaled + instance can utilize. --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET Specifies the target percentage of storage the autoscaled instance @@ -119,7 +117,7 @@ FLAGS At most one of these can be specified: --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING],[disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING],[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS],[total_cpu_target=TOTAL_CPU_TARGET] - Specify the asymmetric autoscaling option for the instance. + Specifies the asymmetric autoscaling option for the instance. --clear-asymmetric-autoscaling-option=LOCATION,[LOCATION,...] Specify a comma separated list of locations from which to remove diff --git a/gcloud/alpha/sql/instances/clone b/gcloud/alpha/sql/instances/clone index 86dc1478f..477f2ad27 100644 --- a/gcloud/alpha/sql/instances/clone +++ b/gcloud/alpha/sql/instances/clone @@ -6,6 +6,7 @@ SYNOPSIS [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] [--preferred-secondary-zone=PREFERRED_SECONDARY_ZONE] [--preferred-zone=PREFERRED_ZONE] + [--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME] [--bin-log-file-name=BIN_LOG_FILE_NAME --bin-log-position=BIN_LOG_POSITION | [--point-in-time=POINT_IN_TIME : --restore-database-name=RESTORE_DATABASE_NAME]] @@ -103,6 +104,10 @@ FLAGS this flag, then the destination instance uses the value as the primary zone. + --source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME + The time the source instance was deleted. This is required if cloning + from a deleted instance. + At most one of these can be specified: Binary log coordinates for point-in-time recovery. diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index bc2a63ea7..401af1630 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -454,11 +454,11 @@ FLAGS 0 to 100. --psc-auto-connections=[network=NETWORK],[project=PROJECT] - A comma-separated list of networks or a comma-separated list of - network-project pairs. Each project in this list is represented by a - project number (numeric) or by a project ID (alphanumeric). This allows - Private Service Connect connections to be created automatically for the - specified networks. For example, this connection uses "the form + A comma-separated list of networks or network-project pairs. Each + project is represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + created automatically for the specified networks. For example, this + connection uses "the form psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" or "the form psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". diff --git a/gcloud/alpha/sql/instances/get-latest-recovery-time b/gcloud/alpha/sql/instances/get-latest-recovery-time index bebcb43fb..d0da2d981 100644 --- a/gcloud/alpha/sql/instances/get-latest-recovery-time +++ b/gcloud/alpha/sql/instances/get-latest-recovery-time @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud alpha sql instances get-latest-recovery-time INSTANCE + [--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -25,6 +26,11 @@ POSITIONAL ARGUMENTS INSTANCE Cloud SQL instance ID. +FLAGS + --source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME + The deletion time of the source instance. This is used to identify the + instance if it has been deleted. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index 2b31eb760..6eabed8c4 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -634,17 +634,16 @@ FLAGS At most one of these can be specified: --clear-psc-auto-connections - This removes all connections created automatically. Cloud SQL uses + This removes all automatically created connections. Cloud SQL uses these connections to connect to an instance using Private Service Connect. --psc-auto-connections=[network=NETWORK],[project=PROJECT] - A comma-separated list of networks or a comma-separated list of - network-project pairs. Each project in this list is represented by a - project number (numeric) or by a project ID (alphanumeric). This - allows Private Service Connect connections to be created - automatically for the specified networks. For example, this - connection uses "the form + A comma-separated list of networks or network-project pairs. Each + project is represented by a project number (numeric) or by a project + ID (alphanumeric). This allows Private Service Connect connections to + be created automatically for the specified networks. For example, + this connection uses "the form psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" or "the form psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". diff --git a/gcloud/alpha/storage/help b/gcloud/alpha/storage/help index 7188b37b8..0234cbf6d 100644 --- a/gcloud/alpha/storage/help +++ b/gcloud/alpha/storage/help @@ -42,7 +42,7 @@ GROUPS (ALPHA) Manage Cloud Storage managed folders. management-hub - (ALPHA) Manage Cloud Storage Management Hub. + (ALPHA) (DEPRECATED) Manage Cloud Storage Management Hub. objects (ALPHA) Manage Cloud Storage objects. diff --git a/gcloud/alpha/storage/management-hub/describe b/gcloud/alpha/storage/management-hub/describe index a1e5d90e2..da23f648f 100644 --- a/gcloud/alpha/storage/management-hub/describe +++ b/gcloud/alpha/storage/management-hub/describe @@ -7,8 +7,10 @@ SYNOPSIS | --sub-folder=SUB_FOLDER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe management hub for the organization, sub-folder or - project. + (ALPHA) (DEPRECATED) This command group is deprecated. Use gcloud alpha + storage intelligence-configs command group instead. + + Describe management hub for the organization, sub-folder or project. EXAMPLES The following command describes management hub for the sub-folder with id diff --git a/gcloud/alpha/storage/management-hub/disable b/gcloud/alpha/storage/management-hub/disable index b61a86cc4..458b0d4a7 100644 --- a/gcloud/alpha/storage/management-hub/disable +++ b/gcloud/alpha/storage/management-hub/disable @@ -7,7 +7,10 @@ SYNOPSIS | --sub-folder=SUB_FOLDER) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Disable management hub for the organization, sub-folder or project. + (ALPHA) (DEPRECATED) This command group is deprecated. Use gcloud alpha + storage intelligence-configs command group instead. + + Disable management hub for the organization, sub-folder or project. EXAMPLES The following command disables management hub for the project. diff --git a/gcloud/alpha/storage/management-hub/enable b/gcloud/alpha/storage/management-hub/enable index c17481dc9..290bb62ed 100644 --- a/gcloud/alpha/storage/management-hub/enable +++ b/gcloud/alpha/storage/management-hub/enable @@ -13,8 +13,11 @@ SYNOPSIS --include-bucket-ids=[INCLUDE_BUCKET_IDS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Enable management hub plan for the organization, sub-folder or - project along with filters. + (ALPHA) (DEPRECATED) This command group is deprecated. Use gcloud alpha + storage intelligence-configs command group instead. + + Enable management hub plan for the organization, sub-folder or project + along with filters. EXAMPLES To remove buckets from the management hub plan, Use the following command diff --git a/gcloud/alpha/storage/management-hub/help b/gcloud/alpha/storage/management-hub/help index b854a959e..4b3116aab 100644 --- a/gcloud/alpha/storage/management-hub/help +++ b/gcloud/alpha/storage/management-hub/help @@ -5,7 +5,10 @@ SYNOPSIS gcloud alpha storage management-hub COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Cloud Storage Management Hub. + (ALPHA) (DEPRECATED) Manage Cloud Storage Management Hub. + + This command group is deprecated. Use gcloud alpha storage + intelligence-configs command group instead. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -16,16 +19,16 @@ COMMANDS COMMAND is one of the following: describe - (ALPHA) Describes Management Hub. + (ALPHA) (DEPRECATED) Describes Management Hub. disable - (ALPHA) Disables Management Hub. + (ALPHA) (DEPRECATED) Disables Management Hub. enable - (ALPHA) Enables Management Hub. + (ALPHA) (DEPRECATED) Enables Management Hub. update - (ALPHA) Updates Management Hub. + (ALPHA) (DEPRECATED) Updates Management Hub. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/storage/management-hub/update b/gcloud/alpha/storage/management-hub/update index 4ddb61208..b829d09e9 100644 --- a/gcloud/alpha/storage/management-hub/update +++ b/gcloud/alpha/storage/management-hub/update @@ -14,8 +14,10 @@ SYNOPSIS | --include-locations=[INCLUDE_LOCATIONS,...]) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update management hub plan for the organization, sub-folder or - project. + (ALPHA) (DEPRECATED) This command group is deprecated. Use gcloud alpha + storage intelligence-configs command group instead. + + Update management hub plan for the organization, sub-folder or project. EXAMPLES To limit buckets in the management hub plan, Use the following command with diff --git a/gcloud/alpha/storage/restore b/gcloud/alpha/storage/restore index 15ab29ab3..206052c41 100644 --- a/gcloud/alpha/storage/restore +++ b/gcloud/alpha/storage/restore @@ -21,73 +21,72 @@ EXAMPLES $ gcloud alpha storage restore gs://bucket#123 - Restore several soft-deleted buckets with generations: + Restore several soft-deleted buckets with generations: $ gcloud alpha storage restore gs://bucket1#123 gs://bucket2#456 - Restore latest soft-deleted version of object in a bucket. + Restore latest soft-deleted version of object in a bucket. $ gcloud alpha storage restore gs://bucket/file1.txt - Restore a specific soft-deleted version of object in a bucket by specifying the generation. + Restore a specific soft-deleted version of object in a bucket by specifying + the generation. $ gcloud alpha storage restore gs://bucket/file1.txt#123 - Restore all soft-deleted versions of object in a bucket. + Restore all soft-deleted versions of object in a bucket. $ gcloud alpha storage restore gs://bucket/file1.txt --all-versions - Restore several objects in a bucket (with or without generation): + Restore several objects in a bucket (with or without generation): $ gcloud alpha storage restore gs://bucket/file1.txt \ - gs://bucket/file2.txt#456 + gs://bucket/file2.txt#456 - Restore the latest soft-deleted version of all text objects in a bucket: + Restore the latest soft-deleted version of all text objects in a bucket: $ gcloud alpha storage restore gs://bucket/**.txt - Restore a list of objects read from stdin (with or without generation): + Restore a list of objects read from stdin (with or without generation): $ cat list-of-files.txt | gcloud alpha storage restore \ - --read-paths-from-stdin + --read-paths-from-stdin - Restore object with its original ACL policy: + Restore object with its original ACL policy: $ gcloud alpha storage restore gs://bucket/file1.txt --preserve-acl - Restore all objects in a bucket asynchronously: + Restore all objects in a bucket asynchronously: $ gcloud alpha storage restore gs://bucket/** --async - Restore all text files in a bucket asynchronously: + Restore all text files in a bucket asynchronously: $ gcloud alpha storage restore gs://bucket/**.txt --async - Restore objects created within a specific time range: + Restore objects created within a specific time range: $ gcloud alpha storage restore gs://bucket/** --async \ - --created-after-time="2023-01-01T00:00:00Z" \ - --created-before-time="2023-01-31T23:59:59Z" + --created-after-time="2023-01-01T00:00:00Z" \ + --created-before-time="2023-01-31T23:59:59Z" - Restore objects soft-deleted within a specific time range: + Restore objects soft-deleted within a specific time range: $ gcloud alpha storage restore gs://bucket/** --async \ - --deleted-after-time="2023-01-01T00:00:00Z" \ - --deleted-before-time="2023-01-31T23:59:59Z" + --deleted-after-time="2023-01-01T00:00:00Z" \ + --deleted-before-time="2023-01-31T23:59:59Z" - Restore objects using a combination of creation and deletion time filters: + Restore objects using a combination of creation and deletion time filters: $ gcloud alpha storage restore gs://bucket/** --async \ - --allow-overwrite --created-after-time="2023-01-01T00:00:00Z" \ - --deleted-after-time="2023-01-01T00:00:00Z" + --allow-overwrite --created-after-time="2023-01-01T00:00:00Z" \ + --deleted-after-time="2023-01-01T00:00:00Z" - This command filters the objects that were live at 2023-01-01T00:00:00Z - and then soft-deleted afterwards. - - This combination of filters is especially helpful if there is a period of - erroneous overwrites. They allow you to go back to the point just before - the overwrites began. You will also need to set the --allow-overwrite - option to true. + This command filters the objects that were live at 2023-01-01T00:00:00Z and + then soft-deleted afterwards. This combination of filters is especially + helpful if there is a period of erroneous overwrites. They allow you to go + back to the point just before the overwrites began. You will also need to + set the --allow-overwrite option to true. POSITIONAL ARGUMENTS [URLS ...] diff --git a/gcloud/backup-dr/help b/gcloud/backup-dr/help index f164a33f4..d541f698b 100644 --- a/gcloud/backup-dr/help +++ b/gcloud/backup-dr/help @@ -45,6 +45,9 @@ GROUPS operations Manage Backup and DR operations. + service-config + Manage Backup and DR Service configuration. + NOTES These variants are also available: diff --git a/gcloud/backup-dr/service-config/help b/gcloud/backup-dr/service-config/help new file mode 100644 index 000000000..cd436d899 --- /dev/null +++ b/gcloud/backup-dr/service-config/help @@ -0,0 +1,26 @@ +NAME + gcloud backup-dr service-config - manage Backup and DR Service + configuration + +SYNOPSIS + gcloud backup-dr service-config COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Backup and DR Service configuration. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + init + Initialize a Backup and DR Service configuration. + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr service-config + diff --git a/gcloud/backup-dr/service-config/init b/gcloud/backup-dr/service-config/init new file mode 100644 index 000000000..4986e385b --- /dev/null +++ b/gcloud/backup-dr/service-config/init @@ -0,0 +1,66 @@ +NAME + gcloud backup-dr service-config init - initialize a Backup and DR Service + configuration + +SYNOPSIS + gcloud backup-dr service-config init --location=LOCATION + --resource-type=RESOURCE_TYPE [--no-async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Initialize a Backup and DR Service configuration. + +EXAMPLES + To initialize a new service configuration in location MY_LOCATION and + project MY_PROJECT for resource type MY_RESOURCE_TYPE, run: + + $ gcloud backup-dr service-config init --project=MY_PROJECT \ + --location=MY_LOCATION --resource-type=MY_RESOURCE_TYPE + +REQUIRED FLAGS + Location resource - The location for which the service configuration + should be created. 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + --resource-type=RESOURCE_TYPE + The resource type to which the default service configuration will be + applied. Examples include, "compute..com/Instance" + +OPTIONAL FLAGS + --no-async + Wait for the operation in progress to complete. + +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 backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +BRIEF + Initializes a Backup and DR Service configuration. + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr service-config init + diff --git a/gcloud/beta/bigtable/materialized-views/update b/gcloud/beta/bigtable/materialized-views/update index 09fe64bc3..840c7c453 100644 --- a/gcloud/beta/bigtable/materialized-views/update +++ b/gcloud/beta/bigtable/materialized-views/update @@ -12,9 +12,11 @@ DESCRIPTION (BETA) Update a Bigtable materialized view. EXAMPLES - To update a materialized view, run: $ gcloud beta bigtable materialized-views update \ + To update a materialized view, run: + + $ gcloud beta bigtable materialized-views update \ my-materialized-view-id --instance=my-instance-id \ - --deletion-protection=true" + --deletion-protection=true POSITIONAL ARGUMENTS Materialized view resource - The materialized view to update. The diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index c2eb15828..0d935731d 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -845,8 +845,8 @@ FLAGS run. PROVISIONING_MODEL must be one of: FLEX_START - Instance is provisioned using the Flex Start provisioning model and - has a limited runtime. + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/beta/compute/instance-templates/create-with-container b/gcloud/beta/compute/instance-templates/create-with-container index e21913365..6849ceda9 100644 --- a/gcloud/beta/compute/instance-templates/create-with-container +++ b/gcloud/beta/compute/instance-templates/create-with-container @@ -695,8 +695,8 @@ FLAGS run. PROVISIONING_MODEL must be one of: FLEX_START - Instance is provisioned using the Flex Start provisioning model and - has a limited runtime. + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index e2f93f7d8..907b591bb 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -51,6 +51,7 @@ SYNOPSIS [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--private-network-ip=PRIVATE_NETWORK_IP] [--provisioning-model=PROVISIONING_MODEL] + [--request-valid-for-duration=REQUEST_VALID_FOR_DURATION] [--no-require-csek-key-create] [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] @@ -922,6 +923,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you @@ -935,6 +939,17 @@ FLAGS The default option. The STANDARD provisioning model gives you full control over your VM instances' runtime. + --request-valid-for-duration=REQUEST_VALID_FOR_DURATION + When you create an instance by using the FLEX_START provisioning model, + you can specify the duration to wait for available resources. If the + instance creation request is still pending after this duration, then + the request fails. You specify a duration by using numbers followed by + h, m, and s for hours, minutes, and seconds, respectively. For example, + specify 30m for a duration of 30 minutes, or 1h2m3s for 1 hour, 2 + minutes, and 3 seconds. Longer durations give you higher chances that + your instance creation request succeeds when resources are in high + demand. + --require-csek-key-create Refuse to create resources not protected by a user managed key in the key file when --csek-key-file is given. This behavior is enabled by diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index 7b42e6fc6..b94fc6da1 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -52,6 +52,7 @@ SYNOPSIS [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--private-network-ip=PRIVATE_NETWORK_IP] [--provisioning-model=PROVISIONING_MODEL] + [--request-valid-for-duration=REQUEST_VALID_FOR_DURATION] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] @@ -807,6 +808,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you @@ -820,6 +824,17 @@ FLAGS The default option. The STANDARD provisioning model gives you full control over your VM instances' runtime. + --request-valid-for-duration=REQUEST_VALID_FOR_DURATION + When you create an instance by using the FLEX_START provisioning model, + you can specify the duration to wait for available resources. If the + instance creation request is still pending after this duration, then + the request fails. You specify a duration by using numbers followed by + h, m, and s for hours, minutes, and seconds, respectively. For example, + specify 30m for a duration of 30 minutes, or 1h2m3s for 1 hour, 2 + minutes, and 3 seconds. Longer durations give you higher chances that + your instance creation request succeeds when resources are in high + demand. + --resource-policies=[RESOURCE_POLICY,...] A list of resource policy names to be added to the instance. The policies must exist in the same region as the instance. diff --git a/gcloud/beta/compute/interconnects/create b/gcloud/beta/compute/interconnects/create index 13d654cb5..c3863f6b1 100644 --- a/gcloud/beta/compute/interconnects/create +++ b/gcloud/beta/compute/interconnects/create @@ -9,7 +9,8 @@ SYNOPSIS [--admin-enabled] [--customer-name=CUSTOMER_NAME] [--description=DESCRIPTION] [--noc-contact-email=NOC_CONTACT_EMAIL] [--remote-location=REMOTE_LOCATION] - [--requested-features=[FEATURES,...]] [GCLOUD_WIDE_FLAG ...] + [--requested-features=[FEATURES,...]] [--subzone=SUBZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute interconnects create is used to create @@ -118,6 +119,15 @@ OPTIONAL FLAGS only be provided during interconnect INSERT and cannot be changed using interconnect PATCH. + --subzone=SUBZONE + Subzone in the LOCATION specified by the --location flag. SUBZONE must + be one of: + + a + Subzone a. + b + Subzone b. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index f90a59569..39e84b2de 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -1393,6 +1393,10 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1635,6 +1639,46 @@ FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the node's + boot disk + ephemeralLocalSsdProfile specify swap on the local + SSD shared with pod + ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. @@ -1715,8 +1759,11 @@ FLAGS disable simultaneous multithreading (SMT) set this to 1. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --workload-metadata=WORKLOAD_METADATA Type of metadata server available to pods running in the node pool. diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index 386142039..1d0ef9913 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -508,8 +508,11 @@ FLAGS Cannot be used with the "--create-subnetwork" option. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --workload-policies=WORKLOAD_POLICIES Add Autopilot workload policies to the cluster. diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 1333884ae..d4c125511 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -770,8 +770,11 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/ip-rotation. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --update-addons=[ADDON=ENABLED|DISABLED,...] Cluster addons to enable or disable. Options are diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index b2fb1d605..634d76d6d 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -776,6 +776,10 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1018,6 +1022,46 @@ FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the node's + boot disk + ephemeralLocalSsdProfile specify swap on the local + SSD shared with pod + ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index 96ed67705..b90c603fd 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -306,6 +306,10 @@ REQUIRED FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -563,6 +567,46 @@ REQUIRED FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the + node's boot disk + ephemeralLocalSsdProfile specify swap on the + local SSD shared with + pod ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. diff --git a/gcloud/beta/kms/decapsulate b/gcloud/beta/kms/decapsulate new file mode 100644 index 000000000..e1a52265f --- /dev/null +++ b/gcloud/beta/kms/decapsulate @@ -0,0 +1,68 @@ +NAME + gcloud beta kms decapsulate - decapsulate an input file using a + key-encapsulation key version + +SYNOPSIS + gcloud beta kms decapsulate --ciphertext-file=CIPHERTEXT_FILE + --shared-secret-file=SHARED_SECRET_FILE [--key=KEY] [--keyring=KEYRING] + [--location=LOCATION] [--skip-integrity-verification] + [--version=VERSION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Decapsulates the given ciphertext file using the provided + key-encapsulation key version and saves the decapsulated shared secret to + the shared secret file. + + By default, the command performs integrity verification on data sent to and + received from Cloud KMS. Use --skip-integrity-verification to disable + integrity verification. + +EXAMPLES + The following command will read the file '/tmp/my/secret.file.enc', + decapsulate it using the key encapsulation CryptoKey my-key Version 3 and + write the shared secret to '/tmp/my/secret.file.dec'. + + $ gcloud beta kms decapsulate --location=us-central1 \ + --keyring=my-keyring --key=my-key --version=3 \ + --ciphertext-file=/tmp/my/secret.file.enc \ + --shared-secret-file=/tmp/my/secret.file.dec + +REQUIRED FLAGS + --ciphertext-file=CIPHERTEXT_FILE + File path of the ciphertext file to decapsulate. + + --shared-secret-file=SHARED_SECRET_FILE + File path of the shared secret file to output. + +OPTIONAL FLAGS + --key=KEY + to use for decapsulation. + + --keyring=KEYRING + Key ring of the key. + + --location=LOCATION + Location of the keyring. + + --skip-integrity-verification + Skip integrity verification on request and response API fields. + + --version=VERSION + Version to use for decapsulation. + +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. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud kms decapsulate + + $ gcloud alpha kms decapsulate + diff --git a/gcloud/beta/kms/help b/gcloud/beta/kms/help index dbfdaeec8..f9c8f456d 100644 --- a/gcloud/beta/kms/help +++ b/gcloud/beta/kms/help @@ -65,6 +65,9 @@ COMMANDS asymmetric-sign (BETA) Sign a user input file using an asymmetric-signing key version. + decapsulate + (BETA) Decapsulate an input file using a key-encapsulation key version. + decrypt (BETA) Decrypt a ciphertext file using a Cloud KMS key. diff --git a/gcloud/beta/kms/keys/create b/gcloud/beta/kms/keys/create index 924ebb7f6..2f0e8b2ed 100644 --- a/gcloud/beta/kms/keys/create +++ b/gcloud/beta/kms/keys/create @@ -171,8 +171,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --purpose=PURPOSE The "purpose" of the key. PURPOSE must be one of: - asymmetric-encryption, asymmetric-signing, encryption, mac, - raw-encryption. + asymmetric-encryption, asymmetric-signing, encryption, + key-encapsulation, mac, raw-encryption. OPTIONAL FLAGS --allowed-access-reasons=[ALLOWED_ACCESS_REASONS,...] @@ -204,18 +204,18 @@ OPTIONAL FLAGS aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, external-symmetric-encryption, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --destroy-scheduled-duration=DESTROY_SCHEDULED_DURATION The amount of time that versions of the key should spend in the diff --git a/gcloud/beta/kms/keys/update b/gcloud/beta/kms/keys/update index 33936e115..82fb4f2a0 100644 --- a/gcloud/beta/kms/keys/update +++ b/gcloud/beta/kms/keys/update @@ -175,18 +175,18 @@ FLAGS aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, external-symmetric-encryption, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --next-rotation-time=NEXT_ROTATION_TIME Next automatic rotation time of the key. See $ gcloud topic datetimes diff --git a/gcloud/beta/kms/keys/versions/get-public-key b/gcloud/beta/kms/keys/versions/get-public-key index 8826c2506..ca1f6e7af 100644 --- a/gcloud/beta/kms/keys/versions/get-public-key +++ b/gcloud/beta/kms/keys/versions/get-public-key @@ -15,11 +15,13 @@ DESCRIPTION If not specified, the public key will be printed to stdout. The optional flag public-key-format indicates the format in which the - public key will be returned. For the PQC algorithms, this must be specified - and set to nist-pqc. For all other algorithms, this flag is optional and - defaults to pem. See "Retrieve a public key" in the Cloud KMS documentation - (https://cloud.google.com/kms/docs/retrieve-public-key) for more - information about the supported formats. + public key will be returned. For the NIST PQC algorithms, this must be + specified and set to nist-pqc. For kem-xwing this must be specified and set + to xwing-raw-bytes. For all other algorithms, this flag is optional and can + be either pem or der; the default value is pem. See "Retrieve a public key" + in the Cloud KMS documentation + (https://cloud.google.com/kms/help/get-public-key) for more information + about the supported formats. EXAMPLES The following command saves the public key for CryptoKey frodo Version 2 to diff --git a/gcloud/beta/kms/keys/versions/import b/gcloud/beta/kms/keys/versions/import index 1637db9f0..a2ed24e95 100644 --- a/gcloud/beta/kms/keys/versions/import +++ b/gcloud/beta/kms/keys/versions/import @@ -34,18 +34,18 @@ REQUIRED FLAGS aes-128-cbc, aes-128-ctr, aes-128-gcm, aes-256-cbc, aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --import-job=IMPORT_JOB Name of the import job to import from. diff --git a/gcloud/beta/recommender/insights/help b/gcloud/beta/recommender/insights/help index fedde6342..a70d22499 100644 --- a/gcloud/beta/recommender/insights/help +++ b/gcloud/beta/recommender/insights/help @@ -19,7 +19,7 @@ COMMANDS (BETA) Describe an insight. list - (BETA) List insights for a Google Cloud entity. + (BETA) List insights for Google Cloud resources. mark-accepted (BETA) Mark an insight's state as ACCEPTED. diff --git a/gcloud/beta/recommender/insights/list b/gcloud/beta/recommender/insights/list index cb4dbc30a..c8ccd6cb8 100644 --- a/gcloud/beta/recommender/insights/list +++ b/gcloud/beta/recommender/insights/list @@ -1,23 +1,23 @@ NAME - gcloud beta recommender insights list - list insights for a Google Cloud - entity + gcloud beta recommender insights list - list insights for Google Cloud + resources SYNOPSIS gcloud beta recommender insights list (--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID) - [--insight-type=INSIGHT_TYPE] [--location=LOCATION] + [--insight-type=INSIGHT_TYPE] [--location=LOCATION] [--[no-]recursive] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This command lists all insights for a given Google Cloud entity, - location, and insight type. If insight-type or location is not specified, - insights for all supported insight-types and locations are listed. - Supported insight-types can be found here: - https://cloud.google.com/recommender/docs/insights/insight-types. The - following Google Cloud entity types are supported: project, - billing_account, folder, and organization. + (BETA) This command lists all insights for the specified Google Cloud + resource, location, and insight type. If an insight type or location is not + specified, insights for all supported insight types or locations, + respectively, are listed. If the --recursive flag is set, insights for + child resources and projects are also listed. Supported insight types can + be found here: + https://cloud.google.com/recommender/docs/insights/insight-types. EXAMPLES To list all insights for a billing account: @@ -48,12 +48,33 @@ REQUIRED FLAGS FLAGS --insight-type=INSIGHT_TYPE - Insight type to list insights for. Supported insight-types can be found - here: https://cloud.google.com/recommender/docs/insights/insight-types + Insight type to list insights for. If no insight type is specified, + insights for all supported insight types are listed. Supported insight + types can be found here: + https://cloud.google.com/recommender/docs/insights/insight-types Not + specifying an insight-type can add a minute to the runtime. --location=LOCATION Location to list insights for. If no location is specified, insights - for all supported locations are listed. + for all supported locations are listed. Not specifying a location can + add 15-20 seconds to the runtime. + + --[no-]recursive + In addition to listing the insights for the specified organization or + folder, recursively list all of the insights for the resource's child + resources, including their descendants (for example, a folder's + sub-folders), and for the resource's child projects. For example, when + using the --recursive flag and specifying an organization, the response + lists all of the insights associated with that organization, all of the + insights associated with that organization's folders and sub-folders, + and all of the insights associated with that organization's child + projects. The maximum number of resources (organization, folders, + projects, and descendant resources) that can be accessed at once with + the --recursive flag is 100. For a larger number of nested resources, + use BigQuery export + (https://cloud.google.com/recommender/docs/bq-export/export-recommendations-to-bq). + Using --recursive can add 15-20 seconds per resource to the runtime. + Use --recursive to enable and --no-recursive to disable. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/recommender/recommendations/help b/gcloud/beta/recommender/recommendations/help index 683959eb2..8df12b28a 100644 --- a/gcloud/beta/recommender/recommendations/help +++ b/gcloud/beta/recommender/recommendations/help @@ -20,7 +20,7 @@ COMMANDS (BETA) Describe a recommendation for a Cloud project. list - (BETA) List operations for a recommendation. + (BETA) List recommendations for Google Cloud resources. mark-claimed (BETA) Mark a recommendation's state as CLAIMED. diff --git a/gcloud/beta/recommender/recommendations/list b/gcloud/beta/recommender/recommendations/list index e42c18e4f..c4b481073 100644 --- a/gcloud/beta/recommender/recommendations/list +++ b/gcloud/beta/recommender/recommendations/list @@ -1,23 +1,22 @@ NAME - gcloud beta recommender recommendations list - list operations for a - recommendation + gcloud beta recommender recommendations list - list recommendations for + Google Cloud resources SYNOPSIS gcloud beta recommender recommendations list (--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID | --organization=ORGANIZATION_ID | --project=PROJECT_ID) - [--location=LOCATION] [--recommender=RECOMMENDER] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + [--location=LOCATION] [--recommender=RECOMMENDER] [--[no-]recursive] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) This command lists all recommendations for a given Google Cloud - entity ID, location, and recommender. If recommender or location is not - specified, recommendations for all supported recommenders and locations are - listed. Supported recommenders can be found here: - https://cloud.google.com/recommender/docs/recommenders. The following - Google Cloud entity types are supported: project, billing_account, folder - and organization. + (BETA) This command lists all recommendations for the specified Google + Cloud resource, location, and recommender. If a recommender or location is + not specified, recommendations for all supported recommenders or locations, + respectively, are listed. If the --recursive flag is set, recommendations + for child resources and projects are also listed. Supported recommenders + can be found here: https://cloud.google.com/recommender/docs/recommenders. EXAMPLES Lists recommendations for a Cloud project. $ gcloud beta recommender recommendations list \ @@ -48,13 +47,33 @@ REQUIRED FLAGS FLAGS --location=LOCATION Location to list recommendations for. If no location is specified, - recommendations for all supported locations are listed. + recommendations for all supported locations are listed. Not specifying + a location can add 15-20 seconds to the runtime. --recommender=RECOMMENDER Recommender to list recommendations for. If no recommender is specified, recommendations for all supported recommenders are listed. Supported recommenders can be found here: - https://cloud.google.com/recommender/docs/recommenders + https://cloud.google.com/recommender/docs/recommenders Not specifying a + recommender can add 15-20 seconds to the runtime. + + --[no-]recursive + In addition to listing the recommendations for the specified + organization or folder, recursively list all of the recommendations for + the resource's child resources, including their descendants (for + example, a folder's sub-folders), and for the resource's child + projects. For example, when using the --recursive flag and specifying + an organization, the response lists all of the recommendations + associated with that organization, all of the recommendations + associated with that organization's folders and sub-folders, and all of + the recommendations associated with that organization's child projects. + The maximum number of resources (organization, folders, projects, and + descendant resources) that can be accessed at once with the --recursive + flag is 100. For a larger number of nested resources, use BigQuery + export + (https://cloud.google.com/recommender/docs/bq-export/export-recommendations-to-bq). + Using --recursive can add 15-20 seconds per resource to the runtime. + Use --recursive to enable and --no-recursive to disable. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/resource-manager/tags/values/create b/gcloud/beta/resource-manager/tags/values/create index ba9307772..0c7955a71 100644 --- a/gcloud/beta/resource-manager/tags/values/create +++ b/gcloud/beta/resource-manager/tags/values/create @@ -10,8 +10,8 @@ SYNOPSIS DESCRIPTION (BETA) Creates a TagValue resource given the short_name and description (optional) as well as the parent, the of the TagValue. The parent of the - TagValue is always a TagKey and the TagKey's details can be passed as a - numeric id or the namespaced name. + TagValue can be a TagKey and TagValue the parent's details can be passed as + a numeric id or the namespaced name. EXAMPLES To create a TagValue with the short name 'test' and the description diff --git a/gcloud/beta/saas-runtime/rollout-kinds/help b/gcloud/beta/saas-runtime/rollout-kinds/help index f5d48b7d5..ef0f298d8 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/help +++ b/gcloud/beta/saas-runtime/rollout-kinds/help @@ -28,7 +28,7 @@ COMMANDS (BETA) List Rollout Kinds. update - (BETA) Update a Rollout Type. + (BETA) Update a Rollout Kind. NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollout-kinds/update b/gcloud/beta/saas-runtime/rollout-kinds/update index bafad806b..3cf9d1b18 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/update +++ b/gcloud/beta/saas-runtime/rollout-kinds/update @@ -1,5 +1,5 @@ NAME - gcloud beta saas-runtime rollout-kinds update - update a Rollout Type + gcloud beta saas-runtime rollout-kinds update - update a Rollout Kind SYNOPSIS gcloud beta saas-runtime rollout-kinds update @@ -15,10 +15,10 @@ SYNOPSIS | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a Rollout Type + (BETA) Update a Rollout Kind EXAMPLES - To update the Rollout Type, run: + To update the Rollout Kind, run: $ gcloud beta saas-runtime rollout-kinds update diff --git a/gcloud/beta/spanner/instances/create b/gcloud/beta/spanner/instances/create index 3e3831781..6a0796dce 100644 --- a/gcloud/beta/spanner/instances/create +++ b/gcloud/beta/spanner/instances/create @@ -8,11 +8,13 @@ SYNOPSIS [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS - | [--autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS) : --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], + | [--autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS) : --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING], + [disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING], + [high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], [location=LOCATION],[max_nodes=MAX_NODES], - [max_processing_units=MAX_PROCESSING_UNITS], - [min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS]]] - [GCLOUD_WIDE_FLAG ...] + [max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES], + [min_processing_units=MIN_PROCESSING_UNITS], + [total_cpu_target=TOTAL_CPU_TARGET]]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a Cloud Spanner instance. @@ -119,8 +121,8 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS] - Specify the asymmetric autoscaling option for the instance. + --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING],[disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING],[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS],[total_cpu_target=TOTAL_CPU_TARGET] + Specifies the asymmetric autoscaling option for the instance. Autoscaling limits can be defined in either nodes or processing units. diff --git a/gcloud/beta/spanner/instances/update b/gcloud/beta/spanner/instances/update index cceb342f5..1a6cdbbe0 100644 --- a/gcloud/beta/spanner/instances/update +++ b/gcloud/beta/spanner/instances/update @@ -7,10 +7,13 @@ SYNOPSIS [--description=DESCRIPTION] [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS - | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING], + [disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING], + [high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], [location=LOCATION],[max_nodes=MAX_NODES], - [max_processing_units=MAX_PROCESSING_UNITS], - [min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS] + [max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES], + [min_processing_units=MIN_PROCESSING_UNITS], + [total_cpu_target=TOTAL_CPU_TARGET] | --clear-asymmetric-autoscaling-option=LOCATION,[LOCATION,...] --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES @@ -113,8 +116,8 @@ FLAGS At most one of these can be specified: - --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS] - Specify the asymmetric autoscaling option for the instance. + --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING],[disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING],[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS],[total_cpu_target=TOTAL_CPU_TARGET] + Specifies the asymmetric autoscaling option for the instance. --clear-asymmetric-autoscaling-option=LOCATION,[LOCATION,...] Specify a comma separated list of locations from which to remove diff --git a/gcloud/beta/sql/instances/clone b/gcloud/beta/sql/instances/clone index f6b23c3a7..c663fce67 100644 --- a/gcloud/beta/sql/instances/clone +++ b/gcloud/beta/sql/instances/clone @@ -5,6 +5,7 @@ SYNOPSIS gcloud beta sql instances clone SOURCE DESTINATION [--async] [--preferred-secondary-zone=PREFERRED_SECONDARY_ZONE] [--preferred-zone=PREFERRED_ZONE] + [--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME] [--bin-log-file-name=BIN_LOG_FILE_NAME --bin-log-position=BIN_LOG_POSITION | [--point-in-time=POINT_IN_TIME : --restore-database-name=RESTORE_DATABASE_NAME]] @@ -88,6 +89,10 @@ FLAGS this flag, then the destination instance uses the value as the primary zone. + --source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME + The time the source instance was deleted. This is required if cloning + from a deleted instance. + At most one of these can be specified: Binary log coordinates for point-in-time recovery. diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 070c916fe..9266c254a 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -454,11 +454,11 @@ FLAGS 0 to 100. --psc-auto-connections=[network=NETWORK],[project=PROJECT] - A comma-separated list of networks or a comma-separated list of - network-project pairs. Each project in this list is represented by a - project number (numeric) or by a project ID (alphanumeric). This allows - Private Service Connect connections to be created automatically for the - specified networks. For example, this connection uses "the form + A comma-separated list of networks or network-project pairs. Each + project is represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + created automatically for the specified networks. For example, this + connection uses "the form psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" or "the form psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". diff --git a/gcloud/beta/sql/instances/get-latest-recovery-time b/gcloud/beta/sql/instances/get-latest-recovery-time index 206c4c3bd..abfc534fb 100644 --- a/gcloud/beta/sql/instances/get-latest-recovery-time +++ b/gcloud/beta/sql/instances/get-latest-recovery-time @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta sql instances get-latest-recovery-time INSTANCE + [--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -25,6 +26,11 @@ POSITIONAL ARGUMENTS INSTANCE Cloud SQL instance ID. +FLAGS + --source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME + The deletion time of the source instance. This is used to identify the + instance if it has been deleted. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index b4c235f4d..8bb9e87a7 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -634,17 +634,16 @@ FLAGS At most one of these can be specified: --clear-psc-auto-connections - This removes all connections created automatically. Cloud SQL uses + This removes all automatically created connections. Cloud SQL uses these connections to connect to an instance using Private Service Connect. --psc-auto-connections=[network=NETWORK],[project=PROJECT] - A comma-separated list of networks or a comma-separated list of - network-project pairs. Each project in this list is represented by a - project number (numeric) or by a project ID (alphanumeric). This - allows Private Service Connect connections to be created - automatically for the specified networks. For example, this - connection uses "the form + A comma-separated list of networks or network-project pairs. Each + project is represented by a project number (numeric) or by a project + ID (alphanumeric). This allows Private Service Connect connections to + be created automatically for the specified networks. For example, + this connection uses "the form psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" or "the form psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". diff --git a/gcloud/bigtable/materialized-views/update b/gcloud/bigtable/materialized-views/update index 502853396..c3b7b8d01 100644 --- a/gcloud/bigtable/materialized-views/update +++ b/gcloud/bigtable/materialized-views/update @@ -12,9 +12,11 @@ DESCRIPTION Update a Bigtable materialized view. EXAMPLES - To update a materialized view, run: $ gcloud bigtable materialized-views update \ + To update a materialized view, run: + + $ gcloud bigtable materialized-views update \ my-materialized-view-id --instance=my-instance-id \ - --deletion-protection=true" + --deletion-protection=true POSITIONAL ARGUMENTS Materialized view resource - The materialized view to update. The diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index d348adda9..e7dab2ac2 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -754,6 +754,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 42ea2fbb6..ddcec5daa 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -47,6 +47,7 @@ SYNOPSIS [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--private-network-ip=PRIVATE_NETWORK_IP] [--provisioning-model=PROVISIONING_MODEL] + [--request-valid-for-duration=REQUEST_VALID_FOR_DURATION] [--no-require-csek-key-create] [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] @@ -855,6 +856,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you @@ -868,6 +872,17 @@ FLAGS The default option. The STANDARD provisioning model gives you full control over your VM instances' runtime. + --request-valid-for-duration=REQUEST_VALID_FOR_DURATION + When you create an instance by using the FLEX_START provisioning model, + you can specify the duration to wait for available resources. If the + instance creation request is still pending after this duration, then + the request fails. You specify a duration by using numbers followed by + h, m, and s for hours, minutes, and seconds, respectively. For example, + specify 30m for a duration of 30 minutes, or 1h2m3s for 1 hour, 2 + minutes, and 3 seconds. Longer durations give you higher chances that + your instance creation request succeeds when resources are in high + demand. + --require-csek-key-create Refuse to create resources not protected by a user managed key in the key file when --csek-key-file is given. This behavior is enabled by diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index f5ff7d28a..e6f2d8e7c 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -49,6 +49,7 @@ SYNOPSIS [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--private-network-ip=PRIVATE_NETWORK_IP] [--provisioning-model=PROVISIONING_MODEL] + [--request-valid-for-duration=REQUEST_VALID_FOR_DURATION] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] @@ -760,6 +761,9 @@ FLAGS affects the price, availability, and how long your VM instances can run. PROVISIONING_MODEL must be one of: + FLEX_START + The VM instance is provisioned using the Flex Start provisioning + model and has a limited runtime. RESERVATION_BOUND The VM instances run for the entire duration of their associated reservation. You can only specify this provisioning model if you @@ -773,6 +777,17 @@ FLAGS The default option. The STANDARD provisioning model gives you full control over your VM instances' runtime. + --request-valid-for-duration=REQUEST_VALID_FOR_DURATION + When you create an instance by using the FLEX_START provisioning model, + you can specify the duration to wait for available resources. If the + instance creation request is still pending after this duration, then + the request fails. You specify a duration by using numbers followed by + h, m, and s for hours, minutes, and seconds, respectively. For example, + specify 30m for a duration of 30 minutes, or 1h2m3s for 1 hour, 2 + minutes, and 3 seconds. Longer durations give you higher chances that + your instance creation request succeeds when resources are in high + demand. + --resource-policies=[RESOURCE_POLICY,...] A list of resource policy names to be added to the instance. The policies must exist in the same region as the instance. diff --git a/gcloud/compute/interconnects/create b/gcloud/compute/interconnects/create index 392cc14bf..049fd7164 100644 --- a/gcloud/compute/interconnects/create +++ b/gcloud/compute/interconnects/create @@ -8,7 +8,8 @@ SYNOPSIS [--admin-enabled] [--customer-name=CUSTOMER_NAME] [--description=DESCRIPTION] [--noc-contact-email=NOC_CONTACT_EMAIL] [--remote-location=REMOTE_LOCATION] - [--requested-features=[FEATURES,...]] [GCLOUD_WIDE_FLAG ...] + [--requested-features=[FEATURES,...]] [--subzone=SUBZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION gcloud compute interconnects create is used to create interconnects. An @@ -114,6 +115,15 @@ OPTIONAL FLAGS only be provided during interconnect INSERT and cannot be changed using interconnect PATCH. + --subzone=SUBZONE + Subzone in the LOCATION specified by the --location flag. SUBZONE must + be one of: + + a + Subzone a. + b + Subzone b. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/compute/tpus/queued-resources/create b/gcloud/compute/tpus/queued-resources/create index c1ac70f60..21cc4803a 100644 --- a/gcloud/compute/tpus/queued-resources/create +++ b/gcloud/compute/tpus/queued-resources/create @@ -7,9 +7,10 @@ SYNOPSIS (--accelerator-type=ACCELERATOR_TYPE | --topology=TOPOLOGY --type=TYPE) (--node-id=NODE_ID | [--node-count=NODE_COUNT : --node-prefix=NODE_PREFIX]) [--async] - [--data-disk=[mode=MODE],[source=SOURCE]] [--description=DESCRIPTION] - [--guaranteed] [--internal-ips] [--labels=[KEY=VALUE,...]] - [--metadata=[KEY=VALUE,...]] [--metadata-from-file=[KEY=VALUE,...]] + [--boot-disk=[KEY=VALUE,...]] [--data-disk=[mode=MODE],[source=SOURCE]] + [--description=DESCRIPTION] [--guaranteed] [--internal-ips] + [--labels=[KEY=VALUE,...]] [--metadata=[KEY=VALUE,...]] + [--metadata-from-file=[KEY=VALUE,...]] [--network=NETWORK; default="default"] [--range=RANGE] [--reserved] [--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT] [--shielded-secure-boot] [--spot] [--subnetwork=SUBNETWORK] @@ -138,6 +139,19 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --boot-disk=[KEY=VALUE,...] + Specifies the boot disk configuration. + + $ gcloud compute tpus queued-resources create \ + --boot-disk kms-key= + + The following keys are allowed: + + kms-key + Specifies the fully qualified Cloud KMS cryptokey name which will + be used to protect the disk. KMS cryptokey name format: + projects//locations//keyRings//cryptoKeys/ + --data-disk=[mode=MODE],[source=SOURCE] Additional data disks for the TPU VM. diff --git a/gcloud/compute/tpus/tpu-vm/create b/gcloud/compute/tpus/tpu-vm/create index 4d97b4ac0..44310dd93 100644 --- a/gcloud/compute/tpus/tpu-vm/create +++ b/gcloud/compute/tpus/tpu-vm/create @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud compute tpus tpu-vm create (TPU : --zone=ZONE) --version=VERSION - [--async] [--data-disk=[mode=MODE],[source=SOURCE]] - [--description=DESCRIPTION] [--internal-ips] [--labels=[KEY=VALUE,...]] + [--async] [--boot-disk=[KEY=VALUE,...]] + [--data-disk=[mode=MODE],[source=SOURCE]] [--description=DESCRIPTION] + [--internal-ips] [--labels=[KEY=VALUE,...]] [--metadata=[KEY=VALUE,...]] [--metadata-from-file=[KEY=VALUE,...]] [--network=NETWORK; default="default"] [--preemptible] [--queue-count=QUEUE_COUNT] [--range=RANGE] [--reserved] @@ -82,6 +83,19 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --boot-disk=[KEY=VALUE,...] + Specifies the boot disk configuration. + + $ gcloud compute tpus tpu-vm create \ + --boot-disk kms-key= + + The following keys are allowed: + + kms-key + Specifies the fully qualified Cloud KMS cryptokey name which will + be used to protect the disk. KMS cryptokey name format: + projects//locations//keyRings//cryptoKeys/ + --data-disk=[mode=MODE],[source=SOURCE] Additional data disks for the TPU VM. diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 7dbe452fe..026a37275 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -1337,6 +1337,10 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1579,6 +1583,46 @@ FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the node's + boot disk + ephemeralLocalSsdProfile specify swap on the local + SSD shared with pod + ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. @@ -1658,8 +1702,11 @@ FLAGS disable simultaneous multithreading (SMT) set this to 1. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --workload-metadata=WORKLOAD_METADATA Type of metadata server available to pods running in the node pool. diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index fdd663369..1e3755601 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -503,8 +503,11 @@ FLAGS Cannot be used with the "--create-subnetwork" option. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --workload-policies=WORKLOAD_POLICIES Add Autopilot workload policies to the cluster. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 48a4c4829..4913db23a 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -768,8 +768,11 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/how-to/ip-rotation. --tier=TIER - Set the desired tier for the cluster. TIER must be one of: standard, - enterprise. + (DEPRECATED) Set the desired tier for the cluster. + + The --tier flag is deprecated. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#September_02_2025. + TIER must be one of: standard, enterprise. --update-addons=[ADDON=ENABLED|DISABLED,...] Cluster addons to enable or disable. Options are diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index 4df2c84e8..e2a722925 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -764,6 +764,10 @@ FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -1006,6 +1010,46 @@ FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the node's + boot disk + ephemeralLocalSsdProfile specify swap on the local + SSD shared with pod + ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index 0a294c64d..af7e25555 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -306,6 +306,10 @@ REQUIRED FLAGS hugepageConfig: hugepage_size2m: '1024' hugepage_size1g: '2' + swapConfig: + enabled: true + bootDiskProfile: + swapSizeGib: 8 cgroupMode: 'CGROUP_MODE_V2' List of supported kubelet configs in 'kubeletConfig'. @@ -563,6 +567,46 @@ REQUIRED FLAGS hugepage_size2m Number of 2M huge pages, any positive integer hugepage_size1g Number of 1G huge pages, any positive integer + List of supported keys in 'swapConfig' under 'linuxConfig'. + + KEY VALUE + enabled boolean + encryptionConfig specify encryption + settings for the swap + space + bootDiskProfile specify swap on the + node's boot disk + ephemeralLocalSsdProfile specify swap on the + local SSD shared with + pod ephemeral storage + dedicatedLocalSsdProfile specify swap on a new, + separate local NVMe SSD + exclusively for swap + + List of supported keys in 'encryptionConfig' under 'swapConfig'. + + KEY VALUE + disabled boolean + + List of supported keys in 'bootDiskProfile' under 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'ephemeralLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + swapSizeGib integer + swapSizePercent integer + + List of supported keys in 'dedicatedLocalSsdProfile' under + 'swapConfig'. + + KEY VALUE + diskCount integer + Allocated hugepage size should not exceed 60% of available memory on the node. For example, c2d-highcpu-4 has 8GB memory, total allocated hugepage of 2m and 1g should not exceed 8GB * 0.6 = 4.8GB. diff --git a/gcloud/filestore/instances/create b/gcloud/filestore/instances/create index 569c325cf..fd410804d 100644 --- a/gcloud/filestore/instances/create +++ b/gcloud/filestore/instances/create @@ -6,8 +6,9 @@ SYNOPSIS --file-share=[capacity=CAPACITY],[name=NAME], [nfs-export-options=NFS-EXPORT-OPTIONS],[source-backup=SOURCE-BACKUP], [source-backup-region=SOURCE-BACKUP-REGION] - --network=[connect-mode=CONNECT-MODE], - [name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] [--async] + --network=[connect-mode=CONNECT-MODE],[name=NAME], + [psc-endpoint-project=PSC-ENDPOINT-PROJECT], + [reserved-ip-range=RESERVED-IP-RANGE] [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--location=LOCATION] [--performance=[max-iops=MAX-IOPS],[max-iops-per-tb=MAX-IOPS-PER-TB]] @@ -31,8 +32,9 @@ EXAMPLES --tier=TIER --protocol=PROTOCOL \ --file-share=name=VOLUME_NAME,capacity=CAPACITY \ --network=name=NETWORK_NAME,\ - reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE \ - --zone=ZONE --performance=max-iops-per-tb=MAX-IOPS-PER-TB \ + reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE,\ + psc-endpoint-project=PSC_ENDPOINT_PROJECT --zone=ZONE \ + --performance=max-iops-per-tb=MAX-IOPS-PER-TB \ --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING \ --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT \ --flags-file=FLAGS_FILE --source-instance=SOURCE_INSTANCE @@ -167,7 +169,7 @@ REQUIRED FLAGS source-backup-region The region of the source backup. - --network=[connect-mode=CONNECT-MODE],[name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] + --network=[connect-mode=CONNECT-MODE],[name=NAME],[psc-endpoint-project=PSC-ENDPOINT-PROJECT],[reserved-ip-range=RESERVED-IP-RANGE] Network configuration for a Cloud Filestore instance. Specifying reserved-ip-range and connect-mode is optional. name @@ -192,7 +194,13 @@ REQUIRED FLAGS network. connect-mode Network connection mode used by instances. CONNECT_MODE must be one - of: DIRECT_PEERING or PRIVATE_SERVICE_ACCESS. + of: DIRECT_PEERING, PRIVATE_SERVICE_ACCESS or + PRIVATE_SERVICE_CONNECT. + psc-endpoint-project + Consumer service project in which the psc endpoint would be set up. + This is optional, and only relevant in case the network is a shared + VPC. If this is not specified, the psc endpoint would be setup in + the VPC host project. OPTIONAL FLAGS --async diff --git a/gcloud/kms/decapsulate b/gcloud/kms/decapsulate new file mode 100644 index 000000000..cf75d9939 --- /dev/null +++ b/gcloud/kms/decapsulate @@ -0,0 +1,67 @@ +NAME + gcloud kms decapsulate - decapsulate an input file using a + key-encapsulation key version + +SYNOPSIS + gcloud kms decapsulate --ciphertext-file=CIPHERTEXT_FILE + --shared-secret-file=SHARED_SECRET_FILE [--key=KEY] [--keyring=KEYRING] + [--location=LOCATION] [--skip-integrity-verification] + [--version=VERSION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Decapsulates the given ciphertext file using the provided key-encapsulation + key version and saves the decapsulated shared secret to the shared secret + file. + + By default, the command performs integrity verification on data sent to and + received from Cloud KMS. Use --skip-integrity-verification to disable + integrity verification. + +EXAMPLES + The following command will read the file '/tmp/my/secret.file.enc', + decapsulate it using the key encapsulation CryptoKey my-key Version 3 and + write the shared secret to '/tmp/my/secret.file.dec'. + + $ gcloud kms decapsulate --location=us-central1 \ + --keyring=my-keyring --key=my-key --version=3 \ + --ciphertext-file=/tmp/my/secret.file.enc \ + --shared-secret-file=/tmp/my/secret.file.dec + +REQUIRED FLAGS + --ciphertext-file=CIPHERTEXT_FILE + File path of the ciphertext file to decapsulate. + + --shared-secret-file=SHARED_SECRET_FILE + File path of the shared secret file to output. + +OPTIONAL FLAGS + --key=KEY + to use for decapsulation. + + --keyring=KEYRING + Key ring of the key. + + --location=LOCATION + Location of the keyring. + + --skip-integrity-verification + Skip integrity verification on request and response API fields. + + --version=VERSION + Version to use for decapsulation. + +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. + +NOTES + These variants are also available: + + $ gcloud alpha kms decapsulate + + $ gcloud beta kms decapsulate + diff --git a/gcloud/kms/help b/gcloud/kms/help index 5fde805fd..afceb3fd1 100644 --- a/gcloud/kms/help +++ b/gcloud/kms/help @@ -64,6 +64,9 @@ COMMANDS asymmetric-sign Sign a user input file using an asymmetric-signing key version. + decapsulate + Decapsulate an input file using a key-encapsulation key version. + decrypt Decrypt a ciphertext file using a Cloud KMS key. diff --git a/gcloud/kms/keys/create b/gcloud/kms/keys/create index 05804e7bf..b44f4dcbe 100644 --- a/gcloud/kms/keys/create +++ b/gcloud/kms/keys/create @@ -171,8 +171,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --purpose=PURPOSE The "purpose" of the key. PURPOSE must be one of: - asymmetric-encryption, asymmetric-signing, encryption, mac, - raw-encryption. + asymmetric-encryption, asymmetric-signing, encryption, + key-encapsulation, mac, raw-encryption. OPTIONAL FLAGS --allowed-access-reasons=[ALLOWED_ACCESS_REASONS,...] @@ -204,18 +204,18 @@ OPTIONAL FLAGS aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, external-symmetric-encryption, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --destroy-scheduled-duration=DESTROY_SCHEDULED_DURATION The amount of time that versions of the key should spend in the diff --git a/gcloud/kms/keys/update b/gcloud/kms/keys/update index 832a02bee..ecc8d1bf3 100644 --- a/gcloud/kms/keys/update +++ b/gcloud/kms/keys/update @@ -175,18 +175,18 @@ FLAGS aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, external-symmetric-encryption, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --next-rotation-time=NEXT_ROTATION_TIME Next automatic rotation time of the key. See $ gcloud topic datetimes diff --git a/gcloud/kms/keys/versions/get-public-key b/gcloud/kms/keys/versions/get-public-key index 05b2ab130..8a102e2d2 100644 --- a/gcloud/kms/keys/versions/get-public-key +++ b/gcloud/kms/keys/versions/get-public-key @@ -15,11 +15,13 @@ DESCRIPTION If not specified, the public key will be printed to stdout. The optional flag public-key-format indicates the format in which the - public key will be returned. For the PQC algorithms, this must be specified - and set to nist-pqc. For all other algorithms, this flag is optional and - defaults to pem. See "Retrieve a public key" in the Cloud KMS documentation - (https://cloud.google.com/kms/docs/retrieve-public-key) for more - information about the supported formats. + public key will be returned. For the NIST PQC algorithms, this must be + specified and set to nist-pqc. For kem-xwing this must be specified and set + to xwing-raw-bytes. For all other algorithms, this flag is optional and can + be either pem or der; the default value is pem. See "Retrieve a public key" + in the Cloud KMS documentation + (https://cloud.google.com/kms/help/get-public-key) for more information + about the supported formats. EXAMPLES The following command saves the public key for CryptoKey frodo Version 2 to diff --git a/gcloud/kms/keys/versions/import b/gcloud/kms/keys/versions/import index 1dbdf6ff4..68ab52d27 100644 --- a/gcloud/kms/keys/versions/import +++ b/gcloud/kms/keys/versions/import @@ -34,18 +34,18 @@ REQUIRED FLAGS aes-128-cbc, aes-128-ctr, aes-128-gcm, aes-256-cbc, aes-256-ctr, aes-256-gcm, ec-sign-ed25519, ec-sign-p256-sha256, ec-sign-p384-sha384, ec-sign-secp256k1-sha256, google-symmetric-encryption, hmac-sha1, - hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, - pq-sign-hash-slh-dsa-sha2-128s-sha256, pq-sign-ml-dsa-65, - pq-sign-slh-dsa-sha2-128s, rsa-decrypt-oaep-2048-sha1, - rsa-decrypt-oaep-2048-sha256, rsa-decrypt-oaep-3072-sha1, - rsa-decrypt-oaep-3072-sha256, rsa-decrypt-oaep-4096-sha1, - rsa-decrypt-oaep-4096-sha256, rsa-decrypt-oaep-4096-sha512, - rsa-sign-pkcs1-2048-sha256, rsa-sign-pkcs1-3072-sha256, - rsa-sign-pkcs1-4096-sha256, rsa-sign-pkcs1-4096-sha512, - rsa-sign-pss-2048-sha256, rsa-sign-pss-3072-sha256, - rsa-sign-pss-4096-sha256, rsa-sign-pss-4096-sha512, - rsa-sign-raw-pkcs1-2048, rsa-sign-raw-pkcs1-3072, - rsa-sign-raw-pkcs1-4096. + hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, kem-xwing, + ml-kem-1024, ml-kem-768, pq-sign-hash-slh-dsa-sha2-128s-sha256, + pq-sign-ml-dsa-65, pq-sign-slh-dsa-sha2-128s, + rsa-decrypt-oaep-2048-sha1, rsa-decrypt-oaep-2048-sha256, + rsa-decrypt-oaep-3072-sha1, rsa-decrypt-oaep-3072-sha256, + rsa-decrypt-oaep-4096-sha1, rsa-decrypt-oaep-4096-sha256, + rsa-decrypt-oaep-4096-sha512, rsa-sign-pkcs1-2048-sha256, + rsa-sign-pkcs1-3072-sha256, rsa-sign-pkcs1-4096-sha256, + rsa-sign-pkcs1-4096-sha512, rsa-sign-pss-2048-sha256, + rsa-sign-pss-3072-sha256, rsa-sign-pss-4096-sha256, + rsa-sign-pss-4096-sha512, rsa-sign-raw-pkcs1-2048, + rsa-sign-raw-pkcs1-3072, rsa-sign-raw-pkcs1-4096. --import-job=IMPORT_JOB Name of the import job to import from. diff --git a/gcloud/spanner/instances/create b/gcloud/spanner/instances/create index bb569ff68..3c6967392 100644 --- a/gcloud/spanner/instances/create +++ b/gcloud/spanner/instances/create @@ -8,11 +8,13 @@ SYNOPSIS [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS - | [--autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS) : --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], + | [--autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET (--autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES | --autoscaling-max-processing-units=AUTOSCALING_MAX_PROCESSING_UNITS --autoscaling-min-processing-units=AUTOSCALING_MIN_PROCESSING_UNITS) : --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING], + [disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING], + [high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], [location=LOCATION],[max_nodes=MAX_NODES], - [max_processing_units=MAX_PROCESSING_UNITS], - [min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS]]] - [GCLOUD_WIDE_FLAG ...] + [max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES], + [min_processing_units=MIN_PROCESSING_UNITS], + [total_cpu_target=TOTAL_CPU_TARGET]]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Cloud Spanner instance. @@ -119,8 +121,8 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS] - Specify the asymmetric autoscaling option for the instance. + --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING],[disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING],[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS],[total_cpu_target=TOTAL_CPU_TARGET] + Specifies the asymmetric autoscaling option for the instance. Autoscaling limits can be defined in either nodes or processing units. diff --git a/gcloud/spanner/instances/update b/gcloud/spanner/instances/update index 8cf549522..390f0547f 100644 --- a/gcloud/spanner/instances/update +++ b/gcloud/spanner/instances/update @@ -7,10 +7,13 @@ SYNOPSIS [--description=DESCRIPTION] [--edition=EDITION] [--expire-behavior=EXPIRE_BEHAVIOR] [--instance-type=INSTANCE_TYPE] [--nodes=NODES | --processing-units=PROCESSING_UNITS - | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], + | --autoscaling-high-priority-cpu-target=AUTOSCALING_HIGH_PRIORITY_CPU_TARGET --autoscaling-storage-target=AUTOSCALING_STORAGE_TARGET --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING], + [disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING], + [high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET], [location=LOCATION],[max_nodes=MAX_NODES], - [max_processing_units=MAX_PROCESSING_UNITS], - [min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS] + [max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES], + [min_processing_units=MIN_PROCESSING_UNITS], + [total_cpu_target=TOTAL_CPU_TARGET] | --clear-asymmetric-autoscaling-option=LOCATION,[LOCATION,...] --autoscaling-max-nodes=AUTOSCALING_MAX_NODES --autoscaling-min-nodes=AUTOSCALING_MIN_NODES @@ -113,8 +116,8 @@ FLAGS At most one of these can be specified: - --asymmetric-autoscaling-option=[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS] - Specify the asymmetric autoscaling option for the instance. + --asymmetric-autoscaling-option=[disable_high_priority_cpu_autoscaling=DISABLE_HIGH_PRIORITY_CPU_AUTOSCALING],[disable_total_cpu_autoscaling=DISABLE_TOTAL_CPU_AUTOSCALING],[high_priority_cpu_target=HIGH_PRIORITY_CPU_TARGET],[location=LOCATION],[max_nodes=MAX_NODES],[max_processing_units=MAX_PROCESSING_UNITS],[min_nodes=MIN_NODES],[min_processing_units=MIN_PROCESSING_UNITS],[total_cpu_target=TOTAL_CPU_TARGET] + Specifies the asymmetric autoscaling option for the instance. --clear-asymmetric-autoscaling-option=LOCATION,[LOCATION,...] Specify a comma separated list of locations from which to remove diff --git a/gcloud/sql/instances/clone b/gcloud/sql/instances/clone index 48041c70e..bc77cec6a 100644 --- a/gcloud/sql/instances/clone +++ b/gcloud/sql/instances/clone @@ -5,6 +5,7 @@ SYNOPSIS gcloud sql instances clone SOURCE DESTINATION [--async] [--preferred-secondary-zone=PREFERRED_SECONDARY_ZONE] [--preferred-zone=PREFERRED_ZONE] + [--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME] [--bin-log-file-name=BIN_LOG_FILE_NAME --bin-log-position=BIN_LOG_POSITION | [--point-in-time=POINT_IN_TIME : --restore-database-name=RESTORE_DATABASE_NAME]] @@ -85,6 +86,10 @@ FLAGS this flag, then the destination instance uses the value as the primary zone. + --source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME + The time the source instance was deleted. This is required if cloning + from a deleted instance. + At most one of these can be specified: Binary log coordinates for point-in-time recovery. diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index e2f40486e..3cb3679f4 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -438,11 +438,11 @@ FLAGS 0 to 100. --psc-auto-connections=[network=NETWORK],[project=PROJECT] - A comma-separated list of networks or a comma-separated list of - network-project pairs. Each project in this list is represented by a - project number (numeric) or by a project ID (alphanumeric). This allows - Private Service Connect connections to be created automatically for the - specified networks. For example, this connection uses "the form + A comma-separated list of networks or network-project pairs. Each + project is represented by a project number (numeric) or by a project ID + (alphanumeric). This allows Private Service Connect connections to be + created automatically for the specified networks. For example, this + connection uses "the form psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" or "the form psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". diff --git a/gcloud/sql/instances/get-latest-recovery-time b/gcloud/sql/instances/get-latest-recovery-time index bfdfdd8b0..849b3d3a2 100644 --- a/gcloud/sql/instances/get-latest-recovery-time +++ b/gcloud/sql/instances/get-latest-recovery-time @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud sql instances get-latest-recovery-time INSTANCE + [--source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -25,6 +26,11 @@ POSITIONAL ARGUMENTS INSTANCE Cloud SQL instance ID. +FLAGS + --source-instance-deletion-time=SOURCE_INSTANCE_DELETION_TIME + The deletion time of the source instance. This is used to identify the + instance if it has been deleted. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 5b6b8d7bf..90f81001d 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -66,6 +66,8 @@ SYNOPSIS [--clear-custom-subject-alternative-names | --custom-subject-alternative-names=DNS,[DNS,[DNS]]] [--clear-database-flags | --database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--clear-psc-auto-connections + | --psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--clear-psc-network-attachment-uri | --psc-network-attachment-uri=PSC_NETWORK_ATTACHMENT_URI] [--gce-zone=GCE_ZONE | --secondary-zone=SECONDARY_ZONE --zone=ZONE] @@ -578,6 +580,42 @@ FLAGS Resource API for allowed flags. (e.g., --database-flags max_allowed_packet=55555,skip_grant_tables=,log_output=1) + At most one of these can be specified: + + --clear-psc-auto-connections + This removes all automatically created connections. Cloud SQL uses + these connections to connect to an instance using Private Service + Connect. + + --psc-auto-connections=[network=NETWORK],[project=PROJECT] + A comma-separated list of networks or network-project pairs. Each + project is represented by a project number (numeric) or by a project + ID (alphanumeric). This allows Private Service Connect connections to + be created automatically for the specified networks. For example, + this connection uses "the form + psc-auto-connections=network=projects/testproject1/global/networks/testnetwork1" + or "the form + psc-auto-connections=project=testproject1,network=projects/testproject1/global/networks/testnetwork1". + Sets psc_auto_connections value. + + network + Required, sets network value. + + project + Sets project value. + + Shorthand Example: + + --psc-auto-connections=network=string,project=string + + JSON Example: + + --psc-auto-connections='{"network": "string", "project": "string"}' + + File Example: + + --psc-auto-connections=path_to_file.(yaml|json) + At most one of these can be specified: --clear-psc-network-attachment-uri diff --git a/gcloud/storage/restore b/gcloud/storage/restore index 81e05b25e..894eb2a30 100644 --- a/gcloud/storage/restore +++ b/gcloud/storage/restore @@ -21,73 +21,72 @@ EXAMPLES $ gcloud storage restore gs://bucket#123 - Restore several soft-deleted buckets with generations: + Restore several soft-deleted buckets with generations: $ gcloud storage restore gs://bucket1#123 gs://bucket2#456 - Restore latest soft-deleted version of object in a bucket. + Restore latest soft-deleted version of object in a bucket. $ gcloud storage restore gs://bucket/file1.txt - Restore a specific soft-deleted version of object in a bucket by specifying the generation. + Restore a specific soft-deleted version of object in a bucket by specifying + the generation. $ gcloud storage restore gs://bucket/file1.txt#123 - Restore all soft-deleted versions of object in a bucket. + Restore all soft-deleted versions of object in a bucket. $ gcloud storage restore gs://bucket/file1.txt --all-versions - Restore several objects in a bucket (with or without generation): + Restore several objects in a bucket (with or without generation): $ gcloud storage restore gs://bucket/file1.txt \ - gs://bucket/file2.txt#456 + gs://bucket/file2.txt#456 - Restore the latest soft-deleted version of all text objects in a bucket: + Restore the latest soft-deleted version of all text objects in a bucket: $ gcloud storage restore gs://bucket/**.txt - Restore a list of objects read from stdin (with or without generation): + Restore a list of objects read from stdin (with or without generation): $ cat list-of-files.txt | gcloud storage restore \ - --read-paths-from-stdin + --read-paths-from-stdin - Restore object with its original ACL policy: + Restore object with its original ACL policy: $ gcloud storage restore gs://bucket/file1.txt --preserve-acl - Restore all objects in a bucket asynchronously: + Restore all objects in a bucket asynchronously: $ gcloud storage restore gs://bucket/** --async - Restore all text files in a bucket asynchronously: + Restore all text files in a bucket asynchronously: $ gcloud storage restore gs://bucket/**.txt --async - Restore objects created within a specific time range: + Restore objects created within a specific time range: $ gcloud storage restore gs://bucket/** --async \ - --created-after-time="2023-01-01T00:00:00Z" \ - --created-before-time="2023-01-31T23:59:59Z" + --created-after-time="2023-01-01T00:00:00Z" \ + --created-before-time="2023-01-31T23:59:59Z" - Restore objects soft-deleted within a specific time range: + Restore objects soft-deleted within a specific time range: $ gcloud storage restore gs://bucket/** --async \ - --deleted-after-time="2023-01-01T00:00:00Z" \ - --deleted-before-time="2023-01-31T23:59:59Z" + --deleted-after-time="2023-01-01T00:00:00Z" \ + --deleted-before-time="2023-01-31T23:59:59Z" - Restore objects using a combination of creation and deletion time filters: + Restore objects using a combination of creation and deletion time filters: $ gcloud storage restore gs://bucket/** --async --allow-overwrite \ - --created-after-time="2023-01-01T00:00:00Z" \ - --deleted-after-time="2023-01-01T00:00:00Z" + --created-after-time="2023-01-01T00:00:00Z" \ + --deleted-after-time="2023-01-01T00:00:00Z" - This command filters the objects that were live at 2023-01-01T00:00:00Z - and then soft-deleted afterwards. - - This combination of filters is especially helpful if there is a period of - erroneous overwrites. They allow you to go back to the point just before - the overwrites began. You will also need to set the --allow-overwrite - option to true. + This command filters the objects that were live at 2023-01-01T00:00:00Z and + then soft-deleted afterwards. This combination of filters is especially + helpful if there is a period of erroneous overwrites. They allow you to go + back to the point just before the overwrites began. You will also need to + set the --allow-overwrite option to true. POSITIONAL ARGUMENTS [URLS ...]