feat(client-ecr): Add UnableToListUpstreamImageReferrersException in ListImageReferrers

Author: awstools

clients/client-ecr/src/commands/ListImageReferrersCommand.ts

@@ -91,6 +91,11 @@ export interface ListImageReferrersCommandOutput extends ListImageReferrersRespo
  * @throws {@link ServerException} (server fault)
  *  <p>These errors are usually caused by a server-side issue.</p>
  *
+ * @throws {@link UnableToListUpstreamImageReferrersException} (client fault)
+ *  <p>The referrer or referrers were unable to be listed 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.</p>
+ *
  * @throws {@link ValidationException} (client fault)
  *  <p>There was an exception validating this request.</p>
  *

clients/client-ecr/src/models/errors.ts

@@ -735,6 +735,28 @@ export class LifecyclePolicyPreviewNotFoundException extends __BaseException {
   }
 }
 
+/**
+ * <p>The referrer or referrers were unable to be listed 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.</p>
+ * @public
+ */
+export class UnableToListUpstreamImageReferrersException extends __BaseException {
+  readonly name = "UnableToListUpstreamImageReferrersException" as const;
+  readonly $fault = "client" as const;
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<UnableToListUpstreamImageReferrersException, __BaseException>) {
+    super({
+      name: "UnableToListUpstreamImageReferrersException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, UnableToListUpstreamImageReferrersException.prototype);
+  }
+}
+
 /**
  * <p>The specified image has already been pushed, and there were no changes to the manifest
  *             or image tag after the last push.</p>

clients/client-ecr/src/models/models_0.ts

@@ -1565,7 +1565,9 @@ export interface DescribeImagesFilter {
   tagStatus?: TagStatus | undefined;
 
   /**
-   * <p>The image status with which to filter your <a>DescribeImages</a> results. Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>.</p>
+   * <p>The image status with which to filter your <a>DescribeImages</a> results.
+   *         Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>.
+   *         If not specified, only images with <code>ACTIVE</code> status are returned.</p>
    * @public
    */
   imageStatus?: ImageStatusFilter | undefined;
@@ -3602,7 +3604,7 @@ export interface ListImageReferrersRequest {
    *             response element. The remaining results of the initial request can be seen by sending
    *             another <code>ListImageReferrers</code> request with the returned <code>nextToken</code> value.
    *             This value can be between 1 and 50. If this parameter is
-   *             not used, then <code>ListImageReferrers</code> returns up to 50 results and a
+   *             not used, then <code>ListImageReferrers</code> returns up to 20 results and a
    *                 <code>nextToken</code> value, if applicable.</p>
    * @public
    */
@@ -3684,7 +3686,9 @@ export interface ListImagesFilter {
   tagStatus?: TagStatus | undefined;
 
   /**
-   * <p>The image status with which to filter your <a>ListImages</a> results. Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>.</p>
+   * <p>The image status with which to filter your <a>ListImages</a> results.
+   *         Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>.
+   *         If not specified, only images with <code>ACTIVE</code> status are returned.</p>
    * @public
    */
   imageStatus?: ImageStatusFilter | undefined;

clients/client-ecr/src/schemas/schemas_0.ts

@@ -301,6 +301,7 @@ const _UTASE = "UnableToAccessSecretException";
 const _UTDSVE = "UnableToDecryptSecretValueException";
 const _UTGUIE = "UnableToGetUpstreamImageException";
 const _UTGULE = "UnableToGetUpstreamLayerException";
+const _UTLUIRE = "UnableToListUpstreamImageReferrersException";
 const _UURE = "UnsupportedUpstreamRegistryException";
 const _V = "Value";
 const _VE = "ValidationException";
@@ -560,6 +561,7 @@ import {
   UnableToDecryptSecretValueException,
   UnableToGetUpstreamImageException,
   UnableToGetUpstreamLayerException,
+  UnableToListUpstreamImageReferrersException,
   UnsupportedImageTypeException,
   UnsupportedUpstreamRegistryException,
   UploadNotFoundException,
@@ -823,6 +825,12 @@ export var UnableToGetUpstreamLayerException$: StaticErrorSchema = [-3, n0, _UTG
   [0]
 ];
 n0_registry.registerError(UnableToGetUpstreamLayerException$, UnableToGetUpstreamLayerException);
+export var UnableToListUpstreamImageReferrersException$: StaticErrorSchema = [-3, n0, _UTLUIRE,
+  { [_e]: _c },
+  [_m],
+  [0]
+];
+n0_registry.registerError(UnableToListUpstreamImageReferrersException$, UnableToListUpstreamImageReferrersException);
 export var UnsupportedImageTypeException$: StaticErrorSchema = [-3, n0, _UITE,
   { [_e]: _c },
   [_m],

clients/client-ecr/test/index-objects.spec.mjs

@@ -383,6 +383,8 @@ import {
   UnableToGetUpstreamImageException$,
   UnableToGetUpstreamLayerException,
   UnableToGetUpstreamLayerException$,
+  UnableToListUpstreamImageReferrersException,
+  UnableToListUpstreamImageReferrersException$,
   UnsupportedImageTypeException,
   UnsupportedImageTypeException$,
   UnsupportedUpstreamRegistryException,
@@ -830,6 +832,8 @@ assert(UnableToGetUpstreamImageException.prototype instanceof ECRServiceExceptio
 assert(typeof UnableToGetUpstreamImageException$ === "object");
 assert(UnableToGetUpstreamLayerException.prototype instanceof ECRServiceException);
 assert(typeof UnableToGetUpstreamLayerException$ === "object");
+assert(UnableToListUpstreamImageReferrersException.prototype instanceof ECRServiceException);
+assert(typeof UnableToListUpstreamImageReferrersException$ === "object");
 assert(UnsupportedImageTypeException.prototype instanceof ECRServiceException);
 assert(typeof UnsupportedImageTypeException$ === "object");
 assert(UnsupportedUpstreamRegistryException.prototype instanceof ECRServiceException);

clients/client-ecr/test/index-types.ts

@@ -418,6 +418,7 @@ export type {
   UnableToDecryptSecretValueException,
   UnableToGetUpstreamImageException,
   UnableToGetUpstreamLayerException,
+  UnableToListUpstreamImageReferrersException,
   UnsupportedImageTypeException,
   UnsupportedUpstreamRegistryException,
   UploadNotFoundException,

codegen/sdk-codegen/aws-models/ecr.json

@@ -4480,7 +4480,7 @@
         "imageStatus": {
           "target": "com.amazonaws.ecr#ImageStatusFilter",
           "traits": {
-            "smithy.api#documentation": "<p>The image status with which to filter your <a>DescribeImages</a> results. Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>.</p>"
+            "smithy.api#documentation": "<p>The image status with which to filter your <a>DescribeImages</a> results.\n        Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>. \n        If not specified, only images with <code>ACTIVE</code> status are returned.</p>"
           }
         }
       },
@@ -7391,6 +7391,9 @@
         {
           "target": "com.amazonaws.ecr#ServerException"
         },
+        {
+          "target": "com.amazonaws.ecr#UnableToListUpstreamImageReferrersException"
+        },
         {
           "target": "com.amazonaws.ecr#ValidationException"
         }
@@ -7554,7 +7557,7 @@
         "maxResults": {
           "target": "com.amazonaws.ecr#FiftyMaxResults",
           "traits": {
-            "smithy.api#documentation": "<p>The maximum number of image referrer results returned by <code>ListImageReferrers</code> in paginated\n            output. When this parameter is used, <code>ListImageReferrers</code> only returns\n                <code>maxResults</code> results in a single page along with a <code>nextToken</code>\n            response element. The remaining results of the initial request can be seen by sending\n            another <code>ListImageReferrers</code> request with the returned <code>nextToken</code> value.\n            This value can be between 1 and 50. If this parameter is\n            not used, then <code>ListImageReferrers</code> returns up to 50 results and a\n                <code>nextToken</code> value, if applicable.</p>"
+            "smithy.api#documentation": "<p>The maximum number of image referrer results returned by <code>ListImageReferrers</code> in paginated\n            output. When this parameter is used, <code>ListImageReferrers</code> only returns\n                <code>maxResults</code> results in a single page along with a <code>nextToken</code>\n            response element. The remaining results of the initial request can be seen by sending\n            another <code>ListImageReferrers</code> request with the returned <code>nextToken</code> value.\n            This value can be between 1 and 50. If this parameter is\n            not used, then <code>ListImageReferrers</code> returns up to 20 results and a\n                <code>nextToken</code> value, if applicable.</p>"
           }
         }
       },
@@ -7655,7 +7658,7 @@
         "imageStatus": {
           "target": "com.amazonaws.ecr#ImageStatusFilter",
           "traits": {
-            "smithy.api#documentation": "<p>The image status with which to filter your <a>ListImages</a> results. Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>.</p>"
+            "smithy.api#documentation": "<p>The image status with which to filter your <a>ListImages</a> results.\n        Valid values are <code>ACTIVE</code>, <code>ARCHIVED</code>, and <code>ACTIVATING</code>.\n        If not specified, only images with <code>ACTIVE</code> status are returned.</p>"
           }
         }
       },
@@ -10576,6 +10579,18 @@
         "smithy.api#error": "client"
       }
     },
+    "com.amazonaws.ecr#UnableToListUpstreamImageReferrersException": {
+      "type": "structure",
+      "members": {
+        "message": {
+          "target": "com.amazonaws.ecr#ExceptionMessage"
+        }
+      },
+      "traits": {
+        "smithy.api#documentation": "<p>The referrer or referrers were unable to be listed using the pull through cache rule. This\n            is usually caused because of an issue with the Secrets Manager secret containing the credentials\n            for the upstream registry.</p>",
+        "smithy.api#error": "client"
+      }
+    },
     "com.amazonaws.ecr#UnsupportedImageTypeException": {
       "type": "structure",
       "members": {