AWS Outposts

2022/06/20 - AWS Outposts - 1 updated api methods

Changes  This release adds the AssetLocation structure to the ListAssets response. AssetLocation includes the RackElevation for an Asset.

ListAssets (updated) Link ΒΆ
Changes (response)
{'Assets': {'AssetLocation': {'RackElevation': 'float'}}}

Lists the hardware assets in an Outpost. If you are using Dedicated Hosts on Amazon Web Services Outposts, you can filter your request by host ID to return a list of hardware assets that allocate resources for Dedicated Hosts.

See also: AWS API Documentation

Request Syntax

client.list_assets(
    OutpostIdentifier='string',
    HostIdFilter=[
        'string',
    ],
    MaxResults=123,
    NextToken='string'
)
type OutpostIdentifier:

string

param OutpostIdentifier:

[REQUIRED]

The ID or the Amazon Resource Name (ARN) of the Outpost.

type HostIdFilter:

list

param HostIdFilter:

A filter for the host ID of Dedicated Hosts on the Outpost.

Filter values are case sensitive. If you specify multiple values for a filter, the values are joined with an OR, and the request returns all results that match any of the specified values.

  • (string) --

type MaxResults:

integer

param MaxResults:

The maximum page size.

type NextToken:

string

param NextToken:

The pagination token.

rtype:

dict

returns:

Response Syntax

{
    'Assets': [
        {
            'AssetId': 'string',
            'RackId': 'string',
            'AssetType': 'COMPUTE',
            'ComputeAttributes': {
                'HostId': 'string'
            },
            'AssetLocation': {
                'RackElevation': ...
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Assets (list) --

      Information about hardware assets.

      • (dict) --

        Information about hardware assets.

        • AssetId (string) --

          The ID of the asset.

        • RackId (string) --

          The rack ID of the asset.

        • AssetType (string) --

          The type of the asset.

        • ComputeAttributes (dict) --

          Information about compute hardware assets.

          • HostId (string) --

            The host ID of any Dedicated Hosts on the asset.

        • AssetLocation (dict) --

          The position of an asset in a rack.

          • RackElevation (float) --

            The position of an asset in a rack measured in rack units.

    • NextToken (string) --

      The pagination token.