dynatrace.CustomDevice
Explore with Pulumi AI
This resource requires the API token scopes Read entities (
entities.read
) and Write entities (entities.write
)
Dynatrace Documentation
- Monitored entities API - https://www.dynatrace.com/support/help/dynatrace-api/environment-api/entity-v2
Resource Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as dynatrace from "@pulumiverse/dynatrace";
const _name_ = new dynatrace.CustomDevice("#name#", {
customDeviceId: "customDeviceId",
displayName: "customDevicename",
});
import pulumi
import pulumiverse_dynatrace as dynatrace
_name_ = dynatrace.CustomDevice("#name#",
custom_device_id="customDeviceId",
display_name="customDevicename")
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumiverse/pulumi-dynatrace/sdk/go/dynatrace"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := dynatrace.NewCustomDevice(ctx, "#name#", &dynatrace.CustomDeviceArgs{
CustomDeviceId: pulumi.String("customDeviceId"),
DisplayName: pulumi.String("customDevicename"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Dynatrace = Pulumiverse.Dynatrace;
return await Deployment.RunAsync(() =>
{
var _name_ = new Dynatrace.CustomDevice("#name#", new()
{
CustomDeviceId = "customDeviceId",
DisplayName = "customDevicename",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.dynatrace.CustomDevice;
import com.pulumi.dynatrace.CustomDeviceArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var _name_ = new CustomDevice("#name#", CustomDeviceArgs.builder()
.customDeviceId("customDeviceId")
.displayName("customDevicename")
.build());
}
}
resources:
'#name#':
type: dynatrace:CustomDevice
properties:
customDeviceId: customDeviceId
displayName: customDevicename
Create CustomDevice Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new CustomDevice(name: string, args: CustomDeviceArgs, opts?: CustomResourceOptions);
@overload
def CustomDevice(resource_name: str,
args: CustomDeviceArgs,
opts: Optional[ResourceOptions] = None)
@overload
def CustomDevice(resource_name: str,
opts: Optional[ResourceOptions] = None,
display_name: Optional[str] = None,
config_url: Optional[str] = None,
custom_device_id: Optional[str] = None,
dns_names: Optional[Sequence[str]] = None,
favicon_url: Optional[str] = None,
group: Optional[str] = None,
ip_addresses: Optional[Sequence[str]] = None,
listen_ports: Optional[Sequence[int]] = None,
properties: Optional[Mapping[str, str]] = None,
props: Optional[str] = None,
type: Optional[str] = None,
ui_based: Optional[bool] = None)
func NewCustomDevice(ctx *Context, name string, args CustomDeviceArgs, opts ...ResourceOption) (*CustomDevice, error)
public CustomDevice(string name, CustomDeviceArgs args, CustomResourceOptions? opts = null)
public CustomDevice(String name, CustomDeviceArgs args)
public CustomDevice(String name, CustomDeviceArgs args, CustomResourceOptions options)
type: dynatrace:CustomDevice
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args CustomDeviceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args CustomDeviceArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args CustomDeviceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args CustomDeviceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args CustomDeviceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var customDeviceResource = new Dynatrace.CustomDevice("customDeviceResource", new()
{
DisplayName = "string",
ConfigUrl = "string",
CustomDeviceId = "string",
DnsNames = new[]
{
"string",
},
FaviconUrl = "string",
Group = "string",
IpAddresses = new[]
{
"string",
},
ListenPorts = new[]
{
0,
},
Props = "string",
Type = "string",
UiBased = false,
});
example, err := dynatrace.NewCustomDevice(ctx, "customDeviceResource", &dynatrace.CustomDeviceArgs{
DisplayName: pulumi.String("string"),
ConfigUrl: pulumi.String("string"),
CustomDeviceId: pulumi.String("string"),
DnsNames: pulumi.StringArray{
pulumi.String("string"),
},
FaviconUrl: pulumi.String("string"),
Group: pulumi.String("string"),
IpAddresses: pulumi.StringArray{
pulumi.String("string"),
},
ListenPorts: pulumi.IntArray{
pulumi.Int(0),
},
Props: pulumi.String("string"),
Type: pulumi.String("string"),
UiBased: pulumi.Bool(false),
})
var customDeviceResource = new CustomDevice("customDeviceResource", CustomDeviceArgs.builder()
.displayName("string")
.configUrl("string")
.customDeviceId("string")
.dnsNames("string")
.faviconUrl("string")
.group("string")
.ipAddresses("string")
.listenPorts(0)
.props("string")
.type("string")
.uiBased(false)
.build());
custom_device_resource = dynatrace.CustomDevice("customDeviceResource",
display_name="string",
config_url="string",
custom_device_id="string",
dns_names=["string"],
favicon_url="string",
group="string",
ip_addresses=["string"],
listen_ports=[0],
props="string",
type="string",
ui_based=False)
const customDeviceResource = new dynatrace.CustomDevice("customDeviceResource", {
displayName: "string",
configUrl: "string",
customDeviceId: "string",
dnsNames: ["string"],
faviconUrl: "string",
group: "string",
ipAddresses: ["string"],
listenPorts: [0],
props: "string",
type: "string",
uiBased: false,
});
type: dynatrace:CustomDevice
properties:
configUrl: string
customDeviceId: string
displayName: string
dnsNames:
- string
faviconUrl: string
group: string
ipAddresses:
- string
listenPorts:
- 0
props: string
type: string
uiBased: false
CustomDevice Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The CustomDevice resource accepts the following input properties:
- Display
Name string - The name of the custom device, displayed in the UI.
- Config
Url string - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- Custom
Device stringId - Dns
Names List<string> - The list of DNS names related to the custom device.
- Favicon
Url string - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- Group string
- User defined group of entity. Changing the group requires a new custom device to be created.
- Ip
Addresses List<string> - The list of IP addresses that belong to the custom device.
- Listen
Ports List<int> - The list of ports the custom devices listens to.
- Properties Dictionary<string, string>
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Props string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Type string
- The technology type definition of the custom device.
- Ui
Based bool - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- Display
Name string - The name of the custom device, displayed in the UI.
- Config
Url string - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- Custom
Device stringId - Dns
Names []string - The list of DNS names related to the custom device.
- Favicon
Url string - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- Group string
- User defined group of entity. Changing the group requires a new custom device to be created.
- Ip
Addresses []string - The list of IP addresses that belong to the custom device.
- Listen
Ports []int - The list of ports the custom devices listens to.
- Properties map[string]string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Props string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Type string
- The technology type definition of the custom device.
- Ui
Based bool - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- display
Name String - The name of the custom device, displayed in the UI.
- config
Url String - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom
Device StringId - dns
Names List<String> - The list of DNS names related to the custom device.
- favicon
Url String - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group String
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip
Addresses List<String> - The list of IP addresses that belong to the custom device.
- listen
Ports List<Integer> - The list of ports the custom devices listens to.
- properties Map<String,String>
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props String
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type String
- The technology type definition of the custom device.
- ui
Based Boolean - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- display
Name string - The name of the custom device, displayed in the UI.
- config
Url string - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom
Device stringId - dns
Names string[] - The list of DNS names related to the custom device.
- favicon
Url string - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group string
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip
Addresses string[] - The list of IP addresses that belong to the custom device.
- listen
Ports number[] - The list of ports the custom devices listens to.
- properties {[key: string]: string}
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type string
- The technology type definition of the custom device.
- ui
Based boolean - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- display_
name str - The name of the custom device, displayed in the UI.
- config_
url str - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom_
device_ strid - dns_
names Sequence[str] - The list of DNS names related to the custom device.
- favicon_
url str - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group str
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip_
addresses Sequence[str] - The list of IP addresses that belong to the custom device.
- listen_
ports Sequence[int] - The list of ports the custom devices listens to.
- properties Mapping[str, str]
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props str
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type str
- The technology type definition of the custom device.
- ui_
based bool - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- display
Name String - The name of the custom device, displayed in the UI.
- config
Url String - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom
Device StringId - dns
Names List<String> - The list of DNS names related to the custom device.
- favicon
Url String - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group String
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip
Addresses List<String> - The list of IP addresses that belong to the custom device.
- listen
Ports List<Number> - The list of ports the custom devices listens to.
- properties Map<String>
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props String
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type String
- The technology type definition of the custom device.
- ui
Based Boolean - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
Outputs
All input properties are implicitly available as output properties. Additionally, the CustomDevice resource produces the following output properties:
Look up Existing CustomDevice Resource
Get an existing CustomDevice resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: CustomDeviceState, opts?: CustomResourceOptions): CustomDevice
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
config_url: Optional[str] = None,
custom_device_id: Optional[str] = None,
display_name: Optional[str] = None,
dns_names: Optional[Sequence[str]] = None,
entity_id: Optional[str] = None,
favicon_url: Optional[str] = None,
group: Optional[str] = None,
ip_addresses: Optional[Sequence[str]] = None,
listen_ports: Optional[Sequence[int]] = None,
properties: Optional[Mapping[str, str]] = None,
props: Optional[str] = None,
type: Optional[str] = None,
ui_based: Optional[bool] = None) -> CustomDevice
func GetCustomDevice(ctx *Context, name string, id IDInput, state *CustomDeviceState, opts ...ResourceOption) (*CustomDevice, error)
public static CustomDevice Get(string name, Input<string> id, CustomDeviceState? state, CustomResourceOptions? opts = null)
public static CustomDevice get(String name, Output<String> id, CustomDeviceState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Config
Url string - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- Custom
Device stringId - Display
Name string - The name of the custom device, displayed in the UI.
- Dns
Names List<string> - The list of DNS names related to the custom device.
- Entity
Id string - The Dynatrace EntityID of this resource. If you need to refer to this custom device within other resources you want to use this ID
- Favicon
Url string - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- Group string
- User defined group of entity. Changing the group requires a new custom device to be created.
- Ip
Addresses List<string> - The list of IP addresses that belong to the custom device.
- Listen
Ports List<int> - The list of ports the custom devices listens to.
- Properties Dictionary<string, string>
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Props string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Type string
- The technology type definition of the custom device.
- Ui
Based bool - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- Config
Url string - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- Custom
Device stringId - Display
Name string - The name of the custom device, displayed in the UI.
- Dns
Names []string - The list of DNS names related to the custom device.
- Entity
Id string - The Dynatrace EntityID of this resource. If you need to refer to this custom device within other resources you want to use this ID
- Favicon
Url string - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- Group string
- User defined group of entity. Changing the group requires a new custom device to be created.
- Ip
Addresses []string - The list of IP addresses that belong to the custom device.
- Listen
Ports []int - The list of ports the custom devices listens to.
- Properties map[string]string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Props string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- Type string
- The technology type definition of the custom device.
- Ui
Based bool - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- config
Url String - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom
Device StringId - display
Name String - The name of the custom device, displayed in the UI.
- dns
Names List<String> - The list of DNS names related to the custom device.
- entity
Id String - The Dynatrace EntityID of this resource. If you need to refer to this custom device within other resources you want to use this ID
- favicon
Url String - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group String
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip
Addresses List<String> - The list of IP addresses that belong to the custom device.
- listen
Ports List<Integer> - The list of ports the custom devices listens to.
- properties Map<String,String>
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props String
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type String
- The technology type definition of the custom device.
- ui
Based Boolean - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- config
Url string - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom
Device stringId - display
Name string - The name of the custom device, displayed in the UI.
- dns
Names string[] - The list of DNS names related to the custom device.
- entity
Id string - The Dynatrace EntityID of this resource. If you need to refer to this custom device within other resources you want to use this ID
- favicon
Url string - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group string
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip
Addresses string[] - The list of IP addresses that belong to the custom device.
- listen
Ports number[] - The list of ports the custom devices listens to.
- properties {[key: string]: string}
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props string
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type string
- The technology type definition of the custom device.
- ui
Based boolean - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- config_
url str - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom_
device_ strid - display_
name str - The name of the custom device, displayed in the UI.
- dns_
names Sequence[str] - The list of DNS names related to the custom device.
- entity_
id str - The Dynatrace EntityID of this resource. If you need to refer to this custom device within other resources you want to use this ID
- favicon_
url str - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group str
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip_
addresses Sequence[str] - The list of IP addresses that belong to the custom device.
- listen_
ports Sequence[int] - The list of ports the custom devices listens to.
- properties Mapping[str, str]
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props str
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type str
- The technology type definition of the custom device.
- ui_
based bool - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
- config
Url String - The URL of a configuration web page for the custom device, such as a login page for a firewall or router.
- custom
Device StringId - display
Name String - The name of the custom device, displayed in the UI.
- dns
Names List<String> - The list of DNS names related to the custom device.
- entity
Id String - The Dynatrace EntityID of this resource. If you need to refer to this custom device within other resources you want to use this ID
- favicon
Url String - The icon to be displayed for your custom component within Smartscape. Provide the full URL of the icon file.
- group String
- User defined group of entity. Changing the group requires a new custom device to be created.
- ip
Addresses List<String> - The list of IP addresses that belong to the custom device.
- listen
Ports List<Number> - The list of ports the custom devices listens to.
- properties Map<String>
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- props String
- The list of key-value pair properties that will be shown beneath the infographics of your custom device.
- type String
- The technology type definition of the custom device.
- ui
Based Boolean - If
true
the custom device will be handled as if it was created via UI. It will be refreshed automatically and won't age out. This attribute is taken into consideration when creating the custom device. Changing it afterwards won't have an effect.
Package Details
- Repository
- dynatrace pulumiverse/pulumi-dynatrace
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
dynatrace
Terraform Provider.