Method: projects.locations.getAwsServerConfig

Returns information, such as supported AWS regions and Kubernetes versions, on a given Google Cloud location.

HTTP request

GET https://{endpoint}/v1/{name=projects/*/locations/*/awsServerConfig}

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the AwsServerConfig resource to describe.

AwsServerConfig names are formatted as projects/<project-id>/locations/<region>/awsServerConfig.

See Resource Names for more details on Google Cloud resource names.

Request body

The request body must be empty.

Response body

AwsServerConfig is the configuration of GKE cluster on AWS.

If successful, the response body contains data with the following structure:

JSON representation
{
  "name": string,
  "validVersions": [
    {
      object (AwsK8sVersionInfo)
    }
  ],
  "supportedAwsRegions": [
    string
  ]
}
Fields
name

string

The resource name of the config.

validVersions[]

object (AwsK8sVersionInfo)

List of all released Kubernetes versions, including ones which are end of life and can no longer be used. Filter by the enabled property to limit to currently available versions. Valid versions supported for both create and update operations

supportedAwsRegions[]

string

The list of supported AWS regions.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

  • gkemulticloud.awsServerConfigs.get

For more information, see the IAM documentation.

AwsK8sVersionInfo

Kubernetes version information of GKE cluster on AWS.

JSON representation
{
  "version": string,
  "enabled": boolean,
  "endOfLife": boolean,
  "endOfLifeDate": {
    object (Date)
  },
  "releaseDate": {
    object (Date)
  }
}
Fields
version

string

Kubernetes version name.

enabled

boolean

Optional. True if the version is available for cluster creation. If a version is enabled for creation, it can be used to create new clusters. Otherwise, cluster creation will fail. However, cluster upgrade operations may succeed, even if the version is not enabled.

endOfLife

boolean

Optional. True if this cluster version belongs to a minor version that has reached its end of life and is no longer in scope to receive security and bug fixes.

endOfLifeDate

object (Date)

Optional. The estimated date (in Pacific Time) when this cluster version will reach its end of life. Or if this version is no longer supported (the endOfLife field is true), this is the actual date (in Pacific time) when the version reached its end of life.

releaseDate

object (Date)

Optional. The date (in Pacific Time) when the cluster version was released.