NetworkManager / Client / update_device

update_device#

NetworkManager.Client.update_device(**kwargs)#

Updates the details for an existing device. To remove information for any of the parameters, specify an empty string.

See also: AWS API Documentation

Request Syntax

response = client.update_device(
    GlobalNetworkId='string',
    DeviceId='string',
    AWSLocation={
        'Zone': 'string',
        'SubnetArn': 'string'
    },
    Description='string',
    Type='string',
    Vendor='string',
    Model='string',
    SerialNumber='string',
    Location={
        'Address': 'string',
        'Latitude': 'string',
        'Longitude': 'string'
    },
    SiteId='string'
)
Parameters:
  • GlobalNetworkId (string) –

    [REQUIRED]

    The ID of the global network.

  • DeviceId (string) –

    [REQUIRED]

    The ID of the device.

  • AWSLocation (dict) –

    The Amazon Web Services location of the device, if applicable. For an on-premises device, you can omit this parameter.

    • Zone (string) –

      The Zone that the device is located in. Specify the ID of an Availability Zone, Local Zone, Wavelength Zone, or an Outpost.

    • SubnetArn (string) –

      The Amazon Resource Name (ARN) of the subnet that the device is located in.

  • Description (string) –

    A description of the device.

    Constraints: Maximum length of 256 characters.

  • Type (string) – The type of the device.

  • Vendor (string) –

    The vendor of the device.

    Constraints: Maximum length of 128 characters.

  • Model (string) –

    The model of the device.

    Constraints: Maximum length of 128 characters.

  • SerialNumber (string) –

    The serial number of the device.

    Constraints: Maximum length of 128 characters.

  • Location (dict) –

    Describes a location.

    • Address (string) –

      The physical address.

    • Latitude (string) –

      The latitude.

    • Longitude (string) –

      The longitude.

  • SiteId (string) – The ID of the site.

Return type:

dict

Returns:

Response Syntax

{
    'Device': {
        'DeviceId': 'string',
        'DeviceArn': 'string',
        'GlobalNetworkId': 'string',
        'AWSLocation': {
            'Zone': 'string',
            'SubnetArn': 'string'
        },
        'Description': 'string',
        'Type': 'string',
        'Vendor': 'string',
        'Model': 'string',
        'SerialNumber': 'string',
        'Location': {
            'Address': 'string',
            'Latitude': 'string',
            'Longitude': 'string'
        },
        'SiteId': 'string',
        'CreatedAt': datetime(2015, 1, 1),
        'State': 'PENDING'|'AVAILABLE'|'DELETING'|'UPDATING',
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) –

    • Device (dict) –

      Information about the device.

      • DeviceId (string) –

        The ID of the device.

      • DeviceArn (string) –

        The Amazon Resource Name (ARN) of the device.

      • GlobalNetworkId (string) –

        The ID of the global network.

      • AWSLocation (dict) –

        The Amazon Web Services location of the device.

        • Zone (string) –

          The Zone that the device is located in. Specify the ID of an Availability Zone, Local Zone, Wavelength Zone, or an Outpost.

        • SubnetArn (string) –

          The Amazon Resource Name (ARN) of the subnet that the device is located in.

      • Description (string) –

        The description of the device.

      • Type (string) –

        The device type.

      • Vendor (string) –

        The device vendor.

      • Model (string) –

        The device model.

      • SerialNumber (string) –

        The device serial number.

      • Location (dict) –

        The site location.

        • Address (string) –

          The physical address.

        • Latitude (string) –

          The latitude.

        • Longitude (string) –

          The longitude.

      • SiteId (string) –

        The site ID.

      • CreatedAt (datetime) –

        The date and time that the site was created.

      • State (string) –

        The device state.

      • Tags (list) –

        The tags for the device.

        • (dict) –

          Describes a tag.

          • Key (string) –

            The tag key.

            Constraints: Maximum length of 128 characters.

          • Value (string) –

            The tag value.

            Constraints: Maximum length of 256 characters.

Exceptions