---
title: "POST /cluster/get"
method: POST
path: "/cluster/get"
---

# POST /cluster/get

`POST /cluster/get`

Returns a list of clusters and metadata associated with an image.

## Request body

- object
  - `filter` object, required — The filter criteria to be used.
    - `resourceId` string — The resource Id to be used in the filter criteria.
  - `maxResults` integer — The maximum number of results to be returned in a single page of results.
  - `nextToken` string — The pagination token from a previous request used to retrieve the next page of results.

## Response `200`

Success

- GetClustersForImageResponse
  - `cluster` ClusterInformation[], required — A unit of work inside of a cluster, which can include metadata about the cluster.
    - `clusterArn` string, required — The cluster ARN.
    - `clusterDetails` ClusterDetails[] — Details about the cluster.
      - `lastInUse` string, date-time, required — The last timestamp when Amazon Inspector recorded the image in use in the task or pod in the cluster.
      - `runningUnitCount` integer — The number of tasks or pods where an image was running on the cluster.
      - `stoppedUnitCount` integer — The number of tasks or pods where an image was stopped on the cluster in the last 24 hours.
      - `clusterMetadata` ClusterMetadata, required — The metadata for a cluster.
        - `awsEcsMetadataDetails` object — The details for an Amazon ECS cluster in the cluster metadata.
          - `detailsGroup` string, required — The details group information for a task in a cluster.
          - `taskDefinitionArn` string, required — The task definition ARN.
        - `awsEksMetadataDetails` object — The details for an Amazon EKS cluster in the cluster metadata.
          - `namespace` string — The namespace for an Amazon EKS cluster.
          - `workloadInfoList` AwsEksWorkloadInfo[] — The list of workloads.
            - `name` string, required — The name of the workload.
            - `type` string, required — The workload type.
  - `nextToken` string — The pagination token from a previous request used to retrieve the next page of results.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/inspector2.md) · [All operations](https://skmtc.net/aws/apis/inspector2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/inspector2/versions/c51110c7cd43/schema)