provision_device

provision_device(**kwargs)

Creates a device and returns a configuration archive. The configuration archive is a ZIP file that contains a provisioning certificate that is valid for 5 minutes. Name the configuration archive certificates-omni_device-name.zip and transfer it to the device within 5 minutes. Use the included USB storage device and connect it to the USB 3.0 port next to the HDMI output.

See also: AWS API Documentation

Request Syntax

response = client.provision_device(
    Description='string',
    Name='string',
    NetworkingConfiguration={
        'Ethernet0': {
            'ConnectionType': 'STATIC_IP'|'DHCP',
            'StaticIpConnectionInfo': {
                'DefaultGateway': 'string',
                'Dns': [
                    'string',
                ],
                'IpAddress': 'string',
                'Mask': 'string'
            }
        },
        'Ethernet1': {
            'ConnectionType': 'STATIC_IP'|'DHCP',
            'StaticIpConnectionInfo': {
                'DefaultGateway': 'string',
                'Dns': [
                    'string',
                ],
                'IpAddress': 'string',
                'Mask': 'string'
            }
        },
        'Ntp': {
            'NtpServers': [
                'string',
            ]
        }
    },
    Tags={
        'string': 'string'
    }
)

Parameters

• Description (string) -- A description for the device.
• Name (string) --

  [REQUIRED]

  A name for the device.

• NetworkingConfiguration (dict) --

  A networking configuration for the device.

  • Ethernet0 (dict) --

    Settings for Ethernet port 0.

    • ConnectionType (string) -- [REQUIRED]

      How the device gets an IP address.

    • StaticIpConnectionInfo (dict) --

      Network configuration for a static IP connection.

      • DefaultGateway (string) -- [REQUIRED]

        The connection's default gateway.

      • Dns (list) -- [REQUIRED]

        The connection's DNS address.

        • (string) --
      • IpAddress (string) -- [REQUIRED]

        The connection's IP address.

      • Mask (string) -- [REQUIRED]

        The connection's DNS mask.

  • Ethernet1 (dict) --

    Settings for Ethernet port 1.

    • ConnectionType (string) -- [REQUIRED]

      How the device gets an IP address.

    • StaticIpConnectionInfo (dict) --

      Network configuration for a static IP connection.

      • DefaultGateway (string) -- [REQUIRED]

        The connection's default gateway.

      • Dns (list) -- [REQUIRED]

        The connection's DNS address.

        • (string) --
      • IpAddress (string) -- [REQUIRED]

        The connection's IP address.

      • Mask (string) -- [REQUIRED]

        The connection's DNS mask.

  • Ntp (dict) --

    Network time protocol (NTP) server settings.

    • NtpServers (list) -- [REQUIRED]

      NTP servers to use, in order of preference.

      • (string) --
• Tags (dict) --

  Tags for the device.

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

Return type

dict

Returns

Response Syntax

{
    'Arn': 'string',
    'Certificates': b'bytes',
    'DeviceId': 'string',
    'IotThingName': 'string',
    'Status': 'AWAITING_PROVISIONING'|'PENDING'|'SUCCEEDED'|'FAILED'|'ERROR'|'DELETING'
}

Response Structure

• (dict) --

  • Arn (string) --

    The device's ARN.

  • Certificates (bytes) --

    The device's configuration bundle.

  • DeviceId (string) --

    The device's ID.

  • IotThingName (string) --

    The device's IoT thing name.

  • Status (string) --

    The device's status.

Exceptions

• Panorama.Client.exceptions.ConflictException
• Panorama.Client.exceptions.ValidationException
• Panorama.Client.exceptions.AccessDeniedException
• Panorama.Client.exceptions.ServiceQuotaExceededException
• Panorama.Client.exceptions.InternalServerException