# Google Container Engine API . projects . clusters

## Instance Methods

Lists all clusters owned by a project across all zones.

### Method Details

`list(projectId)`

    Lists all clusters owned by a project across all zones.

    Args:
      projectId: string, The Google Developers Console project ID or  project number. (required)

    Returns:
      An object of the form:

        {
        "clusters": [ # A list of clusters in the project, across all zones.
          {
            "status": "A String", # [Output only] The current status of this cluster.
            "containerIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in  CIDR notation (e.g. 10.96.0.0/14). Leave blank to have one automatically chosen or specify a /14 block in 10.0.0.0/8 or 172.16.0.0/12.
            "description": "A String", # An optional description of this cluster.
            "name": "A String", # The name of this cluster. The name must be unique within this project and zone, and can be up to 40 characters with the following restrictions:
                # - Lowercase letters, numbers, and hyphens only.
                # - Must start with a letter.
                # - Must end with a number or a letter.
            "numNodes": 42, # The number of nodes to create in this cluster. You must ensure that your Compute Engine resource quota is sufficient for this number of instances plus one (to include the master). You must also have available firewall and routes quota.
            "nodeRoutingPrefixSize": 42, # [Output only] The size of the address space on each node for hosting containers.
            "instanceGroupUrls": [ # [Output only] The resource URLs of [instance groups](/compute/docs/instance-groups/) associated with this cluster.
              "A String",
            ],
            "masterAuth": { # The authentication information for accessing the master. Authentication is either done using HTTP basic authentication or using a bearer token. # The authentication information for accessing the master.
              "bearerToken": "A String", # The token used to authenticate API requests to the master. The token is to be included in an HTTP Authorization Header in all requests to the master endpoint. The format of the header is: "Authorization: Bearer ".
              "clientKey": "A String", # [Output only] Base64 encoded private key used by clients to authenticate to the cluster endpoint.
              "clientCertificate": "A String", # [Output only] Base64 encoded public certificate used by clients to authenticate to the cluster endpoint.
              "user": "A String", # The username to use for HTTP basic authentication when accessing the Kubernetes master endpoint.
              "password": "A String", # The password to use for HTTP basic authentication when accessing the Kubernetes master endpoint. Because the master endpoint is open to the internet, you should create a strong password.
              "clusterCaCertificate": "A String", # [Output only] Base64 encoded public certificate that is the root of trust for the cluster.
            },
            "clusterApiVersion": "A String", # The API version of the Kubernetes master and kubelets running in this cluster. Leave blank to pick up the latest stable release, or specify a version of the form "x.y.z". The Google Container Engine release notes lists the currently supported versions. If an incorrect version is specified, the server returns an error listing the currently supported versions.
            "network": "A String", # The name of the Google Compute Engine network to which the cluster is connected.
            "zone": "A String", # [Output only] The name of the Google Compute Engine zone in which the cluster resides.
            "endpoint": "A String", # [Output only] The IP address of this cluster's Kubernetes master. The endpoint can be accessed from the internet at https://username:password@endpoint/.
                #
                # See the masterAuth property of this resource for username and password information.
            "nodeConfig": { # The machine type and image to use for all nodes in this cluster. See the descriptions of the child properties of nodeConfig.
              "serviceAccounts": [ # The optional list of ServiceAccounts, each with their specified scopes, to be made available on all of the node VMs. In addition to the service accounts and scopes specified, the "default" account will always be created with the following scopes to ensure the correct functioning of the cluster:
                  # - https://www.googleapis.com/auth/compute,
                  # - https://www.googleapis.com/auth/devstorage.read_only
                { # A Compute Engine service account.
                  "scopes": [ # The list of scopes to be made available for this service account.
                    "A String",
                  ],
                  "email": "A String", # Email address of the service account.
                },
              ],
              "machineType": "A String", # The name of a Google Compute Engine machine type (e.g. n1-standard-1).
                  #
                  # If unspecified, the default machine type is n1-standard-1.
              "sourceImage": "A String", # The fully-specified name of a Google Compute Engine image. For example: https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/backports-debian-7-wheezy-vYYYYMMDD (where YYYMMDD is the version date).
                  #
                  # If specifying an image, you are responsible for ensuring its compatibility with the Debian 7 backports image. We recommend leaving this field blank to accept the default backports-debian-7-wheezy value.
            },
            "statusMessage": "A String", # [Output only] Additional information about the current status of this cluster, if available.
            "servicesIpv4Cidr": "A String", # [Output only] The IP address range of the Kubernetes services in this cluster, in  CIDR notation (e.g. 1.2.3.4/29). Service addresses are typically put in the last /16 from the container CIDR.
            "creationTimestamp": "A String", # [Output only] The time the cluster was created, in RFC3339 text format.
            "enableCloudLogging": True or False, # Whether logs from the cluster should be made available via the Google Cloud Logging service. This includes both logs from your applications running in the cluster as well as logs from the Kubernetes components themselves.
            "selfLink": "A String", # [Output only] Server-defined URL for the resource.
            "enableCloudMonitoring": True or False, # Whether metrics from the cluster should be made available via the Google Cloud Monitoring service.
          },
        ],
      }