AWS API Changes

2024/04/16 - AWS Outposts - 5 new api methods

Changes This release adds new APIs to allow customers to configure their Outpost capacity at order-time.

GetOutpostSupportedInstanceTypes (new)

Gets the instance types that an Outpost can support in InstanceTypeCapacity . This will generally include instance types that are not currently configured and therefore cannot be launched with the current Outpost capacity configuration.

See also: AWS API Documentation

Request Syntax

client.get_outpost_supported_instance_types(
    OutpostIdentifier='string',
    OrderId='string',
    MaxResults=123,
    NextToken='string'
)

type OutpostIdentifier

string

param OutpostIdentifier

[REQUIRED]

The ID or ARN of the Outpost.

type OrderId

string

param OrderId

[REQUIRED]

The ID for the Amazon Web Services Outposts order.

type MaxResults

integer

param MaxResults

The maximum page size.

type NextToken

string

param NextToken

The pagination token.

rtype

dict

returns

Response Syntax

{
    'InstanceTypes': [
        {
            'InstanceType': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- InstanceTypes (list) --
  
  Information about the instance types.
  - (dict) --
    
    Information about an instance type.
    - InstanceType (string) --
      
      The instance type.
- NextToken (string) --
  
  The pagination token.

CancelCapacityTask (new)

Link ¶

Cancels the capacity task.

See also: AWS API Documentation

Request Syntax

client.cancel_capacity_task(
    CapacityTaskId='string',
    OutpostIdentifier='string'
)

type CapacityTaskId

string

param CapacityTaskId

[REQUIRED]

ID of the capacity task that you want to cancel.

type OutpostIdentifier

string

param OutpostIdentifier

[REQUIRED]

ID or ARN of the Outpost associated with the capacity task that you want to cancel.

rtype

dict

returns

Response Syntax

{}

Response Structure

(dict) --

GetCapacityTask (new)

Link ¶

Gets details of the specified capacity task.

See also: AWS API Documentation

Request Syntax

client.get_capacity_task(
    CapacityTaskId='string',
    OutpostIdentifier='string'
)

type CapacityTaskId

string

param CapacityTaskId

[REQUIRED]

ID of the capacity task.

type OutpostIdentifier

string

param OutpostIdentifier

[REQUIRED]

ID or ARN of the Outpost associated with the specified capacity task.

rtype

dict

returns

Response Syntax

{
    'CapacityTaskId': 'string',
    'OutpostId': 'string',
    'OrderId': 'string',
    'RequestedInstancePools': [
        {
            'InstanceType': 'string',
            'Count': 123
        },
    ],
    'DryRun': True|False,
    'CapacityTaskStatus': 'REQUESTED'|'IN_PROGRESS'|'FAILED'|'COMPLETED'|'CANCELLED',
    'Failed': {
        'Reason': 'string',
        'Type': 'UNSUPPORTED_CAPACITY_CONFIGURATION'
    },
    'CreationDate': datetime(2015, 1, 1),
    'CompletionDate': datetime(2015, 1, 1),
    'LastModifiedDate': datetime(2015, 1, 1)
}

Response Structure

(dict) --
- CapacityTaskId (string) --
  
  ID of the capacity task.
- OutpostId (string) --
  
  ID of the Outpost associated with the specified capacity task.
- OrderId (string) --
  
  ID of the Amazon Web Services Outposts order associated with the specified capacity task.
- RequestedInstancePools (list) --
  
  List of instance pools requested in the capacity task.
  - (dict) --
    
    The instance type that you specify determines the combination of CPU, memory, storage, and networking capacity.
    - InstanceType (string) --
      
      The instance type of the hosts.
    - Count (integer) --
      
      The number of instances for the specified instance type.
- DryRun (boolean) --
  
  Performs a dry run to determine if you are above or below instance capacity.
- CapacityTaskStatus (string) --
  
  Status of the capacity task.
  
  A capacity task can have one of the following statuses:
  - REQUESTED - The capacity task was created and is awaiting the next step by Amazon Web Services Outposts.
  - IN_PROGRESS - The capacity task is running and cannot be cancelled.
  - WAITING_FOR_EVACUATION - The capacity task requires capacity to run. You must stop the recommended EC2 running instances to free up capacity for the task to run.
- Failed (dict) --
  
  Reason why the capacity task failed.
  - Reason (string) --
    
    The reason that the specified capacity task failed.
  - Type (string) --
    
    The type of failure.
- CreationDate (datetime) --
  
  The date the capacity task was created.
- CompletionDate (datetime) --
  
  The date the capacity task ran successfully.
- LastModifiedDate (datetime) --
  
  The date the capacity task was last modified.

ListCapacityTasks (new)

Link ¶

Lists the capacity tasks for your Amazon Web Services account.

Use filters to return specific results. If you specify multiple filters, the results include only the resources that match all of the specified filters. For a filter where you can specify multiple values, the results include items that match any of the values that you specify for the filter.

See also: AWS API Documentation

Request Syntax

client.list_capacity_tasks(
    OutpostIdentifierFilter='string',
    MaxResults=123,
    NextToken='string',
    CapacityTaskStatusFilter=[
        'REQUESTED'|'IN_PROGRESS'|'FAILED'|'COMPLETED'|'CANCELLED',
    ]
)

type OutpostIdentifierFilter

string

param OutpostIdentifierFilter

Filters the results by an Outpost ID or an Outpost ARN.

type MaxResults

integer

param MaxResults

The maximum page size.

type NextToken

string

param NextToken

The pagination token.

type CapacityTaskStatusFilter

list

param CapacityTaskStatusFilter

A list of statuses. For example, REQUESTED or WAITING_FOR_EVACUATION .

(string) --

rtype

dict

returns

Response Syntax

{
    'CapacityTasks': [
        {
            'CapacityTaskId': 'string',
            'OutpostId': 'string',
            'OrderId': 'string',
            'CapacityTaskStatus': 'REQUESTED'|'IN_PROGRESS'|'FAILED'|'COMPLETED'|'CANCELLED',
            'CreationDate': datetime(2015, 1, 1),
            'CompletionDate': datetime(2015, 1, 1),
            'LastModifiedDate': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- CapacityTasks (list) --
  
  Lists all the capacity tasks.
  - (dict) --
    
    The summary of the capacity task.
    - CapacityTaskId (string) --
      
      The ID of the specified capacity task.
    - OutpostId (string) --
      
      The ID of the Outpost associated with the specified capacity task.
    - OrderId (string) --
      
      The ID of the Amazon Web Services Outposts order of the host associated with the capacity task.
    - CapacityTaskStatus (string) --
      
      The status of the capacity task.
    - CreationDate (datetime) --
      
      The date that the specified capacity task was created.
    - CompletionDate (datetime) --
      
      The date that the specified capacity task successfully ran.
    - LastModifiedDate (datetime) --
      
      The date that the specified capacity was last modified.
- NextToken (string) --
  
  The pagination token.

StartCapacityTask (new)

Link ¶

Starts the specified capacity task. You can have one active capacity task for an order.

See also: AWS API Documentation

Request Syntax

client.start_capacity_task(
    OutpostIdentifier='string',
    OrderId='string',
    InstancePools=[
        {
            'InstanceType': 'string',
            'Count': 123
        },
    ],
    DryRun=True|False
)

type OutpostIdentifier

string

param OutpostIdentifier

[REQUIRED]

The ID or ARN of the Outposts associated with the specified capacity task.

type OrderId

string

param OrderId

[REQUIRED]

The ID of the Amazon Web Services Outposts order associated with the specified capacity task.

type InstancePools

list

param InstancePools

[REQUIRED]

The instance pools specified in the capacity task.

(dict) --

The instance type that you specify determines the combination of CPU, memory, storage, and networking capacity.
- InstanceType (string) -- [REQUIRED]
  
  The instance type of the hosts.
- Count (integer) -- [REQUIRED]
  
  The number of instances for the specified instance type.

type DryRun

boolean

param DryRun

You can request a dry run to determine if the instance type and instance size changes is above or below available instance capacity. Requesting a dry run does not make any changes to your plan.

rtype

dict

returns

Response Syntax

{
    'CapacityTaskId': 'string',
    'OutpostId': 'string',
    'OrderId': 'string',
    'RequestedInstancePools': [
        {
            'InstanceType': 'string',
            'Count': 123
        },
    ],
    'DryRun': True|False,
    'CapacityTaskStatus': 'REQUESTED'|'IN_PROGRESS'|'FAILED'|'COMPLETED'|'CANCELLED',
    'Failed': {
        'Reason': 'string',
        'Type': 'UNSUPPORTED_CAPACITY_CONFIGURATION'
    },
    'CreationDate': datetime(2015, 1, 1),
    'CompletionDate': datetime(2015, 1, 1),
    'LastModifiedDate': datetime(2015, 1, 1)
}

Response Structure

(dict) --
- CapacityTaskId (string) --
  
  ID of the capacity task that you want to start.
- OutpostId (string) --
  
  ID of the Outpost associated with the capacity task.
- OrderId (string) --
  
  ID of the Amazon Web Services Outposts order of the host associated with the capacity task.
- RequestedInstancePools (list) --
  
  List of the instance pools requested in the specified capacity task.
  - (dict) --
    
    The instance type that you specify determines the combination of CPU, memory, storage, and networking capacity.
    - InstanceType (string) --
      
      The instance type of the hosts.
    - Count (integer) --
      
      The number of instances for the specified instance type.
- DryRun (boolean) --
  
  Results of the dry run showing if the specified capacity task is above or below the available instance capacity.
- CapacityTaskStatus (string) --
  
  Status of the specified capacity task.
- Failed (dict) --
  
  Reason that the specified capacity task failed.
  - Reason (string) --
    
    The reason that the specified capacity task failed.
  - Type (string) --
    
    The type of failure.
- CreationDate (datetime) --
  
  Date that the specified capacity task was created.
- CompletionDate (datetime) --
  
  Date that the specified capacity task ran successfully.
- LastModifiedDate (datetime) --
  
  Date that the specified capacity task was last modified.