Skip to content

list_offerings async

list_offerings(
    *,
    config_overrides: Optional[AsyncDeviceFarmClientConfig] = None,
    next_token: Optional[PaginationToken] = None,
) -> ListOfferingsResult

Returns a list of products or offerings that the user can manage through the API. Each offering record indicates the recurring price per unit and the frequency for that offering. The API returns a NotEligible error if the user is not permitted to invoke the operation. If you must be able to invoke this operation, contact [email protected].

Parameters:

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

    An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

Raises:

Examples:

To get information about device offerings The following example returns information about available device offerings.

>>> await client.list_offerings(next_token='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=')
Source code in docs_src/capo_device_farm/_services/async_device_farm.py
async def list_offerings(
    self,
    *,
    config_overrides: Optional[AsyncDeviceFarmClientConfig] = None,
    next_token: Optional[
        "capo_device_farm.types.pagination_token.PaginationToken"
    ] = None,
) -> "capo_device_farm.types.list_offerings_result.ListOfferingsResult":
    """<p>Returns a list of products or offerings that the user can manage through the API. Each offering record indicates the recurring price per unit and the frequency for that offering. The API returns a <code>NotEligible</code> error if the user is not permitted to invoke the operation. If you must be able to invoke this operation, contact <a href="mailto:[email protected]">[email protected]</a>.</p>

    Args:
        next_token: <p>An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.</p>

    Raises:
        capo_device_farm.errors.argument_exception.ArgumentException: <p>An invalid argument was specified.</p>
        capo_device_farm.errors.limit_exceeded_exception.LimitExceededException: <p>A limit was exceeded.</p>
        capo_device_farm.errors.not_eligible_exception.NotEligibleException: <p>Exception gets thrown when a user is not eligible to perform the specified transaction.</p>
        capo_device_farm.errors.not_found_exception.NotFoundException: <p>The specified entity was not found.</p>
        capo_device_farm.errors.service_account_exception.ServiceAccountException: <p>There was a problem with the service account.</p>
        capo_device_farm.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        To get information about device offerings
        The following example returns information about available device offerings.

        >>> await client.list_offerings(next_token='RW5DdDJkMWYwZjM2MzM2VHVpOHJIUXlDUXlhc2QzRGViYnc9SEXAMPLE=')
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_device_farm.types.list_offerings_request.ListOfferingsRequest]",
    ) -> AsyncOperationResponse[
        "capo_device_farm.types.list_offerings_result.ListOfferingsResult"
    ]:
        import capo_device_farm._operations.device_farm_20150623.list_offerings

        (
            output,
            http_response,
        ) = await capo_device_farm._operations.device_farm_20150623.list_offerings.async_list_offerings(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListOfferings")
    )
    input_: capo_device_farm.types.list_offerings_request.ListOfferingsRequest = {}
    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