Skip to content

ServiceImport API Reference


ServiceImport is a resource referring to a Service outside the cluster, paired with ServiceExport resource defined in the other clusters.

Just like Services, ServiceImports can be a backend reference of HTTPRoutes. Along with the cluster's own Services (and ServiceImports from even more clusters), you can distribute the traffic across multiple VPCs and clusters.

Note that ServiceImport is not the implementation of Kubernetes Multicluster Service APIs; instead AWS Gateway API Controller uses its own version of the resource for the purpose of Gateway API integration.


  • ServiceImport shares the limitations of ServiceExport.
  • The controller only supports ServiceImport through HTTPRoute; sending traffic directly is not supported.
  • BackendRef ports pointing to ServiceImport is not respected. Use port annotation of ServiceExport instead.


    (Optional) When specified, the controller will only find target groups exported from the cluster.
    (Optional) When specified, the controller will only find target groups exported from the cluster with the provided VPC ID.

Example Configuration

The following yaml imports service-1 exported from the designated cluster.

kind: ServiceImport
  name: service-1
  annotations: "service-1-owner-cluster" "service-1-owner-vpc-id"
spec: {}

The following example HTTPRoute directs traffic to the above ServiceImport.

kind: HTTPRoute
  name: my-route
    - name: my-gateway
      sectionName: http
    - backendRefs:
        - name: service-1
          kind: ServiceImport