1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-22 15:52:30 +00:00

gcloud: Tue Mar 1 04:29:52 UTC 2022

This commit is contained in:
Automated 2022-03-01 04:29:52 +00:00
parent aab53307a8
commit 1456dab6c7
9791 changed files with 814712 additions and 0 deletions

View file

@ -0,0 +1,69 @@
NAME
gcloud alpha recommender insights describe - describe an insight
SYNOPSIS
gcloud alpha recommender insights describe INSIGHT
--insight-type=INSIGHT_TYPE --location=LOCATION
(--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID
| --organization=ORGANIZATION_ID | --project=PROJECT_ID)
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Describe an insight. This currently supports the following parent
entities: project, billing account, folder, and organization.
EXAMPLES
To describe an insight:
$ gcloud alpha recommender insights describe INSIGHT_ID \
--project=${PROJECT} --location=${LOCATION}
POSITIONAL ARGUMENTS
INSIGHT
insight to describe
REQUIRED FLAGS
--insight-type=INSIGHT_TYPE
Insight type to describe insights
--location=LOCATION
Location
Resource that is associated with cloud entity type. Currently four
mutually exclusive flags are supported, --project, --billing-account,
--folder, --organization.
Exactly one of these must be specified:
--billing-account=BILLING_ACCOUNT
The Google Cloud Platform Billing Account ID to use for this
invocation.
--folder=FOLDER_ID
Folder ID to use for this invocation.
--organization=ORGANIZATION_ID
The Google Cloud Platform Organization ID to use for this invocation.
--project=PROJECT_ID
The Google Cloud Platform project ID. Overrides the default
core/project 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,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud recommender insights describe
$ gcloud beta recommender insights describe

View file

@ -0,0 +1,42 @@
NAME
gcloud alpha recommender insights - manage Cloud resource insights
SYNOPSIS
gcloud alpha recommender insights COMMAND [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Manage Cloud resource insights.
GCLOUD WIDE FLAGS
These flags are available to all commands: --help.
Run $ gcloud help for details.
COMMANDS
COMMAND is one of the following:
describe
(ALPHA) Describe an insight.
list
(ALPHA) List insights for a cloud entity.
mark-accepted
(ALPHA) Mark an insight's state as ACCEPTED.
mark-active
(ALPHA) Mark an insight's state as ACTIVE.
mark-dismissed
(ALPHA) Mark an insight's state as DISMISSED.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud recommender insights
$ gcloud beta recommender insights

View file

@ -0,0 +1,102 @@
NAME
gcloud alpha recommender insights list - list insights for a cloud entity
SYNOPSIS
gcloud alpha recommender insights list --insight-type=INSIGHT_TYPE
--location=LOCATION
(--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID
| --organization=ORGANIZATION_ID | --project=PROJECT_ID)
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) This command will list all insights for a give cloud entity,
location and insight type. Supported insight-types can be found here:
https://cloud.google.com/recommender/docs/insights/insight-types. Currently
the following cloud_entity_types are supported: project, billing_account,
folder and organization.
EXAMPLES
To list all insights for a billing account:
$ gcloud alpha recommender insights list --project=project-name \
--location=global --insight-type=google.compute.firewall.Insight
REQUIRED FLAGS
--insight-type=INSIGHT_TYPE
Insight type to list insights for. Supported insight-types can be found
here: https://cloud.google.com/recommender/docs/insights/insight-types
--location=LOCATION
Location
Resource that is associated with cloud entity type. Currently four
mutually exclusive flags are supported, --project, --billing-account,
--folder, --organization.
Exactly one of these must be specified:
--billing-account=BILLING_ACCOUNT
The Google Cloud Platform Billing Account ID to use for this
invocation.
--folder=FOLDER_ID
Folder ID to use for this invocation.
--organization=ORGANIZATION_ID
The Google Cloud Platform Organization ID to use for this invocation.
--project=PROJECT_ID
The Google Cloud Platform project ID. Overrides the default
core/project property value for this command invocation.
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 alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud recommender insights list
$ gcloud beta recommender insights list

View file

@ -0,0 +1,80 @@
NAME
gcloud alpha recommender insights mark-accepted - mark an insight's state
as ACCEPTED
SYNOPSIS
gcloud alpha recommender insights mark-accepted INSIGHT --etag=etag
--insight-type=INSIGHT_TYPE --location=LOCATION
(--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID
| --organization=ORGANIZATION_ID | --project=PROJECT_ID)
[--state-metadata=KEY=VALUE,[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Mark an insight's state as ACCEPTED. Can be applied to insights in
ACTIVE or ACCEPTED state. The following are currently supported: project,
billing_account, folder, and organization.
EXAMPLES
To mark an insight as ACCEPTED:
$ gcloud alpha recommender insights mark-accepted abcd-1234 \
--project=project-name --location=global \
--insight-type=google.compute.firewall.Insight --etag=abc123
POSITIONAL ARGUMENTS
INSIGHT
Insight id which will be marked as accepted
REQUIRED FLAGS
--etag=etag
Etag of a insight
--insight-type=INSIGHT_TYPE
Insight Type of the insights
--location=LOCATION
Location
Resource that is associated with cloud entity type. Currently four
mutually exclusive flags are supported, --project, --billing-account,
--folder, --organization.
Exactly one of these must be specified:
--billing-account=BILLING_ACCOUNT
The Google Cloud Platform Billing Account ID to use for this
invocation.
--folder=FOLDER_ID
Folder ID to use for this invocation.
--organization=ORGANIZATION_ID
The Google Cloud Platform Organization ID to use for this invocation.
--project=PROJECT_ID
The Google Cloud Platform project ID. Overrides the default
core/project property value for this command invocation.
OPTIONAL FLAGS
--state-metadata=KEY=VALUE,[KEY=VALUE,...]
State metadata for recommendation, in format of
--state-metadata=key1=value1,key2=value2
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud recommender insights mark-accepted
$ gcloud beta recommender insights mark-accepted

View file

@ -0,0 +1,71 @@
NAME
gcloud alpha recommender insights mark-active - mark an insight's state as
ACTIVE
SYNOPSIS
gcloud alpha recommender insights mark-active INSIGHT --etag=etag
--insight-type=INSIGHT_TYPE --location=LOCATION
(--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID
| --organization=ORGANIZATION_ID | --project=PROJECT_ID)
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Mark an insight's state as ACTIVE. Can be applied to insights in
DISMISSED state. The following are currently supported: project,
billing_account, folder, and organization.
EXAMPLES
To mark an insight as ACTIVE:
$ gcloud alpha recommender insights mark-active abcd-1234 \
--project=project-name --location=global \
--insight-type=google.compute.firewall.Insight --etag=abc123
POSITIONAL ARGUMENTS
INSIGHT
Insight id which will be marked as active
REQUIRED FLAGS
--etag=etag
Etag of a insight
--insight-type=INSIGHT_TYPE
Insight Type of the insights
--location=LOCATION
Location
Resource that is associated with cloud entity type. Currently four
mutually exclusive flags are supported, --project, --billing-account,
--folder, --organization.
Exactly one of these must be specified:
--billing-account=BILLING_ACCOUNT
The Google Cloud Platform Billing Account ID to use for this
invocation.
--folder=FOLDER_ID
Folder ID to use for this invocation.
--organization=ORGANIZATION_ID
The Google Cloud Platform Organization ID to use for this invocation.
--project=PROJECT_ID
The Google Cloud Platform project ID. Overrides the default
core/project 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,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.

View file

@ -0,0 +1,77 @@
NAME
gcloud alpha recommender insights mark-dismissed - mark an insight's state
as DISMISSED
SYNOPSIS
gcloud alpha recommender insights mark-dismissed INSIGHT --etag=etag
--insight-type=INSIGHT_TYPE --location=LOCATION
(--billing-account=BILLING_ACCOUNT | --folder=FOLDER_ID
| --organization=ORGANIZATION_ID | --project=PROJECT_ID)
[--recommendation-change-type=Recommendation change type]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Mark an insight's state as DISMISSED. Can be applied to insights in
ACTIVE state. The following are currently supported: project,
billing_account, folder, and organization.
EXAMPLES
To mark an insight as DISMISSED:
$ gcloud alpha recommender insights mark-dismissed abcd-1234 \
--project=project-name --location=global \
--insight-type=google.compute.firewall.Insight --etag=abc123
POSITIONAL ARGUMENTS
INSIGHT
Insight id which will be marked as dismissed
REQUIRED FLAGS
--etag=etag
Etag of a insight
--insight-type=INSIGHT_TYPE
Insight Type of the insights
--location=LOCATION
Location
Resource that is associated with cloud entity type. Currently four
mutually exclusive flags are supported, --project, --billing-account,
--folder, --organization.
Exactly one of these must be specified:
--billing-account=BILLING_ACCOUNT
The Google Cloud Platform Billing Account ID to use for this
invocation.
--folder=FOLDER_ID
Folder ID to use for this invocation.
--organization=ORGANIZATION_ID
The Google Cloud Platform Organization ID to use for this invocation.
--project=PROJECT_ID
The Google Cloud Platform project ID. Overrides the default
core/project property value for this command invocation.
OPTIONAL FLAGS
--recommendation-change-type=Recommendation change type
Recommendation change type. Recommendation change type must be one of:
dismiss, leave_unchanged.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist.