mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
570 lines
9.6 KiB
Plaintext
570 lines
9.6 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * cli_reference/rosa_cli/rosa-manage-objects-cli.adoc
|
|
|
|
[id="rosa-list-objects_{context}"]
|
|
= List and describe objects
|
|
|
|
This section describes the `list` and `describe` commands for clusters and resources.
|
|
|
|
[id="rosa-list-oaddon_{context}"]
|
|
== list addon
|
|
|
|
List the managed service add-on installations.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list addons --cluster=<cluster_name> | <cluster_id>
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster to list the add-ons for.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
[id="rosa-list-clusters_{context}"]
|
|
== list clusters
|
|
|
|
List all of your clusters.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list clusters [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--count
|
|
|The number (integer) of clusters to display. Default: `100`
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
[id="rosa-list-idps_{context}"]
|
|
== list idps
|
|
|
|
List all of the identity providers (IDPs) for a cluster.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list idps --cluster=<cluster_name> | <cluster_id> [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster that the IDPs will be listed for.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
List all identity providers (IDPs) for a cluster named `mycluster`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list idps --cluster=mycluster
|
|
----
|
|
|
|
[id="rosa-list-ingresses_{context}"]
|
|
== list ingresses
|
|
|
|
List all of the API and ingress endpoints for a cluster.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list ingresses --cluster=<cluster_name> | <cluster_id> [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster that the IDPs will be listed for.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
List all API and ingress endpoints for a cluster named `mycluster`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list ingresses --cluster=mycluster
|
|
----
|
|
|
|
== list instance-types
|
|
|
|
List all of the available instance types for use with {product-title}. Availability is based on the account's AWS quota.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list instance-types [arguments]
|
|
----
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--output
|
|
|The output format. Allowed formats are `json` or `yaml`.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|===
|
|
|
|
.Example
|
|
List all instance types:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list instance-types
|
|
----
|
|
|
|
[id="rosa-list-machinepools_{context}"]
|
|
== list machinepools
|
|
|
|
List the machine pools configured on a cluster.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list machinepools --cluster=<cluster_name> | <cluster_id> [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster that the machine pools will be listed for.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
List all of the machine pools on a cluster named `mycluster`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list machinepools --cluster=mycluster
|
|
----
|
|
|
|
[id="rosa-list-regions_{context}"]
|
|
== list regions
|
|
|
|
List all of the available regions for the current AWS account.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list regions [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--multi-az
|
|
|Lists regions that provide support for multiple availability zones.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
List all of the available regions:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list regions
|
|
----
|
|
|
|
[id="rosa-list-upgrades_{context}"]
|
|
== list upgrades
|
|
|
|
List all available and scheduled cluster version upgrades.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list upgrades --cluster=<cluster_name> | <cluster_id> [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster that the available upgrades will be listed for.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
List all of the available upgrades for a cluster named `mycluster`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list upgrades --cluster=mycluster
|
|
----
|
|
|
|
[id="rosa-list-users_{context}"]
|
|
== list users
|
|
List the cluster administrator and dedicated administrator users for a specified cluster.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list users --cluster=<cluster_name> | <cluster_id> [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster that the cluster administrators will be listed for.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
List all of the cluster administrators and dedicated administrators for a cluster named `mycluster`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list users --cluster=mycluster
|
|
----
|
|
|
|
[id="rosa-list-versions_{context}"]
|
|
== list versions
|
|
|
|
List all of the OpenShift versions that are available for creating a cluster.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa list versions [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--channel-group
|
|
|Lists only versions from the specified channel group (string). Default: `stable`
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
List all of the OpenShift Container Platform versions:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa list versions
|
|
----
|
|
|
|
[id="rosa-describe-admin_{context}"]
|
|
== describe admin
|
|
|
|
Show the details of a specified `cluster-admin` user and a command to log in to the cluster.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa describe admin --cluster=<cluster_name> | <cluster_id> [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster to which the cluster-admin belongs.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
Describe the `cluster-admin` user for a cluster named `mycluster`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa describe admin --cluster=mycluster
|
|
----
|
|
|
|
[id="rosa-describe-addon_{context}"]
|
|
== describe addon
|
|
|
|
Show the details of a managed service add-on.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa describe addon <addon_id> | <addon_name> [arguments]
|
|
----
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
Describe an add-on named `codeready-workspaces`:
|
|
|
|
[source,terminal]
|
|
----
|
|
$ rosa describe addon codeready-workspaces
|
|
----
|
|
|
|
[id="rosa-describe-cluster_{context}"]
|
|
== describe cluster
|
|
|
|
Shows the details for a cluster.
|
|
|
|
.Syntax
|
|
[source,terminal]
|
|
----
|
|
$ rosa describe cluster --cluster=<cluster_name> | <cluster_id> [arguments]
|
|
----
|
|
|
|
.Arguments
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--cluster
|
|
|Required: The name or ID (string) of the cluster.
|
|
|===
|
|
|
|
.Optional arguments inherited from parent commands
|
|
[cols="30,70"]
|
|
|===
|
|
|Option |Definition
|
|
|
|
|--help
|
|
|Shows help for this command.
|
|
|
|
|--debug
|
|
|Enables debug mode.
|
|
|
|
|--profile
|
|
|Specifies an AWS profile (string) from your credentials file.
|
|
|
|
|--v <level>
|
|
|The log level for V logs.
|
|
|===
|
|
|
|
.Example
|
|
Describe a cluster named `mycluster`:
|
|
[source,terminal]
|
|
----
|
|
$ rosa describe cluster --cluster=mycluster
|
|
----
|