- NAME
-
- gcloud alpha container hub config-management describe - describe the Config Management feature
- SYNOPSIS
-
-
gcloud alpha container hub config-management describe[--memberships=[MEMBERSHIPS,…] :--location=LOCATION] [--view=VIEW:--filter=EXPRESSION--sort-by=[FIELD,…]] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(ALPHA)Describe the Config Management feature. - EXAMPLES
-
To describe the entire Config Management feature, run:
gcloud alpha container hub config-management describeTo describe select membership configurations, run:
gcloud alpha container hub config-management describe --memberships=example-membership-1,example-membership-2To list the membership configurations, run:
gcloud alpha container hub config-management describe --view=listMEMBERSHIP LOCATION STATUS INSTALL_STATE STOP_STATE SYNC_STATE VERSION SYNCED_TO_FLEET_DEFAULT example-membership-1 asia-east1 OK CONFIG_SYNC_NOT_INSTALLED NOT_INSTALLED FLEET_DEFAULT_NOT_CONFIGURED example-membership-2 us-central1 OK CONFIG_SYNC_INSTALLED NOT_STOPPED SYNCED 1.22.0 FLEET_DEFAULT_NOT_CONFIGURED example-membership-3 us-central1 ERROR CONFIG_SYNC_INSTALLED NOT_STOPPED ERROR 1.21.3 FLEET_DEFAULT_NOT_CONFIGURED - FLAGS
-
-
Memberships to print configurations for. Errors if a specified membership does
not have a configuration for this feature.
-
Membership resource - The group of arguments defining one or more memberships.
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
projectattribute:-
provide the argument
--membershipson the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
--memberships=[MEMBERSHIPS,…]-
IDs of the memberships or fully qualified identifiers for the memberships.
To set the
membershipsattribute:-
provide the argument
--membershipson the command line.
This flag argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--location=LOCATION-
Location for the memberships.
To set the
locationattribute:-
provide the argument
--membershipson the command line with a fully specified name; -
provide the argument
--locationon the command line; -
set the property
gkehub/location.
-
provide the argument
-
provide the argument
-
Membership resource - The group of arguments defining one or more memberships.
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.
--view=VIEW-
View of the feature.
VIEWmust be one of:full- Default view. Prints the entire feature.
list-
List of membership configurations. Default format is a table summary.
The
SYNCED_TO_FLEET_DEFAULTcolumn may displayUNKNOWNfor any membership whose configuration has not been updated since the fleet-default membership configuration enablement.To view the underlying configurations instead of the table summary for select memberships, run:
gcloud alpha container hub config-management describe --view=list --format=yaml --memberships=example-membership-1,example-membership-2
-
List command flags. Only specify when
--view=list. Does not include support for--limit.--filter=EXPRESSION-
Apply a Boolean filter
EXPRESSIONto each resource item to be listed. If the expression evaluatesTrue, 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.To filter for memberships with an overall status of
ERROR, use thepattern and run:COLUMN~VALUEgcloud alpha container hub config-management describe --view=list --filter=STATUS~ERRORTo filter for memberships that are synced to the fleet-default membership configuration, run:
gcloud alpha container hub config-management describe --view=list --filter="spec.origin.type.synced_to_fleet_default()~YES"SYNCED_TO_FLEET_DEFAULTis the only column that requires filtering on the underlying configuration field instead of the column name. An alternative is to--sort-by=SYNCED_TO_FLEET_DEFAULTand filter by eye.To filter on a configuration field not in the table summary, in this case the Config Sync repo, run:
gcloud alpha container hub config-management describe --view=list --format=yaml --filter="spec.configmanagement.configSync.git.syncRepo~https://\github.com/GoogleCloudPlatform/anthos-config-management-samples.git" --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.The default table summary sorts by
LOCATIONthenMEMBERSHIP.To sort the table by
VERSIONinstead, run:gcloud alpha container hub config-management describe --view=list --sort-by=VERSIONTo sort by a configuration field not in the table summary, in this case the Config Sync repo, and print its values in a table, run:
gcloud alpha container hub config-management describe --view=list --sort-by="spec.configmanagement.configSync.git.syncRepo" --format="table(MEMBERSHIP,LOCATION,spec.configmanagement.configSync.git.syncRepo:label=REPO)"
-
Memberships to print configurations for. Errors if a specified membership does
not have a configuration for this feature.
- 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 helpfor 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 container hub config-management describegcloud beta container hub config-management describe
gcloud alpha container hub config-management describe
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-30 UTC.