diff --git a/gcloud/_version b/gcloud/_version index eaf323266..46e8d8303 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 493.0.0 -alpha 2024.09.13 -beta 2024.09.13 +Google Cloud SDK 494.0.0 +alpha 2024.09.20 +beta 2024.09.20 bq 2.1.8 bundled-python3-unix 3.11.9 -core 2024.09.13 +core 2024.09.20 gcloud-crc32c 1.0.0 gsutil 5.30 diff --git a/gcloud/access-context-manager/cloud-bindings/create b/gcloud/access-context-manager/cloud-bindings/create index e39ef5619..c04ead904 100644 --- a/gcloud/access-context-manager/cloud-bindings/create +++ b/gcloud/access-context-manager/cloud-bindings/create @@ -8,9 +8,13 @@ SYNOPSIS [--organization=ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Create a new cloud access binding. The access level will be bound with the - group. The access level will be enforced when any user in the group tries - to access the Google cloud console or API. + Create a new cloud access binding. The access level will be globally bound + with the group. + + Allowlisted Applications can be specified to limit the scope of the cloud + access binding in the 'binding-file'. In such case, the access level + specified in the yaml file will be bound with the group and the allowlisted + applications. EXAMPLES To create a new cloud access binding, run: @@ -19,6 +23,21 @@ EXAMPLES --group-key=my-group-key \ --level=accessPolicies/123/accessLevels/abc + To create a new cloud access binding for particular applications using a + yaml file, run: + + $ gcloud access-context-manager cloud-bindings create \ + --group-key=my-group-key --organization='1234567890' \ + --binding-file='binding.yaml' + + To create a new global cloud access binding, and for particular + applications using a yaml file, run: + + $ gcloud access-context-manager cloud-bindings create \ + --group-key=my-group-key \ + --level=accessPolicies/123/accessLevels/abc \ + --organization='1234567890' --binding-file='binding.yaml' + To create a new cloud access binding for the dry run access level, run: $ gcloud access-context-manager cloud-bindings create \ diff --git a/gcloud/access-context-manager/cloud-bindings/list b/gcloud/access-context-manager/cloud-bindings/list index cac100f9b..60085a501 100644 --- a/gcloud/access-context-manager/cloud-bindings/list +++ b/gcloud/access-context-manager/cloud-bindings/list @@ -15,10 +15,48 @@ EXAMPLES $ gcloud access-context-manager cloud-bindings list - This command prints a list of gcpUserAccessBindings in a tabular form: + This command prints a list of Google Cloud user access bindings, + gcpUserAccessBindings, in YAML format. By default, the binding is printed + in the following format: - NAME GROUP_KEY ACCESS_LEVEL DRY_RUN_ACCESS_LEVEL - organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N a3dad accessPolicies/9522/accessLevels/device_trusted accessPolicies/9522/accessLevels/specific_location + --- + accessLevels: + - accessPolicies/9522/accessLevels/device_trusted + dryRunAccessLevels: + - accessPolicies/9522/accessLevels/specific_location + groupKey: a3dad + name: organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N + + Or + + --- + accessLevels: + - accessPolicies/9522/accessLevels/device_trusted + dryRunAccessLevels: + - accessPolicies/9522/accessLevels/specific_location + groupKey: a3dad + name: organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N + scopedAccessSettings: + - activeSettings: + accessLevels: + - accessPolicies/9522/accessLevels/device_trusted + dryRunSettings: + accessLevels: + - accessPolicies/9522/accessLevels/specific_location + scope: + clientScope: + restrictedClientApplication: + clientId: 123.apps.googleusercontent.com + - activeSettings: + accessLevels: + - accessPolicies/9522/accessLevels/device_trusted + dryRunSettings: + accessLevels: + - accessPolicies/9522/accessLevels/specific_location + scope: + clientScope: + restrictedClientApplication: + name: Cloud Console FLAGS Organization resource - The parent organization of the bindings you want diff --git a/gcloud/access-context-manager/cloud-bindings/update b/gcloud/access-context-manager/cloud-bindings/update index 362c0814a..7e7edefcb 100644 --- a/gcloud/access-context-manager/cloud-bindings/update +++ b/gcloud/access-context-manager/cloud-bindings/update @@ -10,7 +10,7 @@ SYNOPSIS DESCRIPTION Update an existing cloud access binding. You can update the level, dry run - level or both. They can't be both empty after update. + level and scoped access settings. They can't all be empty. EXAMPLES To update an existing cloud access binding, run: @@ -25,6 +25,11 @@ EXAMPLES --binding=my-binding-id --level= \ --dry-run-level=accessPolicies/123/accessLevels/new-def + To update scoped access settings, run: + + $ gcloud access-context-manager cloud-bindings update \ + --binding=my-binding-id --binding-file='binding.yaml' + REQUIRED FLAGS Cloud access binding resource - The cloud access binding you want to update. The arguments in this group can be used to specify the attributes diff --git a/gcloud/alloydb/instances/create b/gcloud/alloydb/instances/create index 6089fe36c..5127a997f 100644 --- a/gcloud/alloydb/instances/create +++ b/gcloud/alloydb/instances/create @@ -14,6 +14,7 @@ SYNOPSIS [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] [--[no-]insights-config-record-application-tags] [--[no-]insights-config-record-client-address] + [--[no-]outbound-public-ip] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE; default="ENCRYPTED_ONLY"] [GCLOUD_WIDE_FLAG ...] @@ -131,6 +132,10 @@ OPTIONAL FLAGS Use --insights-config-record-client-address to enable and --no-insights-config-record-client-address to disable. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alloydb/instances/create-secondary b/gcloud/alloydb/instances/create-secondary index 74165e062..8692c779a 100644 --- a/gcloud/alloydb/instances/create-secondary +++ b/gcloud/alloydb/instances/create-secondary @@ -7,8 +7,9 @@ SYNOPSIS --region=REGION [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] - [--availability-type=AVAILABILITY_TYPE] [--[no-]require-connectors] - [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] + [--availability-type=AVAILABILITY_TYPE] [--[no-]outbound-public-ip] + [--[no-]require-connectors] [--ssl-mode=SSL_MODE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Creates a new AlloyDB SECONDARY instance within a given cluster. @@ -70,6 +71,10 @@ OPTIONAL FLAGS production instances; instance does not automatically fail over to another zone. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --[no-]require-connectors Enable or disable enforcing connectors only (ex: AuthProxy) connections to the database. Use --require-connectors to enable and diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index f98e1d603..9800fe8d5 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -13,6 +13,7 @@ SYNOPSIS [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] [--[no-]insights-config-record-application-tags] [--[no-]insights-config-record-client-address] + [--[no-]outbound-public-ip] [--read-pool-node-count=READ_POOL_NODE_COUNT] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] [GCLOUD_WIDE_FLAG ...] @@ -114,6 +115,10 @@ OPTIONAL FLAGS Use --insights-config-record-client-address to enable and --no-insights-config-record-client-address to disable. + --[no-]outbound-public-ip + Add outbound Public IP connectivity to an AlloyDB instance. Use + --outbound-public-ip to enable and --no-outbound-public-ip to disable. + --read-pool-node-count=READ_POOL_NODE_COUNT Read capacity, i.e. number of nodes in a read pool instance. diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/list b/gcloud/alpha/access-context-manager/cloud-bindings/list index 2cd5325e1..1ebe8465c 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/list +++ b/gcloud/alpha/access-context-manager/cloud-bindings/list @@ -26,10 +26,6 @@ EXAMPLES - accessPolicies/9522/accessLevels/specific_location groupKey: a3dad name: organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N - restrictedClientApplications: - - clientId: 123.apps.googleusercontent.com - - name: Cloud Console - - name: Google Cloud SDK Or @@ -42,25 +38,25 @@ EXAMPLES name: organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N scopedAccessSettings: - activeSettings: - accessLevels: - - accessPolicies/9522/accessLevels/device_trusted - dryRunSettings: - accessLevels: - - accessPolicies/9522/accessLevels/specific_location - scope: - clientScope: - restrictedClientApplication: - clientId: 123.apps.googleusercontent.com + accessLevels: + - accessPolicies/9522/accessLevels/device_trusted + dryRunSettings: + accessLevels: + - accessPolicies/9522/accessLevels/specific_location + scope: + clientScope: + restrictedClientApplication: + clientId: 123.apps.googleusercontent.com - activeSettings: - accessLevels: - - accessPolicies/9522/accessLevels/device_trusted - dryRunSettings: - accessLevels: - - accessPolicies/9522/accessLevels/specific_location - scope: - clientScope: - restrictedClientApplication: - name: Cloud Console + accessLevels: + - accessPolicies/9522/accessLevels/device_trusted + dryRunSettings: + accessLevels: + - accessPolicies/9522/accessLevels/specific_location + scope: + clientScope: + restrictedClientApplication: + name: Cloud Console If filter is specified as principal:serviceAccount OR principal:serviceAccountProjectNumber, the output is printed in the diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/update b/gcloud/alpha/access-context-manager/cloud-bindings/update index acb6c0ffa..1454d94ee 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/update +++ b/gcloud/alpha/access-context-manager/cloud-bindings/update @@ -13,8 +13,8 @@ SYNOPSIS DESCRIPTION (ALPHA) Update an existing access binding. You can update the level, dry - run level, restricted client application client IDs and restricted client - application names. They can't all be empty. + run level, scoped access settings, restricted client application client IDs + and restricted client application names. They can't all be empty. EXAMPLES To update an existing access binding, run: diff --git a/gcloud/alpha/bigtable/app-profiles/create b/gcloud/alpha/bigtable/app-profiles/create index 5d8275a29..3f03e6455 100644 --- a/gcloud/alpha/bigtable/app-profiles/create +++ b/gcloud/alpha/bigtable/app-profiles/create @@ -116,23 +116,23 @@ OPTIONAL FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost Read-only Isolation, rather than Standard Isolation. - If specified, --data-boost-compute-billing-owner is required. - Specifying Data Boost Read-only Isolation on an app profile which - has Standard Isolation enabled may cause unexpected behavior for - running applications. + Use Data Boost serverless compute option, rather than standard + provisioned node compute. If specified, + --data-boost-compute-billing-owner is required. Specifying Data + Boost compute on an app profile that uses standard provisioned node + compute may cause unexpected behavior for running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost Compute Billing Owner, required if + Specify the Data Boost compute billing owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute Billing should be accounted towards the host Cloud - Project (containing the targeted Bigtable Instance / Table). + Compute billing should be accounted towards the host Cloud + project (containing the targeted Bigtable instance / table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -140,14 +140,15 @@ OPTIONAL FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under Standard Isolation. Passing this - option implies Standard Isolation, e.g. the --standard option. If - not specified, the app profile uses Standard Isolation with - PRIORITY_HIGH by default. Specifying request priority on an app - profile that has Data Boost Read-Only Isolation enabled will change - the isolation to Standard and use the specified priority, which may - cause unexpected behavior for running applications. PRIORITY must - be one of: + Specify the request priority under standard provisioned node + compute capabilities. Passing this option implies standard + provisioned node compute, e.g. the --standard option. If not + specified, the app profile uses standard provisioned node compute + with PRIORITY_HIGH by default. Specifying request priority on an + app profile that has Data Boost serverless compute enabled changes + the compute option to standard and uses the specified priority, + which might cause unexpected behavior for running applications. + PRIORITY must be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -160,8 +161,8 @@ OPTIONAL FLAGS in this group are specified. --standard - Use Standard Isolation, rather than Data Boost Read-only Isolation. - If specified, --priority is required. + Use standard provisioned node compute option, rather than Data + Boost compute option. If specified, --priority is required. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/bigtable/app-profiles/update b/gcloud/alpha/bigtable/app-profiles/update index 503b4942d..5771d7ff7 100644 --- a/gcloud/alpha/bigtable/app-profiles/update +++ b/gcloud/alpha/bigtable/app-profiles/update @@ -93,23 +93,23 @@ FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost Read-only Isolation, rather than Standard Isolation. - If specified, --data-boost-compute-billing-owner is required. - Specifying Data Boost Read-only Isolation on an app profile which - has Standard Isolation enabled may cause unexpected behavior for - running applications. + Use Data Boost serverless compute option, rather than standard + provisioned node compute. If specified, + --data-boost-compute-billing-owner is required. Specifying Data + Boost compute on an app profile that uses standard provisioned node + compute may cause unexpected behavior for running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost Compute Billing Owner, required if + Specify the Data Boost compute billing owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute Billing should be accounted towards the host Cloud - Project (containing the targeted Bigtable Instance / Table). + Compute billing should be accounted towards the host Cloud + project (containing the targeted Bigtable instance / table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -117,14 +117,15 @@ FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under Standard Isolation. Passing this - option implies Standard Isolation, e.g. the --standard option. If - not specified, the app profile uses Standard Isolation with - PRIORITY_HIGH by default. Specifying request priority on an app - profile that has Data Boost Read-Only Isolation enabled will change - the isolation to Standard and use the specified priority, which may - cause unexpected behavior for running applications. PRIORITY must - be one of: + Specify the request priority under standard provisioned node + compute capabilities. Passing this option implies standard + provisioned node compute, e.g. the --standard option. If not + specified, the app profile uses standard provisioned node compute + with PRIORITY_HIGH by default. Specifying request priority on an + app profile that has Data Boost serverless compute enabled changes + the compute option to standard and uses the specified priority, + which might cause unexpected behavior for running applications. + PRIORITY must be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -137,8 +138,8 @@ FLAGS in this group are specified. --standard - Use Standard Isolation, rather than Data Boost Read-only Isolation. - If specified, --priority is required. + Use standard provisioned node compute option, rather than Data + Boost compute option. If specified, --priority is required. At most one of these can be specified: diff --git a/gcloud/alpha/compute/instance-groups/managed/create b/gcloud/alpha/compute/instance-groups/managed/create index 5b363aff3..e972d3e3d 100644 --- a/gcloud/alpha/compute/instance-groups/managed/create +++ b/gcloud/alpha/compute/instance-groups/managed/create @@ -135,13 +135,13 @@ OPTIONAL FLAGS meet its target distribution. --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] - Named selection of machine types with an optional rank. eg. + Named selection of machine types with an optional rank. For example, --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" --instance-selection-machine-types=[MACHINE_TYPE,...] - Primary machine types to use for the Compute Engine instances that will - be created with the managed instance group. If not provided, machine - type specified in the instance template will be used. + Machine types that are used to create VMs in the managed instance + group. If not provided, the machine type specified in the instance + template is used. --list-managed-instances-results=MODE Pagination behavior for the group's listManagedInstances API method. diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel b/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel index f29793157..5321cb0a8 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/cancel @@ -3,11 +3,10 @@ NAME cancel a Compute Engine managed instance group resize request SYNOPSIS - gcloud alpha compute instance-groups managed resize-requests cancel - INSTANCE_GROUP_MANAGER + gcloud alpha compute instance-groups managed resize-requests cancel NAME (--resize-request=RESIZE_REQUEST_NAME - | --resize-requests=RESIZE_REQUEST_NAMES,[...]) [--zone=ZONE] - [GCLOUD_WIDE_FLAG ...] + | --resize-requests=RESIZE_REQUEST_NAMES,[...]) + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute instance-groups managed resize-requests cancel @@ -23,7 +22,7 @@ EXAMPLES cancel my-mig --resize-requests=resize-request-1 POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. REQUIRED FLAGS @@ -36,26 +35,29 @@ REQUIRED FLAGS A list of comma-separated names of resize requests to cancel. OPTIONAL FLAGS - --zone=ZONE - Zone of the managed instance group to operate on. If not specified and - the compute/zone property isn't set, you might be prompted to select a - zone (interactive mode only). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete b/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete index fd6631ac2..a940609b6 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/delete @@ -3,9 +3,9 @@ NAME delete a Compute Engine managed instance group resize request SYNOPSIS - gcloud alpha compute instance-groups managed resize-requests delete - INSTANCE_GROUP_MANAGER --resize-requests=RESIZE_REQUEST_NAMES,[...] - [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute instance-groups managed resize-requests delete NAME + --resize-requests=RESIZE_REQUEST_NAMES,[...] + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute instance-groups managed resize-requests delete @@ -22,7 +22,7 @@ EXAMPLES delete my-mig --resize-requests=resize-request-1 POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. REQUIRED FLAGS @@ -30,26 +30,29 @@ REQUIRED FLAGS A list of comma-separated names of resize requests to delete. OPTIONAL FLAGS - --zone=ZONE - Zone of the managed instance group to operate on. If not specified and - the compute/zone property isn't set, you might be prompted to select a - zone (interactive mode only). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe b/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe index 09a349018..49722b08a 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/describe @@ -4,9 +4,9 @@ NAME resource SYNOPSIS - gcloud alpha compute instance-groups managed resize-requests describe - INSTANCE_GROUP_MANAGER --resize-request=RESIZE_REQUEST_NAME - [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute instance-groups managed resize-requests describe NAME + --resize-request=RESIZE_REQUEST_NAME [--region=REGION | --zone=ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute instance-groups managed resize-requests @@ -21,7 +21,7 @@ EXAMPLES describe my-mig --resize-request=resize-request-1 POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. REQUIRED FLAGS @@ -29,26 +29,29 @@ REQUIRED FLAGS The name of the resize request to describe. OPTIONAL FLAGS - --zone=ZONE - Zone of the managed instance group to operate on. If not specified and - the compute/zone property isn't set, you might be prompted to select a - zone (interactive mode only). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/instance-groups/managed/resize-requests/list b/gcloud/alpha/compute/instance-groups/managed/resize-requests/list index e079bf98d..941fd77b1 100644 --- a/gcloud/alpha/compute/instance-groups/managed/resize-requests/list +++ b/gcloud/alpha/compute/instance-groups/managed/resize-requests/list @@ -3,9 +3,9 @@ NAME Compute Engine managed instance group resize requests SYNOPSIS - gcloud alpha compute instance-groups managed resize-requests list - INSTANCE_GROUP_MANAGER [--zone=ZONE] [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + gcloud alpha compute instance-groups managed resize-requests list NAME + [--region=REGION | --zone=ZONE] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -22,30 +22,33 @@ EXAMPLES $ gcloud alpha compute instance-groups managed resize-requests \ list example-managed-instance-group --zone=us-central1-a --uri POSITIONAL ARGUMENTS - INSTANCE_GROUP_MANAGER + NAME Name of the managed instance group to operate on. FLAGS - --zone=ZONE - Zone of the managed instance group to operate on. If not specified and - the compute/zone property isn't set, you might be prompted to select a - zone (interactive mode only). + At most one of these can be specified: - To avoid prompting when this flag is omitted, you can set the - compute/zone property: + --region=REGION + Region of the managed instance group to operate on. If not specified, + you might be prompted to select a region (interactive mode only). - $ gcloud config set compute/zone ZONE + A list of regions can be fetched by running: - A list of zones can be fetched by running: + $ gcloud compute regions list - $ gcloud compute zones list + Overrides the default compute/region property value for this command + invocation. - To unset the property, run: + --zone=ZONE + Zone of the managed instance group to operate on. If not specified, + you might be prompted to select a zone (interactive mode only). - $ gcloud config unset compute/zone + A list of zones can be fetched by running: - Alternatively, the zone can be stored in the environment variable - CLOUDSDK_COMPUTE_ZONE. + $ gcloud compute zones list + + Overrides the default compute/zone property value for this command + invocation. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/compute/instance-groups/managed/update b/gcloud/alpha/compute/instance-groups/managed/update index 0ed220b10..880049788 100644 --- a/gcloud/alpha/compute/instance-groups/managed/update +++ b/gcloud/alpha/compute/instance-groups/managed/update @@ -11,6 +11,8 @@ SYNOPSIS machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] + [--remove-instance-selections=[INSTANCE_SELECTION_NAME,...]] + [--remove-instance-selections-all] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] [--size=SIZE] @@ -113,13 +115,13 @@ FLAGS meet its target distribution. --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] - Named selection of machine types with an optional rank. eg. + Named selection of machine types with an optional rank. For example, --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" --instance-selection-machine-types=[MACHINE_TYPE,...] - Primary machine types to use for the Compute Engine instances that will - be created with the managed instance group. If not provided, machine - type specified in the instance template will be used. + Machine types that are used to create VMs in the managed instance + group. If not provided, the machine type specified in the instance + template is used. --list-managed-instances-results=MODE Pagination behavior for the group's listManagedInstances API method. @@ -134,6 +136,13 @@ FLAGS Pagination is enabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are respected. + --remove-instance-selections=[INSTANCE_SELECTION_NAME,...] + Remove specific instance selections from the instance flexibility + policy. + + --remove-instance-selections-all + Remove all instance selections from the instance flexibility policy. + --remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...] Remove stateful configuration for the specified disks. diff --git a/gcloud/alpha/compute/snapshots/remove-labels b/gcloud/alpha/compute/snapshots/remove-labels index 124626cdd..a06fc1712 100644 --- a/gcloud/alpha/compute/snapshots/remove-labels +++ b/gcloud/alpha/compute/snapshots/remove-labels @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute snapshots remove-labels SNAPSHOT_NAME - (--all | --labels=KEY,[KEY,...]) [GCLOUD_WIDE_FLAG ...] + (--all | --labels=KEY,[KEY,...]) [--global | --region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute snapshots remove-labels removes labels from a @@ -39,6 +40,16 @@ REQUIRED FLAGS --labels=KEY,[KEY,...] A comma-separated list of label keys to remove from the resource. +OPTIONAL FLAGS + At most one of these can be specified: + + --global + If set, the snapshot is global. + + --region=REGION + Region of the snapshot to operate on. Overrides the default + compute/region property value for this command invocation. + 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/container/backup-restore/restores/create b/gcloud/alpha/container/backup-restore/restores/create index 266222ba1..532252f28 100644 --- a/gcloud/alpha/container/backup-restore/restores/create +++ b/gcloud/alpha/container/backup-restore/restores/create @@ -87,7 +87,7 @@ OPTIONAL FLAGS For more information about examples and how to use this filter, please refer to the Backup for GKE documentation: - https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke. + https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke/how-to/fine-grained-restore. --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/container/fleet/config-management/apply b/gcloud/alpha/container/fleet/config-management/apply index 8bcc6bcc0..26d727a3d 100644 --- a/gcloud/alpha/container/fleet/config-management/apply +++ b/gcloud/alpha/container/fleet/config-management/apply @@ -1,20 +1,26 @@ NAME gcloud alpha container fleet config-management apply - update a Config - Management Feature Spec + Management feature spec SYNOPSIS - gcloud alpha container fleet config-management apply --config=CONFIG - [--version=VERSION] [--membership=MEMBERSHIP : --location=LOCATION] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha container fleet config-management apply + (--origin=ORIGIN | [--config=CONFIG : --version=VERSION]) + [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a user-specified config file to a ConfigManagement Custom - Resource. The config file should be a .yaml file, all eligible fields are - listed in - https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields + (ALPHA) Update a membership configuration for the Config Management feature + in a fleet. This command errors if the Config Management feature is not + enabled on the fleet. EXAMPLES - To apply a YAML config file to a membership, prepare apply-spec.yaml + To apply the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to MEMBERSHIP_NAME, run: + + $ gcloud alpha container fleet config-management apply \ + --membership=MEMBERSHIP_NAME --origin=FLEET + + To apply a membership configuration as a YAML file, prepare apply-spec.yaml (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#example_gcloud_apply_spec) then run: @@ -23,13 +29,43 @@ EXAMPLES --version=VERSION REQUIRED FLAGS - --config=CONFIG - The path to config-management.yaml. + Update the membership configuration either to the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + with --origin or to a user-provided configuration with --config and + --version. + + Exactly one of these must be specified: + + --origin=ORIGIN + Updates the configuration of the target membership to the current + fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Errors if fleet-default membership configuration is not enabled; see + the enable command for more details. ORIGIN must be (only one value + is supported): FLEET. + + Provide the entire membership configuration to update with --config and + --version. + + --config=CONFIG + Path to YAML file that contains the configuration to update the + target membership to. The file accepts the following fields + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields). + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --version=VERSION + Version of Config Management. Equivalent to the `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + field in the --config file. Provides --config with a version in the + absence of spec.version. Cannot specify this flag without --config; + cannot set both this flag and spec.version. See `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + for more details. OPTIONAL FLAGS - --version=VERSION - The version of ACM to install. - Membership resource - The group of arguments defining a membership. 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 diff --git a/gcloud/alpha/container/fleet/config-management/delete b/gcloud/alpha/container/fleet/config-management/delete index 165fc3d40..fa2b99a5b 100644 --- a/gcloud/alpha/container/fleet/config-management/delete +++ b/gcloud/alpha/container/fleet/config-management/delete @@ -1,22 +1,22 @@ NAME gcloud alpha container fleet config-management delete - remove the Config - Management Feature Spec for the given membership + Management feature spec for the given membership SYNOPSIS gcloud alpha container fleet config-management delete [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) Remove the Config Management Feature Spec for the + (ALPHA) (DEPRECATED) Remove the Config Management feature spec for the given membership. This command has been deprecated. Please use unmanage instead. - Remove the Config Management Feature Spec for the given membership. The + Remove the Config Management feature spec for the given membership. The existing ConfigManagement resources in the clusters will become unmanaged. EXAMPLES - To remove the Config Management Feature spec for a membership, run: + To remove the Config Management feature spec for a membership, run: $ gcloud alpha container fleet config-management delete \ --membership=MEMBERSHIP_NAME diff --git a/gcloud/alpha/container/fleet/config-management/disable b/gcloud/alpha/container/fleet/config-management/disable index ec379a668..3c9030367 100644 --- a/gcloud/alpha/container/fleet/config-management/disable +++ b/gcloud/alpha/container/fleet/config-management/disable @@ -1,23 +1,40 @@ NAME gcloud alpha container fleet config-management disable - disable Config - Management Feature + Management feature SYNOPSIS - gcloud alpha container fleet config-management disable [--force] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha container fleet config-management disable + [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Disable the Config Management Feature in a fleet. + (ALPHA) Disable the Config Management feature in a fleet. Disable the + feature entirely or only disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for the feature. EXAMPLES - To disable the Config Management Feature, run: + To disable the Config Management feature entirely, run: $ gcloud alpha container fleet config-management disable + To disable only fleet-default membership configuration for the feature, + run: + + $ gcloud alpha container fleet config-management disable \ + --fleet-default-member-config + FLAGS - --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + At most one of these can be specified: + + --fleet-default-member-config + Disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + without disabling the feature. Does not change existing membership + configurations. Exits silently if the feature is not enabled. + + --force + Disable this feature, even if it is currently in use. Force + disablement may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/config-management/enable b/gcloud/alpha/container/fleet/config-management/enable index fe738a2c3..1c7762c43 100644 --- a/gcloud/alpha/container/fleet/config-management/enable +++ b/gcloud/alpha/container/fleet/config-management/enable @@ -1,19 +1,43 @@ NAME gcloud alpha container fleet config-management enable - enable Config - Management Feature + Management feature SYNOPSIS gcloud alpha container fleet config-management enable + [--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Enables the Config Management Feature in a fleet. + (ALPHA) Enables the Config Management feature in a fleet. Without any + flags, this command no-ops if the feature is already enabled. This command + can also enable the feature with a fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for Config Sync. EXAMPLES - To enable the Config Management Feature, run: + To enable the Config Management feature, run: $ gcloud alpha container fleet config-management enable + To enable the Config Management feature with a fleet-default membership + configuration for Config Sync, run: + + $ gcloud alpha container fleet config-management enable \ + --fleet-default-member-config=config.yaml + +FLAGS + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + Path to YAML file that contains the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to enable with a new feature. This file shares the syntax of the + --config flag on the apply command: see recognized fields here + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields). + Errors if the Policy Controller or Hierarchy Controller field is set. + This flag will also enable or update the fleet-default membership + configuration on an existing feature. See the apply command for how to + sync a membership to the fleet-default membership configuration. + 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/container/fleet/config-management/help b/gcloud/alpha/container/fleet/config-management/help index 5b6c06da9..452f3952a 100644 --- a/gcloud/alpha/container/fleet/config-management/help +++ b/gcloud/alpha/container/fleet/config-management/help @@ -1,13 +1,13 @@ NAME gcloud alpha container fleet config-management - manage Config Management - Feature + feature SYNOPSIS gcloud alpha container fleet config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Config Sync using the Config Management Feature. Policy + (ALPHA) Manage Config Sync using the Config Management feature. Policy Controller users should use the separate command group: gcloud container fleet policycontroller. Hierarchy Controller users should use https://github.com/kubernetes-sigs/hierarchical-namespaces instead. @@ -21,17 +21,17 @@ COMMANDS COMMAND is one of the following: apply - (ALPHA) Update a Config Management Feature Spec. + (ALPHA) Update a Config Management feature spec. delete - (ALPHA) (DEPRECATED) Remove the Config Management Feature Spec for the + (ALPHA) (DEPRECATED) Remove the Config Management feature spec for the given membership. disable - (ALPHA) Disable Config Management Feature. + (ALPHA) Disable Config Management feature. enable - (ALPHA) Enable Config Management Feature. + (ALPHA) Enable Config Management feature. fetch-for-apply (ALPHA) Prints the Config Management configuration applied to the given @@ -42,11 +42,11 @@ COMMANDS enabled. unmanage - (ALPHA) Remove the Config Management Feature Spec for the given + (ALPHA) Remove the Config Management feature spec for the given membership. upgrade - (ALPHA) Upgrade the version of the Config Management Feature. + (ALPHA) Upgrade the version of the Config Management feature. version (ALPHA) Print the version of all clusters with Config Management diff --git a/gcloud/alpha/container/fleet/config-management/status b/gcloud/alpha/container/fleet/config-management/status index b41b8d8e7..da660eef5 100644 --- a/gcloud/alpha/container/fleet/config-management/status +++ b/gcloud/alpha/container/fleet/config-management/status @@ -8,16 +8,24 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Print the status of all clusters with Config Management enabled. + (ALPHA) The Synced_to_Fleet_Default status indicates whether each + membership's configuration has been synced with the fleet-default + membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Synced_to_Fleet_Default displays FLEET_DEFAULT_NOT_CONFIGURED when + fleet-default membership configuration is not enabled. + Synced_to_Fleet_Default for an individual membership may be UNKNOWN if + configuration has yet to be applied to this membership since enabling + fleet-default membership configuration. See the enable and apply commands + for more details. EXAMPLES - Print the status of the Config Management Feature: + Print the status of the Config Management feature: $ gcloud alpha container fleet config-management status - Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Hierarchy_Controller - managed-cluster SYNCED 2945500b7f acme 2020-03-23 - 11:12:31 -0700 PDT INSTALLED + Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Policy_Controller Hierarchy_Controller Version Upgrades Synced_To_Fleet_Default + managed-cluster SYNCED 2945500b7f acme 2020-03-23 11:12:31 -0700 PDT NA NA 1.18.3 auto FLEET_DEFAULT_NOT_CONFIGURED View the status for the cluster named managed-cluster-a: @@ -29,13 +37,13 @@ EXAMPLES $ gcloud alpha container fleet config-management status \ --filter="acm_status.name ~ managed-cluster.*" - List all clusters where current status is SYNCED: + List all clusters where current Config Sync Status is SYNCED: $ gcloud alpha container fleet config-management status \ --filter="acm_status.config_sync:SYNCED" List all the clusters where sync_branch is v1 and current Config Sync - status is not SYNCED: + Status is not SYNCED: $ gcloud alpha container fleet config-management status \ --filter="acm_status.sync_branch:v1 AND \ diff --git a/gcloud/alpha/container/fleet/config-management/unmanage b/gcloud/alpha/container/fleet/config-management/unmanage index 6fb1dbd40..c062f8f87 100644 --- a/gcloud/alpha/container/fleet/config-management/unmanage +++ b/gcloud/alpha/container/fleet/config-management/unmanage @@ -1,18 +1,18 @@ NAME gcloud alpha container fleet config-management unmanage - remove the Config - Management Feature Spec for the given membership + Management feature spec for the given membership SYNOPSIS gcloud alpha container fleet config-management unmanage [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Remove the Config Management Feature Spec for the given membership. + (ALPHA) Remove the Config Management feature spec for the given membership. The existing ConfigManagement resources in the clusters will become unmanaged. EXAMPLES - To remove the Config Management Feature spec for a membership, run: + To remove the Config Management feature spec for a membership, run: $ gcloud alpha container fleet config-management unmanage \ --membership=MEMBERSHIP_NAME diff --git a/gcloud/alpha/container/fleet/config-management/upgrade b/gcloud/alpha/container/fleet/config-management/upgrade index 1af598ca3..a89d17650 100644 --- a/gcloud/alpha/container/fleet/config-management/upgrade +++ b/gcloud/alpha/container/fleet/config-management/upgrade @@ -1,6 +1,6 @@ NAME gcloud alpha container fleet config-management upgrade - upgrade the - version of the Config Management Feature + version of the Config Management feature SYNOPSIS gcloud alpha container fleet config-management upgrade --version=VERSION @@ -8,7 +8,7 @@ SYNOPSIS DESCRIPTION (ALPHA) Upgrade a specified membership to any supported version of the - Config Management Feature. + Config Management feature. EXAMPLES To upgrade a membership named MEMBERSHIP_NAME, run: diff --git a/gcloud/alpha/container/fleet/help b/gcloud/alpha/container/fleet/help index a42ced9a1..242908f16 100644 --- a/gcloud/alpha/container/fleet/help +++ b/gcloud/alpha/container/fleet/help @@ -52,7 +52,7 @@ GROUPS (ALPHA) Configure the Fleet clusterupgrade feature. config-management - (ALPHA) Manage Config Management Feature. + (ALPHA) Manage Config Management feature. dataplane-v2-encryption (ALPHA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/alpha/container/hub/config-management/apply b/gcloud/alpha/container/hub/config-management/apply index 46aa0b884..4b8b98fbb 100644 --- a/gcloud/alpha/container/hub/config-management/apply +++ b/gcloud/alpha/container/hub/config-management/apply @@ -1,20 +1,26 @@ NAME gcloud alpha container hub config-management apply - update a Config - Management Feature Spec + Management feature spec SYNOPSIS - gcloud alpha container hub config-management apply --config=CONFIG - [--version=VERSION] [--membership=MEMBERSHIP : --location=LOCATION] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha container hub config-management apply + (--origin=ORIGIN | [--config=CONFIG : --version=VERSION]) + [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a user-specified config file to a ConfigManagement Custom - Resource. The config file should be a .yaml file, all eligible fields are - listed in - https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields + (ALPHA) Update a membership configuration for the Config Management feature + in a fleet. This command errors if the Config Management feature is not + enabled on the fleet. EXAMPLES - To apply a YAML config file to a membership, prepare apply-spec.yaml + To apply the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to MEMBERSHIP_NAME, run: + + $ gcloud alpha container hub config-management apply \ + --membership=MEMBERSHIP_NAME --origin=FLEET + + To apply a membership configuration as a YAML file, prepare apply-spec.yaml (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#example_gcloud_apply_spec) then run: @@ -23,13 +29,43 @@ EXAMPLES --version=VERSION REQUIRED FLAGS - --config=CONFIG - The path to config-management.yaml. + Update the membership configuration either to the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + with --origin or to a user-provided configuration with --config and + --version. + + Exactly one of these must be specified: + + --origin=ORIGIN + Updates the configuration of the target membership to the current + fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Errors if fleet-default membership configuration is not enabled; see + the enable command for more details. ORIGIN must be (only one value + is supported): FLEET. + + Provide the entire membership configuration to update with --config and + --version. + + --config=CONFIG + Path to YAML file that contains the configuration to update the + target membership to. The file accepts the following fields + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields). + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --version=VERSION + Version of Config Management. Equivalent to the `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + field in the --config file. Provides --config with a version in the + absence of spec.version. Cannot specify this flag without --config; + cannot set both this flag and spec.version. See `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + for more details. OPTIONAL FLAGS - --version=VERSION - The version of ACM to install. - Membership resource - The group of arguments defining a membership. 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 diff --git a/gcloud/alpha/container/hub/config-management/delete b/gcloud/alpha/container/hub/config-management/delete index ad9be9bdc..feb19e2a5 100644 --- a/gcloud/alpha/container/hub/config-management/delete +++ b/gcloud/alpha/container/hub/config-management/delete @@ -1,22 +1,22 @@ NAME gcloud alpha container hub config-management delete - remove the Config - Management Feature Spec for the given membership + Management feature spec for the given membership SYNOPSIS gcloud alpha container hub config-management delete [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) (DEPRECATED) Remove the Config Management Feature Spec for the + (ALPHA) (DEPRECATED) Remove the Config Management feature spec for the given membership. This command has been deprecated. Please use unmanage instead. - Remove the Config Management Feature Spec for the given membership. The + Remove the Config Management feature spec for the given membership. The existing ConfigManagement resources in the clusters will become unmanaged. EXAMPLES - To remove the Config Management Feature spec for a membership, run: + To remove the Config Management feature spec for a membership, run: $ gcloud alpha container hub config-management delete \ --membership=MEMBERSHIP_NAME diff --git a/gcloud/alpha/container/hub/config-management/disable b/gcloud/alpha/container/hub/config-management/disable index c68cb91ef..9fefba8f8 100644 --- a/gcloud/alpha/container/hub/config-management/disable +++ b/gcloud/alpha/container/hub/config-management/disable @@ -1,23 +1,40 @@ NAME gcloud alpha container hub config-management disable - disable Config - Management Feature + Management feature SYNOPSIS - gcloud alpha container hub config-management disable [--force] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha container hub config-management disable + [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Disable the Config Management Feature in a fleet. + (ALPHA) Disable the Config Management feature in a fleet. Disable the + feature entirely or only disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for the feature. EXAMPLES - To disable the Config Management Feature, run: + To disable the Config Management feature entirely, run: $ gcloud alpha container hub config-management disable + To disable only fleet-default membership configuration for the feature, + run: + + $ gcloud alpha container hub config-management disable \ + --fleet-default-member-config + FLAGS - --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + At most one of these can be specified: + + --fleet-default-member-config + Disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + without disabling the feature. Does not change existing membership + configurations. Exits silently if the feature is not enabled. + + --force + Disable this feature, even if it is currently in use. Force + disablement may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/config-management/enable b/gcloud/alpha/container/hub/config-management/enable index 18a86903e..52a85f0b0 100644 --- a/gcloud/alpha/container/hub/config-management/enable +++ b/gcloud/alpha/container/hub/config-management/enable @@ -1,18 +1,43 @@ NAME gcloud alpha container hub config-management enable - enable Config - Management Feature + Management feature SYNOPSIS - gcloud alpha container hub config-management enable [GCLOUD_WIDE_FLAG ...] + gcloud alpha container hub config-management enable + [--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Enables the Config Management Feature in a fleet. + (ALPHA) Enables the Config Management feature in a fleet. Without any + flags, this command no-ops if the feature is already enabled. This command + can also enable the feature with a fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for Config Sync. EXAMPLES - To enable the Config Management Feature, run: + To enable the Config Management feature, run: $ gcloud alpha container hub config-management enable + To enable the Config Management feature with a fleet-default membership + configuration for Config Sync, run: + + $ gcloud alpha container hub config-management enable \ + --fleet-default-member-config=config.yaml + +FLAGS + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + Path to YAML file that contains the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to enable with a new feature. This file shares the syntax of the + --config flag on the apply command: see recognized fields here + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields). + Errors if the Policy Controller or Hierarchy Controller field is set. + This flag will also enable or update the fleet-default membership + configuration on an existing feature. See the apply command for how to + sync a membership to the fleet-default membership configuration. + 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/container/hub/config-management/help b/gcloud/alpha/container/hub/config-management/help index 4145ddd3c..e4cba9c5c 100644 --- a/gcloud/alpha/container/hub/config-management/help +++ b/gcloud/alpha/container/hub/config-management/help @@ -1,12 +1,12 @@ NAME gcloud alpha container hub config-management - manage Config Management - Feature + feature SYNOPSIS gcloud alpha container hub config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Config Sync using the Config Management Feature. Policy + (ALPHA) Manage Config Sync using the Config Management feature. Policy Controller users should use the separate command group: gcloud container fleet policycontroller. Hierarchy Controller users should use https://github.com/kubernetes-sigs/hierarchical-namespaces instead. @@ -20,17 +20,17 @@ COMMANDS COMMAND is one of the following: apply - (ALPHA) Update a Config Management Feature Spec. + (ALPHA) Update a Config Management feature spec. delete - (ALPHA) (DEPRECATED) Remove the Config Management Feature Spec for the + (ALPHA) (DEPRECATED) Remove the Config Management feature spec for the given membership. disable - (ALPHA) Disable Config Management Feature. + (ALPHA) Disable Config Management feature. enable - (ALPHA) Enable Config Management Feature. + (ALPHA) Enable Config Management feature. fetch-for-apply (ALPHA) Prints the Config Management configuration applied to the given @@ -41,11 +41,11 @@ COMMANDS enabled. unmanage - (ALPHA) Remove the Config Management Feature Spec for the given + (ALPHA) Remove the Config Management feature spec for the given membership. upgrade - (ALPHA) Upgrade the version of the Config Management Feature. + (ALPHA) Upgrade the version of the Config Management feature. version (ALPHA) Print the version of all clusters with Config Management diff --git a/gcloud/alpha/container/hub/config-management/status b/gcloud/alpha/container/hub/config-management/status index b9ad713d0..6ecb6d5f2 100644 --- a/gcloud/alpha/container/hub/config-management/status +++ b/gcloud/alpha/container/hub/config-management/status @@ -8,16 +8,24 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Print the status of all clusters with Config Management enabled. + (ALPHA) The Synced_to_Fleet_Default status indicates whether each + membership's configuration has been synced with the fleet-default + membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Synced_to_Fleet_Default displays FLEET_DEFAULT_NOT_CONFIGURED when + fleet-default membership configuration is not enabled. + Synced_to_Fleet_Default for an individual membership may be UNKNOWN if + configuration has yet to be applied to this membership since enabling + fleet-default membership configuration. See the enable and apply commands + for more details. EXAMPLES - Print the status of the Config Management Feature: + Print the status of the Config Management feature: $ gcloud alpha container hub config-management status - Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Hierarchy_Controller - managed-cluster SYNCED 2945500b7f acme 2020-03-23 - 11:12:31 -0700 PDT INSTALLED + Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Policy_Controller Hierarchy_Controller Version Upgrades Synced_To_Fleet_Default + managed-cluster SYNCED 2945500b7f acme 2020-03-23 11:12:31 -0700 PDT NA NA 1.18.3 auto FLEET_DEFAULT_NOT_CONFIGURED View the status for the cluster named managed-cluster-a: @@ -29,13 +37,13 @@ EXAMPLES $ gcloud alpha container hub config-management status \ --filter="acm_status.name ~ managed-cluster.*" - List all clusters where current status is SYNCED: + List all clusters where current Config Sync Status is SYNCED: $ gcloud alpha container hub config-management status \ --filter="acm_status.config_sync:SYNCED" List all the clusters where sync_branch is v1 and current Config Sync - status is not SYNCED: + Status is not SYNCED: $ gcloud alpha container hub config-management status \ --filter="acm_status.sync_branch:v1 AND \ diff --git a/gcloud/alpha/container/hub/config-management/unmanage b/gcloud/alpha/container/hub/config-management/unmanage index e3902d2ee..931bb8c3c 100644 --- a/gcloud/alpha/container/hub/config-management/unmanage +++ b/gcloud/alpha/container/hub/config-management/unmanage @@ -1,18 +1,18 @@ NAME gcloud alpha container hub config-management unmanage - remove the Config - Management Feature Spec for the given membership + Management feature spec for the given membership SYNOPSIS gcloud alpha container hub config-management unmanage [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Remove the Config Management Feature Spec for the given membership. + (ALPHA) Remove the Config Management feature spec for the given membership. The existing ConfigManagement resources in the clusters will become unmanaged. EXAMPLES - To remove the Config Management Feature spec for a membership, run: + To remove the Config Management feature spec for a membership, run: $ gcloud alpha container hub config-management unmanage \ --membership=MEMBERSHIP_NAME diff --git a/gcloud/alpha/container/hub/config-management/upgrade b/gcloud/alpha/container/hub/config-management/upgrade index 82ba6e92c..7d195523f 100644 --- a/gcloud/alpha/container/hub/config-management/upgrade +++ b/gcloud/alpha/container/hub/config-management/upgrade @@ -1,6 +1,6 @@ NAME gcloud alpha container hub config-management upgrade - upgrade the version - of the Config Management Feature + of the Config Management feature SYNOPSIS gcloud alpha container hub config-management upgrade --version=VERSION @@ -8,7 +8,7 @@ SYNOPSIS DESCRIPTION (ALPHA) Upgrade a specified membership to any supported version of the - Config Management Feature. + Config Management feature. EXAMPLES To upgrade a membership named MEMBERSHIP_NAME, run: diff --git a/gcloud/alpha/container/hub/help b/gcloud/alpha/container/hub/help index e1f3790ad..57e0cae6c 100644 --- a/gcloud/alpha/container/hub/help +++ b/gcloud/alpha/container/hub/help @@ -52,7 +52,7 @@ GROUPS (ALPHA) Configure the Fleet clusterupgrade feature. config-management - (ALPHA) Manage Config Management Feature. + (ALPHA) Manage Config Management feature. dataplane-v2-encryption (ALPHA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/alpha/database-migration/migration-jobs/restart b/gcloud/alpha/database-migration/migration-jobs/restart index 26dd8c0f9..c259742ab 100644 --- a/gcloud/alpha/database-migration/migration-jobs/restart +++ b/gcloud/alpha/database-migration/migration-jobs/restart @@ -13,13 +13,13 @@ EXAMPLES To restart a migration job: $ gcloud alpha database-migration migration-jobs restart \ - MIGRATION_JOB --region=us-central1 + MIGRATION_JOB --region=us-central1 POSITIONAL ARGUMENTS - Migration job resource - Migration job resource - Cloud Database Migration - Service migration job to restart. 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. + Migration job resource - The migration job to restart. 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 migration_job on the command line with a fully @@ -40,7 +40,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --region=REGION - The name of the region. + The Cloud region for the migration_job. To set the region attribute: ▸ provide the argument migration_job on the command line with a @@ -55,10 +55,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the datamigration/v1alpha2 API. The full documentation - for this API can be found at: https://cloud.google.com/database-migration/ - 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/developer-connect/connections/create b/gcloud/alpha/developer-connect/connections/create index b63875658..f66dc6148 100644 --- a/gcloud/alpha/developer-connect/connections/create +++ b/gcloud/alpha/developer-connect/connections/create @@ -1,30 +1,36 @@ NAME - gcloud alpha developer-connect connections create - create connections + gcloud alpha developer-connect connections create - create a connection + resource SYNOPSIS - gcloud alpha developer-connect connections create - (CONNECTION : --location=LOCATION) [--annotations=[ANNOTATIONS,...]] - [--async] [--disabled] [--etag=ETAG] [--labels=[LABELS,...]] - [--request-id=REQUEST_ID] [--secret=SECRET] [--validate-only] + gcloud alpha developer-connect connections create CONNECTION + [--annotations=[ANNOTATIONS,...]] [--async] [--disabled] [--etag=ETAG] + [--labels=[LABELS,...]] [--location=LOCATION] [--request-id=REQUEST_ID] + [--secret=SECRET] [--validate-only] + [(--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + : --key-ring=KEY_RING)] [[--github-config-app=GITHUB_CONFIG_APP - : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION] + : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a connection + (ALPHA) Create a connection resource. EXAMPLES - To create the connection, run: + To create a GitHub connection named my-connection in us-central1 run: - $ gcloud alpha developer-connect connections create + $ gcloud alpha developer-connect connections create my-connection \ + --github-config-app=developer-connect \ + --github-config-authorizer-credential-oauth-token-secret-version\ + =projects/my-project/secrets/my-oauth-token/versions/1 \ + --github-config-app-installation-id=12345 --location=us-central1 POSITIONAL ARGUMENTS Connection resource - Identifier. The resource name of the connection, in the format - projects/{project}/locations/{location}/connections/{connection_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. + projects/{project}/locations/{location}/connections/{connection_id}. 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 connection on the command line with a fully @@ -32,6 +38,11 @@ POSITIONAL ARGUMENTS ◆ 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. + This must be specified. CONNECTION @@ -41,17 +52,6 @@ POSITIONAL ARGUMENTS 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. - - --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. - FLAGS --annotations=[ANNOTATIONS,...] Allows clients to store small amounts of arbitrary data. @@ -111,6 +111,11 @@ FLAGS --labels=path_to_file.(yaml|json) + --location=LOCATION + For resources [connection, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. + --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to @@ -134,6 +139,48 @@ FLAGS --validate-only If set, validate the request, but do not actually post it. + The crypto key configuration. This field is used by the Customer-managed + encryption keys (CMEK) feature. + + CryptoKey resource - The name of the key which is used to + encrypt/decrypt customer data. For key in Cloud KMS, the key should be + in the format of projects/*/locations/*/keyRings/*/cryptoKeys/*. 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 --crypto-key-config-reference 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 --crypto-key-config-reference on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + + This must be specified. + + --crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line with a fully specified name; + ▫ provide the argument --key-ring on the command line. + Arguments for the connection config. At most one of these can be specified: @@ -188,6 +235,85 @@ FLAGS --github-config-authorizer-credential-oauth-token-secret-version on the command line. + Configuration for connections to an instance of GitHub Enterprise. + + --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitHub Enterprise host this connection is for. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID + ID of the GitHub App created from the manifest. + + --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID + ID of the installation of the GitHub App. + + SecretVersion resource - SecretManager resource containing the private + key of the GitHub App, formatted as projects/*/secrets/*/versions/*. + 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 + --github-enterprise-config-private-key-secret-version 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 secret attribute: + ▫ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line with a fully specified name; + ▫ provide the argument --secret on the command line. + + --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL certificate to use for requests to GitHub Enterprise. + + SecretVersion resource - SecretManager resource containing the webhook + secret of the GitHub App, formatted as + projects/*/secrets/*/versions/*. 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 + --github-enterprise-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --github-enterprise-config-webhook-secret-version on the command + line with a fully specified name; + ▫ provide the argument --secret on the command line. + + --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --github-enterprise-config-webhook-secret-version on the + command line. + Configuration for connections to gitlab.com. Represents a personal access token that authorized the Connection, and @@ -287,6 +413,122 @@ FLAGS ◇ provide the argument --gitlab-config-webhook-secret-version on the command line. + Configuration for connections to an instance of GitLab Enterprise. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line. + + --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitLab Enterprise host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret of a GitLab project, formatted as + projects/*/secrets/*/versions/*. This is used to validate webhooks. + 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 + --gitlab-enterprise-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --gitlab-enterprise-config-webhook-secret-version on the command + line with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --gitlab-enterprise-config-webhook-secret-version on the + command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL Certificate Authority certificate to use for requests to GitLab + Enterprise instance. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, @@ -304,5 +546,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections create diff --git a/gcloud/alpha/developer-connect/connections/delete b/gcloud/alpha/developer-connect/connections/delete index 0784ca0d8..6c1698a3b 100644 --- a/gcloud/alpha/developer-connect/connections/delete +++ b/gcloud/alpha/developer-connect/connections/delete @@ -1,5 +1,6 @@ NAME - gcloud alpha developer-connect connections delete - delete connections + gcloud alpha developer-connect connections delete - delete a single + connection SYNOPSIS gcloud alpha developer-connect connections delete @@ -7,12 +8,13 @@ SYNOPSIS [--request-id=REQUEST_ID] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a connection + (ALPHA) Delete a single connection. EXAMPLES - To delete the connection, run: + To delete a connection my-comection in location us-central1 run: - $ gcloud alpha developer-connect connections delete + $ gcloud alpha developer-connect connections delete my-connection \ + --location=us-central1 POSITIONAL ARGUMENTS Connection resource - Name of the resource The arguments in this group can @@ -90,5 +92,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections delete diff --git a/gcloud/alpha/developer-connect/connections/describe b/gcloud/alpha/developer-connect/connections/describe index 0d018c7bd..6d1159235 100644 --- a/gcloud/alpha/developer-connect/connections/describe +++ b/gcloud/alpha/developer-connect/connections/describe @@ -1,17 +1,20 @@ NAME - gcloud alpha developer-connect connections describe - describe connections + gcloud alpha developer-connect connections describe - get details of a + single connection resource SYNOPSIS gcloud alpha developer-connect connections describe (CONNECTION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a connection + (ALPHA) Get details of a single connection resource. EXAMPLES - To describe the connection, run: + To get the details of a single conenction my-connection in location + us-central1 run: - $ gcloud alpha developer-connect connections describe + $ gcloud alpha developer-connect connections describe \ + my-connection --location=us-central1 POSITIONAL ARGUMENTS Connection resource - Name of the resource The arguments in this group can @@ -61,5 +64,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections describe diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/create b/gcloud/alpha/developer-connect/connections/git-repository-links/create index 9f6938c9c..ed1a550df 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/create +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/create @@ -1,6 +1,6 @@ NAME gcloud alpha developer-connect connections git-repository-links create - - create gitRepositoryLinks + create a git repository link SYNOPSIS gcloud alpha developer-connect connections git-repository-links create @@ -10,12 +10,23 @@ SYNOPSIS [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a gitRepositoryLink + (ALPHA) Create a git repository link. EXAMPLES - To create the gitRepositoryLink, run: + To create a git repository link 'my-git-repository-link' in a connection + my-connection in us-central1 run: - $ gcloud alpha developer-connect connections git-repository-links \ create + $ gcloud alpha developer-connect connections git-repository-links \ create my-git-repository-link \ + --clone-uri=https://github.com/my-org/my-repo.git \ + --connection=my-connection --location=us-central1 + + Or run: + + $ gcloud alpha developer-connect connections git-repository-links \ create \ + projects/my-project/locations/us-central1/connections/\ + my-connection/gitRepositoryLinks/my-git-repository-link \ + --clone-uri=https://github.com/my-org/my-repo.git \ + --location=us-central1 POSITIONAL ARGUMENTS GitRepositoryLink resource - Identifier. Resource name of the repository, @@ -151,5 +162,8 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections git-repository-links \ + create diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/delete b/gcloud/alpha/developer-connect/connections/git-repository-links/delete index cab5112f1..5e9c35b0e 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/delete +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/delete @@ -1,6 +1,6 @@ NAME gcloud alpha developer-connect connections git-repository-links delete - - delete gitRepositoryLinks + delete a single git repository link SYNOPSIS gcloud alpha developer-connect connections git-repository-links delete @@ -9,12 +9,14 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a gitRepositoryLink + (ALPHA) Delete a single git repository link. EXAMPLES - To delete the gitRepositoryLink, run: + To delete a git repository link my-git-repository-link in a connection + my-comection in location us-central1 run: - $ gcloud alpha developer-connect connections git-repository-links \ delete + $ gcloud alpha developer-connect connections git-repository-links \ delete my-git-repository-link --connection=my-connection \ + --location=us-central1 POSITIONAL ARGUMENTS GitRepositoryLink resource - Name of the resource The arguments in this @@ -101,5 +103,8 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections git-repository-links \ + delete diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/describe b/gcloud/alpha/developer-connect/connections/git-repository-links/describe index 718a52383..d07660197 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/describe +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/describe @@ -1,6 +1,6 @@ NAME gcloud alpha developer-connect connections git-repository-links describe - - describe gitRepositoryLinks + get details of a single git repository link SYNOPSIS gcloud alpha developer-connect connections git-repository-links describe @@ -8,12 +8,14 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a gitRepositoryLink + (ALPHA) Get details of a single git repository link. EXAMPLES - To describe the gitRepositoryLink, run: + To get the details of a single git repository link my-git-repository-link + in a conenction my-connection in location us-central1 run: - $ gcloud alpha developer-connect connections git-repository-links \ describe + $ gcloud alpha developer-connect connections git-repository-links \ describe my-git-repository-link --connection=my-connection \ + --location=us-central1-a POSITIONAL ARGUMENTS GitRepositoryLink resource - Name of the resource The arguments in this @@ -72,5 +74,8 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections git-repository-links \ + describe diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token index b7eb6a2fb..e1ff90334 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token @@ -77,5 +77,8 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections git-repository-links \ + fetch-read-token diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token index 14d14bc55..eb65894f3 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token @@ -78,5 +78,8 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections git-repository-links \ + fetch-read-write-token diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/help b/gcloud/alpha/developer-connect/connections/git-repository-links/help index 6e40f003e..645d2c682 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/help +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/help @@ -1,13 +1,13 @@ NAME gcloud alpha developer-connect connections git-repository-links - manage - Git Repository Link resources + git repository link resources SYNOPSIS gcloud alpha developer-connect connections git-repository-links COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Git Repository Link resources. + (ALPHA) Manage git repository link resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,13 +18,13 @@ COMMANDS COMMAND is one of the following: create - (ALPHA) Create gitRepositoryLinks. + (ALPHA) Create a git repository link. delete - (ALPHA) Delete gitRepositoryLinks. + (ALPHA) Delete a single git repository link. describe - (ALPHA) Describe gitRepositoryLinks. + (ALPHA) Get details of a single git repository link. fetch-read-token (ALPHA) Fetch the read token of a given gitRepositoryLink. @@ -33,11 +33,13 @@ COMMANDS (ALPHA) Fetch the read/write token of a given gitRepositoryLink. list - (ALPHA) List gitRepositoryLinks. + (ALPHA) List all git repository links in 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections git-repository-links diff --git a/gcloud/alpha/developer-connect/connections/git-repository-links/list b/gcloud/alpha/developer-connect/connections/git-repository-links/list index a3d6a0134..0adf09c0c 100644 --- a/gcloud/alpha/developer-connect/connections/git-repository-links/list +++ b/gcloud/alpha/developer-connect/connections/git-repository-links/list @@ -1,6 +1,6 @@ NAME gcloud alpha developer-connect connections git-repository-links list - list - gitRepositoryLinks + all git repository links in a connection SYNOPSIS gcloud alpha developer-connect connections git-repository-links list @@ -9,12 +9,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List gitRepositoryLinks + (ALPHA) List all git repository links in a connection. EXAMPLES - To list all gitRepositoryLinks, run: + To list all git repository links in a connection my-connection in location + us-central1 run: - $ gcloud alpha developer-connect connections git-repository-links \ list + $ gcloud alpha developer-connect connections git-repository-links \ list --connection=my-connection --location=us-central1 REQUIRED FLAGS Connection resource - Parent value for ListGitRepositoryLinksRequest The @@ -97,5 +98,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections git-repository-links list diff --git a/gcloud/alpha/developer-connect/connections/help b/gcloud/alpha/developer-connect/connections/help index f4a8d5e08..fab899bbe 100644 --- a/gcloud/alpha/developer-connect/connections/help +++ b/gcloud/alpha/developer-connect/connections/help @@ -1,12 +1,12 @@ NAME - gcloud alpha developer-connect connections - manage Connection resources + gcloud alpha developer-connect connections - manage connection resources SYNOPSIS gcloud alpha developer-connect connections GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Connection resources. + (ALPHA) Manage connection resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -17,29 +17,31 @@ GROUPS GROUP is one of the following: git-repository-links - (ALPHA) Manage Git Repository Link resources. + (ALPHA) Manage git repository link resources. COMMANDS COMMAND is one of the following: create - (ALPHA) Create connections. + (ALPHA) Create a connection resource. delete - (ALPHA) Delete connections. + (ALPHA) Delete a single connection. describe - (ALPHA) Describe connections. + (ALPHA) Get details of a single connection resource. list (ALPHA) List connections. update - (ALPHA) Update connections. + (ALPHA) Update the parameters of a single 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections diff --git a/gcloud/alpha/developer-connect/connections/list b/gcloud/alpha/developer-connect/connections/list index 82741af65..4fbd40b40 100644 --- a/gcloud/alpha/developer-connect/connections/list +++ b/gcloud/alpha/developer-connect/connections/list @@ -7,12 +7,13 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List connections + (ALPHA) List connections. EXAMPLES - To list all connections, run: + To list all connections in location us-central1 run: - $ gcloud alpha developer-connect connections list + $ gcloud alpha developer-connect connections list \ + --location=us-central1 REQUIRED FLAGS Location resource - Parent value for ListConnectionsRequest This @@ -82,5 +83,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections list diff --git a/gcloud/alpha/developer-connect/connections/update b/gcloud/alpha/developer-connect/connections/update index 57aecef55..6422b0369 100644 --- a/gcloud/alpha/developer-connect/connections/update +++ b/gcloud/alpha/developer-connect/connections/update @@ -1,35 +1,39 @@ NAME - gcloud alpha developer-connect connections update - update connections + gcloud alpha developer-connect connections update - update the parameters + of a single connection SYNOPSIS - gcloud alpha developer-connect connections update - (CONNECTION : --location=LOCATION) [--allow-missing] [--async] - [--disabled] [--etag=ETAG] [--request-id=REQUEST_ID] [--secret=SECRET] - [--validate-only] + gcloud alpha developer-connect connections update CONNECTION + [--[no-]allow-missing] [--async] [--[no-]disabled] [--etag=ETAG] + [--location=LOCATION] [--request-id=REQUEST_ID] [--secret=SECRET] + [--[no-]validate-only] [--annotations=[ANNOTATIONS,...] | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations | --remove-annotations=[__REMOVE_ANNOTATIONS,...]] + [--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + : --key-ring=KEY_RING] [--github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID - --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION] + --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] [--labels=[LABELS,...] | --update-labels=[UPDATE_LABELS,...] --clear-labels | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a connection + (ALPHA) Update a connection. EXAMPLES - To update the connection, run: + To update the labels of a connection my-connection in location us-central1 + run: - $ gcloud alpha developer-connect connections update + $ gcloud alpha developer-connect connections update my-connection \ + --labels=key1=value1 --location=us-central1 POSITIONAL ARGUMENTS Connection resource - Identifier. The resource name of the connection, in the format - projects/{project}/locations/{location}/connections/{connection_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. + projects/{project}/locations/{location}/connections/{connection_id}. 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 connection on the command line with a fully @@ -37,6 +41,11 @@ POSITIONAL ARGUMENTS ◆ 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. + This must be specified. CONNECTION @@ -46,39 +55,35 @@ POSITIONAL ARGUMENTS 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. - - --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. - FLAGS - --allow-missing + --[no-]allow-missing If set to true, and the connection is not found a new connection will be created. In this situation update_mask is ignored. The creation will succeed only if the input connection has all the necessary information (e.g a github_config with both user_oauth_token and installation_id - properties). + properties). Use --allow-missing to enable and --no-allow-missing to + disable. --async Return immediately, without waiting for the operation in progress to complete. - --disabled + --[no-]disabled If disabled is set to true, functionality is disabled for this connection. Repository based API methods and webhooks processing for - repositories in this connection will be disabled. + repositories in this connection will be disabled. Use --disabled to + enable and --no-disabled to disable. --etag=ETAG This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. + --location=LOCATION + For resources [connection, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. + --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to @@ -99,8 +104,9 @@ FLAGS secret attribute. When the resource's full URI path is not provided, secret will fallback to this flag value. - --validate-only - If set, validate the request, but do not actually post it. + --[no-]validate-only + If set, validate the request, but do not actually post it. Use + --validate-only to enable and --no-validate-only to disable. Update annotations. @@ -158,6 +164,46 @@ FLAGS --remove-annotations=[__REMOVE_ANNOTATIONS,...] Remove existing value from map annotations. + The crypto key configuration. This field is used by the Customer-managed + encryption keys (CMEK) feature. + + CryptoKey resource - The name of the key which is used to + encrypt/decrypt customer data. For key in Cloud KMS, the key should be + in the format of projects/*/locations/*/keyRings/*/cryptoKeys/*. 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 --crypto-key-config-reference 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 --crypto-key-config-reference on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + + --crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line with a fully specified name; + ▫ provide the argument --key-ring on the command line. + Arguments for the connection config. At most one of these can be specified: @@ -198,6 +244,103 @@ FLAGS --github-config-authorizer-credential-oauth-token-secret-version on the command line. + Configuration for connections to an instance of GitHub Enterprise. + + --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID + ID of the GitHub App created from the manifest. + + --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID + ID of the installation of the GitHub App. + + --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitHub Enterprise host this connection is for. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL certificate to use for requests to GitHub Enterprise. + + Update github_enterprise_config_private_key_secret_version. + + At most one of these can be specified: + + --clear-github-enterprise-config-private-key-secret-version + Clear github_enterprise_config_private_key_secret_version value + and set to null. + + SecretVersion resource - Set + github_enterprise_config_private_key_secret_version to new value. + + SecretManager resource containing the private key of the GitHub App, + formatted as projects/*/secrets/*/versions/*. 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 + --github-enterprise-config-private-key-secret-version 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 secret attribute: + ◇ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line. + + Update github_enterprise_config_webhook_secret_version. + + At most one of these can be specified: + + --clear-github-enterprise-config-webhook-secret-version + Clear github_enterprise_config_webhook_secret_version value and + set to null. + + SecretVersion resource - Set + github_enterprise_config_webhook_secret_version to new value. + + SecretManager resource containing the webhook secret of the GitHub + App, formatted as projects/*/secrets/*/versions/*. 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 + --github-enterprise-config-webhook-secret-version 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 secret attribute: + ◇ provide the argument + --github-enterprise-config-webhook-secret-version on the command + line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --github-enterprise-config-webhook-secret-version on the + command line. + Configuration for connections to gitlab.com. Represents a personal access token that authorized the Connection, and @@ -262,6 +405,84 @@ FLAGS --gitlab-config-read-authorizer-credential-user-token-secret-version on the command line. + Configuration for connections to an instance of GitLab Enterprise. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line. + + --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitLab Enterprise host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL Certificate Authority certificate to use for requests to GitLab + Enterprise instance. + Update labels. At most one of these can be specified: @@ -337,5 +558,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect connections update diff --git a/gcloud/alpha/developer-connect/help b/gcloud/alpha/developer-connect/help index 9f4815c1a..120d24f8a 100644 --- a/gcloud/alpha/developer-connect/help +++ b/gcloud/alpha/developer-connect/help @@ -16,7 +16,7 @@ GROUPS GROUP is one of the following: connections - (ALPHA) Manage Connection resources. + (ALPHA) Manage connection resources. operations (ALPHA) Manage Operation resources. @@ -25,5 +25,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect diff --git a/gcloud/alpha/developer-connect/operations/cancel b/gcloud/alpha/developer-connect/operations/cancel index 03c7b4209..44bee4529 100644 --- a/gcloud/alpha/developer-connect/operations/cancel +++ b/gcloud/alpha/developer-connect/operations/cancel @@ -61,5 +61,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect operations cancel diff --git a/gcloud/alpha/developer-connect/operations/delete b/gcloud/alpha/developer-connect/operations/delete index 1584d8928..654a45ca5 100644 --- a/gcloud/alpha/developer-connect/operations/delete +++ b/gcloud/alpha/developer-connect/operations/delete @@ -61,5 +61,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect operations delete diff --git a/gcloud/alpha/developer-connect/operations/describe b/gcloud/alpha/developer-connect/operations/describe index 5f288dfdb..dfe9b4a66 100644 --- a/gcloud/alpha/developer-connect/operations/describe +++ b/gcloud/alpha/developer-connect/operations/describe @@ -61,5 +61,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect operations describe diff --git a/gcloud/alpha/developer-connect/operations/help b/gcloud/alpha/developer-connect/operations/help index 76b811b40..3ff257b66 100644 --- a/gcloud/alpha/developer-connect/operations/help +++ b/gcloud/alpha/developer-connect/operations/help @@ -34,5 +34,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect operations diff --git a/gcloud/alpha/developer-connect/operations/list b/gcloud/alpha/developer-connect/operations/list index 0b698b125..e09a1a127 100644 --- a/gcloud/alpha/developer-connect/operations/list +++ b/gcloud/alpha/developer-connect/operations/list @@ -82,5 +82,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect operations list diff --git a/gcloud/alpha/developer-connect/operations/wait b/gcloud/alpha/developer-connect/operations/wait index 7ca227467..3ffcbbe4c 100644 --- a/gcloud/alpha/developer-connect/operations/wait +++ b/gcloud/alpha/developer-connect/operations/wait @@ -61,5 +61,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta developer-connect operations wait diff --git a/gcloud/alpha/edge-cloud/container/clusters/update b/gcloud/alpha/edge-cloud/container/clusters/update index 68e787f14..e94835133 100644 --- a/gcloud/alpha/edge-cloud/container/clusters/update +++ b/gcloud/alpha/edge-cloud/container/clusters/update @@ -12,7 +12,9 @@ SYNOPSIS [--clear-max-unavailable-worker-nodes | --max-unavailable-worker-nodes=MAX_UNAVAILABLE_WORKER_NODES] [--control-plane-kms-key=CONTROL_PLANE_KMS_KEY - | --use-google-managed-key] [GCLOUD_WIDE_FLAG ...] + | --use-google-managed-key] + [--use-google-managed-zone-key + | --zone-storage-kms-key=ZONE_STORAGE_KMS_KEY] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an Edge Container cluster. @@ -149,6 +151,14 @@ FLAGS If set, use Google managed key for the cluster control plane nodes encryption. + At most one of these can be specified: + + --use-google-managed-zone-key + If set, use Google managed key for zone storage encryption. + + --zone-storage-kms-key=ZONE_STORAGE_KMS_KEY + If set, use the specified KMS key for zone storage encryption. + 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/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index dc46c038c..5da589d43 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -9,9 +9,7 @@ SYNOPSIS [--enable-message-ordering] [--expiration-period=EXPIRATION_PERIOD] [--labels=[KEY=VALUE,...]] [--message-filter=MESSAGE_FILTER] [--message-retention-duration=MESSAGE_RETENTION_DURATION] - [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL] - [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] - [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] + [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema @@ -21,8 +19,10 @@ SYNOPSIS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] [--max-retry-delay=MAX_RETRY_DELAY --min-retry-delay=MIN_RETRY_DELAY] - [--push-no-wrapper : --push-no-wrapper-write-metadata] - [GCLOUD_WIDE_FLAG ...] + [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + --push-endpoint=PUSH_ENDPOINT [--push-no-wrapper + : --push-no-wrapper-write-metadata]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Creates one or more Cloud Pub/Sub subscriptions for a given topic. @@ -128,18 +128,6 @@ OPTIONAL FLAGS seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --push-auth-service-account=SERVICE_ACCOUNT_EMAIL - Service account email used as the identity for the generated Open ID - Connect token for authenticated push. - - --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE - Audience used in the generated Open ID Connect token for authenticated - push. If not specified, it will be set to the push-endpoint. - - --push-endpoint=PUSH_ENDPOINT - A URL to use as the endpoint for this subscription. This will also - automatically set the subscription type to PUSH. - --retain-acked-messages Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the @@ -318,21 +306,36 @@ OPTIONAL FLAGS of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - NoWrapper Config Options. + Push Config Options. Configuration for a push delivery endpoint. - --push-no-wrapper - When set, the message data is delivered directly as the HTTP body. - Use --no-push-no-wrapper to disable this flag. + --push-auth-service-account=SERVICE_ACCOUNT_EMAIL + Service account email used as the identity for the generated Open ID + Connect token for authenticated push. - This flag argument must be specified if any of the other arguments in - this group are specified. + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + Audience used in the generated Open ID Connect token for + authenticated push. If not specified, it will be set to the + push-endpoint. - --push-no-wrapper-write-metadata - When true, writes the Pub/Sub message metadata to - x-goog-pubsub-: headers of the HTTP request. Writes the - Pub/Sub message attributes to : headers of the HTTP - request. Use --no-push-no-wrapper-write-metadata to disable this - flag. + --push-endpoint=PUSH_ENDPOINT + A URL to use as the endpoint for this subscription. This will also + automatically set the subscription type to PUSH. + + NoWrapper Config Options. + + --push-no-wrapper + When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --push-no-wrapper-write-metadata + When true, writes the Pub/Sub message metadata to + x-goog-pubsub-: headers of the HTTP request. Writes the + Pub/Sub message attributes to : headers of the HTTP + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 00e082e00..90ca7a112 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -7,10 +7,7 @@ SYNOPSIS [--ack-deadline=ACK_DEADLINE] [--enable-exactly-once-delivery] [--expiration-period=EXPIRATION_PERIOD] [--message-retention-duration=MESSAGE_RETENTION_DURATION] - [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL] - [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] - [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] - [--update-labels=[KEY=VALUE,...]] + [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema @@ -22,10 +19,13 @@ SYNOPSIS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] [--clear-labels | --remove-labels=[KEY,...]] - [--clear-push-no-wrapper-config - | [--push-no-wrapper : --push-no-wrapper-write-metadata]] [--clear-retry-policy | --max-retry-delay=MAX_RETRY_DELAY - --min-retry-delay=MIN_RETRY_DELAY] [GCLOUD_WIDE_FLAG ...] + --min-retry-delay=MIN_RETRY_DELAY] + [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + --push-endpoint=PUSH_ENDPOINT --clear-push-no-wrapper-config + | [--push-no-wrapper : --push-no-wrapper-write-metadata]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Updates an existing Cloud Pub/Sub subscription. @@ -82,18 +82,6 @@ FLAGS "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --push-auth-service-account=SERVICE_ACCOUNT_EMAIL - Service account email used as the identity for the generated Open ID - Connect token for authenticated push. - - --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE - Audience used in the generated Open ID Connect token for authenticated - push. If not specified, it will be set to the push-endpoint. - - --push-endpoint=PUSH_ENDPOINT - A URL to use as the endpoint for this subscription. This will also - automatically set the subscription type to PUSH. - --retain-acked-messages Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the @@ -123,6 +111,10 @@ FLAGS service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to write to this BigQuery table. + When updating BigQueryConfig flags, all BigQueryConfig flags must be + specified. Otherwise, any omitted BigQueryConfig flags revert to their + default value. + --bigquery-table=BIGQUERY_TABLE A BigQuery table of the form {project}:{dataset_name}.{table_name} to which to write messages @@ -177,6 +169,10 @@ FLAGS have permission to write to this Cloud Storage bucket and to read this bucket's metadata. + When updating CloudStorageConfig flags, all CloudStorageConfig flags + must be specified. Otherwise, any omitted CloudStorageConfig flags + revert to their default value. + Note that an update to the Cloud Storage config will replace it with a new config containing only the flags that are passed in the update CLI. @@ -257,6 +253,10 @@ FLAGS have permission to Publish() to this topic and Acknowledge() messages on this subscription. + When updating DeadLetterPolicy flags, all DeadLetterPolicy flags must be + specified. Otherwise, any omitted DeadLetterPolicy flags revert to their + default value. + --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS Maximum number of delivery attempts for any message. The value must be between 5 and 100. Defaults to 5. --dead-letter-topic must also @@ -307,28 +307,6 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. - At most one of these can be specified: - - --clear-push-no-wrapper-config - If set, clear the NoWrapper config from the subscription. Use - --no-clear-push-no-wrapper-config to disable this flag. - - NoWrapper Config Options. - - --push-no-wrapper - When set, the message data is delivered directly as the HTTP body. - Use --no-push-no-wrapper to disable this flag. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --push-no-wrapper-write-metadata - When true, writes the Pub/Sub message metadata to - x-goog-pubsub-: headers of the HTTP request. Writes the - Pub/Sub message attributes to : headers of the HTTP - request. Use --no-push-no-wrapper-write-metadata to disable this - flag. - At most one of these can be specified: --clear-retry-policy @@ -338,6 +316,10 @@ FLAGS Retry Policy Options. Retry policy specifies how Cloud Pub/Sub retries message delivery for this subscription. + When updating RetryPolicy flags, all RetryPolicy flags must be + specified. Otherwise, any omitted RetryPolicy flags revert to their + default value. + --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 @@ -352,6 +334,46 @@ FLAGS UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + Push Config Options. Configuration for a push delivery endpoint. + + When updating PushConfig flags, all PushConfig flags must be specified. + Otherwise, any omitted PushConfig flags revert to their default value. + + --push-auth-service-account=SERVICE_ACCOUNT_EMAIL + Service account email used as the identity for the generated Open ID + Connect token for authenticated push. + + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + Audience used in the generated Open ID Connect token for + authenticated push. If not specified, it will be set to the + push-endpoint. + + --push-endpoint=PUSH_ENDPOINT + A URL to use as the endpoint for this subscription. This will also + automatically set the subscription type to PUSH. + + At most one of these can be specified: + + --clear-push-no-wrapper-config + If set, clear the NoWrapper config from the subscription. Use + --no-clear-push-no-wrapper-config to disable this flag. + + NoWrapper Config Options. + + --push-no-wrapper + When set, the message data is delivered directly as the HTTP + body. Use --no-push-no-wrapper to disable this flag. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --push-no-wrapper-write-metadata + When true, writes the Pub/Sub message metadata to + x-goog-pubsub-: headers of the HTTP request. Writes the + Pub/Sub message attributes to : headers of the HTTP + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. + 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/pubsub/topics/update b/gcloud/alpha/pubsub/topics/update index 4fe84d8d9..4d6a22aef 100644 --- a/gcloud/alpha/pubsub/topics/update +++ b/gcloud/alpha/pubsub/topics/update @@ -119,6 +119,10 @@ FLAGS The following flags are for specifying ingestion settings for an import topic from Amazon Web Services (AWS) Kinesis Data Streams + When updating AWSKinesis Source flags, all AWSKinesis Source flags must + be specified. Otherwise, any omitted AWSKinesis Source flags revert to + their default value. + --kinesis-ingestion-consumer-arn=KINESIS_INGESTION_CONSUMER_ARN The Kinesis data streams consumer Amazon Resource Name (ARN) to use for ingestion. @@ -194,6 +198,10 @@ FLAGS Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. + When updating SchemaSettings flags, all SchemaSettings flags must be + specified. Otherwise, any omitted SchemaSettings flags revert to their + default value. + --message-encoding=ENCODING The encoding of messages validated against the schema. ENCODING must be one of: json, binary. @@ -243,7 +251,11 @@ FLAGS Options for explicitly specifying the message storage policy (https://cloud.google.com/pubsub/docs/resource-location-restriction) for - a topic. These fields can be set only if the + a topic. + + When updating MessageStoragePolicy flags, all MessageStoragePolicy flags + must be specified. Otherwise, any omitted MessageStoragePolicy flags + revert to their default value. These fields can be set only if the --recompute-message-storage-policy flag is not set. --message-storage-policy-allowed-regions=[REGION,...] diff --git a/gcloud/alpha/recommender/insights/list b/gcloud/alpha/recommender/insights/list index 2a6f9ebf0..45eb0fe54 100644 --- a/gcloud/alpha/recommender/insights/list +++ b/gcloud/alpha/recommender/insights/list @@ -51,11 +51,13 @@ FLAGS 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 + 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 @@ -69,8 +71,9 @@ 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. Use --recursive to enable and --no-recursive to - disable. Use --recursive to enable and --no-recursive to disable. + use BigQuery Export. 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 976719d86..280b93e31 100644 --- a/gcloud/alpha/recommender/recommendations/list +++ b/gcloud/alpha/recommender/recommendations/list @@ -47,13 +47,15 @@ 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 @@ -68,8 +70,8 @@ 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. Use --recursive to enable and --no-recursive to disable. Use - --recursive to enable and --no-recursive to disable. + Export. 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/sql/instances/patch b/gcloud/alpha/sql/instances/patch index ebf5b0f98..9e6e47b1f 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -49,7 +49,8 @@ SYNOPSIS [--storage-size=STORAGE_SIZE] [--switch-transaction-logs-to-cloud-storage] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] - [--update-labels=[KEY=VALUE,...]] [--upgrade-sql-network-architecture] + [--time-zone=TIME_ZONE] [--update-labels=[KEY=VALUE,...]] + [--upgrade-sql-network-architecture] [--allowed-psc-projects=PROJECT,[PROJECT,...] | --clear-allowed-psc-projects] [--authorized-gae-apps=APP,[APP,...] | --clear-gae-apps] @@ -412,6 +413,9 @@ FLAGS https://cloud.google.com/sql/pricing. WARNING: Instance will be restarted. + --time-zone=TIME_ZONE + Set a non-default time zone. Only available for SQL Server instances. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/alpha/storage/diagnose b/gcloud/alpha/storage/diagnose index 8c3a0b49d..439648197 100644 --- a/gcloud/alpha/storage/diagnose +++ b/gcloud/alpha/storage/diagnose @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud alpha storage diagnose URL [--test-type=[TEST_TYPES,...]] [--download-type=DOWNLOAD_TYPE; default=] + [--logs-path=LOGS_PATH] [--upload-type=UPLOAD_TYPE; default=] [--process-count=PROCESS_COUNT] [--thread-count=THREAD_COUNT] [--object-count=OBJECT_COUNT (--object-size=OBJECT_SIZE @@ -42,7 +43,7 @@ EXAMPLES diagnostic tests: $ gcloud alpha storage diagnose gs://my-bucket \ - --test-type=[UPLOAD_THROUGHPUT,DOWNLOAD_THROUGHPUT] + --test-type=UPLOAD_THROUGHPUT,DOWNLOAD_THROUGHPUT The following command runs the diagnostic tests using 10 objects of 1MiB size each with 10 threads and 10 processes at max: @@ -64,17 +65,20 @@ FLAGS --test-type=[TEST_TYPES,...] Tests to run as part of this diagnosis. Following tests are supported: + DIRECT_CONNECTIVITY: Run a test upload over the Direct Connectivity + network path and run other diagnostics if the upload fails. + DOWNLOAD_THROUGHPUT: Upload objects to the specified bucket and record - the number of bytes transfered per second. + the number of bytes transferred per second. UPLOAD_THROUGHPUT: Download objects from the specified bucket and - record the number of bytes transfered per second. + record the number of bytes transferred per second. - LATENCY: Writes the objects, retrieves its metadata, reads the objects - and records latency of each operation. + LATENCY: Write the objects, retrieve their metadata, read the objects, + and record latency of each operation. - TEST_TYPES must be one of: DOWNLOAD_THROUGHPUT, LATENCY, - UPLOAD_THROUGHPUT. + TEST_TYPES must be one of: DIRECT_CONNECTIVITY, DOWNLOAD_THROUGHPUT, + LATENCY, UPLOAD_THROUGHPUT. --download-type=DOWNLOAD_TYPE; default= Download strategy to use for the DOWNLOAD_THROUGHPUT diagnostic test. @@ -93,6 +97,10 @@ FLAGS DOWNLOAD_TYPE must be one of: FILE, SLICED, STREAMING. + --logs-path=LOGS_PATH + If the diagnostic supports writing logs, write the logs to this file + location. + --upload-type=UPLOAD_TYPE; default= Upload strategy to use for the UPLOAD_THROUGHPUT diagnostic test. diff --git a/gcloud/alpha/storage/ls b/gcloud/alpha/storage/ls index 5a360d95a..82f115847 100644 --- a/gcloud/alpha/storage/ls +++ b/gcloud/alpha/storage/ls @@ -123,8 +123,8 @@ FLAGS expression. --soft-deleted - Displays soft-deleted objects only. Excludes live and noncurrent - objects. + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. At most one of these can be specified: diff --git a/gcloud/alpha/storage/objects/describe b/gcloud/alpha/storage/objects/describe index 49dab3d96..a493ee7ec 100644 --- a/gcloud/alpha/storage/objects/describe +++ b/gcloud/alpha/storage/objects/describe @@ -43,8 +43,8 @@ FLAGS standardizing it. --soft-deleted - Displays soft-deleted objects only. Excludes live and noncurrent - objects. + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. ENCRYPTION FLAGS --decryption-keys=[DECRYPTION_KEY,...] diff --git a/gcloud/alpha/storage/objects/list b/gcloud/alpha/storage/objects/list index 0a842a98f..655d6b28b 100644 --- a/gcloud/alpha/storage/objects/list +++ b/gcloud/alpha/storage/objects/list @@ -66,8 +66,8 @@ FLAGS standardizing it. --soft-deleted - Displays soft-deleted objects only. Excludes live and noncurrent - objects. + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. --stat Emulates gsutil stat-style behavior. Does not show past object versions diff --git a/gcloud/alpha/storage/restore b/gcloud/alpha/storage/restore index 115efbebd..ed4584794 100644 --- a/gcloud/alpha/storage/restore +++ b/gcloud/alpha/storage/restore @@ -10,11 +10,19 @@ SYNOPSIS --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) The restore command restores soft-deleted objects: + (ALPHA) The restore command restores soft-deleted resources: $ gcloud alpha storage restore url... EXAMPLES + Restore soft-deleted version of bucket with generations: + + $ gcloud alpha storage restore gs://bucket#123 + + 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. $ gcloud alpha storage restore gs://bucket/file1.txt diff --git a/gcloud/beta/bigtable/app-profiles/create b/gcloud/beta/bigtable/app-profiles/create index 87cc572eb..c170f9400 100644 --- a/gcloud/beta/bigtable/app-profiles/create +++ b/gcloud/beta/bigtable/app-profiles/create @@ -116,23 +116,23 @@ OPTIONAL FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost Read-only Isolation, rather than Standard Isolation. - If specified, --data-boost-compute-billing-owner is required. - Specifying Data Boost Read-only Isolation on an app profile which - has Standard Isolation enabled may cause unexpected behavior for - running applications. + Use Data Boost serverless compute option, rather than standard + provisioned node compute. If specified, + --data-boost-compute-billing-owner is required. Specifying Data + Boost compute on an app profile that uses standard provisioned node + compute may cause unexpected behavior for running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost Compute Billing Owner, required if + Specify the Data Boost compute billing owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute Billing should be accounted towards the host Cloud - Project (containing the targeted Bigtable Instance / Table). + Compute billing should be accounted towards the host Cloud + project (containing the targeted Bigtable instance / table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -140,14 +140,15 @@ OPTIONAL FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under Standard Isolation. Passing this - option implies Standard Isolation, e.g. the --standard option. If - not specified, the app profile uses Standard Isolation with - PRIORITY_HIGH by default. Specifying request priority on an app - profile that has Data Boost Read-Only Isolation enabled will change - the isolation to Standard and use the specified priority, which may - cause unexpected behavior for running applications. PRIORITY must - be one of: + Specify the request priority under standard provisioned node + compute capabilities. Passing this option implies standard + provisioned node compute, e.g. the --standard option. If not + specified, the app profile uses standard provisioned node compute + with PRIORITY_HIGH by default. Specifying request priority on an + app profile that has Data Boost serverless compute enabled changes + the compute option to standard and uses the specified priority, + which might cause unexpected behavior for running applications. + PRIORITY must be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -160,8 +161,8 @@ OPTIONAL FLAGS in this group are specified. --standard - Use Standard Isolation, rather than Data Boost Read-only Isolation. - If specified, --priority is required. + Use standard provisioned node compute option, rather than Data + Boost compute option. If specified, --priority is required. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/bigtable/app-profiles/update b/gcloud/beta/bigtable/app-profiles/update index fd0a6e906..ab39962c6 100644 --- a/gcloud/beta/bigtable/app-profiles/update +++ b/gcloud/beta/bigtable/app-profiles/update @@ -93,23 +93,23 @@ FLAGS Data Boost Read-only Isolation --data-boost - Use Data Boost Read-only Isolation, rather than Standard Isolation. - If specified, --data-boost-compute-billing-owner is required. - Specifying Data Boost Read-only Isolation on an app profile which - has Standard Isolation enabled may cause unexpected behavior for - running applications. + Use Data Boost serverless compute option, rather than standard + provisioned node compute. If specified, + --data-boost-compute-billing-owner is required. Specifying Data + Boost compute on an app profile that uses standard provisioned node + compute may cause unexpected behavior for running applications. This flag argument must be specified if any of the other arguments in this group are specified. --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER - Specify the Data Boost Compute Billing Owner, required if + Specify the Data Boost compute billing owner, required if --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be (only one value is supported): HOST_PAYS - Compute Billing should be accounted towards the host Cloud - Project (containing the targeted Bigtable Instance / Table). + Compute billing should be accounted towards the host Cloud + project (containing the targeted Bigtable instance / table). This flag argument must be specified if any of the other arguments in this group are specified. @@ -117,14 +117,15 @@ FLAGS Standard Isolation --priority=PRIORITY - Specify the request priority under Standard Isolation. Passing this - option implies Standard Isolation, e.g. the --standard option. If - not specified, the app profile uses Standard Isolation with - PRIORITY_HIGH by default. Specifying request priority on an app - profile that has Data Boost Read-Only Isolation enabled will change - the isolation to Standard and use the specified priority, which may - cause unexpected behavior for running applications. PRIORITY must - be one of: + Specify the request priority under standard provisioned node + compute capabilities. Passing this option implies standard + provisioned node compute, e.g. the --standard option. If not + specified, the app profile uses standard provisioned node compute + with PRIORITY_HIGH by default. Specifying request priority on an + app profile that has Data Boost serverless compute enabled changes + the compute option to standard and uses the specified priority, + which might cause unexpected behavior for running applications. + PRIORITY must be one of: PRIORITY_HIGH Requests are treated with high priority. @@ -137,8 +138,8 @@ FLAGS in this group are specified. --standard - Use Standard Isolation, rather than Data Boost Read-only Isolation. - If specified, --priority is required. + Use standard provisioned node compute option, rather than Data + Boost compute option. If specified, --priority is required. At most one of these can be specified: diff --git a/gcloud/beta/colab-enterprise/runtimes/delete b/gcloud/beta/colab-enterprise/runtimes/delete new file mode 100644 index 000000000..6d7438e29 --- /dev/null +++ b/gcloud/beta/colab-enterprise/runtimes/delete @@ -0,0 +1,64 @@ +NAME + gcloud beta colab-enterprise runtimes delete - delete a runtime + +SYNOPSIS + gcloud beta colab-enterprise runtimes delete (RUNTIME : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deletes a Colab Enterprise notebook runtime. + +EXAMPLES + To delete a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab-enterprise runtimes delete my-runtime \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to delete. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --region 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab-enterprise/runtimes/describe b/gcloud/beta/colab-enterprise/runtimes/describe new file mode 100644 index 000000000..b9ee9ee4f --- /dev/null +++ b/gcloud/beta/colab-enterprise/runtimes/describe @@ -0,0 +1,59 @@ +NAME + gcloud beta colab-enterprise runtimes describe - describe a runtime + +SYNOPSIS + gcloud beta colab-enterprise runtimes describe (RUNTIME : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describes a Colab Enterprise notebook runtime. + +EXAMPLES + To describe a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab-enterprise runtimes describe my-runtime \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to describe. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --region 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 beta and might change without notice. + diff --git a/gcloud/beta/colab-enterprise/runtimes/help b/gcloud/beta/colab-enterprise/runtimes/help index afd4c39cc..9cb41d8a6 100644 --- a/gcloud/beta/colab-enterprise/runtimes/help +++ b/gcloud/beta/colab-enterprise/runtimes/help @@ -20,6 +20,21 @@ COMMANDS assign (BETA) Assign a notebook runtime. + delete + (BETA) Delete a runtime. + + describe + (BETA) Describe a runtime. + + list + (BETA) List your project's runtimes. + + start + (BETA) Start a stopped runtime. + + upgrade + (BETA) Upgrade a runtime. + NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/colab-enterprise/runtimes/list b/gcloud/beta/colab-enterprise/runtimes/list new file mode 100644 index 000000000..79fd00fd2 --- /dev/null +++ b/gcloud/beta/colab-enterprise/runtimes/list @@ -0,0 +1,80 @@ +NAME + gcloud beta colab-enterprise runtimes list - list your project's runtimes + +SYNOPSIS + gcloud beta colab-enterprise runtimes list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists your project's Colab Enterprise notebook runtimes in a given + region. + +EXAMPLES + To list your runtimes in region 'us-central1', run: + + $ gcloud beta colab-enterprise runtimes list --region=us-central1 + +REQUIRED FLAGS + Region resource - Cloud region for which to list all runtimes. Please see + https://cloud.google.com/colab/docs/locations for a list of supported + regions. 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 --region 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. + + --region=REGION + ID of the region or fully qualified identifier for the region. + + To set the region attribute: + ▸ provide the argument --region 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab-enterprise/runtimes/start b/gcloud/beta/colab-enterprise/runtimes/start new file mode 100644 index 000000000..122bb7e30 --- /dev/null +++ b/gcloud/beta/colab-enterprise/runtimes/start @@ -0,0 +1,64 @@ +NAME + gcloud beta colab-enterprise runtimes start - start a stopped runtime + +SYNOPSIS + gcloud beta colab-enterprise runtimes start (RUNTIME : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Starts a stopped Colab Enterprise notebook runtime. + +EXAMPLES + To start a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab-enterprise runtimes start my-runtime \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to start. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --region 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/colab-enterprise/runtimes/upgrade b/gcloud/beta/colab-enterprise/runtimes/upgrade new file mode 100644 index 000000000..5b2182d0c --- /dev/null +++ b/gcloud/beta/colab-enterprise/runtimes/upgrade @@ -0,0 +1,64 @@ +NAME + gcloud beta colab-enterprise runtimes upgrade - upgrade a runtime + +SYNOPSIS + gcloud beta colab-enterprise runtimes upgrade (RUNTIME : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Upgrades a Colab Enterprise notebook runtime. + +EXAMPLES + To upgrade a runtime with id 'my-runtime' in region 'us-central1', run: + + $ gcloud beta colab-enterprise runtimes upgrade my-runtime \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Runtime resource - Unique name of the runtime to upgrade. This was + optionally provided by setting --runtime-id in the assign runtime command, + or was system-generated if unspecified. 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 runtime 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. + + RUNTIME + ID of the runtime or fully qualified identifier for the runtime. + + To set the name attribute: + ▸ provide the argument runtime on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Cloud region for the runtime. + + To set the region attribute: + ▸ provide the argument runtime on the command line with a fully + specified name; + ▸ provide the argument --region 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/compute/instance-groups/managed/create b/gcloud/beta/compute/instance-groups/managed/create index 5c1484d89..ab23f6613 100644 --- a/gcloud/beta/compute/instance-groups/managed/create +++ b/gcloud/beta/compute/instance-groups/managed/create @@ -8,6 +8,9 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--initial-delay=INITIAL_DELAY] [--instance-redistribution-type=TYPE] + [--instance-selection=name=NAME, + machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] [--resource-manager-tags=[KEY=VALUE,...]] [--standby-policy-initial-delay=STANDBY_POLICY_INITIAL_DELAY] @@ -131,6 +134,15 @@ OPTIONAL FLAGS The managed instance group proactively redistributes instances to meet its target distribution. + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] + Named selection of machine types with an optional rank. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + + --instance-selection-machine-types=[MACHINE_TYPE,...] + Machine types that are used to create VMs in the managed instance + group. If not provided, the machine type specified in the instance + template is used. + --list-managed-instances-results=MODE Pagination behavior for the group's listManagedInstances API method. This flag does not affect the group's gcloud or console list-instances diff --git a/gcloud/beta/compute/instance-groups/managed/update b/gcloud/beta/compute/instance-groups/managed/update index 61421d1da..34af4f4e0 100644 --- a/gcloud/beta/compute/instance-groups/managed/update +++ b/gcloud/beta/compute/instance-groups/managed/update @@ -7,7 +7,12 @@ SYNOPSIS [--default-action-on-vm-failure=ACTION_ON_VM_FAILURE] [--description=DESCRIPTION] [--[no-]force-update-on-repair] [--instance-redistribution-type=TYPE] + [--instance-selection=name=NAME, + machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK]] + [--instance-selection-machine-types=[MACHINE_TYPE,...]] [--list-managed-instances-results=MODE] + [--remove-instance-selections=[INSTANCE_SELECTION_NAME,...]] + [--remove-instance-selections-all] [--remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...]] [--remove-stateful-external-ips=INTERFACE_NAME,[...]] [--remove-stateful-internal-ips=INTERFACE_NAME,[...]] [--size=SIZE] @@ -109,6 +114,15 @@ FLAGS The managed instance group proactively redistributes instances to meet its target distribution. + --instance-selection=name=NAME,machine-type=MACHINE_TYPE[,machine-type=MACHINE_TYPE...][,rank=RANK] + Named selection of machine types with an optional rank. For example, + --instance-selection="name=instance-selection-1,machine-type=e2-standard-8,machine-type=t2d-standard-8,rank=0" + + --instance-selection-machine-types=[MACHINE_TYPE,...] + Machine types that are used to create VMs in the managed instance + group. If not provided, the machine type specified in the instance + template is used. + --list-managed-instances-results=MODE Pagination behavior for the group's listManagedInstances API method. This flag does not affect the group's gcloud or console list-instances @@ -122,6 +136,13 @@ FLAGS Pagination is enabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are respected. + --remove-instance-selections=[INSTANCE_SELECTION_NAME,...] + Remove specific instance selections from the instance flexibility + policy. + + --remove-instance-selections-all + Remove all instance selections from the instance flexibility policy. + --remove-stateful-disks=DEVICE_NAME,[DEVICE_NAME,...] Remove stateful configuration for the specified disks. diff --git a/gcloud/beta/container/backup-restore/restores/create b/gcloud/beta/container/backup-restore/restores/create index 3276cdab8..d0feed124 100644 --- a/gcloud/beta/container/backup-restore/restores/create +++ b/gcloud/beta/container/backup-restore/restores/create @@ -87,7 +87,7 @@ OPTIONAL FLAGS For more information about examples and how to use this filter, please refer to the Backup for GKE documentation: - https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke. + https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke/how-to/fine-grained-restore. --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/container/fleet/config-management/apply b/gcloud/beta/container/fleet/config-management/apply index ff3c00558..71c388d46 100644 --- a/gcloud/beta/container/fleet/config-management/apply +++ b/gcloud/beta/container/fleet/config-management/apply @@ -1,20 +1,26 @@ NAME gcloud beta container fleet config-management apply - update a Config - Management Feature Spec + Management feature spec SYNOPSIS - gcloud beta container fleet config-management apply --config=CONFIG - [--version=VERSION] [--membership=MEMBERSHIP : --location=LOCATION] - [GCLOUD_WIDE_FLAG ...] + gcloud beta container fleet config-management apply + (--origin=ORIGIN | [--config=CONFIG : --version=VERSION]) + [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a user-specified config file to a ConfigManagement Custom - Resource. The config file should be a .yaml file, all eligible fields are - listed in - https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields + (BETA) Update a membership configuration for the Config Management feature + in a fleet. This command errors if the Config Management feature is not + enabled on the fleet. EXAMPLES - To apply a YAML config file to a membership, prepare apply-spec.yaml + To apply the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to MEMBERSHIP_NAME, run: + + $ gcloud beta container fleet config-management apply \ + --membership=MEMBERSHIP_NAME --origin=FLEET + + To apply a membership configuration as a YAML file, prepare apply-spec.yaml (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#example_gcloud_apply_spec) then run: @@ -23,13 +29,43 @@ EXAMPLES --version=VERSION REQUIRED FLAGS - --config=CONFIG - The path to config-management.yaml. + Update the membership configuration either to the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + with --origin or to a user-provided configuration with --config and + --version. + + Exactly one of these must be specified: + + --origin=ORIGIN + Updates the configuration of the target membership to the current + fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Errors if fleet-default membership configuration is not enabled; see + the enable command for more details. ORIGIN must be (only one value + is supported): FLEET. + + Provide the entire membership configuration to update with --config and + --version. + + --config=CONFIG + Path to YAML file that contains the configuration to update the + target membership to. The file accepts the following fields + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields). + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --version=VERSION + Version of Config Management. Equivalent to the `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + field in the --config file. Provides --config with a version in the + absence of spec.version. Cannot specify this flag without --config; + cannot set both this flag and spec.version. See `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + for more details. OPTIONAL FLAGS - --version=VERSION - The version of ACM to install. - Membership resource - The group of arguments defining a membership. 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 diff --git a/gcloud/beta/container/fleet/config-management/disable b/gcloud/beta/container/fleet/config-management/disable index 4a7750f37..789c563b5 100644 --- a/gcloud/beta/container/fleet/config-management/disable +++ b/gcloud/beta/container/fleet/config-management/disable @@ -1,23 +1,40 @@ NAME gcloud beta container fleet config-management disable - disable Config - Management Feature + Management feature SYNOPSIS - gcloud beta container fleet config-management disable [--force] - [GCLOUD_WIDE_FLAG ...] + gcloud beta container fleet config-management disable + [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Disable the Config Management Feature in a fleet. + (BETA) Disable the Config Management feature in a fleet. Disable the + feature entirely or only disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for the feature. EXAMPLES - To disable the Config Management Feature, run: + To disable the Config Management feature entirely, run: $ gcloud beta container fleet config-management disable + To disable only fleet-default membership configuration for the feature, + run: + + $ gcloud beta container fleet config-management disable \ + --fleet-default-member-config + FLAGS - --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + At most one of these can be specified: + + --fleet-default-member-config + Disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + without disabling the feature. Does not change existing membership + configurations. Exits silently if the feature is not enabled. + + --force + Disable this feature, even if it is currently in use. Force + disablement may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/config-management/enable b/gcloud/beta/container/fleet/config-management/enable index f6516ce7e..31c1cfc12 100644 --- a/gcloud/beta/container/fleet/config-management/enable +++ b/gcloud/beta/container/fleet/config-management/enable @@ -1,18 +1,43 @@ NAME gcloud beta container fleet config-management enable - enable Config - Management Feature + Management feature SYNOPSIS - gcloud beta container fleet config-management enable [GCLOUD_WIDE_FLAG ...] + gcloud beta container fleet config-management enable + [--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Enables the Config Management Feature in a fleet. + (BETA) Enables the Config Management feature in a fleet. Without any flags, + this command no-ops if the feature is already enabled. This command can + also enable the feature with a fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for Config Sync. EXAMPLES - To enable the Config Management Feature, run: + To enable the Config Management feature, run: $ gcloud beta container fleet config-management enable + To enable the Config Management feature with a fleet-default membership + configuration for Config Sync, run: + + $ gcloud beta container fleet config-management enable \ + --fleet-default-member-config=config.yaml + +FLAGS + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + Path to YAML file that contains the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to enable with a new feature. This file shares the syntax of the + --config flag on the apply command: see recognized fields here + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields). + Errors if the Policy Controller or Hierarchy Controller field is set. + This flag will also enable or update the fleet-default membership + configuration on an existing feature. See the apply command for how to + sync a membership to the fleet-default membership configuration. + 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/fleet/config-management/help b/gcloud/beta/container/fleet/config-management/help index 923ec2f1b..ab7f9b4d3 100644 --- a/gcloud/beta/container/fleet/config-management/help +++ b/gcloud/beta/container/fleet/config-management/help @@ -1,13 +1,13 @@ NAME gcloud beta container fleet config-management - manage Config Management - Feature + feature SYNOPSIS gcloud beta container fleet config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage Config Sync using the Config Management Feature. Policy + (BETA) Manage Config Sync using the Config Management feature. Policy Controller users should use the separate command group: gcloud container fleet policycontroller. Hierarchy Controller users should use https://github.com/kubernetes-sigs/hierarchical-namespaces instead. @@ -21,23 +21,23 @@ COMMANDS COMMAND is one of the following: apply - (BETA) Update a Config Management Feature Spec. + (BETA) Update a Config Management feature spec. disable - (BETA) Disable Config Management Feature. + (BETA) Disable Config Management feature. enable - (BETA) Enable Config Management Feature. + (BETA) Enable Config Management feature. status (BETA) Print the status of all clusters with Config Management enabled. unmanage - (BETA) Remove the Config Management Feature Spec for the given + (BETA) Remove the Config Management feature spec for the given membership. upgrade - (BETA) Upgrade the version of the Config Management Feature. + (BETA) Upgrade the version of the Config Management feature. version (BETA) Print the version of all clusters with Config Management diff --git a/gcloud/beta/container/fleet/config-management/status b/gcloud/beta/container/fleet/config-management/status index 92e6ae081..10971bc1c 100644 --- a/gcloud/beta/container/fleet/config-management/status +++ b/gcloud/beta/container/fleet/config-management/status @@ -8,16 +8,24 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Print the status of all clusters with Config Management enabled. + (BETA) The Synced_to_Fleet_Default status indicates whether each + membership's configuration has been synced with the fleet-default + membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Synced_to_Fleet_Default displays FLEET_DEFAULT_NOT_CONFIGURED when + fleet-default membership configuration is not enabled. + Synced_to_Fleet_Default for an individual membership may be UNKNOWN if + configuration has yet to be applied to this membership since enabling + fleet-default membership configuration. See the enable and apply commands + for more details. EXAMPLES - Print the status of the Config Management Feature: + Print the status of the Config Management feature: $ gcloud beta container fleet config-management status - Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Hierarchy_Controller - managed-cluster SYNCED 2945500b7f acme 2020-03-23 - 11:12:31 -0700 PDT INSTALLED + Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Policy_Controller Hierarchy_Controller Version Upgrades Synced_To_Fleet_Default + managed-cluster SYNCED 2945500b7f acme 2020-03-23 11:12:31 -0700 PDT NA NA 1.18.3 auto FLEET_DEFAULT_NOT_CONFIGURED View the status for the cluster named managed-cluster-a: @@ -29,13 +37,13 @@ EXAMPLES $ gcloud beta container fleet config-management status \ --filter="acm_status.name ~ managed-cluster.*" - List all clusters where current status is SYNCED: + List all clusters where current Config Sync Status is SYNCED: $ gcloud beta container fleet config-management status \ --filter="acm_status.config_sync:SYNCED" List all the clusters where sync_branch is v1 and current Config Sync - status is not SYNCED: + Status is not SYNCED: $ gcloud beta container fleet config-management status \ --filter="acm_status.sync_branch:v1 AND \ diff --git a/gcloud/beta/container/fleet/config-management/unmanage b/gcloud/beta/container/fleet/config-management/unmanage index 54ca9d581..e2b4fa742 100644 --- a/gcloud/beta/container/fleet/config-management/unmanage +++ b/gcloud/beta/container/fleet/config-management/unmanage @@ -1,18 +1,18 @@ NAME gcloud beta container fleet config-management unmanage - remove the Config - Management Feature Spec for the given membership + Management feature spec for the given membership SYNOPSIS gcloud beta container fleet config-management unmanage [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Remove the Config Management Feature Spec for the given membership. + (BETA) Remove the Config Management feature spec for the given membership. The existing ConfigManagement resources in the clusters will become unmanaged. EXAMPLES - To remove the Config Management Feature spec for a membership, run: + To remove the Config Management feature spec for a membership, run: $ gcloud beta container fleet config-management unmanage \ --membership=MEMBERSHIP_NAME diff --git a/gcloud/beta/container/fleet/config-management/upgrade b/gcloud/beta/container/fleet/config-management/upgrade index d57f301d5..f9c47d701 100644 --- a/gcloud/beta/container/fleet/config-management/upgrade +++ b/gcloud/beta/container/fleet/config-management/upgrade @@ -1,6 +1,6 @@ NAME gcloud beta container fleet config-management upgrade - upgrade the version - of the Config Management Feature + of the Config Management feature SYNOPSIS gcloud beta container fleet config-management upgrade --version=VERSION @@ -8,7 +8,7 @@ SYNOPSIS DESCRIPTION (BETA) Upgrade a specified membership to any supported version of the - Config Management Feature. + Config Management feature. EXAMPLES To upgrade a membership named MEMBERSHIP_NAME, run: diff --git a/gcloud/beta/container/fleet/help b/gcloud/beta/container/fleet/help index 36ca89cdc..feac29022 100644 --- a/gcloud/beta/container/fleet/help +++ b/gcloud/beta/container/fleet/help @@ -52,7 +52,7 @@ GROUPS (BETA) Configure the Fleet clusterupgrade feature. config-management - (BETA) Manage Config Management Feature. + (BETA) Manage Config Management feature. dataplane-v2-encryption (BETA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/beta/container/hub/config-management/apply b/gcloud/beta/container/hub/config-management/apply index dfd0eb193..d05f5d03c 100644 --- a/gcloud/beta/container/hub/config-management/apply +++ b/gcloud/beta/container/hub/config-management/apply @@ -1,20 +1,26 @@ NAME gcloud beta container hub config-management apply - update a Config - Management Feature Spec + Management feature spec SYNOPSIS - gcloud beta container hub config-management apply --config=CONFIG - [--version=VERSION] [--membership=MEMBERSHIP : --location=LOCATION] - [GCLOUD_WIDE_FLAG ...] + gcloud beta container hub config-management apply + (--origin=ORIGIN | [--config=CONFIG : --version=VERSION]) + [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Update a user-specified config file to a ConfigManagement Custom - Resource. The config file should be a .yaml file, all eligible fields are - listed in - https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields + (BETA) Update a membership configuration for the Config Management feature + in a fleet. This command errors if the Config Management feature is not + enabled on the fleet. EXAMPLES - To apply a YAML config file to a membership, prepare apply-spec.yaml + To apply the fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to MEMBERSHIP_NAME, run: + + $ gcloud beta container hub config-management apply \ + --membership=MEMBERSHIP_NAME --origin=FLEET + + To apply a membership configuration as a YAML file, prepare apply-spec.yaml (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#example_gcloud_apply_spec) then run: @@ -23,13 +29,43 @@ EXAMPLES --version=VERSION REQUIRED FLAGS - --config=CONFIG - The path to config-management.yaml. + Update the membership configuration either to the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + with --origin or to a user-provided configuration with --config and + --version. + + Exactly one of these must be specified: + + --origin=ORIGIN + Updates the configuration of the target membership to the current + fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Errors if fleet-default membership configuration is not enabled; see + the enable command for more details. ORIGIN must be (only one value + is supported): FLEET. + + Provide the entire membership configuration to update with --config and + --version. + + --config=CONFIG + Path to YAML file that contains the configuration to update the + target membership to. The file accepts the following fields + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields). + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --version=VERSION + Version of Config Management. Equivalent to the `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + field in the --config file. Provides --config with a version in the + absence of spec.version. Cannot specify this flag without --config; + cannot set both this flag and spec.version. See `spec.version` + (https://cloud.google.com/anthos-config-management/docs/reference/gcloud-apply-fields#common) + for more details. OPTIONAL FLAGS - --version=VERSION - The version of ACM to install. - Membership resource - The group of arguments defining a membership. 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 diff --git a/gcloud/beta/container/hub/config-management/disable b/gcloud/beta/container/hub/config-management/disable index 210ba067e..b9370607e 100644 --- a/gcloud/beta/container/hub/config-management/disable +++ b/gcloud/beta/container/hub/config-management/disable @@ -1,23 +1,40 @@ NAME gcloud beta container hub config-management disable - disable Config - Management Feature + Management feature SYNOPSIS - gcloud beta container hub config-management disable [--force] - [GCLOUD_WIDE_FLAG ...] + gcloud beta container hub config-management disable + [--fleet-default-member-config | --force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Disable the Config Management Feature in a fleet. + (BETA) Disable the Config Management feature in a fleet. Disable the + feature entirely or only disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for the feature. EXAMPLES - To disable the Config Management Feature, run: + To disable the Config Management feature entirely, run: $ gcloud beta container hub config-management disable + To disable only fleet-default membership configuration for the feature, + run: + + $ gcloud beta container hub config-management disable \ + --fleet-default-member-config + FLAGS - --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + At most one of these can be specified: + + --fleet-default-member-config + Disable fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + without disabling the feature. Does not change existing membership + configurations. Exits silently if the feature is not enabled. + + --force + Disable this feature, even if it is currently in use. Force + disablement may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/config-management/enable b/gcloud/beta/container/hub/config-management/enable index 209a578f7..f70079d6a 100644 --- a/gcloud/beta/container/hub/config-management/enable +++ b/gcloud/beta/container/hub/config-management/enable @@ -1,18 +1,43 @@ NAME gcloud beta container hub config-management enable - enable Config - Management Feature + Management feature SYNOPSIS - gcloud beta container hub config-management enable [GCLOUD_WIDE_FLAG ...] + gcloud beta container hub config-management enable + [--fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Enables the Config Management Feature in a fleet. + (BETA) Enables the Config Management feature in a fleet. Without any flags, + this command no-ops if the feature is already enabled. This command can + also enable the feature with a fleet-default membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + for Config Sync. EXAMPLES - To enable the Config Management Feature, run: + To enable the Config Management feature, run: $ gcloud beta container hub config-management enable + To enable the Config Management feature with a fleet-default membership + configuration for Config Sync, run: + + $ gcloud beta container hub config-management enable \ + --fleet-default-member-config=config.yaml + +FLAGS + --fleet-default-member-config=FLEET_DEFAULT_MEMBER_CONFIG + Path to YAML file that contains the fleet-default membership + configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features) + to enable with a new feature. This file shares the syntax of the + --config flag on the apply command: see recognized fields here + (https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields). + Errors if the Policy Controller or Hierarchy Controller field is set. + This flag will also enable or update the fleet-default membership + configuration on an existing feature. See the apply command for how to + sync a membership to the fleet-default membership configuration. + 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/hub/config-management/help b/gcloud/beta/container/hub/config-management/help index 295e3298c..da53a607a 100644 --- a/gcloud/beta/container/hub/config-management/help +++ b/gcloud/beta/container/hub/config-management/help @@ -1,12 +1,12 @@ NAME gcloud beta container hub config-management - manage Config Management - Feature + feature SYNOPSIS gcloud beta container hub config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage Config Sync using the Config Management Feature. Policy + (BETA) Manage Config Sync using the Config Management feature. Policy Controller users should use the separate command group: gcloud container fleet policycontroller. Hierarchy Controller users should use https://github.com/kubernetes-sigs/hierarchical-namespaces instead. @@ -20,23 +20,23 @@ COMMANDS COMMAND is one of the following: apply - (BETA) Update a Config Management Feature Spec. + (BETA) Update a Config Management feature spec. disable - (BETA) Disable Config Management Feature. + (BETA) Disable Config Management feature. enable - (BETA) Enable Config Management Feature. + (BETA) Enable Config Management feature. status (BETA) Print the status of all clusters with Config Management enabled. unmanage - (BETA) Remove the Config Management Feature Spec for the given + (BETA) Remove the Config Management feature spec for the given membership. upgrade - (BETA) Upgrade the version of the Config Management Feature. + (BETA) Upgrade the version of the Config Management feature. version (BETA) Print the version of all clusters with Config Management diff --git a/gcloud/beta/container/hub/config-management/status b/gcloud/beta/container/hub/config-management/status index c75cdf899..9e94b5a5e 100644 --- a/gcloud/beta/container/hub/config-management/status +++ b/gcloud/beta/container/hub/config-management/status @@ -8,16 +8,24 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Print the status of all clusters with Config Management enabled. + (BETA) The Synced_to_Fleet_Default status indicates whether each + membership's configuration has been synced with the fleet-default + membership configuration + (https://cloud.google.com/kubernetes-engine/fleet-management/docs/manage-features). + Synced_to_Fleet_Default displays FLEET_DEFAULT_NOT_CONFIGURED when + fleet-default membership configuration is not enabled. + Synced_to_Fleet_Default for an individual membership may be UNKNOWN if + configuration has yet to be applied to this membership since enabling + fleet-default membership configuration. See the enable and apply commands + for more details. EXAMPLES - Print the status of the Config Management Feature: + Print the status of the Config Management feature: $ gcloud beta container hub config-management status - Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Hierarchy_Controller - managed-cluster SYNCED 2945500b7f acme 2020-03-23 - 11:12:31 -0700 PDT INSTALLED + Name Status Last_Synced_Token Sync_Branch Last_Synced_Time Policy_Controller Hierarchy_Controller Version Upgrades Synced_To_Fleet_Default + managed-cluster SYNCED 2945500b7f acme 2020-03-23 11:12:31 -0700 PDT NA NA 1.18.3 auto FLEET_DEFAULT_NOT_CONFIGURED View the status for the cluster named managed-cluster-a: @@ -29,13 +37,13 @@ EXAMPLES $ gcloud beta container hub config-management status \ --filter="acm_status.name ~ managed-cluster.*" - List all clusters where current status is SYNCED: + List all clusters where current Config Sync Status is SYNCED: $ gcloud beta container hub config-management status \ --filter="acm_status.config_sync:SYNCED" List all the clusters where sync_branch is v1 and current Config Sync - status is not SYNCED: + Status is not SYNCED: $ gcloud beta container hub config-management status \ --filter="acm_status.sync_branch:v1 AND \ diff --git a/gcloud/beta/container/hub/config-management/unmanage b/gcloud/beta/container/hub/config-management/unmanage index 746c24d5b..12e0ad152 100644 --- a/gcloud/beta/container/hub/config-management/unmanage +++ b/gcloud/beta/container/hub/config-management/unmanage @@ -1,18 +1,18 @@ NAME gcloud beta container hub config-management unmanage - remove the Config - Management Feature Spec for the given membership + Management feature spec for the given membership SYNOPSIS gcloud beta container hub config-management unmanage [--membership=MEMBERSHIP : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Remove the Config Management Feature Spec for the given membership. + (BETA) Remove the Config Management feature spec for the given membership. The existing ConfigManagement resources in the clusters will become unmanaged. EXAMPLES - To remove the Config Management Feature spec for a membership, run: + To remove the Config Management feature spec for a membership, run: $ gcloud beta container hub config-management unmanage \ --membership=MEMBERSHIP_NAME diff --git a/gcloud/beta/container/hub/config-management/upgrade b/gcloud/beta/container/hub/config-management/upgrade index 3d9705dd6..4d756f8cf 100644 --- a/gcloud/beta/container/hub/config-management/upgrade +++ b/gcloud/beta/container/hub/config-management/upgrade @@ -1,6 +1,6 @@ NAME gcloud beta container hub config-management upgrade - upgrade the version - of the Config Management Feature + of the Config Management feature SYNOPSIS gcloud beta container hub config-management upgrade --version=VERSION @@ -8,7 +8,7 @@ SYNOPSIS DESCRIPTION (BETA) Upgrade a specified membership to any supported version of the - Config Management Feature. + Config Management feature. EXAMPLES To upgrade a membership named MEMBERSHIP_NAME, run: diff --git a/gcloud/beta/container/hub/help b/gcloud/beta/container/hub/help index dd292f646..e44de14a5 100644 --- a/gcloud/beta/container/hub/help +++ b/gcloud/beta/container/hub/help @@ -52,7 +52,7 @@ GROUPS (BETA) Configure the Fleet clusterupgrade feature. config-management - (BETA) Manage Config Management Feature. + (BETA) Manage Config Management feature. dataplane-v2-encryption (BETA) Manage Dataplane V2 Encryption Feature. diff --git a/gcloud/beta/developer-connect/connections/create b/gcloud/beta/developer-connect/connections/create new file mode 100644 index 000000000..6f7e415d4 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/create @@ -0,0 +1,550 @@ +NAME + gcloud beta developer-connect connections create - create a connection + resource + +SYNOPSIS + gcloud beta developer-connect connections create CONNECTION + [--annotations=[ANNOTATIONS,...]] [--async] [--disabled] [--etag=ETAG] + [--labels=[LABELS,...]] [--location=LOCATION] [--request-id=REQUEST_ID] + [--secret=SECRET] [--validate-only] + [(--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + : --key-ring=KEY_RING)] + [[--github-config-app=GITHUB_CONFIG_APP + : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a connection resource. + +EXAMPLES + To create a GitHub connection named my-connection in us-central1 run: + + $ gcloud beta developer-connect connections create my-connection \ + --github-config-app=developer-connect \ + --github-config-authorizer-credential-oauth-token-secret-version\ + =projects/my-project/secrets/my-oauth-token/versions/1 \ + --github-config-app-installation-id=12345 --location=us-central1 + +POSITIONAL ARGUMENTS + Connection resource - Identifier. The resource name of the connection, in + the format + projects/{project}/locations/{location}/connections/{connection_id}. 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 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. + + 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. + +FLAGS + --annotations=[ANNOTATIONS,...] + Allows clients to store small amounts of arbitrary data. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --annotations=string=string + + JSON Example: + + --annotations='{"string": "string"}' + + File Example: + + --annotations=path_to_file.(yaml|json) + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --disabled + If disabled is set to true, functionality is disabled for this + connection. Repository based API methods and webhooks processing for + repositories in this connection will be disabled. + + --etag=ETAG + This checksum is computed by the server based on the value of other + fields, and may be sent on update and delete requests to ensure the + client has an up-to-date value before proceeding. + + --labels=[LABELS,...] + Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --location=LOCATION + For resources [connection, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + --secret=SECRET + For resources [secretVersion], provides fallback value for resource + secret attribute. When the resource's full URI path is not provided, + secret will fallback to this flag value. + + --validate-only + If set, validate the request, but do not actually post it. + + The crypto key configuration. This field is used by the Customer-managed + encryption keys (CMEK) feature. + + CryptoKey resource - The name of the key which is used to + encrypt/decrypt customer data. For key in Cloud KMS, the key should be + in the format of projects/*/locations/*/keyRings/*/cryptoKeys/*. 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 --crypto-key-config-reference 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 --crypto-key-config-reference on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + + This must be specified. + + --crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line with a fully specified name; + ▫ provide the argument --key-ring on the command line. + + Arguments for the connection config. + + At most one of these can be specified: + + Configuration for connections to github.com. + + --github-config-app=GITHUB_CONFIG_APP + The GitHub Application that was installed to the GitHub user or + organization. GITHUB_CONFIG_APP must be one of: + + developer-connect + The Developer Connect GitHub Application. + firebase + The Firebase GitHub Application. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID + GitHub App installation id. + + Represents an OAuth token of the account that authorized the + Connection, and associated metadata. + + SecretVersion resource - A SecretManager resource containing the + OAuth token that authorizes the connection. Format: + projects/*/secrets/*/versions/*. 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 + --github-config-authorizer-credential-oauth-token-secret-version + 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 secret attribute: + ◇ provide the argument + --github-config-authorizer-credential-oauth-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --github-config-authorizer-credential-oauth-token-secret-version + on the command line. + + Configuration for connections to an instance of GitHub Enterprise. + + --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitHub Enterprise host this connection is for. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID + ID of the GitHub App created from the manifest. + + --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID + ID of the installation of the GitHub App. + + SecretVersion resource - SecretManager resource containing the private + key of the GitHub App, formatted as projects/*/secrets/*/versions/*. + 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 + --github-enterprise-config-private-key-secret-version 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 secret attribute: + ▫ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line with a fully specified name; + ▫ provide the argument --secret on the command line. + + --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL certificate to use for requests to GitHub Enterprise. + + SecretVersion resource - SecretManager resource containing the webhook + secret of the GitHub App, formatted as + projects/*/secrets/*/versions/*. 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 + --github-enterprise-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --github-enterprise-config-webhook-secret-version on the command + line with a fully specified name; + ▫ provide the argument --secret on the command line. + + --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --github-enterprise-config-webhook-secret-version on the + command line. + + Configuration for connections to gitlab.com. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret of a GitLab project, formatted as + projects/*/secrets/*/versions/*. This is used to validate webhooks. + 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 --gitlab-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument --gitlab-config-webhook-secret-version on + the command line with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument --gitlab-config-webhook-secret-version + on the command line. + + Configuration for connections to an instance of GitLab Enterprise. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line. + + --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitLab Enterprise host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret of a GitLab project, formatted as + projects/*/secrets/*/versions/*. This is used to validate webhooks. + 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 + --gitlab-enterprise-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --gitlab-enterprise-config-webhook-secret-version on the command + line with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --gitlab-enterprise-config-webhook-secret-version on the + command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL Certificate Authority certificate to use for requests to GitLab + Enterprise instance. + +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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections create + diff --git a/gcloud/beta/developer-connect/connections/delete b/gcloud/beta/developer-connect/connections/delete new file mode 100644 index 000000000..aaef86f60 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/delete @@ -0,0 +1,96 @@ +NAME + gcloud beta developer-connect connections delete - delete a single + connection + +SYNOPSIS + gcloud beta developer-connect connections delete + (CONNECTION : --location=LOCATION) [--async] [--etag=ETAG] + [--request-id=REQUEST_ID] [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a single connection. + +EXAMPLES + To delete a connection my-comection in location us-central1 run: + + $ gcloud beta developer-connect connections delete my-connection \ + --location=us-central1 + +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. + + --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. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --etag=ETAG + The current etag of the Connection. If an etag is provided and does not + match the current etag of the Connection, deletion will be blocked and + an ABORTED error will be returned. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes after the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + --validate-only + If set, validate the request, but do not actually post it. + +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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections delete + diff --git a/gcloud/beta/developer-connect/connections/describe b/gcloud/beta/developer-connect/connections/describe new file mode 100644 index 000000000..4f48e2b90 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta developer-connect connections describe - get details of a + single connection resource + +SYNOPSIS + gcloud beta developer-connect connections describe + (CONNECTION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get details of a single connection resource. + +EXAMPLES + To get the details of a single conenction my-connection in location + us-central1 run: + + $ gcloud beta developer-connect connections describe my-connection \ + --location=us-central1 + +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. + + --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. + +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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections describe + diff --git a/gcloud/beta/developer-connect/connections/git-repository-links/create b/gcloud/beta/developer-connect/connections/git-repository-links/create new file mode 100644 index 000000000..8488a3cb8 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/git-repository-links/create @@ -0,0 +1,167 @@ +NAME + gcloud beta developer-connect connections git-repository-links create - + create a git repository link + +SYNOPSIS + gcloud beta developer-connect connections git-repository-links create + (GIT_REPOSITORY_LINK : --connection=CONNECTION --location=LOCATION) + --clone-uri=CLONE_URI [--annotations=[ANNOTATIONS,...]] [--async] + [--etag=ETAG] [--labels=[LABELS,...]] [--request-id=REQUEST_ID] + [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a git repository link. + +EXAMPLES + To create a git repository link 'my-git-repository-link' in a connection + my-connection in us-central1 run: + + $ gcloud beta developer-connect connections git-repository-links \ create my-git-repository-link \ + --clone-uri=https://github.com/my-org/my-repo.git \ + --connection=my-connection --location=us-central1 + + Or run: + + $ gcloud beta developer-connect connections git-repository-links \ create \ + projects/my-project/locations/us-central1/connections/\ + my-connection/gitRepositoryLinks/my-git-repository-link \ + --clone-uri=https://github.com/my-org/my-repo.git \ + --location=us-central1 + +POSITIONAL ARGUMENTS + GitRepositoryLink resource - Identifier. Resource name of the repository, + in the format 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 git_repository_link 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. + + GIT_REPOSITORY_LINK + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git_repository_link attribute: + ▸ provide the argument git_repository_link on the command line. + + This positional 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 git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --connection on the command line. + + --location=LOCATION + The location id of the gitRepositoryLink resource. + + To set the location attribute: + ▸ provide the argument git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --clone-uri=CLONE_URI + Git Clone URI. + +OPTIONAL FLAGS + --annotations=[ANNOTATIONS,...] + Allows clients to store small amounts of arbitrary data. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --annotations=string=string + + JSON Example: + + --annotations='{"string": "string"}' + + File Example: + + --annotations=path_to_file.(yaml|json) + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --etag=ETAG + This checksum is computed by the server based on the value of other + fields, and may be sent on update and delete requests to ensure the + client has an up-to-date value before proceeding. + + --labels=[LABELS,...] + Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + --validate-only + If set, validate the request, but do not actually post it. + +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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections git-repository-links \ + create + diff --git a/gcloud/beta/developer-connect/connections/git-repository-links/delete b/gcloud/beta/developer-connect/connections/git-repository-links/delete new file mode 100644 index 000000000..5364c14c8 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/git-repository-links/delete @@ -0,0 +1,108 @@ +NAME + gcloud beta developer-connect connections git-repository-links delete - + delete a single git repository link + +SYNOPSIS + gcloud beta developer-connect connections git-repository-links delete + (GIT_REPOSITORY_LINK : --connection=CONNECTION --location=LOCATION) + [--async] [--etag=ETAG] [--request-id=REQUEST_ID] [--validate-only] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a single git repository link. + +EXAMPLES + To delete a git repository link my-git-repository-link in a connection + my-comection in location us-central1 run: + + $ gcloud beta developer-connect connections git-repository-links \ delete my-git-repository-link --connection=my-connection \ + --location=us-central1 + +POSITIONAL ARGUMENTS + GitRepositoryLink 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 git_repository_link 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. + + GIT_REPOSITORY_LINK + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git_repository_link attribute: + ▸ provide the argument git_repository_link on the command line. + + This positional 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 git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --connection on the command line. + + --location=LOCATION + The location id of the gitRepositoryLink resource. + + To set the location attribute: + ▸ provide the argument git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --etag=ETAG + This checksum is computed by the server based on the value of other + fields, and may be sent on update and delete requests to ensure the + client has an up-to-date value before proceeding. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes after the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + --validate-only + If set, validate the request, but do not actually post it. + +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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections git-repository-links \ + delete + diff --git a/gcloud/beta/developer-connect/connections/git-repository-links/describe b/gcloud/beta/developer-connect/connections/git-repository-links/describe new file mode 100644 index 000000000..b2c5710d7 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/git-repository-links/describe @@ -0,0 +1,79 @@ +NAME + gcloud beta developer-connect connections git-repository-links describe - + get details of a single git repository link + +SYNOPSIS + gcloud beta developer-connect connections git-repository-links describe + (GIT_REPOSITORY_LINK : --connection=CONNECTION --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get details of a single git repository link. + +EXAMPLES + To get the details of a single git repository link my-git-repository-link + in a conenction my-connection in location us-central1 run: + + $ gcloud beta developer-connect connections git-repository-links \ describe my-git-repository-link --connection=my-connection \ + --location=us-central1-a + +POSITIONAL ARGUMENTS + GitRepositoryLink 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 git_repository_link 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. + + GIT_REPOSITORY_LINK + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git_repository_link attribute: + ▸ provide the argument git_repository_link on the command line. + + This positional 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 git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --connection on the command line. + + --location=LOCATION + The location id of the gitRepositoryLink resource. + + To set the location attribute: + ▸ provide the argument git_repository_link 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections git-repository-links \ + describe + diff --git a/gcloud/beta/developer-connect/connections/git-repository-links/fetch-read-token b/gcloud/beta/developer-connect/connections/git-repository-links/fetch-read-token new file mode 100644 index 000000000..4f1219167 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/git-repository-links/fetch-read-token @@ -0,0 +1,82 @@ +NAME + gcloud beta developer-connect connections git-repository-links + fetch-read-token - fetch the read token of a given gitRepositoryLink + +SYNOPSIS + gcloud beta developer-connect connections git-repository-links + fetch-read-token + (GIT_REPOSITORY_LINK : --connection=CONNECTION --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Fetch the read token of a given gitRepositoryLink. + +EXAMPLES + To get the read token of a GitRepositoryLink named "my-git-repository-link" + in a Connection named "my-connection" in location "us-central1": + + $ gcloud beta developer-connect connections git-repository-links \ + fetch-read-token fetch-read-token my-git-repository-link \ + --connection=my-connection --location=us-central1 \ + --project=my-project + +POSITIONAL ARGUMENTS + GitRepositoryLink resource - Developer Connect GitRepositoryLink from + which to fetch the read token. 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 git_repository_link 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. + + GIT_REPOSITORY_LINK + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git_repository_link attribute: + ▸ provide the argument git_repository_link on the command line. + + This positional 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 git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --connection on the command line. + + --location=LOCATION + The location id of the gitRepositoryLink resource. + + To set the location attribute: + ▸ provide the argument git_repository_link 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections git-repository-links \ + fetch-read-token + diff --git a/gcloud/beta/developer-connect/connections/git-repository-links/fetch-read-write-token b/gcloud/beta/developer-connect/connections/git-repository-links/fetch-read-write-token new file mode 100644 index 000000000..e5aac424b --- /dev/null +++ b/gcloud/beta/developer-connect/connections/git-repository-links/fetch-read-write-token @@ -0,0 +1,83 @@ +NAME + gcloud beta developer-connect connections git-repository-links + fetch-read-write-token - fetch the read/write token of a given + gitRepositoryLink + +SYNOPSIS + gcloud beta developer-connect connections git-repository-links + fetch-read-write-token + (GIT_REPOSITORY_LINK : --connection=CONNECTION --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Fetch the read/write token of a given gitRepositoryLink. + +EXAMPLES + To get the read/write token of a GitRepositoryLink named + "my-git-repository-link" in a Connection named "my-connection": + + $ gcloud beta developer-connect connections git-repository-links \ + fetch-read-write-token fetch-read-write-token \ + my-git-repository-link --connection=my-connection \ + --location=us-central1 --project=my-project + +POSITIONAL ARGUMENTS + GitRepositoryLink resource - Developer Connect GitRepositoryLink from + which to fetch the read/write token. 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 git_repository_link 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. + + GIT_REPOSITORY_LINK + ID of the gitRepositoryLink or fully qualified identifier for the + gitRepositoryLink. + + To set the git_repository_link attribute: + ▸ provide the argument git_repository_link on the command line. + + This positional 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 git_repository_link on the command line with + a fully specified name; + ▸ provide the argument --connection on the command line. + + --location=LOCATION + The location id of the gitRepositoryLink resource. + + To set the location attribute: + ▸ provide the argument git_repository_link 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections git-repository-links \ + fetch-read-write-token + diff --git a/gcloud/beta/developer-connect/connections/git-repository-links/help b/gcloud/beta/developer-connect/connections/git-repository-links/help new file mode 100644 index 000000000..b164c3a89 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/git-repository-links/help @@ -0,0 +1,43 @@ +NAME + gcloud beta developer-connect connections git-repository-links - manage git + repository link resources + +SYNOPSIS + gcloud beta developer-connect connections git-repository-links COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage git repository link 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 + (BETA) Create a git repository link. + + delete + (BETA) Delete a single git repository link. + + describe + (BETA) Get details of a single git repository link. + + fetch-read-token + (BETA) Fetch the read token of a given gitRepositoryLink. + + fetch-read-write-token + (BETA) Fetch the read/write token of a given gitRepositoryLink. + + list + (BETA) List all git repository links in a connection. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections git-repository-links + diff --git a/gcloud/beta/developer-connect/connections/git-repository-links/list b/gcloud/beta/developer-connect/connections/git-repository-links/list new file mode 100644 index 000000000..b1b0f9736 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/git-repository-links/list @@ -0,0 +1,103 @@ +NAME + gcloud beta developer-connect connections git-repository-links list - list + all git repository links in a connection + +SYNOPSIS + gcloud beta developer-connect connections git-repository-links list + (--connection=CONNECTION : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all git repository links in a connection. + +EXAMPLES + To list all git repository links in a connection my-connection in location + us-central1 run: + + $ gcloud beta developer-connect connections git-repository-links \ list --connection=my-connection --location=us-central1 + +REQUIRED FLAGS + Connection resource - Parent value for ListGitRepositoryLinksRequest 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=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 flag argument must be specified if any of the other arguments in + this group are specified. + + --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. + +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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections git-repository-links \ + list + diff --git a/gcloud/beta/developer-connect/connections/help b/gcloud/beta/developer-connect/connections/help new file mode 100644 index 000000000..2a6cc83c0 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/help @@ -0,0 +1,45 @@ +NAME + gcloud beta developer-connect connections - manage connection resources + +SYNOPSIS + gcloud beta developer-connect connections GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage connection resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + git-repository-links + (BETA) Manage git repository link resources. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a connection resource. + + delete + (BETA) Delete a single connection. + + describe + (BETA) Get details of a single connection resource. + + list + (BETA) List connections. + + update + (BETA) Update the parameters of a single connection. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections + diff --git a/gcloud/beta/developer-connect/connections/list b/gcloud/beta/developer-connect/connections/list new file mode 100644 index 000000000..5cd2457f5 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/list @@ -0,0 +1,87 @@ +NAME + gcloud beta developer-connect connections list - list connections + +SYNOPSIS + gcloud beta developer-connect connections list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List connections. + +EXAMPLES + To list all connections in location us-central1 run: + + $ gcloud beta developer-connect connections list \ + --location=us-central1 + +REQUIRED FLAGS + Location resource - Parent value for ListConnectionsRequest 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections list + diff --git a/gcloud/beta/developer-connect/connections/update b/gcloud/beta/developer-connect/connections/update new file mode 100644 index 000000000..6d19dcc45 --- /dev/null +++ b/gcloud/beta/developer-connect/connections/update @@ -0,0 +1,562 @@ +NAME + gcloud beta developer-connect connections update - update the parameters of + a single connection + +SYNOPSIS + gcloud beta developer-connect connections update CONNECTION + [--[no-]allow-missing] [--async] [--[no-]disabled] [--etag=ETAG] + [--location=LOCATION] [--request-id=REQUEST_ID] [--secret=SECRET] + [--[no-]validate-only] + [--annotations=[ANNOTATIONS,...] + | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations + | --remove-annotations=[__REMOVE_ANNOTATIONS,...]] + [--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + : --key-ring=KEY_RING] + [--github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID + --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a connection. + +EXAMPLES + To update the labels of a connection my-connection in location us-central1 + run: + + $ gcloud beta developer-connect connections update my-connection \ + --labels=key1=value1 --location=us-central1 + +POSITIONAL ARGUMENTS + Connection resource - Identifier. The resource name of the connection, in + the format + projects/{project}/locations/{location}/connections/{connection_id}. 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 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. + + 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. + +FLAGS + --[no-]allow-missing + If set to true, and the connection is not found a new connection will + be created. In this situation update_mask is ignored. The creation will + succeed only if the input connection has all the necessary information + (e.g a github_config with both user_oauth_token and installation_id + properties). Use --allow-missing to enable and --no-allow-missing to + disable. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --[no-]disabled + If disabled is set to true, functionality is disabled for this + connection. Repository based API methods and webhooks processing for + repositories in this connection will be disabled. Use --disabled to + enable and --no-disabled to disable. + + --etag=ETAG + This checksum is computed by the server based on the value of other + fields, and may be sent on update and delete requests to ensure the + client has an up-to-date value before proceeding. + + --location=LOCATION + For resources [connection, cryptoKey], provides fallback value for + resource location attribute. When the resource's full URI path is not + provided, location will fallback to this flag value. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + --secret=SECRET + For resources [secretVersion], provides fallback value for resource + secret attribute. When the resource's full URI path is not provided, + secret will fallback to this flag value. + + --[no-]validate-only + If set, validate the request, but do not actually post it. Use + --validate-only to enable and --no-validate-only to disable. + + Update annotations. + + At most one of these can be specified: + + --annotations=[ANNOTATIONS,...] + Set annotations to new value. Allows clients to store small amounts + of arbitrary data. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --annotations=string=string + + JSON Example: + + --annotations='{"string": "string"}' + + File Example: + + --annotations=path_to_file.(yaml|json) + + --update-annotations=[UPDATE_ANNOTATIONS,...] + Update annotations value or add key value pair. Allows clients to + store small amounts of arbitrary data. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --update-annotations=string=string + + JSON Example: + + --update-annotations='{"string": "string"}' + + File Example: + + --update-annotations=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-annotations + Clear annotations value and set to empty map. + + --remove-annotations=[__REMOVE_ANNOTATIONS,...] + Remove existing value from map annotations. + + The crypto key configuration. This field is used by the Customer-managed + encryption keys (CMEK) feature. + + CryptoKey resource - The name of the key which is used to + encrypt/decrypt customer data. For key in Cloud KMS, the key should be + in the format of projects/*/locations/*/keyRings/*/cryptoKeys/*. 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 --crypto-key-config-reference 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 --crypto-key-config-reference on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + + --crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE + ID of the cryptoKey or fully qualified identifier for the + cryptoKey. + + To set the crypto-key attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --key-ring=KEY_RING + The keyRing id of the cryptoKey resource. + + To set the key-ring attribute: + ▫ provide the argument --crypto-key-config-reference on the + command line with a fully specified name; + ▫ provide the argument --key-ring on the command line. + + Arguments for the connection config. + + At most one of these can be specified: + + Configuration for connections to github.com. + + --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID + GitHub App installation id. + + Represents an OAuth token of the account that authorized the + Connection, and associated metadata. + + SecretVersion resource - A SecretManager resource containing the + OAuth token that authorizes the connection. Format: + projects/*/secrets/*/versions/*. 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 + --github-config-authorizer-credential-oauth-token-secret-version + 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 secret attribute: + ◇ provide the argument + --github-config-authorizer-credential-oauth-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --github-config-authorizer-credential-oauth-token-secret-version + on the command line. + + Configuration for connections to an instance of GitHub Enterprise. + + --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID + ID of the GitHub App created from the manifest. + + --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID + ID of the installation of the GitHub App. + + --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitHub Enterprise host this connection is for. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL certificate to use for requests to GitHub Enterprise. + + Update github_enterprise_config_private_key_secret_version. + + At most one of these can be specified: + + --clear-github-enterprise-config-private-key-secret-version + Clear github_enterprise_config_private_key_secret_version value + and set to null. + + SecretVersion resource - Set + github_enterprise_config_private_key_secret_version to new value. + + SecretManager resource containing the private key of the GitHub App, + formatted as projects/*/secrets/*/versions/*. 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 + --github-enterprise-config-private-key-secret-version 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 secret attribute: + ◇ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --github-enterprise-config-private-key-secret-version on the + command line. + + Update github_enterprise_config_webhook_secret_version. + + At most one of these can be specified: + + --clear-github-enterprise-config-webhook-secret-version + Clear github_enterprise_config_webhook_secret_version value and + set to null. + + SecretVersion resource - Set + github_enterprise_config_webhook_secret_version to new value. + + SecretManager resource containing the webhook secret of the GitHub + App, formatted as projects/*/secrets/*/versions/*. 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 + --github-enterprise-config-webhook-secret-version 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 secret attribute: + ◇ provide the argument + --github-enterprise-config-webhook-secret-version on the command + line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --github-enterprise-config-webhook-secret-version on the + command line. + + Configuration for connections to gitlab.com. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-config-read-authorizer-credential-user-token-secret-version + on the command line. + + Configuration for connections to an instance of GitLab Enterprise. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-authorizer-credential-user-token-secret-version + on the command line. + + --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI + The URI of the GitLab Enterprise host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version + on the command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY + The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + + --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE + SSL Certificate Authority certificate to use for requests to GitLab + Enterprise instance. + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=[__REMOVE_LABELS,...] + Remove existing value from map labels. + +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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect connections update + diff --git a/gcloud/beta/developer-connect/help b/gcloud/beta/developer-connect/help new file mode 100644 index 000000000..4d3b435c0 --- /dev/null +++ b/gcloud/beta/developer-connect/help @@ -0,0 +1,29 @@ +NAME + gcloud beta developer-connect - manage Developer Connect resources + +SYNOPSIS + gcloud beta developer-connect GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Developer Connect 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 + (BETA) Manage connection resources. + + operations + (BETA) Manage Operation resources. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect + diff --git a/gcloud/beta/developer-connect/operations/cancel b/gcloud/beta/developer-connect/operations/cancel new file mode 100644 index 000000000..224f880ba --- /dev/null +++ b/gcloud/beta/developer-connect/operations/cancel @@ -0,0 +1,65 @@ +NAME + gcloud beta developer-connect operations cancel - cancel operations + +SYNOPSIS + gcloud beta developer-connect operations cancel + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Cancel an operation + +EXAMPLES + To cancel the operation, run: + + $ gcloud beta developer-connect 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect operations cancel + diff --git a/gcloud/beta/developer-connect/operations/delete b/gcloud/beta/developer-connect/operations/delete new file mode 100644 index 000000000..ecacac69e --- /dev/null +++ b/gcloud/beta/developer-connect/operations/delete @@ -0,0 +1,65 @@ +NAME + gcloud beta developer-connect operations delete - delete operations + +SYNOPSIS + gcloud beta developer-connect operations delete + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete an operation + +EXAMPLES + To delete the operation, run: + + $ gcloud beta developer-connect 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect operations delete + diff --git a/gcloud/beta/developer-connect/operations/describe b/gcloud/beta/developer-connect/operations/describe new file mode 100644 index 000000000..4e62c089c --- /dev/null +++ b/gcloud/beta/developer-connect/operations/describe @@ -0,0 +1,65 @@ +NAME + gcloud beta developer-connect operations describe - describe operations + +SYNOPSIS + gcloud beta developer-connect operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe an operation + +EXAMPLES + To describe the operation, run: + + $ gcloud beta developer-connect 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect operations describe + diff --git a/gcloud/beta/developer-connect/operations/help b/gcloud/beta/developer-connect/operations/help new file mode 100644 index 000000000..d24b61d6d --- /dev/null +++ b/gcloud/beta/developer-connect/operations/help @@ -0,0 +1,38 @@ +NAME + gcloud beta developer-connect operations - manage Operation resources + +SYNOPSIS + gcloud beta developer-connect operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) 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 + (BETA) Cancel operations. + + delete + (BETA) Delete operations. + + describe + (BETA) Describe operations. + + list + (BETA) List operations. + + wait + (BETA) Wait operations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect operations + diff --git a/gcloud/beta/developer-connect/operations/list b/gcloud/beta/developer-connect/operations/list new file mode 100644 index 000000000..749a71d14 --- /dev/null +++ b/gcloud/beta/developer-connect/operations/list @@ -0,0 +1,86 @@ +NAME + gcloud beta developer-connect operations list - list operations + +SYNOPSIS + gcloud beta developer-connect operations list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List operations + +EXAMPLES + To list all operations, run: + + $ gcloud beta developer-connect 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect operations list + diff --git a/gcloud/beta/developer-connect/operations/wait b/gcloud/beta/developer-connect/operations/wait new file mode 100644 index 000000000..6fd562a59 --- /dev/null +++ b/gcloud/beta/developer-connect/operations/wait @@ -0,0 +1,65 @@ +NAME + gcloud beta developer-connect operations wait - wait operations + +SYNOPSIS + gcloud beta developer-connect operations wait + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Wait an operation + +EXAMPLES + To wait the operation, run: + + $ gcloud beta developer-connect operations wait + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to wait on. 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 developerconnect/v1 API. The full documentation for + this API can be found at: + http://cloud.google.com/developer-connect/docs/overview + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha developer-connect operations wait + diff --git a/gcloud/beta/network-security/security-profile-groups/create b/gcloud/beta/network-security/security-profile-groups/create index c4c35b274..c3fe1655a 100644 --- a/gcloud/beta/network-security/security-profile-groups/create +++ b/gcloud/beta/network-security/security-profile-groups/create @@ -7,6 +7,8 @@ SYNOPSIS (SECURITY_PROFILE_GROUP : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE + : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [GCLOUD_WIDE_FLAG ...] @@ -75,6 +77,48 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the custom-mirroring-profile-profile attribute: + ▸ provide the argument --custom-mirroring-profile on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security profiles + are supported. + + To set the custom-mirroring-profile-location attribute: + ▸ provide the argument --custom-mirroring-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-mirroring-profile-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the custom-mirroring-profile-organization attribute: + ▸ provide the argument --custom-mirroring-profile on the command + line with a fully specified name; + ▸ provide the argument --custom-mirroring-profile-organization on + the command line; + ▸ provide the argument --organization on the command line; + ▸ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + Security Profile resource - Path to Security Profile resource. The arguments in this group can be used to specify the attributes of this resource. diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index 5d8d937db..fe08c43ea 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -9,9 +9,7 @@ SYNOPSIS [--enable-message-ordering] [--expiration-period=EXPIRATION_PERIOD] [--labels=[KEY=VALUE,...]] [--message-filter=MESSAGE_FILTER] [--message-retention-duration=MESSAGE_RETENTION_DURATION] - [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL] - [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] - [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] + [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema @@ -21,8 +19,10 @@ SYNOPSIS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] [--max-retry-delay=MAX_RETRY_DELAY --min-retry-delay=MIN_RETRY_DELAY] - [--push-no-wrapper : --push-no-wrapper-write-metadata] - [GCLOUD_WIDE_FLAG ...] + [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + --push-endpoint=PUSH_ENDPOINT [--push-no-wrapper + : --push-no-wrapper-write-metadata]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Creates one or more Cloud Pub/Sub subscriptions for a given topic. @@ -128,18 +128,6 @@ OPTIONAL FLAGS seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --push-auth-service-account=SERVICE_ACCOUNT_EMAIL - Service account email used as the identity for the generated Open ID - Connect token for authenticated push. - - --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE - Audience used in the generated Open ID Connect token for authenticated - push. If not specified, it will be set to the push-endpoint. - - --push-endpoint=PUSH_ENDPOINT - A URL to use as the endpoint for this subscription. This will also - automatically set the subscription type to PUSH. - --retain-acked-messages Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the @@ -318,21 +306,36 @@ OPTIONAL FLAGS of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - NoWrapper Config Options. + Push Config Options. Configuration for a push delivery endpoint. - --push-no-wrapper - When set, the message data is delivered directly as the HTTP body. - Use --no-push-no-wrapper to disable this flag. + --push-auth-service-account=SERVICE_ACCOUNT_EMAIL + Service account email used as the identity for the generated Open ID + Connect token for authenticated push. - This flag argument must be specified if any of the other arguments in - this group are specified. + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + Audience used in the generated Open ID Connect token for + authenticated push. If not specified, it will be set to the + push-endpoint. - --push-no-wrapper-write-metadata - When true, writes the Pub/Sub message metadata to - x-goog-pubsub-: headers of the HTTP request. Writes the - Pub/Sub message attributes to : headers of the HTTP - request. Use --no-push-no-wrapper-write-metadata to disable this - flag. + --push-endpoint=PUSH_ENDPOINT + A URL to use as the endpoint for this subscription. This will also + automatically set the subscription type to PUSH. + + NoWrapper Config Options. + + --push-no-wrapper + When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --push-no-wrapper-write-metadata + When true, writes the Pub/Sub message metadata to + x-goog-pubsub-: headers of the HTTP request. Writes the + Pub/Sub message attributes to : headers of the HTTP + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index 0643f0079..77d47726d 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -7,10 +7,7 @@ SYNOPSIS [--ack-deadline=ACK_DEADLINE] [--enable-exactly-once-delivery] [--expiration-period=EXPIRATION_PERIOD] [--message-retention-duration=MESSAGE_RETENTION_DURATION] - [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL] - [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] - [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] - [--update-labels=[KEY=VALUE,...]] + [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema @@ -22,10 +19,13 @@ SYNOPSIS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] [--clear-labels | --remove-labels=[KEY,...]] - [--clear-push-no-wrapper-config - | [--push-no-wrapper : --push-no-wrapper-write-metadata]] [--clear-retry-policy | --max-retry-delay=MAX_RETRY_DELAY - --min-retry-delay=MIN_RETRY_DELAY] [GCLOUD_WIDE_FLAG ...] + --min-retry-delay=MIN_RETRY_DELAY] + [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + --push-endpoint=PUSH_ENDPOINT --clear-push-no-wrapper-config + | [--push-no-wrapper : --push-no-wrapper-write-metadata]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Updates an existing Cloud Pub/Sub subscription. @@ -82,18 +82,6 @@ FLAGS "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --push-auth-service-account=SERVICE_ACCOUNT_EMAIL - Service account email used as the identity for the generated Open ID - Connect token for authenticated push. - - --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE - Audience used in the generated Open ID Connect token for authenticated - push. If not specified, it will be set to the push-endpoint. - - --push-endpoint=PUSH_ENDPOINT - A URL to use as the endpoint for this subscription. This will also - automatically set the subscription type to PUSH. - --retain-acked-messages Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the @@ -123,6 +111,10 @@ FLAGS service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to write to this BigQuery table. + When updating BigQueryConfig flags, all BigQueryConfig flags must be + specified. Otherwise, any omitted BigQueryConfig flags revert to their + default value. + --bigquery-table=BIGQUERY_TABLE A BigQuery table of the form {project}:{dataset_name}.{table_name} to which to write messages @@ -177,6 +169,10 @@ FLAGS have permission to write to this Cloud Storage bucket and to read this bucket's metadata. + When updating CloudStorageConfig flags, all CloudStorageConfig flags + must be specified. Otherwise, any omitted CloudStorageConfig flags + revert to their default value. + Note that an update to the Cloud Storage config will replace it with a new config containing only the flags that are passed in the update CLI. @@ -257,6 +253,10 @@ FLAGS have permission to Publish() to this topic and Acknowledge() messages on this subscription. + When updating DeadLetterPolicy flags, all DeadLetterPolicy flags must be + specified. Otherwise, any omitted DeadLetterPolicy flags revert to their + default value. + --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS Maximum number of delivery attempts for any message. The value must be between 5 and 100. Defaults to 5. --dead-letter-topic must also @@ -307,28 +307,6 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. - At most one of these can be specified: - - --clear-push-no-wrapper-config - If set, clear the NoWrapper config from the subscription. Use - --no-clear-push-no-wrapper-config to disable this flag. - - NoWrapper Config Options. - - --push-no-wrapper - When set, the message data is delivered directly as the HTTP body. - Use --no-push-no-wrapper to disable this flag. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --push-no-wrapper-write-metadata - When true, writes the Pub/Sub message metadata to - x-goog-pubsub-: headers of the HTTP request. Writes the - Pub/Sub message attributes to : headers of the HTTP - request. Use --no-push-no-wrapper-write-metadata to disable this - flag. - At most one of these can be specified: --clear-retry-policy @@ -338,6 +316,10 @@ FLAGS Retry Policy Options. Retry policy specifies how Cloud Pub/Sub retries message delivery for this subscription. + When updating RetryPolicy flags, all RetryPolicy flags must be + specified. Otherwise, any omitted RetryPolicy flags revert to their + default value. + --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 @@ -352,6 +334,46 @@ FLAGS UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + Push Config Options. Configuration for a push delivery endpoint. + + When updating PushConfig flags, all PushConfig flags must be specified. + Otherwise, any omitted PushConfig flags revert to their default value. + + --push-auth-service-account=SERVICE_ACCOUNT_EMAIL + Service account email used as the identity for the generated Open ID + Connect token for authenticated push. + + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + Audience used in the generated Open ID Connect token for + authenticated push. If not specified, it will be set to the + push-endpoint. + + --push-endpoint=PUSH_ENDPOINT + A URL to use as the endpoint for this subscription. This will also + automatically set the subscription type to PUSH. + + At most one of these can be specified: + + --clear-push-no-wrapper-config + If set, clear the NoWrapper config from the subscription. Use + --no-clear-push-no-wrapper-config to disable this flag. + + NoWrapper Config Options. + + --push-no-wrapper + When set, the message data is delivered directly as the HTTP + body. Use --no-push-no-wrapper to disable this flag. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --push-no-wrapper-write-metadata + When true, writes the Pub/Sub message metadata to + x-goog-pubsub-: headers of the HTTP request. Writes the + Pub/Sub message attributes to : headers of the HTTP + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. + 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/pubsub/topics/update b/gcloud/beta/pubsub/topics/update index 07df86625..7a267cead 100644 --- a/gcloud/beta/pubsub/topics/update +++ b/gcloud/beta/pubsub/topics/update @@ -119,6 +119,10 @@ FLAGS The following flags are for specifying ingestion settings for an import topic from Amazon Web Services (AWS) Kinesis Data Streams + When updating AWSKinesis Source flags, all AWSKinesis Source flags must + be specified. Otherwise, any omitted AWSKinesis Source flags revert to + their default value. + --kinesis-ingestion-consumer-arn=KINESIS_INGESTION_CONSUMER_ARN The Kinesis data streams consumer Amazon Resource Name (ARN) to use for ingestion. @@ -194,6 +198,10 @@ FLAGS Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. + When updating SchemaSettings flags, all SchemaSettings flags must be + specified. Otherwise, any omitted SchemaSettings flags revert to their + default value. + --message-encoding=ENCODING The encoding of messages validated against the schema. ENCODING must be one of: json, binary. @@ -243,7 +251,11 @@ FLAGS Options for explicitly specifying the message storage policy (https://cloud.google.com/pubsub/docs/resource-location-restriction) for - a topic. These fields can be set only if the + a topic. + + When updating MessageStoragePolicy flags, all MessageStoragePolicy flags + must be specified. Otherwise, any omitted MessageStoragePolicy flags + revert to their default value. These fields can be set only if the --recompute-message-storage-policy flag is not set. --message-storage-policy-allowed-regions=[REGION,...] diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index b775a736c..00cfb74d1 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -49,7 +49,8 @@ SYNOPSIS [--storage-size=STORAGE_SIZE] [--switch-transaction-logs-to-cloud-storage] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] - [--update-labels=[KEY=VALUE,...]] [--upgrade-sql-network-architecture] + [--time-zone=TIME_ZONE] [--update-labels=[KEY=VALUE,...]] + [--upgrade-sql-network-architecture] [--allowed-psc-projects=PROJECT,[PROJECT,...] | --clear-allowed-psc-projects] [--authorized-gae-apps=APP,[APP,...] | --clear-gae-apps] @@ -412,6 +413,9 @@ FLAGS https://cloud.google.com/sql/pricing. WARNING: Instance will be restarted. + --time-zone=TIME_ZONE + Set a non-default time zone. Only available for SQL Server instances. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/bigtable/app-profiles/create b/gcloud/bigtable/app-profiles/create index 8a93cc7b3..47bf47018 100644 --- a/gcloud/bigtable/app-profiles/create +++ b/gcloud/bigtable/app-profiles/create @@ -5,8 +5,10 @@ SYNOPSIS gcloud bigtable app-profiles create (APP_PROFILE : --instance=INSTANCE) ([--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]) - [--description=DESCRIPTION] [--force] [--priority=PRIORITY] - [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] [--force] + [--data-boost + --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER + | [--priority=PRIORITY : --standard]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new Bigtable app profile. @@ -35,6 +37,13 @@ EXAMPLES $ gcloud bigtable app-profiles create my-app-profile-id \ --instance=my-instance-id --route-any --priority=PRIORITY_MEDIUM + To create an app profile with Data Boost enabled which bills usage to the + host project, run: + + $ gcloud bigtable app-profiles create my-app-profile-id \ + --instance=my-instance-id --data-boost \ + --data-boost-compute-billing-owner=HOST_PAYS + POSITIONAL ARGUMENTS App profile resource - The app profile to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -100,16 +109,58 @@ OPTIONAL FLAGS --force Ignore warnings and force create. - --priority=PRIORITY - Specify the request priority. If not specified, the app profile uses - PRIORITY_HIGH by default. PRIORITY must be one of: + At most one of these can be specified: - PRIORITY_HIGH - Requests are treated with high priority. - PRIORITY_LOW - Requests are treated with low priority. - PRIORITY_MEDIUM - Requests are treated with medium priority. + Data Boost Read-only Isolation + + --data-boost + Use Data Boost serverless compute option, rather than standard + provisioned node compute. If specified, + --data-boost-compute-billing-owner is required. Specifying Data + Boost compute on an app profile that uses standard provisioned node + compute may cause unexpected behavior for running applications. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER + Specify the Data Boost compute billing owner, required if + --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be + (only one value is supported): + + HOST_PAYS + Compute billing should be accounted towards the host Cloud + project (containing the targeted Bigtable instance / table). + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Standard Isolation + + --priority=PRIORITY + Specify the request priority under standard provisioned node + compute capabilities. Passing this option implies standard + provisioned node compute, e.g. the --standard option. If not + specified, the app profile uses standard provisioned node compute + with PRIORITY_HIGH by default. Specifying request priority on an + app profile that has Data Boost serverless compute enabled changes + the compute option to standard and uses the specified priority, + which might cause unexpected behavior for running applications. + PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --standard + Use standard provisioned node compute option, rather than Data + Boost compute option. If specified, --priority is required. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/bigtable/app-profiles/update b/gcloud/bigtable/app-profiles/update index ec80cb461..4f1be15ea 100644 --- a/gcloud/bigtable/app-profiles/update +++ b/gcloud/bigtable/app-profiles/update @@ -3,7 +3,10 @@ NAME SYNOPSIS gcloud bigtable app-profiles update (APP_PROFILE : --instance=INSTANCE) - [--async] [--description=DESCRIPTION] [--force] [--priority=PRIORITY] + [--async] [--description=DESCRIPTION] [--force] + [--data-boost + --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER + | [--priority=PRIORITY : --standard]] [[--route-any : --restrict-to=[RESTRICT_TO,...]] | [--route-to=ROUTE_TO : --transactional-writes]] [GCLOUD_WIDE_FLAG ...] @@ -34,6 +37,13 @@ EXAMPLES $ gcloud bigtable app-profiles update my-app-profile-id \ --instance=my-instance-id --priority=PRIORITY_LOW + To update an app profile to enable Data Boost which bills usage to the host + project, run: + + $ gcloud bigtable app-profiles update my-app-profile-id \ + --instance=my-instance-id --data-boost \ + --data-boost-compute-billing-owner=HOST_PAYS + POSITIONAL ARGUMENTS App profile resource - The app profile to update. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -77,16 +87,58 @@ FLAGS --force Ignore warnings and force update. - --priority=PRIORITY - Specify the request priority. If not specified, the app profile uses - PRIORITY_HIGH by default. PRIORITY must be one of: + At most one of these can be specified: - PRIORITY_HIGH - Requests are treated with high priority. - PRIORITY_LOW - Requests are treated with low priority. - PRIORITY_MEDIUM - Requests are treated with medium priority. + Data Boost Read-only Isolation + + --data-boost + Use Data Boost serverless compute option, rather than standard + provisioned node compute. If specified, + --data-boost-compute-billing-owner is required. Specifying Data + Boost compute on an app profile that uses standard provisioned node + compute may cause unexpected behavior for running applications. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --data-boost-compute-billing-owner=DATA_BOOST_COMPUTE_BILLING_OWNER + Specify the Data Boost compute billing owner, required if + --data-boost is passed. DATA_BOOST_COMPUTE_BILLING_OWNER must be + (only one value is supported): + + HOST_PAYS + Compute billing should be accounted towards the host Cloud + project (containing the targeted Bigtable instance / table). + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Standard Isolation + + --priority=PRIORITY + Specify the request priority under standard provisioned node + compute capabilities. Passing this option implies standard + provisioned node compute, e.g. the --standard option. If not + specified, the app profile uses standard provisioned node compute + with PRIORITY_HIGH by default. Specifying request priority on an + app profile that has Data Boost serverless compute enabled changes + the compute option to standard and uses the specified priority, + which might cause unexpected behavior for running applications. + PRIORITY must be one of: + + PRIORITY_HIGH + Requests are treated with high priority. + PRIORITY_LOW + Requests are treated with low priority. + PRIORITY_MEDIUM + Requests are treated with medium priority. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --standard + Use standard provisioned node compute option, rather than Data + Boost compute option. If specified, --priority is required. At most one of these can be specified: diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index aed02148f..a94d835e1 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -969,12 +969,16 @@ FLAGS Computing can be based on Secure Encrypted Virtualization (SEV) or Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), both of which are AMD virtualization features for running - confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + confidential instances. Trust Domain eXtension based on Intel + virtualization features for running confidential instances is also + supported. CONFIDENTIAL_COMPUTE_TYPE must be one of: SEV Secure Encrypted Virtualization SEV_SNP Secure Encrypted Virtualization - Secure Nested Paging + TDX + Trust Domain eXtension Custom machine type extensions. diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index a6b444a58..31dd054df 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -893,12 +893,16 @@ OPTIONAL FLAGS Computing can be based on Secure Encrypted Virtualization (SEV) or Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), both of which are AMD virtualization features for running - confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + confidential instances. Trust Domain eXtension based on Intel + virtualization features for running confidential instances is also + supported. CONFIDENTIAL_COMPUTE_TYPE must be one of: SEV Secure Encrypted Virtualization SEV_SNP Secure Encrypted Virtualization - Secure Nested Paging + TDX + Trust Domain eXtension Custom machine type extensions. diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 161743c10..53a822a92 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -1087,12 +1087,16 @@ FLAGS Computing can be based on Secure Encrypted Virtualization (SEV) or Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), both of which are AMD virtualization features for running - confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + confidential instances. Trust Domain eXtension based on Intel + virtualization features for running confidential instances is also + supported. CONFIDENTIAL_COMPUTE_TYPE must be one of: SEV Secure Encrypted Virtualization SEV_SNP Secure Encrypted Virtualization - Secure Nested Paging + TDX + Trust Domain eXtension Custom machine type extensions. diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index cc4d94bc1..7b3cd0545 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -922,12 +922,16 @@ FLAGS Computing can be based on Secure Encrypted Virtualization (SEV) or Secure Encrypted Virtualization - Secure Nested Paging (SEV-SNP), both of which are AMD virtualization features for running - confidential instances. CONFIDENTIAL_COMPUTE_TYPE must be one of: + confidential instances. Trust Domain eXtension based on Intel + virtualization features for running confidential instances is also + supported. CONFIDENTIAL_COMPUTE_TYPE must be one of: SEV Secure Encrypted Virtualization SEV_SNP Secure Encrypted Virtualization - Secure Nested Paging + TDX + Trust Domain eXtension Custom machine type extensions. diff --git a/gcloud/compute/network-endpoint-groups/create b/gcloud/compute/network-endpoint-groups/create index 3712aca7b..cc6e3950b 100644 --- a/gcloud/compute/network-endpoint-groups/create +++ b/gcloud/compute/network-endpoint-groups/create @@ -53,7 +53,7 @@ FLAGS This is only supported for NEGs with endpoint type gce-vm-ip-port, non-gcp-private-ip-port, gce-vm-ip, private-service-connect, - internet-ip-port, or internet-fqdn-port. + internet-ip-port, internet-fqdn-port, or gce-vm-ip-portmap. For Private Service Connect NEGs, you can optionally specify --network and --subnet if --psc-target-service points to a published service. If @@ -108,9 +108,15 @@ FLAGS optional. If unspecified, the primary NIC address is used. A port must not be specified. + gce-vm-ip-portmap + Endpoint IP address must be a primary IP of a VM's network + interface in Compute Engine. The --default-port must be specified + or every network endpoint in the network endpoint group must have a + port specified. + NETWORK_ENDPOINT_TYPE must be one of: gce-vm-ip-port, internet-ip-port, internet-fqdn-port, non-gcp-private-ip-port, - serverless, gce-vm-ip, private-service-connect. + serverless, gce-vm-ip, private-service-connect, gce-vm-ip-portmap. --producer-port=PRODUCER_PORT The producer port to use when a consumer PSC NEG connects to a @@ -134,9 +140,9 @@ FLAGS region where the network endpoint group is created. This is only supported for NEGs with endpoint type gce-vm-ip-port, - gce-vm-ip, or private-service-connect. For Private Service Connect - NEGs, you can optionally specify --network and --subnet if - --psc-target-service points to a published service. If + gce-vm-ip, private-service-connect, or gce-vm-ip-portmap. For Private + Service Connect NEGs, you can optionally specify --network and --subnet + if --psc-target-service points to a published service. If --psc-target-service points to the regional service endpoint of a Google API, do not specify --network or --subnet. diff --git a/gcloud/compute/network-endpoint-groups/update b/gcloud/compute/network-endpoint-groups/update index f12239fe0..c2dd43778 100644 --- a/gcloud/compute/network-endpoint-groups/update +++ b/gcloud/compute/network-endpoint-groups/update @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud compute network-endpoint-groups update NAME - (--add-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] - | --remove-endpoint=[fqdn=FQDN], - [instance=INSTANCE],[ip=IP],[port=PORT]) + (--add-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT], + [fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] + | --remove-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT], + [fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT]) [--global | --region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -37,7 +38,7 @@ REQUIRED FLAGS Exactly one of these must be specified: - --add-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] + --add-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT],[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] The network endpoint to add to the network endpoint group. Keys used depend on the endpoint type of the NEG. @@ -60,6 +61,9 @@ REQUIRED FLAGS *port* - Required endpoint port unless NEG default port is set. + *client-destination-port* - Required endpoint client destination port only for the port + mapping NEG. + internet-ip-port *ip* - Required IPv4 address of the endpoint to attach. Must be @@ -107,7 +111,7 @@ REQUIRED FLAGS IP address must be the VM's network interface address. If not specified, the primary NIC address is used. - --remove-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] + --remove-endpoint=[client-destination-port=CLIENT-DESTINATION-PORT],[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] The network endpoint to detach from the network endpoint group. Keys used depend on the endpoint type of the NEG. @@ -122,6 +126,8 @@ REQUIRED FLAGS *port* - Optional port of the network endpoint to detach. + *client-destination-port* - Optional client destination port, only for port mapping NEGs. + internet-ip-port *ip* - Required IPv4 address of the network endpoint to detach. diff --git a/gcloud/database-migration/connection-profiles/create/alloydb b/gcloud/database-migration/connection-profiles/create/alloydb index 0d77a1da7..8d53715b2 100644 --- a/gcloud/database-migration/connection-profiles/create/alloydb +++ b/gcloud/database-migration/connection-profiles/create/alloydb @@ -88,7 +88,7 @@ OPTIONAL FLAGS --database-version=DATABASE_VERSION Database engine major version. DATABASE_VERSION must be one of: - POSTGRES_14, POSTGRES_15. + POSTGRES_14, POSTGRES_15, POSTGRES_16. --display-name=DISPLAY_NAME A user-friendly name for the connection profile. The display name can diff --git a/gcloud/database-migration/migration-jobs/restart b/gcloud/database-migration/migration-jobs/restart index c0c3d4608..90074ef90 100644 --- a/gcloud/database-migration/migration-jobs/restart +++ b/gcloud/database-migration/migration-jobs/restart @@ -14,13 +14,19 @@ EXAMPLES To restart a migration job: $ gcloud database-migration migration-jobs restart MIGRATION_JOB \ - --region=us-central1 + --region=us-central1 + + To restart a migration job without running prior configuration + verification: + + $ gcloud database-migration migration-jobs restart MIGRATION_JOB \ + --region=us-central1 --skip-validation POSITIONAL ARGUMENTS - Migration job resource - Migration job resource - Cloud Database Migration - Service migration job to restart. 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. + Migration job resource - The migration job to restart. 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 migration_job on the command line with a fully @@ -41,7 +47,7 @@ POSITIONAL ARGUMENTS arguments in this group are specified. --region=REGION - The name of the region. + The Cloud region for the migration_job. To set the region attribute: ▸ provide the argument migration_job on the command line with a @@ -61,10 +67,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the datamigration/v1 API. The full documentation for this - API can be found at: https://cloud.google.com/database-migration/ - NOTES This variant is also available: diff --git a/gcloud/gemini/code-repository-indexes/create b/gcloud/gemini/code-repository-indexes/create new file mode 100644 index 000000000..303981fe3 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/create @@ -0,0 +1,122 @@ +NAME + gcloud gemini code-repository-indexes create - create a code repository + index instance + +SYNOPSIS + gcloud gemini code-repository-indexes create + (CODE_REPOSITORY_INDEX : --location=LOCATION) [--async] + [--kms-key=KMS_KEY] [--labels=[LABELS,...]] [--request-id=REQUEST_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a code repository index instance. + + The instance will be created in the specified project and location. + +EXAMPLES + To create a code repository index instance my-instance in project + my-project and location us-central1, run: + + $ gcloud gemini code-repository-indexes create my-instance \ + --project=my-project --location=us-central1 + + To create a code repository index instance my-instance in project + my-project, location us-central1 with your managed encryption key run: + + $ gcloud gemini code-repository-indexes create my-instance \ + --project=my-project --location=us-central1 \ + --kms-key=projects/*/locations/*/keyRings/*/cryptoKeys/* + + Note: --kms-key can be only passed during index creation and can not be + used during update. + +POSITIONAL ARGUMENTS + CodeRepositoryIndex resource - Identifier. name of 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 code_repository_index 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. + + CODE_REPOSITORY_INDEX + ID of the codeRepositoryIndex or fully qualified identifier for the + codeRepositoryIndex. + + To set the code_repository_index attribute: + ▸ provide the argument code_repository_index 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 codeRepositoryIndex resource. + + To set the location attribute: + ▸ provide the argument code_repository_index on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --kms-key=KMS_KEY + Customer-managed encryption key name, in the format + projects/*/locations/*/keyRings/*/cryptoKeys/*. + + --labels=[LABELS,...] + Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/delete b/gcloud/gemini/code-repository-indexes/delete new file mode 100644 index 000000000..411b8a725 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/delete @@ -0,0 +1,87 @@ +NAME + gcloud gemini code-repository-indexes delete - delete a code repository + index instance + +SYNOPSIS + gcloud gemini code-repository-indexes delete + (CODE_REPOSITORY_INDEX : --location=LOCATION) [--async] [--force] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a code repository index instance. + +EXAMPLES + To delete code repository index instance my-instance in project my-project + and location us-central1, run: + + $ gcloud gemini code-repository-indexes delete my-instance \ + --project=my-project --location=us-central1 + +POSITIONAL ARGUMENTS + CodeRepositoryIndex 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 code_repository_index 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. + + CODE_REPOSITORY_INDEX + ID of the codeRepositoryIndex or fully qualified identifier for the + codeRepositoryIndex. + + To set the code_repository_index attribute: + ▸ provide the argument code_repository_index 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 codeRepositoryIndex resource. + + To set the location attribute: + ▸ provide the argument code_repository_index on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set to true, any RepositoryGroups from this CodeRepositoryIndex will + also be deleted. (Otherwise, the request will only work if the + CodeRepositoryIndex has no RepositoryGroups.) + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes after the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/describe b/gcloud/gemini/code-repository-indexes/describe new file mode 100644 index 000000000..fb1d9b05c --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/describe @@ -0,0 +1,61 @@ +NAME + gcloud gemini code-repository-indexes describe - get details of a code + repository index instance + +SYNOPSIS + gcloud gemini code-repository-indexes describe + (CODE_REPOSITORY_INDEX : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a code repository index instance. + +EXAMPLES + To get the details of code repository index instance my-instance in project + my-project and location us-central, run: + + $ gcloud gemini code-repository-indexes describe my-instance \ + --project=my-project --location=us-central1 + +POSITIONAL ARGUMENTS + CodeRepositoryIndex 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 code_repository_index 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. + + CODE_REPOSITORY_INDEX + ID of the codeRepositoryIndex or fully qualified identifier for the + codeRepositoryIndex. + + To set the code_repository_index attribute: + ▸ provide the argument code_repository_index 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 codeRepositoryIndex resource. + + To set the location attribute: + ▸ provide the argument code_repository_index 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/help b/gcloud/gemini/code-repository-indexes/help new file mode 100644 index 000000000..7f37f63ed --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/help @@ -0,0 +1,40 @@ +NAME + gcloud gemini code-repository-indexes - manage Code Repository Index + resources + +SYNOPSIS + gcloud gemini code-repository-indexes GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Code Repository Index resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + repository-groups + Manage Repository Group resources. + +COMMANDS + COMMAND is one of the following: + + create + Create a code repository index instance. + + delete + Delete a code repository index instance. + + describe + Get details of a code repository index instance. + + list + List all code repository index instances in a specified project and + location. + + update + Update the configuration of a code repository index instance. diff --git a/gcloud/gemini/code-repository-indexes/list b/gcloud/gemini/code-repository-indexes/list new file mode 100644 index 000000000..b79c9071a --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/list @@ -0,0 +1,82 @@ +NAME + gcloud gemini code-repository-indexes list - list all code repository index + instances in a specified project and location + +SYNOPSIS + gcloud gemini code-repository-indexes list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all code repository index instances in a specified project and + location. + +EXAMPLES + To list all code repository index instances in project my-project and + location us-central, run: + + $ gcloud gemini code-repository-indexes list --project=my-project \ + --location=us-central1 + +REQUIRED FLAGS + Location resource - Parent value for ListCodeRepositoryIndexesRequest 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/create b/gcloud/gemini/code-repository-indexes/repository-groups/create new file mode 100644 index 000000000..bcef325b3 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/create @@ -0,0 +1,183 @@ +NAME + gcloud gemini code-repository-indexes repository-groups create - create a + repository group for a given code repository index instance + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups create + (REPOSITORY_GROUP + : --code-repository-index=CODE_REPOSITORY_INDEX --location=LOCATION) + --repositories=[branchPattern=BRANCHPATTERN],[resource=RESOURCE] + [--async] [--labels=[LABELS,...]] [--request-id=REQUEST_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a repository group for a given code repository index instance. + +EXAMPLES + To create a repository group my-repository-group for a code repository + index instance my-instance in project my-project and location us-central1 + with one Developer Connect repository and branch pattern .*, run: + + $ gcloud gemini code-repository-indexes repository-groups create \ + my-repository-group --code-repository-index=my-instance \ + --project=my-project --location=us-central1 \ + --repositories=branchPattern=.*,\ + resource=developerconnect.googleapis.com/projects//\ + locations//connections//gitRepositoryLinks/\ + + + Developer Connect Git repository resource must already exist. Refer to + Developer Connect documentation + (http://cloud.google.com/developer-connect/docs/connect-repo) for more + details. + + To create a repository group my-repository-group for a code repository + index instance my-instance in project my-project and location us-central1 + with a fully qualified name, run: + + $ gcloud gemini code-repository-indexes repository-groups create \ + projects/my-project/locations/us-central1/\ + codeRepositoryIndexes/my-instance/repositoryGroups/\ + my-repository-group \ + --repositories=branchPattern=.*,\ + resource=developerconnect.googleapis.com/projects//\ + locations//connections//gitRepositoryLinks/\ + + + Developer Connect Git repository resource must already exist. Refer to + Developer Connect documentation + (http://cloud.google.com/developer-connect/docs/connect-repo) for more + details. + + To create a repository group my-repository-group for a code repository + index instance my-instance in project my-project and location us-central1 + with Developer Connect repositories defined in a separate file, run: + + $ gcloud gemini code-repository-indexes repository-groups create \ + my-repository-group --code-repository-index=my-instance \ + --project=my-project --location=us-central1 \ + --repositories=@/path/to/repositories.json + + Developer Connect Git repository resource must already exist. Refer to + Developer Connect documentation + (http://cloud.google.com/developer-connect/docs/connect-repo) for more + details. + +POSITIONAL ARGUMENTS + RepositoryGroup resource - Identifier. name of 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 repository_group 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. + + REPOSITORY_GROUP + ID of the repositoryGroup or fully qualified identifier for the + repositoryGroup. + + To set the repository_group attribute: + ▸ provide the argument repository_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --code-repository-index=CODE_REPOSITORY_INDEX + The codeRepositoryIndex id of the repositoryGroup resource. + + To set the code-repository-index attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --code-repository-index on the command line. + + --location=LOCATION + The location id of the repositoryGroup resource. + + To set the location attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --repositories=[branchPattern=BRANCHPATTERN],[resource=RESOURCE] + Required, List of repositories to group. + + branchPattern + The Git branch pattern used for indexing in RE2 syntax. See + https://github.com/google/re2/wiki/syntax for syntax. + + resource + The link to the DeveloperConnect repository resource name or URL to + be indexed. + + Shorthand Example: + + --repositories=branchPattern=string,resource=string --repositories=branchPattern=string,resource=string + + JSON Example: + + --repositories='[{"branchPattern": "string", "resource": "string"}]' + + File Example: + + --repositories=path_to_file.(yaml|json) + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --labels=[LABELS,...] + Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/delete b/gcloud/gemini/code-repository-indexes/repository-groups/delete new file mode 100644 index 000000000..20969c9b7 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/delete @@ -0,0 +1,93 @@ +NAME + gcloud gemini code-repository-indexes repository-groups delete - delete a + repository group from a given code repository index instance + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups delete + (REPOSITORY_GROUP + : --code-repository-index=CODE_REPOSITORY_INDEX --location=LOCATION) + [--async] [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a repository group from a given code repository index instance. + +EXAMPLES + To delete a repository group my-repository-group from a code repository + index instance my-instance in project my-project and location us-central1 + with a fully qualified name, run: + + $ gcloud gemini code-repository-indexes repository-groups delete \ + my-repository-group --code-repository-index=my-instance \ + --project=my-project + +POSITIONAL ARGUMENTS + RepositoryGroup 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 repository_group 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. + + REPOSITORY_GROUP + ID of the repositoryGroup or fully qualified identifier for the + repositoryGroup. + + To set the repository_group attribute: + ▸ provide the argument repository_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --code-repository-index=CODE_REPOSITORY_INDEX + The codeRepositoryIndex id of the repositoryGroup resource. + + To set the code-repository-index attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --code-repository-index on the command line. + + --location=LOCATION + The location id of the repositoryGroup resource. + + To set the location attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes after the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/describe b/gcloud/gemini/code-repository-indexes/repository-groups/describe new file mode 100644 index 000000000..44607cee0 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/describe @@ -0,0 +1,73 @@ +NAME + gcloud gemini code-repository-indexes repository-groups describe - get + details of a code repository index instance + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups describe + (REPOSITORY_GROUP + : --code-repository-index=CODE_REPOSITORY_INDEX --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a code repository index instance. + +EXAMPLES + To get the details of repository group my-repository-group of a code + repository index instance my-instance in project my-project and location + us-central1, run: + + $ gcloud gemini code-repository-indexes repository-groups describe \ + my-repository-group --code-repository-index=my-instance \ + --project=my-project --location=us-central1 + +POSITIONAL ARGUMENTS + RepositoryGroup 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 repository_group 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. + + REPOSITORY_GROUP + ID of the repositoryGroup or fully qualified identifier for the + repositoryGroup. + + To set the repository_group attribute: + ▸ provide the argument repository_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --code-repository-index=CODE_REPOSITORY_INDEX + The codeRepositoryIndex id of the repositoryGroup resource. + + To set the code-repository-index attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --code-repository-index on the command line. + + --location=LOCATION + The location id of the repositoryGroup resource. + + To set the location attribute: + ▸ provide the argument repository_group 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/get-iam-policy b/gcloud/gemini/code-repository-indexes/repository-groups/get-iam-policy new file mode 100644 index 000000000..73ad0c714 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/get-iam-policy @@ -0,0 +1,104 @@ +NAME + gcloud gemini code-repository-indexes repository-groups get-iam-policy - + get the IAM policy for a code repository index repository group + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups get-iam-policy + (REPOSITORY_GROUP + : --code-repository-index=CODE_REPOSITORY_INDEX --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud gemini code-repository-indexes repository-groups get-iam-policy + displays the IAM policy associated with a code repository index repository + group. If formatted as JSON, the output can be edited and used as a policy + file for set-iam-policy. The output includes an "etag" field identifying + the version emitted and allowing detection of concurrent policy updates; + see $ gcloud gemini code-repository-indexes repository-groups + set-iam-policy for additional details. + +EXAMPLES + To print the IAM policy for a target my-repository-group, run: + + $ gcloud gemini code-repository-indexes repository-groups \ + get-iam-policy my-repository-group --region=us-central1 \ + --code-repository-index=my-index + +POSITIONAL ARGUMENTS + Repository group resource - The repository group for which to display the + IAM policy. 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 repository_group 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. + + REPOSITORY_GROUP + ID of the repository_group or fully qualified identifier for the + repository_group. + + To set the repository_group attribute: + ▸ provide the argument repository_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --code-repository-index=CODE_REPOSITORY_INDEX + ID of the code repository index resource. + + To set the code-repository-index attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --code-repository-index on the command line. + + --location=LOCATION + Location of the Gemini resource. + + To set the location attribute: + ▸ provide the argument repository_group 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/help b/gcloud/gemini/code-repository-indexes/repository-groups/help new file mode 100644 index 000000000..fe1655a43 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/help @@ -0,0 +1,39 @@ +NAME + gcloud gemini code-repository-indexes repository-groups - manage Repository + Group resources + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Repository Group 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 + Create a repository group for a given code repository index instance. + + delete + Delete a repository group from a given code repository index instance. + + describe + Get details of a code repository index instance. + + get-iam-policy + Get the IAM policy for a code repository index repository group. + + list + List all repository group for a given code repository index instance. + + set-iam-policy + Get the IAM policy for a code repository index repository group. + + update + Update the configuration of a repository group. diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/list b/gcloud/gemini/code-repository-indexes/repository-groups/list new file mode 100644 index 000000000..4f4d3c9cf --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/list @@ -0,0 +1,96 @@ +NAME + gcloud gemini code-repository-indexes repository-groups list - list all + repository group for a given code repository index instance + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups list + (--code-repository-index=CODE_REPOSITORY_INDEX : --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all repository group for a given code repository index instance. + +EXAMPLES + To list all repository groups of a code repository index instance + my-instance in project my-project and location us-central1, run: + + $ gcloud gemini code-repository-indexes repository-groups list \ + --code-repository-index=my-instance --project=my-project \ + --location=us-central1 + +REQUIRED FLAGS + CodeRepositoryIndex resource - Parent value for + ListRepositoryGroupsRequest 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 --code-repository-index 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. + + --code-repository-index=CODE_REPOSITORY_INDEX + ID of the codeRepositoryIndex or fully qualified identifier for the + codeRepositoryIndex. + + To set the code-repository-index attribute: + ▸ provide the argument --code-repository-index 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 codeRepositoryIndex resource. + + To set the location attribute: + ▸ provide the argument --code-repository-index 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/set-iam-policy b/gcloud/gemini/code-repository-indexes/repository-groups/set-iam-policy new file mode 100644 index 000000000..276b98735 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/set-iam-policy @@ -0,0 +1,85 @@ +NAME + gcloud gemini code-repository-indexes repository-groups set-iam-policy - + get the IAM policy for a code repository index repository group + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups set-iam-policy + (REPOSITORY_GROUP + : --code-repository-index=CODE_REPOSITORY_INDEX --location=LOCATION) + POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud gemini code-repository-indexes repository-groups set-iam-policy sets + the IAM policy for a code repository index repository group as defined in a + JSON or YAML file. + + See https://cloud.google.com/iam/docs/managing-policies for details of the + policy file format and contents. + +EXAMPLES + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for the repository group named + 'my-repository-group': + + $ gcloud gemini code-repository-indexes repository-groups \ + set-iam-policy my-repository-group policy.json \ + --region=us-central1 --code-repository-index=my-index + +POSITIONAL ARGUMENTS + Repository group resource - The repository group for which to set the IAM + policy. 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 repository_group 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. + + REPOSITORY_GROUP + ID of the repository_group or fully qualified identifier for the + repository_group. + + To set the repository_group attribute: + ▸ provide the argument repository_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --code-repository-index=CODE_REPOSITORY_INDEX + ID of the code repository index resource. + + To set the code-repository-index attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --code-repository-index on the command line. + + --location=LOCATION + Location of the Gemini resource. + + To set the location attribute: + ▸ provide the argument repository_group 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/repository-groups/update b/gcloud/gemini/code-repository-indexes/repository-groups/update new file mode 100644 index 000000000..f57b18977 --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/repository-groups/update @@ -0,0 +1,242 @@ +NAME + gcloud gemini code-repository-indexes repository-groups update - update the + configuration of a repository group + +SYNOPSIS + gcloud gemini code-repository-indexes repository-groups update + (REPOSITORY_GROUP + : --code-repository-index=CODE_REPOSITORY_INDEX --location=LOCATION) + [--async] [--request-id=REQUEST_ID] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=[__REMOVE_LABELS,...]] + [--repositories=[branchPattern=BRANCHPATTERN],[resource=RESOURCE] + | --add-repositories=[branchPattern=BRANCHPATTERN], + [resource=RESOURCE] --clear-repositories + | --remove-repositories=[branchPattern=BRANCHPATTERN], + [resource=RESOURCE]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update the configuration of a repository group. + +EXAMPLES + To update repository group my-repository-group of code repository index + instance my-instance in project my-project and location us-central1 with a + new branch pattern for one of the Git repositories, run: + + $ gcloud gemini code-repository-indexes repository-groups update \ + my-repository-group --code-repository-index=my-instance \ + --project=my-project --location=us-central1 \ + --repositories=branchPattern=new_branch,\ + resource=developerconnect.googleapis.com/projects//\ + locations//connections//gitRepositoryLinks/\ + + +POSITIONAL ARGUMENTS + RepositoryGroup resource - Identifier. name of 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 repository_group 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. + + REPOSITORY_GROUP + ID of the repositoryGroup or fully qualified identifier for the + repositoryGroup. + + To set the repository_group attribute: + ▸ provide the argument repository_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --code-repository-index=CODE_REPOSITORY_INDEX + The codeRepositoryIndex id of the repositoryGroup resource. + + To set the code-repository-index attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --code-repository-index on the command line. + + --location=LOCATION + The location id of the repositoryGroup resource. + + To set the location attribute: + ▸ provide the argument repository_group on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=[__REMOVE_LABELS,...] + Remove existing value from map labels. + + Update repositories. + + At most one of these can be specified: + + --repositories=[branchPattern=BRANCHPATTERN],[resource=RESOURCE] + Set repositories to new value. List of repositories to group. + + branchPattern + The Git branch pattern used for indexing in RE2 syntax. See + https://github.com/google/re2/wiki/syntax for syntax. + + resource + The link to the DeveloperConnect repository resource name or URL + to be indexed. + + Shorthand Example: + + --repositories=branchPattern=string,resource=string --repositories=branchPattern=string,resource=string + + JSON Example: + + --repositories='[{"branchPattern": "string", "resource": "string"}]' + + File Example: + + --repositories=path_to_file.(yaml|json) + + --add-repositories=[branchPattern=BRANCHPATTERN],[resource=RESOURCE] + Add new value to repositories list. List of repositories to group. + + branchPattern + The Git branch pattern used for indexing in RE2 syntax. See + https://github.com/google/re2/wiki/syntax for syntax. + + resource + The link to the DeveloperConnect repository resource name or URL + to be indexed. + + Shorthand Example: + + --add-repositories=branchPattern=string,resource=string --add-repositories=branchPattern=string,resource=string + + JSON Example: + + --add-repositories='[{"branchPattern": "string", "resource": "string"}]' + + File Example: + + --add-repositories=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-repositories + Clear repositories value and set to empty list. + + --remove-repositories=[branchPattern=BRANCHPATTERN],[resource=RESOURCE] + Remove existing value from repositories list. List of repositories + to group. + + branchPattern + The Git branch pattern used for indexing in RE2 syntax. See + https://github.com/google/re2/wiki/syntax for syntax. + + resource + The link to the DeveloperConnect repository resource name or + URL to be indexed. + + Shorthand Example: + + --remove-repositories=branchPattern=string,resource=string --remove-repositories=branchPattern=string,resource=string + + JSON Example: + + --remove-repositories='[{"branchPattern": "string", "resource": "string"}]' + + File Example: + + --remove-repositories=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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/code-repository-indexes/update b/gcloud/gemini/code-repository-indexes/update new file mode 100644 index 000000000..f9a9fa40f --- /dev/null +++ b/gcloud/gemini/code-repository-indexes/update @@ -0,0 +1,144 @@ +NAME + gcloud gemini code-repository-indexes update - update the configuration of + a code repository index instance + +SYNOPSIS + gcloud gemini code-repository-indexes update + (CODE_REPOSITORY_INDEX : --location=LOCATION) [--async] + [--request-id=REQUEST_ID] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=[__REMOVE_LABELS,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update the configuration of a code repository index instance. + +EXAMPLES + To update code repository index instance my-instance in project my-project + and location us-central1 with new labels, run: + + $ gcloud gemini code-repository-indexes update `my-instance` \ + --project=my-project --location=us-central1 \ + --labels='{"my_label": "my_value"}' + +POSITIONAL ARGUMENTS + CodeRepositoryIndex resource - Identifier. name of 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 code_repository_index 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. + + CODE_REPOSITORY_INDEX + ID of the codeRepositoryIndex or fully qualified identifier for the + codeRepositoryIndex. + + To set the code_repository_index attribute: + ▸ provide the argument code_repository_index 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 codeRepositoryIndex resource. + + To set the location attribute: + ▸ provide the argument code_repository_index on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --request-id=REQUEST_ID + An optional request ID to identify requests. Specify a unique request + ID so that if you must retry your request, the server will know to + ignore the request if it has already been completed. The server will + guarantee that for at least 60 minutes since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, will ignore the second request. + This prevents clients from accidentally creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. Labels as key value pairs. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=[__REMOVE_LABELS,...] + Remove existing value from map labels. + +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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/help b/gcloud/gemini/help new file mode 100644 index 000000000..e3b2eae31 --- /dev/null +++ b/gcloud/gemini/help @@ -0,0 +1,22 @@ +NAME + gcloud gemini - manage code repository index resources + +SYNOPSIS + gcloud gemini GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage code repository index resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + code-repository-indexes + Manage Code Repository Index resources. + + operations + Manage Operation resources. diff --git a/gcloud/gemini/operations/cancel b/gcloud/gemini/operations/cancel new file mode 100644 index 000000000..fc3ca5afe --- /dev/null +++ b/gcloud/gemini/operations/cancel @@ -0,0 +1,57 @@ +NAME + gcloud gemini operations cancel - cancel operations + +SYNOPSIS + gcloud gemini operations cancel (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel an operation + +EXAMPLES + To cancel the operation, run: + + $ gcloud gemini 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/operations/delete b/gcloud/gemini/operations/delete new file mode 100644 index 000000000..914c10a92 --- /dev/null +++ b/gcloud/gemini/operations/delete @@ -0,0 +1,57 @@ +NAME + gcloud gemini operations delete - delete operations + +SYNOPSIS + gcloud gemini operations delete (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an operation + +EXAMPLES + To delete the operation, run: + + $ gcloud gemini 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/operations/describe b/gcloud/gemini/operations/describe new file mode 100644 index 000000000..df90cf2f0 --- /dev/null +++ b/gcloud/gemini/operations/describe @@ -0,0 +1,57 @@ +NAME + gcloud gemini operations describe - describe operations + +SYNOPSIS + gcloud gemini operations describe (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an operation + +EXAMPLES + To describe the operation, run: + + $ gcloud gemini 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/operations/help b/gcloud/gemini/operations/help new file mode 100644 index 000000000..d836eef50 --- /dev/null +++ b/gcloud/gemini/operations/help @@ -0,0 +1,31 @@ +NAME + gcloud gemini operations - manage Operation resources + +SYNOPSIS + gcloud gemini operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + 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 + Cancel operations. + + delete + Delete operations. + + describe + Describe operations. + + list + List operations. + + wait + Wait operations. diff --git a/gcloud/gemini/operations/list b/gcloud/gemini/operations/list new file mode 100644 index 000000000..e85ead141 --- /dev/null +++ b/gcloud/gemini/operations/list @@ -0,0 +1,78 @@ +NAME + gcloud gemini operations list - list operations + +SYNOPSIS + gcloud gemini operations list --location=LOCATION [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List operations + +EXAMPLES + To list all operations, run: + + $ gcloud gemini 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/gemini/operations/wait b/gcloud/gemini/operations/wait new file mode 100644 index 000000000..fe3bb3d0a --- /dev/null +++ b/gcloud/gemini/operations/wait @@ -0,0 +1,57 @@ +NAME + gcloud gemini operations wait - wait operations + +SYNOPSIS + gcloud gemini operations wait (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Wait an operation + +EXAMPLES + To wait the operation, run: + + $ gcloud gemini operations wait + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to wait on. 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 cloudaicompanion/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/gemini diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index a9714cad6..c06dd03e7 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -17,13 +17,8 @@ SYNOPSIS [kerberos-5i-read-write=KERBEROS-5I-READ-WRITE], [kerberos-5p-read-only=KERBEROS-5P-READ-ONLY], [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], - [nfsv3=NFSV3],[nfsv4=NFSV4]] - [--hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION], - [description=DESCRIPTION],[labels=LABELS], - [peer-cluster-name=PEER-CLUSTER-NAME], - [peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME], - [peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION]] - [--labels=[KEY=VALUE,...]] [--large-capacity=LARGE_CAPACITY] + [nfsv3=NFSV3],[nfsv4=NFSV4]] [--labels=[KEY=VALUE,...]] + [--large-capacity=LARGE_CAPACITY] [--multiple-endpoints=MULTIPLE_ENDPOINTS] [--restricted-actions=RESTRICTED_ACTION,[...]] [--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"] @@ -169,30 +164,6 @@ OPTIONAL FLAGS kerberos-5p-read-only=KERBEROS_5P_READ_ONLY, kerberos-5p-read-write=KERBEROS_5P_READ_WRITE - --hybrid-replication-parameters=[cluster-location=CLUSTER-LOCATION],[description=DESCRIPTION],[labels=LABELS],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME],[replication=REPLICATION] - Hybrid Replication Parameters contains hybrid replication parameters on - a volume. - - Hybrid Replication Parameters will have the following format - --hybrid-replication-parameters=replication=REPLICATION, - peer-volume-name=PEER_VOLUME_NAME, - peer-cluster-name=PEER_CLUSTER_NAME, - peer-svm-name=PEER_SVM_NAME, - peer-ip-addresses=[PEER-IP-ADDRESS1#PEER-IP-ADDRESS2#...], - cluster-location=CLUSTER_LOCATION, - description=DESCRIPTION, - labels=[KEY1:VALUE1#KEY2:VALUE2#...] - - replication is the desired name for the replication of the volume, - peer-volume-name is the name of the user's local source volume, - peer-cluster-name is the name of the user's local source cluster, - peer-svm-name is the name of the user's local source vserver svm, - peer-ip-addresses is a ampersand-separated(#) list of ip addresses, - cluster-location is the name of the source cluster location, - description is the description of the replication and labels is an - hashtag-separated(#) key value pair of labels with key and value - separated by colon(:) for the replication. - --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/oracle-database/autonomous-database-backups/help b/gcloud/oracle-database/autonomous-database-backups/help new file mode 100644 index 000000000..04c4874d6 --- /dev/null +++ b/gcloud/oracle-database/autonomous-database-backups/help @@ -0,0 +1,21 @@ +NAME + gcloud oracle-database autonomous-database-backups - manage Autonomous + Database Backup resources + +SYNOPSIS + gcloud oracle-database autonomous-database-backups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Autonomous Database Backup resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List autonomous database backups. diff --git a/gcloud/oracle-database/autonomous-database-backups/list b/gcloud/oracle-database/autonomous-database-backups/list new file mode 100644 index 000000000..e9ec76903 --- /dev/null +++ b/gcloud/oracle-database/autonomous-database-backups/list @@ -0,0 +1,75 @@ +NAME + gcloud oracle-database autonomous-database-backups list - list autonomous + database backups + +SYNOPSIS + gcloud oracle-database autonomous-database-backups list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists all AutonomousDatabaseBackups for the specified AutonomousDatabase. + +EXAMPLES + To list all backups for an AutonomousDatabase with id my-instance in the + location us-east4, run: + + $ gcloud oracle-database autonomous-database-backups list \ + --location=us-east4 \ + --filter='autonomous_database_id="my-instance"' + +REQUIRED FLAGS + Location resource - The location you want to list the connection profiles + for. 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 ADB filter in the format : + --filter='autonomous_database_id="my-instance"' + + --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. diff --git a/gcloud/oracle-database/autonomous-database-character-sets/help b/gcloud/oracle-database/autonomous-database-character-sets/help new file mode 100644 index 000000000..e63209e8c --- /dev/null +++ b/gcloud/oracle-database/autonomous-database-character-sets/help @@ -0,0 +1,21 @@ +NAME + gcloud oracle-database autonomous-database-character-sets - manage + Autonomous Database Character Set resources + +SYNOPSIS + gcloud oracle-database autonomous-database-character-sets COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Autonomous Database Character Set resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all AutonomousDatabaseCharacterSets. diff --git a/gcloud/oracle-database/autonomous-database-character-sets/list b/gcloud/oracle-database/autonomous-database-character-sets/list new file mode 100644 index 000000000..5e3d80959 --- /dev/null +++ b/gcloud/oracle-database/autonomous-database-character-sets/list @@ -0,0 +1,82 @@ +NAME + gcloud oracle-database autonomous-database-character-sets list - list all + AutonomousDatabaseCharacterSets + +SYNOPSIS + gcloud oracle-database autonomous-database-character-sets list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all AutonomousDatabaseCharacterSets. + +EXAMPLES + To list all AutonomousDatabaseCharacterSets in the location us-east4, run: + + $ gcloud oracle-database autonomous-database-character-sets list \ + --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for the Autonomous Database in the + following format: projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/autonomous-databases/create b/gcloud/oracle-database/autonomous-databases/create new file mode 100644 index 000000000..591a83e7c --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/create @@ -0,0 +1,276 @@ +NAME + gcloud oracle-database autonomous-databases create - create a new + AutonomousDatabase + +SYNOPSIS + gcloud oracle-database autonomous-databases create + (AUTONOMOUS_DATABASE : --location=LOCATION) --cidr=CIDR + --network=NETWORK [--admin-password=ADMIN_PASSWORD] [--async] + [--database=DATABASE] [--display-name=DISPLAY_NAME] + [--labels=[LABELS,...]] [--request-id=REQUEST_ID] + [--properties-db-workload=PROPERTIES_DB_WORKLOAD + --properties-license-type=PROPERTIES_LICENSE_TYPE + : --properties-backup-retention-period-days=PROPERTIES_BACKUP_RETENTION_PERIOD_DAYS --properties-character-set=PROPERTIES_CHARACTER_SET --properties-compute-count=PROPERTIES_COMPUTE_COUNT --properties-cpu-core-count=PROPERTIES_CPU_CORE_COUNT --properties-customer-contacts=[email=EMAIL] --properties-data-storage-size-gb=PROPERTIES_DATA_STORAGE_SIZE_GB --properties-data-storage-size-tb=PROPERTIES_DATA_STORAGE_SIZE_TB --properties-db-edition=PROPERTIES_DB_EDITION --properties-db-version=PROPERTIES_DB_VERSION --properties-is-auto-scaling-enabled --properties-is-storage-auto-scaling-enabled --properties-maintenance-schedule-type=PROPERTIES_MAINTENANCE_SCHEDULE_TYPE --properties-mtls-connection-required --properties-n-character-set=PROPERTIES_N_CHARACTER_SET --properties-private-endpoint-ip=PROPERTIES_PRIVATE_ENDPOINT_IP --properties-private-endpoint-label=PROPERTIES_PRIVATE_ENDPOINT_LABEL --properties-secret-id=PROPERTIES_SECRET_ID --properties-vault-id=PROPERTIES_VAULT_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new AutonomousDatabase. + +EXAMPLES + To create AutonomousDatabase with id my-instance in the location us-east4 + with display-name my instance, network + projects/my-project/locations/global/networks/default, location us-east4, + database testadb, admin-password 123Abpassdord, cidr 12.2.0.0/24, + properties-compute-count 2, properties-db-version 19c, + properties-license-type LICENSE_INCLUDED, properties-db-workload DW. run: + + $ gcloud oracle-database autonomous-databases create my-instance \ + --location=us-east4 --display-name="my instance" \ + --network=projects/my-project/locations/global/networks/\ + default --cidr=12.2.0.0/24 --location=us-east4 --database=testadb \ + --admin-password=123Abpassdord --properties-compute-count=2 \ + --properties-db-version=19c \ + --properties-license-type=LICENSE_INCLUDED \ + --properties-db-workload=DW + +POSITIONAL ARGUMENTS + AutonomousDatabase resource - Identifier. The name of the Autonomous + Database resource in the following format: + projects/{project}/locations/{region}/autonomousDatabases/{autonomous_database} + 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 autonomous_database 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. + + AUTONOMOUS_DATABASE + ID of the autonomousDatabase or fully qualified identifier for the + autonomousDatabase. + + To set the autonomous_database attribute: + ▸ provide the argument autonomous_database 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 autonomousDatabase resource. + + To set the location attribute: + ▸ provide the argument autonomous_database on the command line with + a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --cidr=CIDR + The subnet CIDR range for the Autonmous Database. + + Network resource - The name of the VPC network used by the Autonomous + Database in the following format: + projects/{project}/global/networks/{network} 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 --network 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. + + --network=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network attribute: + ▸ provide the argument --network on the command line. + +OPTIONAL FLAGS + --admin-password=ADMIN_PASSWORD + The password for the default ADMIN user. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --database=DATABASE + The name of the Autonomous Database. The database name must be unique + in the project. The name must begin with a letter and can contain a + maximum of 30 alphanumeric characters. + + --display-name=DISPLAY_NAME + The display name for the Autonomous Database. The name does not have to + be unique within your project. + + --labels=[LABELS,...] + The labels or tags associated with the Autonomous Database. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + An optional ID to identify the request. This value is used to identify + duplicate requests. If you make a request with the same request ID and + the original request is still in progress or completed, the server + ignores the second request. This prevents clients from accidentally + creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + The properties of an Autonomous Database. + + --properties-db-workload=PROPERTIES_DB_WORKLOAD + The workload type of the Autonomous Database. PROPERTIES_DB_WORKLOAD + must be one of: + + ajd + Autonomous JSON Database. + apex + Autonomous Database with the Oracle APEX Application Development + workload type. + dw + Autonomous Data Warehouse database. + oltp + Autonomous Transaction Processing database. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --properties-license-type=PROPERTIES_LICENSE_TYPE + The license type used for the Autonomous Database. + PROPERTIES_LICENSE_TYPE must be one of: + + bring-your-own-license + Bring your own license + license-included + License included part of offer + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --properties-backup-retention-period-days=PROPERTIES_BACKUP_RETENTION_PERIOD_DAYS + The retention period for the Autonomous Database. This field is + specified in days, can range from 1 day to 60 days, and has a default + value of 60 days. + + --properties-character-set=PROPERTIES_CHARACTER_SET + The character set for the Autonomous Database. The default is + AL32UTF8. + + --properties-compute-count=PROPERTIES_COMPUTE_COUNT + The number of compute servers for the Autonomous Database. + + --properties-cpu-core-count=PROPERTIES_CPU_CORE_COUNT + The number of CPU cores to be made available to the database. + + --properties-customer-contacts=[email=EMAIL] + The list of customer contacts. + + email + The email address used by Oracle to send notifications regarding + databases and infrastructure. + + Shorthand Example: + + --properties-customer-contacts=email=string --properties-customer-contacts=email=string + + JSON Example: + + --properties-customer-contacts='[{"email": "string"}]' + + File Example: + + --properties-customer-contacts=path_to_file.(yaml|json) + + --properties-data-storage-size-gb=PROPERTIES_DATA_STORAGE_SIZE_GB + The size of the data stored in the database, in gigabytes. + + --properties-data-storage-size-tb=PROPERTIES_DATA_STORAGE_SIZE_TB + The size of the data stored in the database, in terabytes. + + --properties-db-edition=PROPERTIES_DB_EDITION + The edition of the Autonomous Databases. PROPERTIES_DB_EDITION must + be one of: + + enterprise-edition + Enterprise Database Edition + standard-edition + Standard Database Edition + + --properties-db-version=PROPERTIES_DB_VERSION + The Oracle Database version for the Autonomous Database. + + --properties-is-auto-scaling-enabled + This field indicates if auto scaling is enabled for the Autonomous + Database CPU core count. + + --properties-is-storage-auto-scaling-enabled + This field indicates if auto scaling is enabled for the Autonomous + Database storage. + + --properties-maintenance-schedule-type=PROPERTIES_MAINTENANCE_SCHEDULE_TYPE + The maintenance schedule of the Autonomous Database. + PROPERTIES_MAINTENANCE_SCHEDULE_TYPE must be one of: + + early + An EARLY maintenance schedule patches the database before the + regular scheduled maintenance. + regular + A REGULAR maintenance schedule follows the normal maintenance + cycle. + + --properties-mtls-connection-required + This field specifies if the Autonomous Database requires mTLS + connections. + + --properties-n-character-set=PROPERTIES_N_CHARACTER_SET + The national character set for the Autonomous Database. The default + is AL16UTF16. + + --properties-private-endpoint-ip=PROPERTIES_PRIVATE_ENDPOINT_IP + The private endpoint IP address for the Autonomous Database. + + --properties-private-endpoint-label=PROPERTIES_PRIVATE_ENDPOINT_LABEL + The private endpoint label for the Autonomous Database. + + --properties-secret-id=PROPERTIES_SECRET_ID + The ID of the Oracle Cloud Infrastructure vault secret. + + --properties-vault-id=PROPERTIES_VAULT_ID + The ID of the Oracle Cloud Infrastructure vault. + +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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/autonomous-databases/delete b/gcloud/oracle-database/autonomous-databases/delete new file mode 100644 index 000000000..5df53e268 --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/delete @@ -0,0 +1,79 @@ +NAME + gcloud oracle-database autonomous-databases delete - delete an + AutonomousDatabase + +SYNOPSIS + gcloud oracle-database autonomous-databases delete + (AUTONOMOUS_DATABASE : --location=LOCATION) [--async] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an AutonomousDatabase. + +EXAMPLES + To delete an AutonomousDatabase with id my-instance in the location + us-east4, run: + + $ gcloud oracle-database autonomous-databases delete my-instance \ + --location=us-east4 + +POSITIONAL ARGUMENTS + AutonomousDatabase resource - The name of the resource in the following + format: + projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}. + 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 autonomous_database 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. + + AUTONOMOUS_DATABASE + ID of the autonomousDatabase or fully qualified identifier for the + autonomousDatabase. + + To set the autonomous_database attribute: + ▸ provide the argument autonomous_database 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 autonomousDatabase resource. + + To set the location attribute: + ▸ provide the argument autonomous_database on the command line with + a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --request-id=REQUEST_ID + An optional ID to identify the request. This value is used to identify + duplicate requests. If you make a request with the same request ID and + the original request is still in progress or completed, the server + ignores the second request. This prevents clients from accidentally + creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/autonomous-databases/describe b/gcloud/oracle-database/autonomous-databases/describe new file mode 100644 index 000000000..17c587679 --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/describe @@ -0,0 +1,63 @@ +NAME + gcloud oracle-database autonomous-databases describe - get details of an + AutonomousDatabase + +SYNOPSIS + gcloud oracle-database autonomous-databases describe + (AUTONOMOUS_DATABASE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of an AutonomousDatabase. + +EXAMPLES + To get an AutonomousDatabase with id my-instance in the location us-east4, + run: + + $ gcloud oracle-database autonomous-databases describe my-instance \ + --location=us-east4 + +POSITIONAL ARGUMENTS + AutonomousDatabase resource - The name of the Autonomous Database in the + following format: + projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}. + 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 autonomous_database 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. + + AUTONOMOUS_DATABASE + ID of the autonomousDatabase or fully qualified identifier for the + autonomousDatabase. + + To set the autonomous_database attribute: + ▸ provide the argument autonomous_database 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 autonomousDatabase resource. + + To set the location attribute: + ▸ provide the argument autonomous_database 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/autonomous-databases/generate-wallet b/gcloud/oracle-database/autonomous-databases/generate-wallet new file mode 100644 index 000000000..17a82e432 --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/generate-wallet @@ -0,0 +1,85 @@ +NAME + gcloud oracle-database autonomous-databases generate-wallet - generate + wallet for an AutonomousDatabase + +SYNOPSIS + gcloud oracle-database autonomous-databases generate-wallet + (AUTONOMOUS_DATABASE : --location=LOCATION) --password=PASSWORD + [--is-regional] [--type=TYPE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Generate wallet for an AutonomousDatabase, Content is base64 encoded zip + archive. + +EXAMPLES + To generate wallet for an AutonomousDatabase with id my-instance with + password 123Abpassword, to encrypt the keys inside the wallet in the + location us-east4, run: + + $ gcloud oracle-database autonomous-databases generate-wallet \ + my-instance --location=us-east4 --password=123Abpassword + +POSITIONAL ARGUMENTS + AutonomousDatabase resource - The name of the Autonomous Database in the + following format: + projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}. + 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 autonomous_database 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. + + AUTONOMOUS_DATABASE + ID of the autonomousDatabase or fully qualified identifier for the + autonomousDatabase. + + To set the autonomous_database attribute: + ▸ provide the argument autonomous_database 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 autonomousDatabase resource. + + To set the location attribute: + ▸ provide the argument autonomous_database on the command line with + a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --password=PASSWORD + The password used to encrypt the keys inside the wallet. The password + must be a minimum of 8 characters. + +OPTIONAL FLAGS + --is-regional + True when requesting regional connection strings in PDB connect info, + applicable to cross-region Data Guard only. + + --type=TYPE + The type of wallet generation for the Autonomous Database. The default + value is SINGLE. TYPE must be one of: + + all + Used to generate wallet for all databases in the region. + single + Used to generate wallet for a single database. + +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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/autonomous-databases/help b/gcloud/oracle-database/autonomous-databases/help new file mode 100644 index 000000000..e1762290f --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/help @@ -0,0 +1,35 @@ +NAME + gcloud oracle-database autonomous-databases - manage Autonomous Database + resources + +SYNOPSIS + gcloud oracle-database autonomous-databases COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Autonomous Database 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 + Create a new AutonomousDatabase. + + delete + Delete an AutonomousDatabase. + + describe + Get details of an AutonomousDatabase. + + generate-wallet + Generate wallet for an AutonomousDatabase. + + list + List all AutonomousDatabases. + + restore + Restore an AutonomousDatabase. diff --git a/gcloud/oracle-database/autonomous-databases/list b/gcloud/oracle-database/autonomous-databases/list new file mode 100644 index 000000000..6213f5fdd --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/list @@ -0,0 +1,81 @@ +NAME + gcloud oracle-database autonomous-databases list - list all + AutonomousDatabases + +SYNOPSIS + gcloud oracle-database autonomous-databases list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all AutonomousDatabases. + +EXAMPLES + To list all AutonomousDatabases in the location us-east4, run: + + $ gcloud oracle-database autonomous-databases list \ + --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for the Autonomous Database in the + following format: projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/autonomous-databases/restore b/gcloud/oracle-database/autonomous-databases/restore new file mode 100644 index 000000000..996c4a2a6 --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/restore @@ -0,0 +1,74 @@ +NAME + gcloud oracle-database autonomous-databases restore - restore an + AutonomousDatabase + +SYNOPSIS + gcloud oracle-database autonomous-databases restore + (AUTONOMOUS_DATABASE : --location=LOCATION) --restore-time=RESTORE_TIME + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Restore an AutonomousDatabase to the state at specified restore-time. + +EXAMPLES + To restore an AutonomousDatabase with id my-instance at restore-time + 2024-05-01T00:00:00.000Z in the location us-east4 , The restore-time is the + 'endTime' property of a backup. run: + + $ gcloud oracle-database autonomous-databases restore my-instance \ + --location=us-east4 --restore-time=2024-05-01T00:00:00.000Z + +POSITIONAL ARGUMENTS + AutonomousDatabase resource - The name of the Autonomous Database in the + following format: + projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}. + 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 autonomous_database 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. + + AUTONOMOUS_DATABASE + ID of the autonomousDatabase or fully qualified identifier for the + autonomousDatabase. + + To set the autonomous_database attribute: + ▸ provide the argument autonomous_database 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 autonomousDatabase resource. + + To set the location attribute: + ▸ provide the argument autonomous_database on the command line with + a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --restore-time=RESTORE_TIME + The time and date to restore the database to. + +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. + +API REFERENCE + This command uses the oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/autonomous-db-versions/help b/gcloud/oracle-database/autonomous-db-versions/help new file mode 100644 index 000000000..5f34af45e --- /dev/null +++ b/gcloud/oracle-database/autonomous-db-versions/help @@ -0,0 +1,21 @@ +NAME + gcloud oracle-database autonomous-db-versions - manage Autonomous Db + Version resources + +SYNOPSIS + gcloud oracle-database autonomous-db-versions COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Autonomous Db Version resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all AutonomousDbVersions. diff --git a/gcloud/oracle-database/autonomous-db-versions/list b/gcloud/oracle-database/autonomous-db-versions/list new file mode 100644 index 000000000..689c8bdf0 --- /dev/null +++ b/gcloud/oracle-database/autonomous-db-versions/list @@ -0,0 +1,81 @@ +NAME + gcloud oracle-database autonomous-db-versions list - list all + AutonomousDbVersions + +SYNOPSIS + gcloud oracle-database autonomous-db-versions list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all AutonomousDbVersions. + +EXAMPLES + To list all AutonomousDbVersions in the location us-east4, run: + + $ gcloud oracle-database autonomous-db-versions list \ + --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for the Autonomous Database in the + following format: projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/create b/gcloud/oracle-database/cloud-exadata-infrastructures/create new file mode 100644 index 000000000..9af22dc4b --- /dev/null +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/create @@ -0,0 +1,280 @@ +NAME + gcloud oracle-database cloud-exadata-infrastructures create - create a new + ExadataInfrastructure + +SYNOPSIS + gcloud oracle-database cloud-exadata-infrastructures create + (CLOUD_EXADATA_INFRASTRUCTURE : --location=LOCATION) [--async] + [--display-name=DISPLAY_NAME] [--gcp-oracle-zone=GCP_ORACLE_ZONE] + [--labels=[LABELS,...]] [--request-id=REQUEST_ID] + [[--properties-shape=PROPERTIES_SHAPE + : --properties-compute-count=PROPERTIES_COMPUTE_COUNT + --properties-cpu-count=PROPERTIES_CPU_COUNT + --properties-customer-contacts=[email=EMAIL] + --properties-db-node-storage-size-gb=PROPERTIES_DB_NODE_STORAGE_SIZE_GB --properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB --properties-storage-count=PROPERTIES_STORAGE_COUNT --properties-total-storage-size-gb=PROPERTIES_TOTAL_STORAGE_SIZE_GB --maintenance-window-custom-action-timeout-mins=MAINTENANCE_WINDOW_CUSTOM_ACTION_TIMEOUT_MINS --maintenance-window-days-of-week=[MAINTENANCE_WINDOW_DAYS_OF_WEEK, + ...] + --maintenance-window-hours-of-day=[MAINTENANCE_WINDOW_HOURS_OF_DAY, + ...] --maintenance-window-is-custom-action-timeout-enabled + --maintenance-window-lead-time-week=MAINTENANCE_WINDOW_LEAD_TIME_WEEK + --maintenance-window-months=[MAINTENANCE_WINDOW_MONTHS,...] + --maintenance-window-patching-mode=MAINTENANCE_WINDOW_PATCHING_MODE + --maintenance-window-preference=MAINTENANCE_WINDOW_PREFERENCE + --maintenance-window-weeks-of-month=[MAINTENANCE_WINDOW_WEEKS_OF_MONTH, + ...]]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Creates a new ExadataInfrastructure. + +EXAMPLES + Choose an available system shapes in your location by running gcloud + oracle-database db-system-shapes list --location=us-east4. To create + Exadata Infrastructure instance with id my-instance in the location + us-east4 with display-name my instance, compute count 2 and choosen shape + "Exadata.FOO", run: + + $ gcloud oracle-database cloud-exadata-infrastructures create \ + my-instance --location=us-east4 --display-name="my instance" \ + --properties-shape=Exadata.FOO --properties-compute-count=2 \ + --properties-storage-count=3 + +POSITIONAL ARGUMENTS + CloudExadataInfrastructure resource - Identifier. The name of the Exadata + Infrastructure resource with the format: + projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure} + 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 cloud_exadata_infrastructure 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. + + CLOUD_EXADATA_INFRASTRUCTURE + ID of the cloudExadataInfrastructure or fully qualified identifier + for the cloudExadataInfrastructure. + + To set the cloud_exadata_infrastructure attribute: + ▸ provide the argument cloud_exadata_infrastructure 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 cloudExadataInfrastructure resource. + + To set the location attribute: + ▸ provide the argument cloud_exadata_infrastructure on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + User friendly name for this resource. + + --gcp-oracle-zone=GCP_ORACLE_ZONE + Google Cloud Platform location where Oracle Exadata is hosted. + + --labels=[LABELS,...] + Labels or tags associated with the resource. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + An optional ID to identify the request. This value is used to identify + duplicate requests. If you make a request with the same request ID and + the original request is still in progress or completed, the server + ignores the second request. This prevents clients from accidentally + creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + Various properties of Exadata Infrastructure. + + --properties-shape=PROPERTIES_SHAPE + The shape of the Exadata Infrastructure. The shape determines the + amount of CPU, storage, and memory resources allocated to the + instance. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --properties-compute-count=PROPERTIES_COMPUTE_COUNT + The number of compute servers for the Exadata Infrastructure. + + --properties-cpu-count=PROPERTIES_CPU_COUNT + The number of enabled CPU cores. + + --properties-customer-contacts=[email=EMAIL] + The list of customer contacts. + + email + The email address used by Oracle to send notifications regarding + databases and infrastructure. + + Shorthand Example: + + --properties-customer-contacts=email=string --properties-customer-contacts=email=string + + JSON Example: + + --properties-customer-contacts='[{"email": "string"}]' + + File Example: + + --properties-customer-contacts=path_to_file.(yaml|json) + + --properties-db-node-storage-size-gb=PROPERTIES_DB_NODE_STORAGE_SIZE_GB + The local node storage allocated in GBs. + + --properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB + The memory allocated in GBs. + + --properties-storage-count=PROPERTIES_STORAGE_COUNT + The number of Cloud Exadata storage servers for the Exadata + Infrastructure. + + --properties-total-storage-size-gb=PROPERTIES_TOTAL_STORAGE_SIZE_GB + The total storage allocated to the Exadata Infrastructure resource, + in gigabytes (GB). + + Maintenance window as defined by Oracle. + https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/MaintenanceWindow + + --maintenance-window-custom-action-timeout-mins=MAINTENANCE_WINDOW_CUSTOM_ACTION_TIMEOUT_MINS + Determines the amount of time the system will wait before the start + of each database server patching operation. Custom action timeout + is in minutes and valid value is between 15 to 120 (inclusive). + + --maintenance-window-days-of-week=[MAINTENANCE_WINDOW_DAYS_OF_WEEK,...] + Days during the week when maintenance should be performed. + MAINTENANCE_WINDOW_DAYS_OF_WEEK must be one of: + + friday + Friday + monday + Monday + saturday + Saturday + sunday + Sunday + thursday + Thursday + tuesday + Tuesday + wednesday + Wednesday + + --maintenance-window-hours-of-day=[MAINTENANCE_WINDOW_HOURS_OF_DAY,...] + The window of hours during the day when maintenance should be + performed. The window is a 4 hour slot. Valid values are: 0 - + represents time slot 0:00 - 3:59 UTC 4 - represents time slot 4:00 + - 7:59 UTC 8 - represents time slot 8:00 - 11:59 UTC 12 - + represents time slot 12:00 - 15:59 UTC 16 - represents time slot + 16:00 - 19:59 UTC 20 - represents time slot 20:00 - 23:59 UTC + + --maintenance-window-is-custom-action-timeout-enabled + If true, enables the configuration of a custom action timeout + (waiting period) between database server patching operations. + + --maintenance-window-lead-time-week=MAINTENANCE_WINDOW_LEAD_TIME_WEEK + Lead time window allows user to set a lead time to prepare for a + down time. The lead time is in weeks and valid value is between 1 + to 4. + + --maintenance-window-months=[MAINTENANCE_WINDOW_MONTHS,...] + Months during the year when maintenance should be performed. + MAINTENANCE_WINDOW_MONTHS must be one of: + + april + The month of April. + august + The month of August. + december + The month of December. + february + The month of February. + january + The month of January. + july + The month of July. + june + The month of June. + march + The month of March. + may + The month of May. + november + The month of November. + october + The month of October. + september + The month of September. + + --maintenance-window-patching-mode=MAINTENANCE_WINDOW_PATCHING_MODE + Cloud CloudExadataInfrastructure node patching method, either + "ROLLING" or "NONROLLING". Default value is ROLLING. + + MAINTENANCE_WINDOW_PATCHING_MODE must be one of: + + non-rolling + The non-rolling maintenance method first updates your storage + servers at the same time, then your database servers at the + same time. + rolling + Updates the Cloud Exadata database server hosts in a rolling + fashion. + + --maintenance-window-preference=MAINTENANCE_WINDOW_PREFERENCE + The maintenance window scheduling preference. + MAINTENANCE_WINDOW_PREFERENCE must be one of: + + custom-preference + Custom preference. + no-preference + No preference. + + --maintenance-window-weeks-of-month=[MAINTENANCE_WINDOW_WEEKS_OF_MONTH,...] + Weeks during the month when maintenance should be performed. Weeks + start on the 1st, 8th, 15th, and 22nd days of the month, and have a + duration of 7 days. Weeks start and end based on calendar dates, + not days of the week. + +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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/db-servers/help b/gcloud/oracle-database/cloud-exadata-infrastructures/db-servers/help new file mode 100644 index 000000000..1bc6acac9 --- /dev/null +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/db-servers/help @@ -0,0 +1,21 @@ +NAME + gcloud oracle-database cloud-exadata-infrastructures db-servers - manage Db + Server resources + +SYNOPSIS + gcloud oracle-database cloud-exadata-infrastructures db-servers COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Db Server resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all DbServers. diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/db-servers/list b/gcloud/oracle-database/cloud-exadata-infrastructures/db-servers/list new file mode 100644 index 000000000..c86b2cce2 --- /dev/null +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/db-servers/list @@ -0,0 +1,97 @@ +NAME + gcloud oracle-database cloud-exadata-infrastructures db-servers list - list + all DbServers + +SYNOPSIS + gcloud oracle-database cloud-exadata-infrastructures db-servers list + (--cloud-exadata-infrastructure=CLOUD_EXADATA_INFRASTRUCTURE + : --location=LOCATION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all DbServers. + +EXAMPLES + To list all DbServers in the location us-east4, run: + + $ gcloud oracle-database cloud-exadata-infrastructures db-servers \ list --location=us-east4 + +REQUIRED FLAGS + CloudExadataInfrastructure resource - The parent value for database server + in the following format: + projects/{project}/locations/{location}/cloudExadataInfrastructures/{cloudExadataInfrastructure}. + 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 --cloud-exadata-infrastructure 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. + + --cloud-exadata-infrastructure=CLOUD_EXADATA_INFRASTRUCTURE + ID of the cloudExadataInfrastructure or fully qualified identifier + for the cloudExadataInfrastructure. + + To set the cloud-exadata-infrastructure attribute: + ▸ provide the argument --cloud-exadata-infrastructure 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 cloudExadataInfrastructure resource. + + To set the location attribute: + ▸ provide the argument --cloud-exadata-infrastructure 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/delete b/gcloud/oracle-database/cloud-exadata-infrastructures/delete new file mode 100644 index 000000000..c87bf473c --- /dev/null +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/delete @@ -0,0 +1,85 @@ +NAME + gcloud oracle-database cloud-exadata-infrastructures delete - delete an + ExadataInfrastructure + +SYNOPSIS + gcloud oracle-database cloud-exadata-infrastructures delete + (CLOUD_EXADATA_INFRASTRUCTURE : --location=LOCATION) [--async] + [--force] [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an ExadataInfrastructure. + +EXAMPLES + To delete a ExadataInfrastructure with id my-instance in the location + us-east4, run: + + $ gcloud oracle-database cloud-exadata-infrastructures delete \ + my-instance --location=us-east4 + +POSITIONAL ARGUMENTS + CloudExadataInfrastructure resource - The name of the Cloud Exadata + Infrastructure in the following format: + projects/{project}/locations/{location}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}. + 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 cloud_exadata_infrastructure 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. + + CLOUD_EXADATA_INFRASTRUCTURE + ID of the cloudExadataInfrastructure or fully qualified identifier + for the cloudExadataInfrastructure. + + To set the cloud_exadata_infrastructure attribute: + ▸ provide the argument cloud_exadata_infrastructure 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 cloudExadataInfrastructure resource. + + To set the location attribute: + ▸ provide the argument cloud_exadata_infrastructure on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set to true, all VM clusters for this Exadata Infrastructure will be + deleted. An Exadata Infrastructure can only be deleted once all its VM + clusters have been deleted. + + --request-id=REQUEST_ID + An optional ID to identify the request. This value is used to identify + duplicate requests. If you make a request with the same request ID and + the original request is still in progress or completed, the server + ignores the second request. This prevents clients from accidentally + creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/describe b/gcloud/oracle-database/cloud-exadata-infrastructures/describe new file mode 100644 index 000000000..3051d3ea1 --- /dev/null +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/describe @@ -0,0 +1,65 @@ +NAME + gcloud oracle-database cloud-exadata-infrastructures describe - get details + of a ExadataInfrastructure + +SYNOPSIS + gcloud oracle-database cloud-exadata-infrastructures describe + (CLOUD_EXADATA_INFRASTRUCTURE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a ExadataInfrastructure. + +EXAMPLES + To get a ExadataInfrastructure with id my-instance in the location + us-east4, run: + + $ gcloud oracle-database cloud-exadata-infrastructures describe \ + my-instance --location=us-east4 + +POSITIONAL ARGUMENTS + CloudExadataInfrastructure resource - The name of the Cloud Exadata + Infrastructure in the following format: + projects/{project}/locations/{location}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}. + 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 cloud_exadata_infrastructure 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. + + CLOUD_EXADATA_INFRASTRUCTURE + ID of the cloudExadataInfrastructure or fully qualified identifier + for the cloudExadataInfrastructure. + + To set the cloud_exadata_infrastructure attribute: + ▸ provide the argument cloud_exadata_infrastructure 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 cloudExadataInfrastructure resource. + + To set the location attribute: + ▸ provide the argument cloud_exadata_infrastructure 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/help b/gcloud/oracle-database/cloud-exadata-infrastructures/help new file mode 100644 index 000000000..3c80ad086 --- /dev/null +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/help @@ -0,0 +1,36 @@ +NAME + gcloud oracle-database cloud-exadata-infrastructures - manage Cloud Exadata + Infrastructure resources + +SYNOPSIS + gcloud oracle-database cloud-exadata-infrastructures GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Exadata Infrastructure resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + db-servers + Manage Db Server resources. + +COMMANDS + COMMAND is one of the following: + + create + Create a new ExadataInfrastructure. + + delete + Delete an ExadataInfrastructure. + + describe + Get details of a ExadataInfrastructure. + + list + List all ExadataInfrastructures. diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/list b/gcloud/oracle-database/cloud-exadata-infrastructures/list new file mode 100644 index 000000000..83bee3158 --- /dev/null +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/list @@ -0,0 +1,82 @@ +NAME + gcloud oracle-database cloud-exadata-infrastructures list - list all + ExadataInfrastructures + +SYNOPSIS + gcloud oracle-database cloud-exadata-infrastructures list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all ExadataInfrastructures. + +EXAMPLES + To list all ExadataInfrastructures in the location us-east4, run: + + $ gcloud oracle-database cloud-exadata-infrastructures list \ + --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for CloudExadataInfrastructure in the + following format: projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-vm-clusters/create b/gcloud/oracle-database/cloud-vm-clusters/create new file mode 100644 index 000000000..d104569c3 --- /dev/null +++ b/gcloud/oracle-database/cloud-vm-clusters/create @@ -0,0 +1,278 @@ +NAME + gcloud oracle-database cloud-vm-clusters create - create a new + CloudVmCluster + +SYNOPSIS + gcloud oracle-database cloud-vm-clusters create CLOUD_VM_CLUSTER + --backup-subnet-cidr=BACKUP_SUBNET_CIDR --cidr=CIDR + --exadata-infrastructure=EXADATA_INFRASTRUCTURE --network=NETWORK + [--async] [--display-name=DISPLAY_NAME] [--labels=[LABELS,...]] + [--location=LOCATION] [--request-id=REQUEST_ID] + [[--properties-cpu-core-count=PROPERTIES_CPU_CORE_COUNT + --properties-license-type=PROPERTIES_LICENSE_TYPE + : --properties-cluster-name=PROPERTIES_CLUSTER_NAME + --properties-data-storage-size-tb=PROPERTIES_DATA_STORAGE_SIZE_TB + --properties-db-node-storage-size-gb=PROPERTIES_DB_NODE_STORAGE_SIZE_GB --properties-db-server-ocids=[PROPERTIES_DB_SERVER_OCIDS, + ...] --properties-disk-redundancy=PROPERTIES_DISK_REDUNDANCY + --properties-gi-version=PROPERTIES_GI_VERSION + --properties-hostname-prefix=PROPERTIES_HOSTNAME_PREFIX + --properties-local-backup-enabled + --properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB + --properties-node-count=PROPERTIES_NODE_COUNT + --properties-ocpu-count=PROPERTIES_OCPU_COUNT + --properties-sparse-diskgroup-enabled + --properties-ssh-public-keys=[PROPERTIES_SSH_PUBLIC_KEYS,...] + --diagnostics-data-collection-options-events-enabled + --diagnostics-data-collection-options-health-monitoring-enabled + --diagnostics-data-collection-options-incident-logs-enabled + --time-zone-id=TIME_ZONE_ID --time-zone-version=TIME_ZONE_VERSION]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new CloudVmCluster. + +EXAMPLES + Choose an available gi-versions in your location by running gcloud + oracle-database db-system-shapes list --location=us-east4. To create + CloudVmCluster instance with id my-instance in the location us-east4 with + display-name my instance, cidr 10.1.0.0/24, network + projects/my-project/locations/global/networks/default, backup-subnet-cidr + 10.2.0.0/24, license-type LICENSE_INCLUDED, ssh-public-keys + VtTxzlPJtIivthmLOmWdRDFy5l27pKUTwLp02, hostname-prefix hostname1, + cpu-core-count 4 and choosen gi-version xx.0.0.0, run: + + $ gcloud oracle-database cloud-vm-clusters create my-instance \ + --location=us-east4 --display-name="my instance" \ + --cidr=10.1.0.0/24 \ + --network=projects/my-project/locations/global/networks/\ + default --backup-subnet-cidr=10.2.0.0/24 \ + --properties-license-type=LICENSE_INCLUDED \ + --properties-ssh-public-keys="VtTxzlPJtIivthmLOmWdRDFy5l27pKUTwL\ + p02" --properties-gi-version=xx.0.0.0 \ + --properties-hostname-prefix=hostname1 \ + --properties-cpu-core-count=4 + +POSITIONAL ARGUMENTS + CloudVmCluster resource - Identifier. The name of the VM Cluster resource + with the format: + projects/{project}/locations/{region}/cloudVmClusters/{cloud_vm_cluster} + 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 cloud_vm_cluster 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 cloud_vm_cluster on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + CLOUD_VM_CLUSTER + ID of the cloudVmCluster or fully qualified identifier for the + cloudVmCluster. + + To set the cloud_vm_cluster attribute: + ▸ provide the argument cloud_vm_cluster on the command line. + +REQUIRED FLAGS + --backup-subnet-cidr=BACKUP_SUBNET_CIDR + CIDR range of the backup subnet. + + --cidr=CIDR + Network settings. CIDR to use for cluster IP allocation. + + CloudExadataInfrastructure resource - The name of the Exadata + Infrastructure resource on which VM cluster resource is created, in the + following format: + projects/{project}/locations/{region}/cloudExadataInfrastuctures/{cloud_extradata_infrastructure} + 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 --exadata-infrastructure 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 --exadata-infrastructure on the command line + with a fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + --exadata-infrastructure=EXADATA_INFRASTRUCTURE + ID of the cloudExadataInfrastructure or fully qualified identifier + for the cloudExadataInfrastructure. + + To set the cloud-exadata-infrastructure attribute: + ▸ provide the argument --exadata-infrastructure on the command + line. + + Network resource - The name of the VPC network. Format: + projects/{project}/global/networks/{network} 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 --network 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. + + --network=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network attribute: + ▸ provide the argument --network on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --display-name=DISPLAY_NAME + User friendly name for this resource. + + --labels=[LABELS,...] + Labels or tags associated with the VM Cluster. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --location=LOCATION + For resources [cloudVmCluster, cloudExadataInfrastructure], provides + fallback value for resource location attribute. When the resource's + full URI path is not provided, location will fallback to this flag + value. + + --request-id=REQUEST_ID + An optional ID to identify the request. This value is used to identify + duplicate requests. If you make a request with the same request ID and + the original request is still in progress or completed, the server + ignores the second request. This prevents clients from accidentally + creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + + Various properties and settings associated with Exadata VM cluster. + + --properties-cpu-core-count=PROPERTIES_CPU_CORE_COUNT + Number of enabled CPU cores. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --properties-license-type=PROPERTIES_LICENSE_TYPE + License type of VM Cluster. PROPERTIES_LICENSE_TYPE must be one of: + + bring-your-own-license + Bring your own license + license-included + License included part of offer + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --properties-cluster-name=PROPERTIES_CLUSTER_NAME + OCI Cluster name. + + --properties-data-storage-size-tb=PROPERTIES_DATA_STORAGE_SIZE_TB + The data disk group size to be allocated in TBs. + + --properties-db-node-storage-size-gb=PROPERTIES_DB_NODE_STORAGE_SIZE_GB + Local storage per VM. + + --properties-db-server-ocids=[PROPERTIES_DB_SERVER_OCIDS,...] + OCID of database servers. + + --properties-disk-redundancy=PROPERTIES_DISK_REDUNDANCY + The type of redundancy. PROPERTIES_DISK_REDUNDANCY must be one of: + + high + High - 3 way mirror. + normal + Normal - 2 way mirror. + + --properties-gi-version=PROPERTIES_GI_VERSION + Grid Infrastructure Version. + + --properties-hostname-prefix=PROPERTIES_HOSTNAME_PREFIX + Prefix for VM cluster host names. + + --properties-local-backup-enabled + Use local backup. + + --properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB + Memory allocated in GBs. + + --properties-node-count=PROPERTIES_NODE_COUNT + Number of database servers. + + --properties-ocpu-count=PROPERTIES_OCPU_COUNT + OCPU count per VM. Minimum is 0.1. + + --properties-sparse-diskgroup-enabled + Use exadata sparse snapshots. + + --properties-ssh-public-keys=[PROPERTIES_SSH_PUBLIC_KEYS,...] + SSH public keys to be stored with cluster. + + Data collection options for diagnostics. + + --diagnostics-data-collection-options-events-enabled + Indicates whether diagnostic collection is enabled for the VM + cluster + + --diagnostics-data-collection-options-health-monitoring-enabled + Indicates whether health monitoring is enabled for the VM cluster + + --diagnostics-data-collection-options-incident-logs-enabled + Indicates whether incident logs and trace collection are enabled + for the VM cluster + + Represents a time zone from the IANA Time Zone Database + (https://www.iana.org/time-zones). + + --time-zone-id=TIME_ZONE_ID + IANA Time Zone Database time zone, e.g. "America/New_York". + + --time-zone-version=TIME_ZONE_VERSION + IANA Time Zone Database version number, e.g. "2019a". + +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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-vm-clusters/db-nodes/help b/gcloud/oracle-database/cloud-vm-clusters/db-nodes/help new file mode 100644 index 000000000..96e0c979f --- /dev/null +++ b/gcloud/oracle-database/cloud-vm-clusters/db-nodes/help @@ -0,0 +1,21 @@ +NAME + gcloud oracle-database cloud-vm-clusters db-nodes - manage Db Node + resources + +SYNOPSIS + gcloud oracle-database cloud-vm-clusters db-nodes COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Db Node resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all DbNodes. diff --git a/gcloud/oracle-database/cloud-vm-clusters/db-nodes/list b/gcloud/oracle-database/cloud-vm-clusters/db-nodes/list new file mode 100644 index 000000000..b203f1c77 --- /dev/null +++ b/gcloud/oracle-database/cloud-vm-clusters/db-nodes/list @@ -0,0 +1,95 @@ +NAME + gcloud oracle-database cloud-vm-clusters db-nodes list - list all DbNodes + +SYNOPSIS + gcloud oracle-database cloud-vm-clusters db-nodes list + (--cloud-vm-cluster=CLOUD_VM_CLUSTER : --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all DbNodes. + +EXAMPLES + To list all DbNodes in the location us-east4, run: + + $ gcloud oracle-database cloud-vm-clusters db-nodes list \ + --location=us-east4 + +REQUIRED FLAGS + CloudVmCluster resource - The parent value for database node in the + following format: + projects/{project}/locations/{location}/cloudVmClusters/{cloudVmCluster}. + 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 --cloud-vm-cluster 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. + + --cloud-vm-cluster=CLOUD_VM_CLUSTER + ID of the cloudVmCluster or fully qualified identifier for the + cloudVmCluster. + + To set the cloud-vm-cluster attribute: + ▸ provide the argument --cloud-vm-cluster 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 cloudVmCluster resource. + + To set the location attribute: + ▸ provide the argument --cloud-vm-cluster 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-vm-clusters/delete b/gcloud/oracle-database/cloud-vm-clusters/delete new file mode 100644 index 000000000..86e31235d --- /dev/null +++ b/gcloud/oracle-database/cloud-vm-clusters/delete @@ -0,0 +1,83 @@ +NAME + gcloud oracle-database cloud-vm-clusters delete - delete a CloudVmCluster + +SYNOPSIS + gcloud oracle-database cloud-vm-clusters delete + (CLOUD_VM_CLUSTER : --location=LOCATION) [--async] [--force] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a CloudVmCluster. + +EXAMPLES + To delete a CloudVmCluster with id my-instance in the location us-east4, + run: + + $ gcloud oracle-database cloud-vm-clusters delete my-instance \ + --location=us-east4 + +POSITIONAL ARGUMENTS + CloudVmCluster resource - The name of the Cloud VM Cluster in the + following format: + projects/{project}/locations/{location}/cloudVmClusters/{cloud_vm_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 set in other ways. + + To set the project attribute: + ◆ provide the argument cloud_vm_cluster 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. + + CLOUD_VM_CLUSTER + ID of the cloudVmCluster or fully qualified identifier for the + cloudVmCluster. + + To set the cloud_vm_cluster attribute: + ▸ provide the argument cloud_vm_cluster 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 cloudVmCluster resource. + + To set the location attribute: + ▸ provide the argument cloud_vm_cluster on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + If set to true, all child resources for the VM Cluster will be deleted. + A VM Cluster can only be deleted once all its child resources have been + deleted. + + --request-id=REQUEST_ID + An optional ID to identify the request. This value is used to identify + duplicate requests. If you make a request with the same request ID and + the original request is still in progress or completed, the server + ignores the second request. This prevents clients from accidentally + creating duplicate commitments. + + The request ID must be a valid UUID with the exception that zero UUID + is not supported (00000000-0000-0000-0000-000000000000). + +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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-vm-clusters/describe b/gcloud/oracle-database/cloud-vm-clusters/describe new file mode 100644 index 000000000..48d9e2de3 --- /dev/null +++ b/gcloud/oracle-database/cloud-vm-clusters/describe @@ -0,0 +1,61 @@ +NAME + gcloud oracle-database cloud-vm-clusters describe - describe + cloudVmClusters + +SYNOPSIS + gcloud oracle-database cloud-vm-clusters describe + (CLOUD_VM_CLUSTER : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a cloudVmCluster + +EXAMPLES + To describe the cloudVmCluster, run: + + $ gcloud oracle-database cloud-vm-clusters describe + +POSITIONAL ARGUMENTS + CloudVmCluster resource - The name of the Cloud VM Cluster in the + following format: + projects/{project}/locations/{location}/cloudVmClusters/{cloud_vm_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 set in other ways. + + To set the project attribute: + ◆ provide the argument cloud_vm_cluster 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. + + CLOUD_VM_CLUSTER + ID of the cloudVmCluster or fully qualified identifier for the + cloudVmCluster. + + To set the cloud_vm_cluster attribute: + ▸ provide the argument cloud_vm_cluster 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 cloudVmCluster resource. + + To set the location attribute: + ▸ provide the argument cloud_vm_cluster 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/cloud-vm-clusters/help b/gcloud/oracle-database/cloud-vm-clusters/help new file mode 100644 index 000000000..ec4c5243d --- /dev/null +++ b/gcloud/oracle-database/cloud-vm-clusters/help @@ -0,0 +1,36 @@ +NAME + gcloud oracle-database cloud-vm-clusters - manage Cloud Vm Cluster + resources + +SYNOPSIS + gcloud oracle-database cloud-vm-clusters GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Vm Cluster resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + db-nodes + Manage Db Node resources. + +COMMANDS + COMMAND is one of the following: + + create + Create a new CloudVmCluster. + + delete + Delete a CloudVmCluster. + + describe + Describe cloudVmClusters. + + list + List all CloudVmClusters. diff --git a/gcloud/oracle-database/cloud-vm-clusters/list b/gcloud/oracle-database/cloud-vm-clusters/list new file mode 100644 index 000000000..befe73417 --- /dev/null +++ b/gcloud/oracle-database/cloud-vm-clusters/list @@ -0,0 +1,79 @@ +NAME + gcloud oracle-database cloud-vm-clusters list - list all CloudVmClusters + +SYNOPSIS + gcloud oracle-database cloud-vm-clusters list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all CloudVmClusters. + +EXAMPLES + To list all CloudVmClusters in the location us-east4, run: + + $ gcloud oracle-database cloud-vm-clusters list --location=us-east4 + +REQUIRED FLAGS + Location resource - The name of the parent in the following format: + projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/db-system-shapes/help b/gcloud/oracle-database/db-system-shapes/help new file mode 100644 index 000000000..f3800e11f --- /dev/null +++ b/gcloud/oracle-database/db-system-shapes/help @@ -0,0 +1,19 @@ +NAME + gcloud oracle-database db-system-shapes - manage Db System Shape resources + +SYNOPSIS + gcloud oracle-database db-system-shapes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Db System Shape resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all DbSystemShapes. diff --git a/gcloud/oracle-database/db-system-shapes/list b/gcloud/oracle-database/db-system-shapes/list new file mode 100644 index 000000000..edfdce588 --- /dev/null +++ b/gcloud/oracle-database/db-system-shapes/list @@ -0,0 +1,79 @@ +NAME + gcloud oracle-database db-system-shapes list - list all DbSystemShapes + +SYNOPSIS + gcloud oracle-database db-system-shapes list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all DbSystemShapes. + +EXAMPLES + To list all DbSystemShapes in the location us-east4, run: + + $ gcloud oracle-database db-system-shapes list --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for Database System Shapes in the + following format: projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/entitlements/help b/gcloud/oracle-database/entitlements/help new file mode 100644 index 000000000..e1564f511 --- /dev/null +++ b/gcloud/oracle-database/entitlements/help @@ -0,0 +1,19 @@ +NAME + gcloud oracle-database entitlements - manage Entitlement resources + +SYNOPSIS + gcloud oracle-database entitlements COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Entitlement resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all Entitlements. diff --git a/gcloud/oracle-database/entitlements/list b/gcloud/oracle-database/entitlements/list new file mode 100644 index 000000000..aa86bd062 --- /dev/null +++ b/gcloud/oracle-database/entitlements/list @@ -0,0 +1,79 @@ +NAME + gcloud oracle-database entitlements list - list all Entitlements + +SYNOPSIS + gcloud oracle-database entitlements list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Entitlements. + +EXAMPLES + To list all Entitlements in the location us-east4, run: + + $ gcloud oracle-database entitlements list --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for the entitlement in the following + format: projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/gi-versions/help b/gcloud/oracle-database/gi-versions/help new file mode 100644 index 000000000..c486f671b --- /dev/null +++ b/gcloud/oracle-database/gi-versions/help @@ -0,0 +1,19 @@ +NAME + gcloud oracle-database gi-versions - manage Gi Version resources + +SYNOPSIS + gcloud oracle-database gi-versions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Gi Version resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all GiVersions. diff --git a/gcloud/oracle-database/gi-versions/list b/gcloud/oracle-database/gi-versions/list new file mode 100644 index 000000000..049d3a6e0 --- /dev/null +++ b/gcloud/oracle-database/gi-versions/list @@ -0,0 +1,79 @@ +NAME + gcloud oracle-database gi-versions list - list all GiVersions + +SYNOPSIS + gcloud oracle-database gi-versions list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all GiVersions. + +EXAMPLES + To list all GiVersions in the location us-east4, run: + + $ gcloud oracle-database gi-versions list --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for Grid Infrastructure Version in + the following format: Format: projects/{project}/locations/{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=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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/help b/gcloud/oracle-database/help new file mode 100644 index 000000000..7290405c1 --- /dev/null +++ b/gcloud/oracle-database/help @@ -0,0 +1,46 @@ +NAME + gcloud oracle-database - manage Oracle Database resources + +SYNOPSIS + gcloud oracle-database GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Oracle Database resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + autonomous-database-backups + Manage Autonomous Database Backup resources. + + autonomous-database-character-sets + Manage Autonomous Database Character Set resources. + + autonomous-databases + Manage Autonomous Database resources. + + autonomous-db-versions + Manage Autonomous Db Version resources. + + cloud-exadata-infrastructures + Manage Cloud Exadata Infrastructure resources. + + cloud-vm-clusters + Manage Cloud Vm Cluster resources. + + db-system-shapes + Manage Db System Shape resources. + + entitlements + Manage Entitlement resources. + + gi-versions + Manage Gi Version resources. + + operations + Manage Operation resources. diff --git a/gcloud/oracle-database/operations/cancel b/gcloud/oracle-database/operations/cancel new file mode 100644 index 000000000..304f8feaa --- /dev/null +++ b/gcloud/oracle-database/operations/cancel @@ -0,0 +1,57 @@ +NAME + gcloud oracle-database operations cancel - cancel operations + +SYNOPSIS + gcloud oracle-database operations cancel (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Cancel an operation + +EXAMPLES + To cancel the operation, run: + + $ gcloud oracle-database 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/operations/delete b/gcloud/oracle-database/operations/delete new file mode 100644 index 000000000..97b3e1fab --- /dev/null +++ b/gcloud/oracle-database/operations/delete @@ -0,0 +1,57 @@ +NAME + gcloud oracle-database operations delete - delete operations + +SYNOPSIS + gcloud oracle-database operations delete (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an operation + +EXAMPLES + To delete the operation, run: + + $ gcloud oracle-database 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/operations/describe b/gcloud/oracle-database/operations/describe new file mode 100644 index 000000000..1a76f10e2 --- /dev/null +++ b/gcloud/oracle-database/operations/describe @@ -0,0 +1,57 @@ +NAME + gcloud oracle-database operations describe - describe operations + +SYNOPSIS + gcloud oracle-database operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an operation + +EXAMPLES + To describe the operation, run: + + $ gcloud oracle-database 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/operations/help b/gcloud/oracle-database/operations/help new file mode 100644 index 000000000..ef00a7e85 --- /dev/null +++ b/gcloud/oracle-database/operations/help @@ -0,0 +1,31 @@ +NAME + gcloud oracle-database operations - manage Operation resources + +SYNOPSIS + gcloud oracle-database operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + 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 + Cancel operations. + + delete + Delete operations. + + describe + Describe operations. + + list + List operations. + + wait + Wait operations. diff --git a/gcloud/oracle-database/operations/list b/gcloud/oracle-database/operations/list new file mode 100644 index 000000000..321cfa6da --- /dev/null +++ b/gcloud/oracle-database/operations/list @@ -0,0 +1,78 @@ +NAME + gcloud oracle-database operations list - list operations + +SYNOPSIS + gcloud oracle-database operations list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List operations + +EXAMPLES + To list all operations, run: + + $ gcloud oracle-database 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/oracle-database/operations/wait b/gcloud/oracle-database/operations/wait new file mode 100644 index 000000000..2d6564a5c --- /dev/null +++ b/gcloud/oracle-database/operations/wait @@ -0,0 +1,57 @@ +NAME + gcloud oracle-database operations wait - wait operations + +SYNOPSIS + gcloud oracle-database operations wait (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Wait an operation + +EXAMPLES + To wait the operation, run: + + $ gcloud oracle-database operations wait + +POSITIONAL ARGUMENTS + Operation resource - The name of the operation resource to wait on. 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 oracledatabase/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/oracle/database/docs diff --git a/gcloud/pubsub/subscriptions/create b/gcloud/pubsub/subscriptions/create index e06a36051..b48a65116 100644 --- a/gcloud/pubsub/subscriptions/create +++ b/gcloud/pubsub/subscriptions/create @@ -9,9 +9,7 @@ SYNOPSIS [--enable-message-ordering] [--expiration-period=EXPIRATION_PERIOD] [--labels=[KEY=VALUE,...]] [--message-filter=MESSAGE_FILTER] [--message-retention-duration=MESSAGE_RETENTION_DURATION] - [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL] - [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] - [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] + [--retain-acked-messages] [[--bigquery-table=BIGQUERY_TABLE : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema @@ -21,8 +19,10 @@ SYNOPSIS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] [--max-retry-delay=MAX_RETRY_DELAY --min-retry-delay=MIN_RETRY_DELAY] - [--push-no-wrapper : --push-no-wrapper-write-metadata] - [GCLOUD_WIDE_FLAG ...] + [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + --push-endpoint=PUSH_ENDPOINT [--push-no-wrapper + : --push-no-wrapper-write-metadata]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Creates one or more Cloud Pub/Sub subscriptions for a given topic. The new @@ -128,18 +128,6 @@ OPTIONAL FLAGS seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --push-auth-service-account=SERVICE_ACCOUNT_EMAIL - Service account email used as the identity for the generated Open ID - Connect token for authenticated push. - - --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE - Audience used in the generated Open ID Connect token for authenticated - push. If not specified, it will be set to the push-endpoint. - - --push-endpoint=PUSH_ENDPOINT - A URL to use as the endpoint for this subscription. This will also - automatically set the subscription type to PUSH. - --retain-acked-messages Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the @@ -318,21 +306,36 @@ OPTIONAL FLAGS of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - NoWrapper Config Options. + Push Config Options. Configuration for a push delivery endpoint. - --push-no-wrapper - When set, the message data is delivered directly as the HTTP body. - Use --no-push-no-wrapper to disable this flag. + --push-auth-service-account=SERVICE_ACCOUNT_EMAIL + Service account email used as the identity for the generated Open ID + Connect token for authenticated push. - This flag argument must be specified if any of the other arguments in - this group are specified. + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + Audience used in the generated Open ID Connect token for + authenticated push. If not specified, it will be set to the + push-endpoint. - --push-no-wrapper-write-metadata - When true, writes the Pub/Sub message metadata to - x-goog-pubsub-: headers of the HTTP request. Writes the - Pub/Sub message attributes to : headers of the HTTP - request. Use --no-push-no-wrapper-write-metadata to disable this - flag. + --push-endpoint=PUSH_ENDPOINT + A URL to use as the endpoint for this subscription. This will also + automatically set the subscription type to PUSH. + + NoWrapper Config Options. + + --push-no-wrapper + When set, the message data is delivered directly as the HTTP body. + Use --no-push-no-wrapper to disable this flag. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --push-no-wrapper-write-metadata + When true, writes the Pub/Sub message metadata to + x-goog-pubsub-: headers of the HTTP request. Writes the + Pub/Sub message attributes to : headers of the HTTP + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/pubsub/subscriptions/update b/gcloud/pubsub/subscriptions/update index 39d45282a..4b4453e71 100644 --- a/gcloud/pubsub/subscriptions/update +++ b/gcloud/pubsub/subscriptions/update @@ -7,10 +7,7 @@ SYNOPSIS [--ack-deadline=ACK_DEADLINE] [--enable-exactly-once-delivery] [--expiration-period=EXPIRATION_PERIOD] [--message-retention-duration=MESSAGE_RETENTION_DURATION] - [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL] - [--push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE] - [--push-endpoint=PUSH_ENDPOINT] [--retain-acked-messages] - [--update-labels=[KEY=VALUE,...]] + [--retain-acked-messages] [--update-labels=[KEY=VALUE,...]] [--clear-bigquery-config | [--bigquery-table=BIGQUERY_TABLE : --bigquery-service-account-email=BIGQUERY_SERVICE_ACCOUNT_EMAIL --drop-unknown-fields --write-metadata --use-table-schema @@ -22,10 +19,13 @@ SYNOPSIS [--dead-letter-topic=DEAD_LETTER_TOPIC : --dead-letter-topic-project=DEAD_LETTER_TOPIC_PROJECT]] [--clear-labels | --remove-labels=[KEY,...]] - [--clear-push-no-wrapper-config - | [--push-no-wrapper : --push-no-wrapper-write-metadata]] [--clear-retry-policy | --max-retry-delay=MAX_RETRY_DELAY - --min-retry-delay=MIN_RETRY_DELAY] [GCLOUD_WIDE_FLAG ...] + --min-retry-delay=MIN_RETRY_DELAY] + [--push-auth-service-account=SERVICE_ACCOUNT_EMAIL + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + --push-endpoint=PUSH_ENDPOINT --clear-push-no-wrapper-config + | [--push-no-wrapper : --push-no-wrapper-write-metadata]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Updates an existing Cloud Pub/Sub subscription. @@ -82,18 +82,6 @@ FLAGS "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. - --push-auth-service-account=SERVICE_ACCOUNT_EMAIL - Service account email used as the identity for the generated Open ID - Connect token for authenticated push. - - --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE - Audience used in the generated Open ID Connect token for authenticated - push. If not specified, it will be set to the push-endpoint. - - --push-endpoint=PUSH_ENDPOINT - A URL to use as the endpoint for this subscription. This will also - automatically set the subscription type to PUSH. - --retain-acked-messages Whether or not to retain acknowledged messages. If true, messages are not expunged from the subscription's backlog until they fall out of the @@ -123,6 +111,10 @@ FLAGS service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have permission to write to this BigQuery table. + When updating BigQueryConfig flags, all BigQueryConfig flags must be + specified. Otherwise, any omitted BigQueryConfig flags revert to their + default value. + --bigquery-table=BIGQUERY_TABLE A BigQuery table of the form {project}:{dataset_name}.{table_name} to which to write messages @@ -177,6 +169,10 @@ FLAGS have permission to write to this Cloud Storage bucket and to read this bucket's metadata. + When updating CloudStorageConfig flags, all CloudStorageConfig flags + must be specified. Otherwise, any omitted CloudStorageConfig flags + revert to their default value. + Note that an update to the Cloud Storage config will replace it with a new config containing only the flags that are passed in the update CLI. @@ -257,6 +253,10 @@ FLAGS have permission to Publish() to this topic and Acknowledge() messages on this subscription. + When updating DeadLetterPolicy flags, all DeadLetterPolicy flags must be + specified. Otherwise, any omitted DeadLetterPolicy flags revert to their + default value. + --max-delivery-attempts=MAX_DELIVERY_ATTEMPTS Maximum number of delivery attempts for any message. The value must be between 5 and 100. Defaults to 5. --dead-letter-topic must also @@ -307,28 +307,6 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. - At most one of these can be specified: - - --clear-push-no-wrapper-config - If set, clear the NoWrapper config from the subscription. Use - --no-clear-push-no-wrapper-config to disable this flag. - - NoWrapper Config Options. - - --push-no-wrapper - When set, the message data is delivered directly as the HTTP body. - Use --no-push-no-wrapper to disable this flag. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --push-no-wrapper-write-metadata - When true, writes the Pub/Sub message metadata to - x-goog-pubsub-: headers of the HTTP request. Writes the - Pub/Sub message attributes to : headers of the HTTP - request. Use --no-push-no-wrapper-write-metadata to disable this - flag. - At most one of these can be specified: --clear-retry-policy @@ -338,6 +316,10 @@ FLAGS Retry Policy Options. Retry policy specifies how Cloud Pub/Sub retries message delivery for this subscription. + When updating RetryPolicy flags, all RetryPolicy flags must be + specified. Otherwise, any omitted RetryPolicy flags revert to their + default value. + --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 @@ -352,6 +334,46 @@ FLAGS UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. + Push Config Options. Configuration for a push delivery endpoint. + + When updating PushConfig flags, all PushConfig flags must be specified. + Otherwise, any omitted PushConfig flags revert to their default value. + + --push-auth-service-account=SERVICE_ACCOUNT_EMAIL + Service account email used as the identity for the generated Open ID + Connect token for authenticated push. + + --push-auth-token-audience=OPTIONAL_AUDIENCE_OVERRIDE + Audience used in the generated Open ID Connect token for + authenticated push. If not specified, it will be set to the + push-endpoint. + + --push-endpoint=PUSH_ENDPOINT + A URL to use as the endpoint for this subscription. This will also + automatically set the subscription type to PUSH. + + At most one of these can be specified: + + --clear-push-no-wrapper-config + If set, clear the NoWrapper config from the subscription. Use + --no-clear-push-no-wrapper-config to disable this flag. + + NoWrapper Config Options. + + --push-no-wrapper + When set, the message data is delivered directly as the HTTP + body. Use --no-push-no-wrapper to disable this flag. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --push-no-wrapper-write-metadata + When true, writes the Pub/Sub message metadata to + x-goog-pubsub-: headers of the HTTP request. Writes the + Pub/Sub message attributes to : headers of the HTTP + request. Use --no-push-no-wrapper-write-metadata to disable this + flag. + 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/pubsub/topics/update b/gcloud/pubsub/topics/update index b403682f5..fedf6d19c 100644 --- a/gcloud/pubsub/topics/update +++ b/gcloud/pubsub/topics/update @@ -119,6 +119,10 @@ FLAGS The following flags are for specifying ingestion settings for an import topic from Amazon Web Services (AWS) Kinesis Data Streams + When updating AWSKinesis Source flags, all AWSKinesis Source flags must + be specified. Otherwise, any omitted AWSKinesis Source flags revert to + their default value. + --kinesis-ingestion-consumer-arn=KINESIS_INGESTION_CONSUMER_ARN The Kinesis data streams consumer Amazon Resource Name (ARN) to use for ingestion. @@ -194,6 +198,10 @@ FLAGS Schema settings. The schema that messages published to this topic must conform to and the expected message encoding. + When updating SchemaSettings flags, all SchemaSettings flags must be + specified. Otherwise, any omitted SchemaSettings flags revert to their + default value. + --message-encoding=ENCODING The encoding of messages validated against the schema. ENCODING must be one of: json, binary. @@ -243,7 +251,11 @@ FLAGS Options for explicitly specifying the message storage policy (https://cloud.google.com/pubsub/docs/resource-location-restriction) for - a topic. These fields can be set only if the + a topic. + + When updating MessageStoragePolicy flags, all MessageStoragePolicy flags + must be specified. Otherwise, any omitted MessageStoragePolicy flags + revert to their default value. These fields can be set only if the --recompute-message-storage-policy flag is not set. --message-storage-policy-allowed-regions=[REGION,...] diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index decf8ff66..5c638ef1f 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -42,7 +42,7 @@ SYNOPSIS [--storage-size=STORAGE_SIZE] [--switch-transaction-logs-to-cloud-storage] [--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER] - [--upgrade-sql-network-architecture] + [--time-zone=TIME_ZONE] [--upgrade-sql-network-architecture] [--allowed-psc-projects=PROJECT,[PROJECT,...] | --clear-allowed-psc-projects] [--authorized-gae-apps=APP,[APP,...] | --clear-gae-apps] @@ -393,6 +393,9 @@ FLAGS https://cloud.google.com/sql/pricing. WARNING: Instance will be restarted. + --time-zone=TIME_ZONE + Set a non-default time zone. Only available for SQL Server instances. + --upgrade-sql-network-architecture Upgrade from old network architecture to new network architecture. The new network architecture offers better isolation, reliability, and diff --git a/gcloud/storage/ls b/gcloud/storage/ls index 01965bf11..f266010f3 100644 --- a/gcloud/storage/ls +++ b/gcloud/storage/ls @@ -122,8 +122,8 @@ FLAGS expression. --soft-deleted - Displays soft-deleted objects only. Excludes live and noncurrent - objects. + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. At most one of these can be specified: diff --git a/gcloud/storage/objects/describe b/gcloud/storage/objects/describe index f4dbbeca4..e77d92aae 100644 --- a/gcloud/storage/objects/describe +++ b/gcloud/storage/objects/describe @@ -42,8 +42,8 @@ FLAGS standardizing it. --soft-deleted - Displays soft-deleted objects only. Excludes live and noncurrent - objects. + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. ENCRYPTION FLAGS --decryption-keys=[DECRYPTION_KEY,...] diff --git a/gcloud/storage/objects/list b/gcloud/storage/objects/list index 89cfbe6a8..44e1bd92c 100644 --- a/gcloud/storage/objects/list +++ b/gcloud/storage/objects/list @@ -65,8 +65,8 @@ FLAGS standardizing it. --soft-deleted - Displays soft-deleted objects only. Excludes live and noncurrent - objects. + Displays soft-deleted resources only. For objects, it will exclude live + and noncurrent ones. --stat Emulates gsutil stat-style behavior. Does not show past object versions diff --git a/gcloud/storage/restore b/gcloud/storage/restore index abf8d8fec..eea820a6b 100644 --- a/gcloud/storage/restore +++ b/gcloud/storage/restore @@ -10,11 +10,19 @@ SYNOPSIS --if-metageneration-match=METAGENERATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - The restore command restores soft-deleted objects: + The restore command restores soft-deleted resources: $ gcloud storage restore url... EXAMPLES + Restore soft-deleted version of bucket with generations: + + $ gcloud storage restore gs://bucket#123 + + 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. $ gcloud storage restore gs://bucket/file1.txt