EC2 / Client / delete_queued_reserved_instances

delete_queued_reserved_instances#

EC2.Client.delete_queued_reserved_instances(**kwargs)#

Deletes the queued purchases for the specified Reserved Instances.

Request Syntax

response = client.delete_queued_reserved_instances(
    DryRun=True|False,
    ReservedInstancesIds=[
        'string',
    ]
)

Parameters:

DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
ReservedInstancesIds (list) –
[REQUIRED]

The IDs of the Reserved Instances.
- (string) –

Return type:

dict

Returns:

Response Syntax

{
    'SuccessfulQueuedPurchaseDeletions': [
        {
            'ReservedInstancesId': 'string'
        },
    ],
    'FailedQueuedPurchaseDeletions': [
        {
            'Error': {
                'Code': 'reserved-instances-id-invalid'|'reserved-instances-not-in-queued-state'|'unexpected-error',
                'Message': 'string'
            },
            'ReservedInstancesId': 'string'
        },
    ]
}

Response Structure

(dict) –
- SuccessfulQueuedPurchaseDeletions (list) –
  
  Information about the queued purchases that were successfully deleted.
  - (dict) –
    
    Describes a Reserved Instance whose queued purchase was successfully deleted.
    - ReservedInstancesId (string) –
      
      The ID of the Reserved Instance.
- FailedQueuedPurchaseDeletions (list) –
  
  Information about the queued purchases that could not be deleted.
  - (dict) –
    
    Describes a Reserved Instance whose queued purchase was not deleted.
    - Error (dict) –
      
      The error.
      - Code (string) –
        
        The error code.
      - Message (string) –
        
        The error message.
    - ReservedInstancesId (string) –
      
      The ID of the Reserved Instance.