purchase_offering async ¶

async def purchase_offering(
    self,
    offering_id: "capo_medialive.types.__string.__string",
    *,
    config_overrides: Optional[AsyncMediaLiveClientConfig] = None,
    count: Optional["capo_medialive.types.__integer_min1.__integerMin1"] = None,
    name: Optional["capo_medialive.types.__string.__string"] = None,
    renewal_settings: Optional[
        "capo_medialive.types.renewal_settings.RenewalSettings"
    ] = None,
    request_id: Optional["capo_medialive.types.__string.__string"] = None,
    start: Optional["capo_medialive.types.__string.__string"] = None,
    tags: Optional["capo_medialive.types.tags.Tags"] = None,
) -> "capo_medialive.types.purchase_offering_response.PurchaseOfferingResponse":
    """Purchase an offering and create a reservation.

    Args:
        count: Number of resources
        name: Name for the new reservation
        offering_id: Offering to purchase, e.g. '87654321'
        renewal_settings: Renewal settings for the reservation
        request_id: Unique request ID to be specified. This is needed to prevent retries from creating multiple resources.
        start: Requested reservation start time (UTC) in ISO-8601 format. The specified time must be between the first day of the current month and one year from now. If no value is given, the default is now.
        tags: A collection of key-value pairs

    Raises:
        capo_medialive.errors.bad_gateway_exception.BadGatewayException: Placeholder documentation for BadGatewayException
        capo_medialive.errors.bad_request_exception.BadRequestException: Placeholder documentation for BadRequestException
        capo_medialive.errors.conflict_exception.ConflictException: Placeholder documentation for ConflictException
        capo_medialive.errors.forbidden_exception.ForbiddenException: Placeholder documentation for ForbiddenException
        capo_medialive.errors.gateway_timeout_exception.GatewayTimeoutException: Placeholder documentation for GatewayTimeoutException
        capo_medialive.errors.internal_server_error_exception.InternalServerErrorException: Placeholder documentation for InternalServerErrorException
        capo_medialive.errors.not_found_exception.NotFoundException: Placeholder documentation for NotFoundException
        capo_medialive.errors.too_many_requests_exception.TooManyRequestsException: Placeholder documentation for TooManyRequestsException
        capo_medialive.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_medialive.types.purchase_offering_request.PurchaseOfferingRequest]",
    ) -> AsyncOperationResponse[
        "capo_medialive.types.purchase_offering_response.PurchaseOfferingResponse"
    ]:
        import capo_medialive._operations.media_live.purchase_offering

        (
            output,
            http_response,
        ) = await capo_medialive._operations.media_live.purchase_offering.async_purchase_offering(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("PurchaseOffering")
    )
    input_: capo_medialive.types.purchase_offering_request.PurchaseOfferingRequest = {
        "offering_id": offering_id
    }
    if count is not None:
        input_["count"] = count
    if name is not None:
        input_["name"] = name
    if renewal_settings is not None:
        input_["renewal_settings"] = renewal_settings
    if request_id is None:
        request_id = str(uuid.uuid4())
    input_["request_id"] = request_id
    if start is not None:
        input_["start"] = start
    if tags is not None:
        input_["tags"] = tags

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