Method: projects.locations.attachedClusters.import

Imports creates a new AttachedCluster resource by importing an existing Fleet Membership resource.

Attached Clusters created before the introduction of the Anthos Multi-Cloud API can be imported through this method.

If successful, the response contains a newly created Operation resource that can be described to track the status of the operation.

HTTP request

POST https://{endpoint}/v1/{parent=projects/*/locations/*}/attachedClusters:import

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

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent location where this AttachedCluster resource will be created.

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

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

Request body

The request body contains data with the following structure:

JSON representation
{
  "validateOnly": boolean,
  "fleetMembership": string,
  "platformVersion": string,
  "distribution": string,
  "proxyConfig": {
    object (AttachedProxyConfig)
  }
}
Fields
validateOnly

boolean

If set, only validate the request, but do not actually import the cluster.

fleetMembership

string

Required. The name of the fleet membership resource to import.

platformVersion

string

Required. The platform version for the cluster (e.g. 1.19.0-gke.1000).

You can list all supported versions on a given Google Cloud region by calling locations.getAttachedServerConfig.

distribution

string

Required. The Kubernetes distribution of the underlying attached cluster.

Supported values: ["eks", "aks", "generic"].

proxyConfig

object (AttachedProxyConfig)

Optional. Proxy configuration for outbound HTTP(S) traffic.

Response body

If successful, the response body contains an instance of Operation.

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 parent resource:

  • gkemulticloud.attachedClusters.import

For more information, see the IAM documentation.