Skip to content

list_agreement_cancellation_requests async

list_agreement_cancellation_requests(
    party_type: PartyType,
    *,
    config_overrides: Optional[AsyncMarketplaceAgreementClientConfig] = None,
    agreement_id: Optional[AgreementId] = None,
    status: Optional[AgreementCancellationRequestStatus] = None,
    agreement_type: Optional[AgreementType] = None,
    catalog: Optional[Catalog] = None,
    max_results: Optional[MaxResults] = None,
    next_token: Optional[NextToken] = None,
) -> ListAgreementCancellationRequestsOutput

Lists agreement cancellation requests available to you as a seller or buyer. Both sellers (proposers) and buyers (acceptors) can use this operation to find cancellation requests by specifying their party type and applying optional filters.

PartyType is a required parameter. A ValidationException is returned if PartyType is not provided.

Parameters:

  • party_type (PartyType) –

    The party type for the cancellation requests. Required parameter. Use Proposer to list cancellation requests where you are the seller, or Acceptor to list cancellation requests where you are the buyer.

  • agreement_id (Optional[AgreementId], default: None ) –

    An optional parameter to filter cancellation requests for a specific agreement.

  • status (Optional[AgreementCancellationRequestStatus], default: None ) –

    An optional parameter to filter cancellation requests by status.

  • agreement_type (Optional[AgreementType], default: None ) –

    An optional parameter to filter cancellation requests by agreement type (e.g., PurchaseAgreement).

  • catalog (Optional[Catalog], default: None ) –

    An optional parameter to filter cancellation requests by catalog (e.g., AWSMarketplace).

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

    The maximum number of cancellation requests to return in the response.

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

    A token to specify where to start pagination.

Raises:

Examples:

List cancellation requests

>>> await client.list_agreement_cancellation_requests(party_type='Proposer', max_results=10)
Source code in docs_src/capo_marketplace_agreement/_services/async_marketplace_agreement.py
async def list_agreement_cancellation_requests(
    self,
    party_type: "capo_marketplace_agreement.types.party_type.PartyType",
    *,
    config_overrides: Optional[AsyncMarketplaceAgreementClientConfig] = None,
    agreement_id: Optional[
        "capo_marketplace_agreement.types.agreement_id.AgreementId"
    ] = None,
    status: Optional[
        "capo_marketplace_agreement.types.agreement_cancellation_request_status.AgreementCancellationRequestStatus"
    ] = None,
    agreement_type: Optional[
        "capo_marketplace_agreement.types.agreement_type.AgreementType"
    ] = None,
    catalog: Optional["capo_marketplace_agreement.types.catalog.Catalog"] = None,
    max_results: Optional[
        "capo_marketplace_agreement.types.max_results.MaxResults"
    ] = None,
    next_token: Optional[
        "capo_marketplace_agreement.types.next_token.NextToken"
    ] = None,
) -> "capo_marketplace_agreement.types.list_agreement_cancellation_requests_output.ListAgreementCancellationRequestsOutput":
    """<p>Lists agreement cancellation requests available to you as a seller or buyer. Both sellers (proposers) and buyers (acceptors) can use this operation to find cancellation requests by specifying their party type and applying optional filters.</p> <note> <p> <code>PartyType</code> is a required parameter. A <code>ValidationException</code> is returned if <code>PartyType</code> is not provided.</p> </note>

    Args:
        party_type: <p>The party type for the cancellation requests. Required parameter. Use <code>Proposer</code> to list cancellation requests where you are the seller, or <code>Acceptor</code> to list cancellation requests where you are the buyer.</p>
        agreement_id: <p>An optional parameter to filter cancellation requests for a specific agreement.</p>
        status: <p>An optional parameter to filter cancellation requests by status.</p>
        agreement_type: <p>An optional parameter to filter cancellation requests by agreement type (e.g., <code>PurchaseAgreement</code>).</p>
        catalog: <p>An optional parameter to filter cancellation requests by catalog (e.g., <code>AWSMarketplace</code>).</p>
        max_results: <p>The maximum number of cancellation requests to return in the response.</p>
        next_token: <p>A token to specify where to start pagination.</p>

    Raises:
        capo_marketplace_agreement.errors.access_denied_exception.AccessDeniedException: <p>User does not have sufficient access to perform this action.</p>
        capo_marketplace_agreement.errors.internal_server_exception.InternalServerException: <p>Unexpected error during processing of request.</p>
        capo_marketplace_agreement.errors.throttling_exception.ThrottlingException: <p>Request was denied due to request throttling.</p>
        capo_marketplace_agreement.errors.validation_exception.ValidationException: <p>The input fails to satisfy the constraints specified by the service.</p>
        capo_marketplace_agreement.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        List cancellation requests

        >>> await client.list_agreement_cancellation_requests(party_type='Proposer', max_results=10)
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_marketplace_agreement.types.list_agreement_cancellation_requests_input.ListAgreementCancellationRequestsInput]",
    ) -> AsyncOperationResponse[
        "capo_marketplace_agreement.types.list_agreement_cancellation_requests_output.ListAgreementCancellationRequestsOutput"
    ]:
        import capo_marketplace_agreement._operations.awsmp_commerce_service_v20200301.list_agreement_cancellation_requests

        (
            output,
            http_response,
        ) = await capo_marketplace_agreement._operations.awsmp_commerce_service_v20200301.list_agreement_cancellation_requests.async_list_agreement_cancellation_requests(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListAgreementCancellationRequests")
    )
    input_: capo_marketplace_agreement.types.list_agreement_cancellation_requests_input.ListAgreementCancellationRequestsInput = {
        "party_type": party_type
    }
    if agreement_id is not None:
        input_["agreement_id"] = agreement_id
    if status is not None:
        input_["status"] = status
    if agreement_type is not None:
        input_["agreement_type"] = agreement_type
    if catalog is not None:
        input_["catalog"] = catalog
    if max_results is not None:
        input_["max_results"] = max_results
    if next_token is not None:
        input_["next_token"] = next_token

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output