AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Gets detailed information for an image. Images are specified with either an imageTag
or imageDigest.
When an image is pulled, the BatchGetImage API is called once to retrieve the image manifest.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginBatchGetImage and EndBatchGetImage.
Namespace: Amazon.ECR
Assembly: AWSSDK.ECR.dll
Version: 3.x.y.z
public virtual Task<BatchGetImageResponse> BatchGetImageAsync( BatchGetImageRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the BatchGetImage service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| InvalidParameterException | The specified parameter is invalid. Review the available parameters for the API request. |
| LimitExceededException | The operation did not succeed because it would have exceeded a service limit for your account. For more information, see Amazon ECR service quotas in the Amazon Elastic Container Registry User Guide. |
| RepositoryNotFoundException | The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry. |
| ServerException | These errors are usually caused by a server-side issue. |
| UnableToGetUpstreamImageException | The image or images were unable to be pulled using the pull through cache rule. This is usually caused because of an issue with the Secrets Manager secret containing the credentials for the upstream registry. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5