Skip to content

Creates a new device in a global network

Description

Creates a new device in a global network. If you specify both a site ID and a location, the location of the site is used for visualization in the Network Manager console.

Usage

networkmanager_create_device(GlobalNetworkId, AWSLocation, Description,
  Type, Vendor, Model, SerialNumber, Location, SiteId, Tags)

Arguments

  • GlobalNetworkId

    [required] The ID of the global network.

  • AWSLocation

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

  • Description

    A description of the device.

    Constraints: Maximum length of 256 characters.

  • Type

    The type of the device.

  • Vendor

    The vendor of the device.

    Constraints: Maximum length of 128 characters.

  • Model

    The model of the device.

    Constraints: Maximum length of 128 characters.

  • SerialNumber

    The serial number of the device.

    Constraints: Maximum length of 128 characters.

  • Location

    The location of the device.

  • SiteId

    The ID of the site.

  • Tags

    The tags to apply to the resource during creation.

Value

A list with the following syntax:

list(
  Device = list(
    DeviceId = "string",
    DeviceArn = "string",
    GlobalNetworkId = "string",
    AWSLocation = list(
      Zone = "string",
      SubnetArn = "string"
    ),
    Description = "string",
    Type = "string",
    Vendor = "string",
    Model = "string",
    SerialNumber = "string",
    Location = list(
      Address = "string",
      Latitude = "string",
      Longitude = "string"
    ),
    SiteId = "string",
    CreatedAt = as.POSIXct(
      "2015-01-01"
    ),
    State = "PENDING"|"AVAILABLE"|"DELETING"|"UPDATING",
    Tags = list(
      list(
        Key = "string",
        Value = "string"
      )
    )
  )
)

Request syntax

svc$create_device(
  GlobalNetworkId = "string",
  AWSLocation = list(
    Zone = "string",
    SubnetArn = "string"
  ),
  Description = "string",
  Type = "string",
  Vendor = "string",
  Model = "string",
  SerialNumber = "string",
  Location = list(
    Address = "string",
    Latitude = "string",
    Longitude = "string"
  ),
  SiteId = "string",
  Tags = list(
    list(
      Key = "string",
      Value = "string"
    )
  )
)