v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1441293181.2 KB

Retrieves the results of the lifecycle policy preview request for the specified repository.

post/#X-Amz-Target=AmazonEC2ContainerRegistry_V20150921.GetLifecyclePolicyPreview

Query parameters

maxResultsstring

Pagination limit

nextTokenstring

Pagination token

Headers

X-Amz-Target'AmazonEC2ContainerRegistry_V20150921.GetLifecyclePolicyPreview' required

Request body

registryIdstring

The Amazon Web Services account ID associated with the registry that contains the repository. If you do not specify a registry, the default registry is assumed.

repositoryNamestring required

The name of the repository.

nextTokenstring

The <code>nextToken</code> value returned from a previous paginated
 <code>GetLifecyclePolicyPreviewRequest</code> request where <code>maxResults</code> was used and the
 results exceeded the value of that parameter. Pagination continues from the end of the
 previous results that returned the <code>nextToken</code> value. This value is
 <code>null</code> when there are no more results to return. This option cannot be used when you specify images with <code>imageIds</code>.

maxResultsinteger

The maximum number of repository results returned by <code>GetLifecyclePolicyPreviewRequest</code> in
 paginated output. When this parameter is used, <code>GetLifecyclePolicyPreviewRequest</code> only returns
 <code>maxResults</code> results in a single page along with a <code>nextToken</code>
 response element. The remaining results of the initial request can be seen by sending
 another <code>GetLifecyclePolicyPreviewRequest</code> request with the returned <code>nextToken</code>
 value. This value can be between 1 and 1000. If this
 parameter is not used, then <code>GetLifecyclePolicyPreviewRequest</code> returns up to
 100 results and a <code>nextToken</code> value, if
 applicable. This option cannot be used when you specify images with <code>imageIds</code>.

Response

Success

registryIdstring

The registry ID associated with the request.

repositoryNamestring

The repository name associated with the request.

lifecyclePolicyTextstring

The JSON lifecycle policy text.

status'IN_PROGRESS' | 'COMPLETE' | 'EXPIRED' | 'FAILED'

The status of the lifecycle policy preview request.

nextTokenstring

The <code>nextToken</code> value to include in a future <code>GetLifecyclePolicyPreview</code> request. When the results of a <code>GetLifecyclePolicyPreview</code> request exceed <code>maxResults</code>, this value can be used to retrieve the next page of results. This value is <code>null</code> when there are no more results to return.