MediaConnect / Client / purchase_offering

purchase_offering#

MediaConnect.Client.purchase_offering(**kwargs)#

Submits a request to purchase an offering. If you already have an active reservation, you can’t purchase another offering.

See also: AWS API Documentation

Request Syntax

response = client.purchase_offering(
    OfferingArn='string',
    ReservationName='string',
    Start='string'
)
Parameters:
  • OfferingArn (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the offering.

  • ReservationName (string) –

    [REQUIRED]

    The name that you want to use for the reservation.

  • Start (string) –

    [REQUIRED]

    The date and time that you want the reservation to begin, in Coordinated Universal Time (UTC).

    You can specify any date and time between 12:00am on the first day of the current month to the current time on today’s date, inclusive. Specify the start in a 24-hour notation. Use the following format: YYYY-MM-DDTHH:mm:SSZ, where T and Z are literal characters. For example, to specify 11:30pm on March 5, 2020, enter 2020-03-05T23:30:00Z.

Return type:

dict

Returns:

Response Syntax

{
    'Reservation': {
        'CurrencyCode': 'string',
        'Duration': 123,
        'DurationUnits': 'MONTHS',
        'End': 'string',
        'OfferingArn': 'string',
        'OfferingDescription': 'string',
        'PricePerUnit': 'string',
        'PriceUnits': 'HOURLY',
        'ReservationArn': 'string',
        'ReservationName': 'string',
        'ReservationState': 'ACTIVE'|'EXPIRED'|'PROCESSING'|'CANCELED',
        'ResourceSpecification': {
            'ReservedBitrate': 123,
            'ResourceType': 'Mbps_Outbound_Bandwidth'
        },
        'Start': 'string'
    }
}

Response Structure

  • (dict) –

    • Reservation (dict) –

      The details of the reservation that you just created when you purchased the offering.

      • CurrencyCode (string) –

        The type of currency that is used for billing. The currencyCode used for your reservation is US dollars.

      • Duration (integer) –

        The length of time that this reservation is active. MediaConnect defines this value in the offering.

      • DurationUnits (string) –

        The unit of measurement for the duration of the reservation. MediaConnect defines this value in the offering.

      • End (string) –

        The day and time that this reservation expires. This value is calculated based on the start date and time that you set and the offering’s duration.

      • OfferingArn (string) –

        The Amazon Resource Name (ARN) that MediaConnect assigns to the offering.

      • OfferingDescription (string) –

        A description of the offering. MediaConnect defines this value in the offering.

      • PricePerUnit (string) –

        The cost of a single unit. This value, in combination with priceUnits, makes up the rate. MediaConnect defines this value in the offering.

      • PriceUnits (string) –

        The unit of measurement that is used for billing. This value, in combination with pricePerUnit, makes up the rate. MediaConnect defines this value in the offering.

      • ReservationArn (string) –

        The Amazon Resource Name (ARN) that MediaConnect assigns to the reservation when you purchase an offering.

      • ReservationName (string) –

        The name that you assigned to the reservation when you purchased the offering.

      • ReservationState (string) –

        The status of your reservation.

      • ResourceSpecification (dict) –

        A definition of the amount of outbound bandwidth that you would be reserving if you purchase the offering. MediaConnect defines the values that make up the resourceSpecification in the offering.

        • ReservedBitrate (integer) –

          The amount of outbound bandwidth that is discounted in the offering.

        • ResourceType (string) –

          The type of resource and the unit that is being billed for.

      • Start (string) –

        The day and time that the reservation becomes active. You set this value when you purchase the offering.

Exceptions

  • MediaConnect.Client.exceptions.BadRequestException

  • MediaConnect.Client.exceptions.TooManyRequestsException

  • MediaConnect.Client.exceptions.InternalServerErrorException

  • MediaConnect.Client.exceptions.ForbiddenException

  • MediaConnect.Client.exceptions.NotFoundException

  • MediaConnect.Client.exceptions.ServiceUnavailableException