# Amazon EC2 Container Registry API

> Amazon EC2 Container Registry API on Apizie: 41 endpoints (Checks the availability of one or more image layers in a repository. When an image is pushed to a…, Deletes a list of specified images within a repository. Images are specified with either an imageTag or…, Gets detailed information for an image. Images are specified with either an imageTag or imageDigest . When…, Gets the scanning configuration for one or more repositories., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-ecr`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-ecr
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-ecr/openapi.json

Amazon Elastic Container Registry Amazon Elastic Container Registry (Amazon ECR) is a managed container image registry service. Customers can use the familiar Docker CLI, or their preferred client, to push, pull, and…

## Endpoints

### Checks the availability of one or more image layers in a repository. When an image is pushed to a…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/batch-check-layer-availability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a list of specified images within a repository. Images are specified with either an imageTag or…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/batch-delete-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Gets detailed information for an image. Images are specified with either an imageTag or imageDigest . When…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/batch-get-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Gets the scanning configuration for one or more repositories.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/batch-get-repository-scanning-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Informs Amazon ECR that the image layer upload has completed for a specified registry, repository name, and…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/complete-layer-upload` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a pull through cache rule. A pull through cache rule provides a way to cache images from an external…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/create-pull-through-cache-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a repository. For more information, see Amazon ECR repositories in the Amazon Elastic Container…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/create-repository` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the lifecycle policy associated with the specified repository.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/delete-lifecycle-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a pull through cache rule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/delete-pull-through-cache-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the registry permissions policy.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/delete-registry-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a repository. If the repository contains images, you must either delete all images in the repository…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/delete-repository` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the repository policy associated with the specified repository.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/delete-repository-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Returns the replication status for a specified image.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/describe-image-replication-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Returns the scan findings for the specified image.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/describe-image-scan-findings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns metadata about the images in a repository. Beginning with Docker version 1.9, the Docker client…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/describe-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns the pull through cache rules for a registry.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/describe-pull-through-cache-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Describes the settings for a registry. The replication configuration for a repository can be created or…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/describe-registry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes image repositories in a registry.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/describe-repositories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Retrieves an authorization token. An authorization token represents your IAM authentication credentials and…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/get-authorization-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can only get URLs for…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/get-download-url-for-layer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves the lifecycle policy for the specified repository.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/get-lifecycle-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves the results of the lifecycle policy preview request for the specified repository.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/get-lifecycle-policy-preview` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Retrieves the permissions policy for a registry.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/get-registry-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves the scanning configuration for a registry.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/get-registry-scanning-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves the repository policy for the specified repository.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/get-repository-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Notifies Amazon ECR that you intend to upload an image layer. When an image is pushed, the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/initiate-layer-upload` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists all the image IDs for the specified repository. You can filter images based on whether or not they are…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/list-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### List the tags for an Amazon ECR resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates or updates the image manifest and tags associated with an image. When an image is pushed and all new…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/put-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### The PutImageScanningConfiguration API is being deprecated, in favor of specifying the image scanning…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/put-image-scanning-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the image tag mutability settings for the specified repository. For more information, see Image tag…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/put-image-tag-mutability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates or updates the lifecycle policy for the specified repository. For more information, see Lifecycle…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/put-lifecycle-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates or updates the permissions policy for your registry. A registry policy is used to specify…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/put-registry-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates or updates the scanning configuration for your private registry.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/put-registry-scanning-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates or updates the replication configuration for a registry. The existing replication configuration for…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/put-replication-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Applies a repository policy to the specified repository to control access permissions. For more information,…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/set-repository-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts an image vulnerability scan. An image scan can only be started once per 24 hours on an individual…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/start-image-scan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts a preview of a lifecycle policy for the specified repository. This allows you to see the results…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/start-lifecycle-policy-preview` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Adds specified tags to a resource with the specified ARN. Existing tags on a resource are not changed if…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes specified tags from a resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Uploads an image layer part to Amazon ECR. When an image is pushed, each new image layer is uploaded in…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/upload-layer-part` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/batch-check-layer-availability" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon EC2 Container Registry API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecr/batch-check-layer-availability with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Amazon EC2 Container Registry API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon EC2 Container Registry itself also needs your own key from amazonaws.com.

### Can AI agents use the Amazon EC2 Container Registry API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-ecr.

### What is the status of the Amazon EC2 Container Registry API?
Needs your own provider key (bring your own key)