imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-17 14:26:34 +00:00
Code Activity

gcloud: Wed Sep 25 09:51:52 UTC 2024

Browse source
This commit is contained in:
Automated 2024-09-25 09:51:52 +00:00
parent 8ebed5b0f1
commit 0a5b6f11af
202 changed files with 9781 additions and 830 deletions
Download patch file Download diff file Expand all files Collapse all files

294
gcloud/alpha/developer-connect/connections/create
View file

@ -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

14
gcloud/alpha/developer-connect/connections/delete
View file

@ -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

15
gcloud/alpha/developer-connect/connections/describe
View file

@ -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

24
gcloud/alpha/developer-connect/connections/git-repository-links/create
View file

@ -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

15
gcloud/alpha/developer-connect/connections/git-repository-links/delete
View file

@ -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

15
gcloud/alpha/developer-connect/connections/git-repository-links/describe
View file

@ -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

5
gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-token
View file

@ -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

5
gcloud/alpha/developer-connect/connections/git-repository-links/fetch-read-write-token
View file

@ -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

16
gcloud/alpha/developer-connect/connections/git-repository-links/help
View file

@ -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

13
gcloud/alpha/developer-connect/connections/git-repository-links/list
View file

@ -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

18
gcloud/alpha/developer-connect/connections/help
View file

@ -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

11
gcloud/alpha/developer-connect/connections/list
View file

@ -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

285
gcloud/alpha/developer-connect/connections/update
View file

@ -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

6
gcloud/alpha/developer-connect/help
View file

@ -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

4
gcloud/alpha/developer-connect/operations/cancel
View file

@ -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

4
gcloud/alpha/developer-connect/operations/delete
View file

@ -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

4
gcloud/alpha/developer-connect/operations/describe
View file

@ -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

4
gcloud/alpha/developer-connect/operations/help
View file

@ -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

4
gcloud/alpha/developer-connect/operations/list
View file

@ -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

4
gcloud/alpha/developer-connect/operations/wait
View file

@ -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