Skip to content

list_pull_time_update_exclusions

list_pull_time_update_exclusions(
    *,
    config_overrides: Optional[ECRClientConfig] = None,
    max_results: Optional[MaxResults] = None,
    next_token: Optional[NextToken] = None,
) -> ListPullTimeUpdateExclusionsResponse

Lists the IAM principals that are excluded from having their image pull times recorded.

Parameters:

  • max_results (Optional[MaxResults], default: None ) –

    The maximum number of pull time update exclusion results returned by ListPullTimeUpdateExclusions in paginated output. When this parameter is used, ListPullTimeUpdateExclusions only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListPullTimeUpdateExclusions request with the returned nextToken value. This value can be between 1 and 1000. If this parameter is not used, then ListPullTimeUpdateExclusions returns up to 100 results and a nextToken value, if applicable.

  • next_token (Optional[NextToken], default: None ) –

    The nextToken value returned from a previous paginated ListPullTimeUpdateExclusions request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

    This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.

Raises:

Examples:

To list all pull time update exclusions This example lists all IAM principals that are excluded from having their image pull timestamps recorded in the registry.

>>> client.list_pull_time_update_exclusions()
To list pull time update exclusions with pagination
This example lists pull time update exclusions with pagination, requesting a maximum of 2 results per page.
>>> client.list_pull_time_update_exclusions(max_results=2)
Source code in docs_src/capo_ecr/_services/ecr.py
def list_pull_time_update_exclusions(
    self,
    *,
    config_overrides: Optional[ECRClientConfig] = None,
    max_results: Optional["capo_ecr.types.max_results.MaxResults"] = None,
    next_token: Optional["capo_ecr.types.next_token.NextToken"] = None,
) -> "capo_ecr.types.list_pull_time_update_exclusions_response.ListPullTimeUpdateExclusionsResponse":
    """<p>Lists the IAM principals that are excluded from having their image pull times recorded.</p>

    Args:
        max_results: <p>The maximum number of pull time update exclusion results returned by <code>ListPullTimeUpdateExclusions</code> in paginated output. When this parameter is used, <code>ListPullTimeUpdateExclusions</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>ListPullTimeUpdateExclusions</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>ListPullTimeUpdateExclusions</code> returns up to 100 results and a <code>nextToken</code> value, if applicable.</p>
        next_token: <p>The <code>nextToken</code> value returned from a previous paginated <code>ListPullTimeUpdateExclusions</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.</p> <note> <p>This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.</p> </note>

    Raises:
        capo_ecr.errors.invalid_parameter_exception.InvalidParameterException: <p>The specified parameter is invalid. Review the available parameters for the API request.</p>
        capo_ecr.errors.limit_exceeded_exception.LimitExceededException: <p>The operation did not succeed because it would have exceeded a service limit for your account. For more information, see <a href="https://docs.aws.amazon.com/AmazonECR/latest/userguide/service-quotas.html">Amazon ECR service quotas</a> in the Amazon Elastic Container Registry User Guide.</p>
        capo_ecr.errors.server_exception.ServerException: <p>These errors are usually caused by a server-side issue.</p>
        capo_ecr.errors.validation_exception.ValidationException: <p>There was an exception validating this request.</p>
        capo_ecr.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        To list all pull time update exclusions
        This example lists all IAM principals that are excluded from having their image pull timestamps recorded in the registry.

        >>> client.list_pull_time_update_exclusions()
        To list pull time update exclusions with pagination
        This example lists pull time update exclusions with pagination, requesting a maximum of 2 results per page.

        >>> client.list_pull_time_update_exclusions(max_results=2)
    """

    def _handler(
        req: "OperationRequest[capo_ecr.types.list_pull_time_update_exclusions_request.ListPullTimeUpdateExclusionsRequest]",
    ) -> OperationResponse[
        "capo_ecr.types.list_pull_time_update_exclusions_response.ListPullTimeUpdateExclusionsResponse"
    ]:
        import capo_ecr._operations.amazon_ec2_container_registry_v20150921.list_pull_time_update_exclusions

        output, http_response = (
            capo_ecr._operations.amazon_ec2_container_registry_v20150921.list_pull_time_update_exclusions.list_pull_time_update_exclusions(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListPullTimeUpdateExclusions")
    )
    input_: capo_ecr.types.list_pull_time_update_exclusions_request.ListPullTimeUpdateExclusionsRequest = {}
    if max_results is not None:
        input_["max_results"] = max_results
    if next_token is not None:
        input_["next_token"] = next_token

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output