describe_device

describe_device(**kwargs)

Checks device-specific information, such as the device type, software version, IP addresses, and lock status.

See also: AWS API Documentation

Request Syntax

response = client.describe_device(
    managedDeviceId='string'
)

Parameters

managedDeviceId (string) --

[REQUIRED]

The ID of the device that you are checking the information of.

Return type

dict

Returns

Response Syntax

{
    'associatedWithJob': 'string',
    'deviceCapacities': [
        {
            'available': 123,
            'name': 'string',
            'total': 123,
            'unit': 'string',
            'used': 123
        },
    ],
    'deviceState': 'UNLOCKED'|'LOCKED'|'UNLOCKING',
    'deviceType': 'string',
    'lastReachedOutAt': datetime(2015, 1, 1),
    'lastUpdatedAt': datetime(2015, 1, 1),
    'managedDeviceArn': 'string',
    'managedDeviceId': 'string',
    'physicalNetworkInterfaces': [
        {
            'defaultGateway': 'string',
            'ipAddress': 'string',
            'ipAddressAssignment': 'DHCP'|'STATIC',
            'macAddress': 'string',
            'netmask': 'string',
            'physicalConnectorType': 'RJ45'|'SFP_PLUS'|'QSFP'|'RJ45_2'|'WIFI',
            'physicalNetworkInterfaceId': 'string'
        },
    ],
    'software': {
        'installState': 'string',
        'installedVersion': 'string',
        'installingVersion': 'string'
    },
    'tags': {
        'string': 'string'
    }
}

Response Structure

• (dict) --
  • associatedWithJob (string) --

    The ID of the job used when ordering the device.

  • deviceCapacities (list) --

    The hardware specifications of the device.

    • (dict) --

      The physical capacity of the Amazon Web Services Snow Family device.

      • available (integer) --

        The amount of capacity available for use on the device.

      • name (string) --

        The name of the type of capacity, such as memory.

      • total (integer) --

        The total capacity on the device.

      • unit (string) --

        The unit of measure for the type of capacity.

      • used (integer) --

        The amount of capacity used on the device.

  • deviceState (string) --

    The current state of the device.

  • deviceType (string) --

    The type of Amazon Web Services Snow Family device.

  • lastReachedOutAt (datetime) --

    When the device last contacted the Amazon Web Services Cloud. Indicates that the device is online.

  • lastUpdatedAt (datetime) --

    When the device last pushed an update to the Amazon Web Services Cloud. Indicates when the device cache was refreshed.

  • managedDeviceArn (string) --

    The Amazon Resource Name (ARN) of the device.

  • managedDeviceId (string) --

    The ID of the device that you checked the information for.

  • physicalNetworkInterfaces (list) --

    The network interfaces available on the device.

    • (dict) --

      The details about the physical network interface for the device.

      • defaultGateway (string) --

        The default gateway of the device.

      • ipAddress (string) --

        The IP address of the device.

      • ipAddressAssignment (string) --

        A value that describes whether the IP address is dynamic or persistent.

      • macAddress (string) --

        The MAC address of the device.

      • netmask (string) --

        The netmask used to divide the IP address into subnets.

      • physicalConnectorType (string) --

        The physical connector type.

      • physicalNetworkInterfaceId (string) --

        The physical network interface ID.

  • software (dict) --

    The software installed on the device.

    • installState (string) --

      The state of the software that is installed or that is being installed on the device.

    • installedVersion (string) --

      The version of the software currently installed on the device.

    • installingVersion (string) --

      The version of the software being installed on the device.

  • tags (dict) --

    Optional metadata that you assign to a resource. You can use tags to categorize a resource in different ways, such as by purpose, owner, or environment.

    • (string) --
      • (string) --

Exceptions

• SnowDeviceManagement.Client.exceptions.ThrottlingException
• SnowDeviceManagement.Client.exceptions.InternalServerException
• SnowDeviceManagement.Client.exceptions.ResourceNotFoundException
• SnowDeviceManagement.Client.exceptions.ValidationException
• SnowDeviceManagement.Client.exceptions.AccessDeniedException