AWS Outposts

{'AssetTypeFilter': ['COMPUTE | STORAGE | POWERSHELF | SWITCH | NETWORKING'],
 'StatusFilter': {'INSTALLING'}}

{'Assets': {'AssetType': {'SWITCH', 'STORAGE', 'NETWORKING', 'POWERSHELF'},
            'ComputeAttributes': {'State': {'INSTALLING'}}}}

Lists the hardware assets for the specified Outpost.

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_assets(
    OutpostIdentifier='string',
    HostIdFilter=[
        'string',
    ],
    MaxResults=123,
    NextToken='string',
    StatusFilter=[
        'ACTIVE'|'RETIRING'|'ISOLATED'|'INSTALLING',
    ],
    AssetTypeFilter=[
        'COMPUTE'|'STORAGE'|'POWERSHELF'|'SWITCH'|'NETWORKING',
    ]
)

type OutpostIdentifier:

string

param OutpostIdentifier:

[REQUIRED]

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

type HostIdFilter:

list

param HostIdFilter:

Filters the results by the host ID of a Dedicated Host.

• (string) --

type MaxResults:

integer

param MaxResults:

The maximum page size.

type NextToken:

string

param NextToken:

The pagination token.

type StatusFilter:

list

param StatusFilter:

Filters the results by state.

• (string) --

type AssetTypeFilter:

list

param AssetTypeFilter:

Filters the results by asset type.

• COMPUTE - Server asset used for customer compute

• STORAGE - Server asset used by storage services

• POWERSHELF - Powershelf assets

• SWITCH - Switch assets

• NETWORKING - Asset managed by Amazon Web Services for networking purposes

• (string) --

rtype:

dict

returns:

Response Syntax

{
    'Assets': [
        {
            'AssetId': 'string',
            'RackId': 'string',
            'AssetType': 'COMPUTE'|'STORAGE'|'POWERSHELF'|'SWITCH'|'NETWORKING',
            'ComputeAttributes': {
                'HostId': 'string',
                'State': 'ACTIVE'|'ISOLATED'|'RETIRING'|'INSTALLING',
                'InstanceFamilies': [
                    'string',
                ],
                'InstanceTypeCapacities': [
                    {
                        'InstanceType': 'string',
                        'Count': 123
                    },
                ],
                'MaxVcpus': 123
            },
            'AssetLocation': {
                'RackElevation': ...
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) --

  • Assets (list) --

    Information about the hardware assets.

    • (dict) --

      Information about hardware assets.

      • AssetId (string) --

        The ID of the asset. An Outpost asset can be a single server within an Outposts rack or an Outposts server configuration.

      • 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 the Dedicated Host on the asset.

        • State (string) --

          The state.

          • ACTIVE - The asset is available and can provide capacity for new compute resources.

          • ISOLATED - The asset is undergoing maintenance and can't provide capacity for new compute resources. Existing compute resources on the asset are not affected.

          • RETIRING - The underlying hardware for the asset is degraded. Capacity for new compute resources is reduced. Amazon Web Services sends notifications for resources that must be stopped before the asset can be replaced.

          • INSTALLING - The asset is being installed and can't yet provide capacity for new compute resources.

        • InstanceFamilies (list) --

          A list of the names of instance families that are currently associated with a given asset.

          • (string) --

        • InstanceTypeCapacities (list) --

          The instance type capacities configured for this asset. This can be changed through a capacity task.

          • (dict) --

            The capacity for each instance type.

            • InstanceType (string) --

              The type of instance.

            • Count (integer) --

              The number of each instance type.

        • MaxVcpus (integer) --

          The maximum number of vCPUs possible for the specified 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.