1. Packages
  2. Azure Native v2
  3. API Docs
  4. databoxedge
  5. getIoTRole
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi

azure-native-v2.databoxedge.getIoTRole

Explore with Pulumi AI

These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi

Gets a specific role by name. Azure REST API version: 2022-03-01.

Using getIoTRole

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getIoTRole(args: GetIoTRoleArgs, opts?: InvokeOptions): Promise<GetIoTRoleResult>
function getIoTRoleOutput(args: GetIoTRoleOutputArgs, opts?: InvokeOptions): Output<GetIoTRoleResult>
Copy
def get_io_t_role(device_name: Optional[str] = None,
                  name: Optional[str] = None,
                  resource_group_name: Optional[str] = None,
                  opts: Optional[InvokeOptions] = None) -> GetIoTRoleResult
def get_io_t_role_output(device_name: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  resource_group_name: Optional[pulumi.Input[str]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetIoTRoleResult]
Copy
func LookupIoTRole(ctx *Context, args *LookupIoTRoleArgs, opts ...InvokeOption) (*LookupIoTRoleResult, error)
func LookupIoTRoleOutput(ctx *Context, args *LookupIoTRoleOutputArgs, opts ...InvokeOption) LookupIoTRoleResultOutput
Copy

> Note: This function is named LookupIoTRole in the Go SDK.

public static class GetIoTRole 
{
    public static Task<GetIoTRoleResult> InvokeAsync(GetIoTRoleArgs args, InvokeOptions? opts = null)
    public static Output<GetIoTRoleResult> Invoke(GetIoTRoleInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetIoTRoleResult> getIoTRole(GetIoTRoleArgs args, InvokeOptions options)
public static Output<GetIoTRoleResult> getIoTRole(GetIoTRoleArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: azure-native:databoxedge:getIoTRole
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

DeviceName
This property is required.
Changes to this property will trigger replacement.
string
The device name.
Name
This property is required.
Changes to this property will trigger replacement.
string
The role name.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The resource group name.
DeviceName
This property is required.
Changes to this property will trigger replacement.
string
The device name.
Name
This property is required.
Changes to this property will trigger replacement.
string
The role name.
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The resource group name.
deviceName
This property is required.
Changes to this property will trigger replacement.
String
The device name.
name
This property is required.
Changes to this property will trigger replacement.
String
The role name.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The resource group name.
deviceName
This property is required.
Changes to this property will trigger replacement.
string
The device name.
name
This property is required.
Changes to this property will trigger replacement.
string
The role name.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The resource group name.
device_name
This property is required.
Changes to this property will trigger replacement.
str
The device name.
name
This property is required.
Changes to this property will trigger replacement.
str
The role name.
resource_group_name
This property is required.
Changes to this property will trigger replacement.
str
The resource group name.
deviceName
This property is required.
Changes to this property will trigger replacement.
String
The device name.
name
This property is required.
Changes to this property will trigger replacement.
String
The role name.
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The resource group name.

getIoTRole Result

The following output properties are available:

HostPlatform string
Host OS supported by the IoT role.
HostPlatformType string
Platform where the Iot runtime is hosted.
Id string
The path ID that uniquely identifies the object.
IoTDeviceDetails Pulumi.AzureNative.DataBoxEdge.Outputs.IoTDeviceInfoResponse
IoT device metadata to which data box edge device needs to be connected.
IoTEdgeDeviceDetails Pulumi.AzureNative.DataBoxEdge.Outputs.IoTDeviceInfoResponse
IoT edge device to which the IoT role needs to be configured.
Name string
The object name.
RoleStatus string
Role status.
SystemData Pulumi.AzureNative.DataBoxEdge.Outputs.SystemDataResponse
Metadata pertaining to creation and last modification of Role
Type string
The hierarchical type of the object.
ComputeResource Pulumi.AzureNative.DataBoxEdge.Outputs.ComputeResourceResponse
Resource allocation
IoTEdgeAgentInfo Pulumi.AzureNative.DataBoxEdge.Outputs.IoTEdgeAgentInfoResponse
Iot edge agent details to download the agent and bootstrap iot runtime.
ShareMappings List<Pulumi.AzureNative.DataBoxEdge.Outputs.MountPointMapResponse>
Mount points of shares in role(s).
HostPlatform string
Host OS supported by the IoT role.
HostPlatformType string
Platform where the Iot runtime is hosted.
Id string
The path ID that uniquely identifies the object.
IoTDeviceDetails IoTDeviceInfoResponse
IoT device metadata to which data box edge device needs to be connected.
IoTEdgeDeviceDetails IoTDeviceInfoResponse
IoT edge device to which the IoT role needs to be configured.
Name string
The object name.
RoleStatus string
Role status.
SystemData SystemDataResponse
Metadata pertaining to creation and last modification of Role
Type string
The hierarchical type of the object.
ComputeResource ComputeResourceResponse
Resource allocation
IoTEdgeAgentInfo IoTEdgeAgentInfoResponse
Iot edge agent details to download the agent and bootstrap iot runtime.
ShareMappings []MountPointMapResponse
Mount points of shares in role(s).
hostPlatform String
Host OS supported by the IoT role.
hostPlatformType String
Platform where the Iot runtime is hosted.
id String
The path ID that uniquely identifies the object.
ioTDeviceDetails IoTDeviceInfoResponse
IoT device metadata to which data box edge device needs to be connected.
ioTEdgeDeviceDetails IoTDeviceInfoResponse
IoT edge device to which the IoT role needs to be configured.
name String
The object name.
roleStatus String
Role status.
systemData SystemDataResponse
Metadata pertaining to creation and last modification of Role
type String
The hierarchical type of the object.
computeResource ComputeResourceResponse
Resource allocation
ioTEdgeAgentInfo IoTEdgeAgentInfoResponse
Iot edge agent details to download the agent and bootstrap iot runtime.
shareMappings List<MountPointMapResponse>
Mount points of shares in role(s).
hostPlatform string
Host OS supported by the IoT role.
hostPlatformType string
Platform where the Iot runtime is hosted.
id string
The path ID that uniquely identifies the object.
ioTDeviceDetails IoTDeviceInfoResponse
IoT device metadata to which data box edge device needs to be connected.
ioTEdgeDeviceDetails IoTDeviceInfoResponse
IoT edge device to which the IoT role needs to be configured.
name string
The object name.
roleStatus string
Role status.
systemData SystemDataResponse
Metadata pertaining to creation and last modification of Role
type string
The hierarchical type of the object.
computeResource ComputeResourceResponse
Resource allocation
ioTEdgeAgentInfo IoTEdgeAgentInfoResponse
Iot edge agent details to download the agent and bootstrap iot runtime.
shareMappings MountPointMapResponse[]
Mount points of shares in role(s).
host_platform str
Host OS supported by the IoT role.
host_platform_type str
Platform where the Iot runtime is hosted.
id str
The path ID that uniquely identifies the object.
io_t_device_details IoTDeviceInfoResponse
IoT device metadata to which data box edge device needs to be connected.
io_t_edge_device_details IoTDeviceInfoResponse
IoT edge device to which the IoT role needs to be configured.
name str
The object name.
role_status str
Role status.
system_data SystemDataResponse
Metadata pertaining to creation and last modification of Role
type str
The hierarchical type of the object.
compute_resource ComputeResourceResponse
Resource allocation
io_t_edge_agent_info IoTEdgeAgentInfoResponse
Iot edge agent details to download the agent and bootstrap iot runtime.
share_mappings Sequence[MountPointMapResponse]
Mount points of shares in role(s).
hostPlatform String
Host OS supported by the IoT role.
hostPlatformType String
Platform where the Iot runtime is hosted.
id String
The path ID that uniquely identifies the object.
ioTDeviceDetails Property Map
IoT device metadata to which data box edge device needs to be connected.
ioTEdgeDeviceDetails Property Map
IoT edge device to which the IoT role needs to be configured.
name String
The object name.
roleStatus String
Role status.
systemData Property Map
Metadata pertaining to creation and last modification of Role
type String
The hierarchical type of the object.
computeResource Property Map
Resource allocation
ioTEdgeAgentInfo Property Map
Iot edge agent details to download the agent and bootstrap iot runtime.
shareMappings List<Property Map>
Mount points of shares in role(s).

Supporting Types

AsymmetricEncryptedSecretResponse

EncryptionAlgorithm This property is required. string
The algorithm used to encrypt "Value".
Value This property is required. string
The value of the secret.
EncryptionCertThumbprint string
Thumbprint certificate used to encrypt "Value". If the value is unencrypted, it will be null.
EncryptionAlgorithm This property is required. string
The algorithm used to encrypt "Value".
Value This property is required. string
The value of the secret.
EncryptionCertThumbprint string
Thumbprint certificate used to encrypt "Value". If the value is unencrypted, it will be null.
encryptionAlgorithm This property is required. String
The algorithm used to encrypt "Value".
value This property is required. String
The value of the secret.
encryptionCertThumbprint String
Thumbprint certificate used to encrypt "Value". If the value is unencrypted, it will be null.
encryptionAlgorithm This property is required. string
The algorithm used to encrypt "Value".
value This property is required. string
The value of the secret.
encryptionCertThumbprint string
Thumbprint certificate used to encrypt "Value". If the value is unencrypted, it will be null.
encryption_algorithm This property is required. str
The algorithm used to encrypt "Value".
value This property is required. str
The value of the secret.
encryption_cert_thumbprint str
Thumbprint certificate used to encrypt "Value". If the value is unencrypted, it will be null.
encryptionAlgorithm This property is required. String
The algorithm used to encrypt "Value".
value This property is required. String
The value of the secret.
encryptionCertThumbprint String
Thumbprint certificate used to encrypt "Value". If the value is unencrypted, it will be null.

AuthenticationResponse

SymmetricKey SymmetricKeyResponse
Symmetric key for authentication.
symmetricKey SymmetricKeyResponse
Symmetric key for authentication.
symmetricKey SymmetricKeyResponse
Symmetric key for authentication.
symmetric_key SymmetricKeyResponse
Symmetric key for authentication.
symmetricKey Property Map
Symmetric key for authentication.

ComputeResourceResponse

MemoryInGB This property is required. double
Memory in GB
ProcessorCount This property is required. int
Processor count
MemoryInGB This property is required. float64
Memory in GB
ProcessorCount This property is required. int
Processor count
memoryInGB This property is required. Double
Memory in GB
processorCount This property is required. Integer
Processor count
memoryInGB This property is required. number
Memory in GB
processorCount This property is required. number
Processor count
memory_in_gb This property is required. float
Memory in GB
processor_count This property is required. int
Processor count
memoryInGB This property is required. Number
Memory in GB
processorCount This property is required. Number
Processor count

ImageRepositoryCredentialResponse

ImageRepositoryUrl This property is required. string
Image repository url (e.g.: mcr.microsoft.com).
UserName This property is required. string
Repository user name.
Password Pulumi.AzureNative.DataBoxEdge.Inputs.AsymmetricEncryptedSecretResponse
Repository user password.
ImageRepositoryUrl This property is required. string
Image repository url (e.g.: mcr.microsoft.com).
UserName This property is required. string
Repository user name.
Password AsymmetricEncryptedSecretResponse
Repository user password.
imageRepositoryUrl This property is required. String
Image repository url (e.g.: mcr.microsoft.com).
userName This property is required. String
Repository user name.
password AsymmetricEncryptedSecretResponse
Repository user password.
imageRepositoryUrl This property is required. string
Image repository url (e.g.: mcr.microsoft.com).
userName This property is required. string
Repository user name.
password AsymmetricEncryptedSecretResponse
Repository user password.
image_repository_url This property is required. str
Image repository url (e.g.: mcr.microsoft.com).
user_name This property is required. str
Repository user name.
password AsymmetricEncryptedSecretResponse
Repository user password.
imageRepositoryUrl This property is required. String
Image repository url (e.g.: mcr.microsoft.com).
userName This property is required. String
Repository user name.
password Property Map
Repository user password.

IoTDeviceInfoResponse

DeviceId This property is required. string
ID of the IoT device/edge device.
IoTHostHub This property is required. string
Host name for the IoT hub associated to the device.
Authentication Pulumi.AzureNative.DataBoxEdge.Inputs.AuthenticationResponse
Encrypted IoT device/IoT edge device connection string.
IoTHostHubId string
Id for the IoT hub associated to the device.
DeviceId This property is required. string
ID of the IoT device/edge device.
IoTHostHub This property is required. string
Host name for the IoT hub associated to the device.
Authentication AuthenticationResponse
Encrypted IoT device/IoT edge device connection string.
IoTHostHubId string
Id for the IoT hub associated to the device.
deviceId This property is required. String
ID of the IoT device/edge device.
ioTHostHub This property is required. String
Host name for the IoT hub associated to the device.
authentication AuthenticationResponse
Encrypted IoT device/IoT edge device connection string.
ioTHostHubId String
Id for the IoT hub associated to the device.
deviceId This property is required. string
ID of the IoT device/edge device.
ioTHostHub This property is required. string
Host name for the IoT hub associated to the device.
authentication AuthenticationResponse
Encrypted IoT device/IoT edge device connection string.
ioTHostHubId string
Id for the IoT hub associated to the device.
device_id This property is required. str
ID of the IoT device/edge device.
io_t_host_hub This property is required. str
Host name for the IoT hub associated to the device.
authentication AuthenticationResponse
Encrypted IoT device/IoT edge device connection string.
io_t_host_hub_id str
Id for the IoT hub associated to the device.
deviceId This property is required. String
ID of the IoT device/edge device.
ioTHostHub This property is required. String
Host name for the IoT hub associated to the device.
authentication Property Map
Encrypted IoT device/IoT edge device connection string.
ioTHostHubId String
Id for the IoT hub associated to the device.

IoTEdgeAgentInfoResponse

ImageName This property is required. string
Name of the IoT edge agent image.
Tag This property is required. string
Image Tag.
ImageRepository Pulumi.AzureNative.DataBoxEdge.Inputs.ImageRepositoryCredentialResponse
Image repository details.
ImageName This property is required. string
Name of the IoT edge agent image.
Tag This property is required. string
Image Tag.
ImageRepository ImageRepositoryCredentialResponse
Image repository details.
imageName This property is required. String
Name of the IoT edge agent image.
tag This property is required. String
Image Tag.
imageRepository ImageRepositoryCredentialResponse
Image repository details.
imageName This property is required. string
Name of the IoT edge agent image.
tag This property is required. string
Image Tag.
imageRepository ImageRepositoryCredentialResponse
Image repository details.
image_name This property is required. str
Name of the IoT edge agent image.
tag This property is required. str
Image Tag.
image_repository ImageRepositoryCredentialResponse
Image repository details.
imageName This property is required. String
Name of the IoT edge agent image.
tag This property is required. String
Image Tag.
imageRepository Property Map
Image repository details.

MountPointMapResponse

MountPoint This property is required. string
Mount point for the share.
MountType This property is required. string
Mounting type.
RoleId This property is required. string
ID of the role to which share is mounted.
RoleType This property is required. string
Role type.
ShareId This property is required. string
ID of the share mounted to the role VM.
MountPoint This property is required. string
Mount point for the share.
MountType This property is required. string
Mounting type.
RoleId This property is required. string
ID of the role to which share is mounted.
RoleType This property is required. string
Role type.
ShareId This property is required. string
ID of the share mounted to the role VM.
mountPoint This property is required. String
Mount point for the share.
mountType This property is required. String
Mounting type.
roleId This property is required. String
ID of the role to which share is mounted.
roleType This property is required. String
Role type.
shareId This property is required. String
ID of the share mounted to the role VM.
mountPoint This property is required. string
Mount point for the share.
mountType This property is required. string
Mounting type.
roleId This property is required. string
ID of the role to which share is mounted.
roleType This property is required. string
Role type.
shareId This property is required. string
ID of the share mounted to the role VM.
mount_point This property is required. str
Mount point for the share.
mount_type This property is required. str
Mounting type.
role_id This property is required. str
ID of the role to which share is mounted.
role_type This property is required. str
Role type.
share_id This property is required. str
ID of the share mounted to the role VM.
mountPoint This property is required. String
Mount point for the share.
mountType This property is required. String
Mounting type.
roleId This property is required. String
ID of the role to which share is mounted.
roleType This property is required. String
Role type.
shareId This property is required. String
ID of the share mounted to the role VM.

SymmetricKeyResponse

ConnectionString AsymmetricEncryptedSecretResponse
Connection string based on the symmetric key.
connectionString AsymmetricEncryptedSecretResponse
Connection string based on the symmetric key.
connectionString AsymmetricEncryptedSecretResponse
Connection string based on the symmetric key.
connection_string AsymmetricEncryptedSecretResponse
Connection string based on the symmetric key.
connectionString Property Map
Connection string based on the symmetric key.

SystemDataResponse

CreatedAt string
The timestamp of resource creation (UTC).
CreatedBy string
The identity that created the resource.
CreatedByType string
The type of identity that created the resource.
LastModifiedAt string
The timestamp of resource last modification (UTC)
LastModifiedBy string
The identity that last modified the resource.
LastModifiedByType string
The type of identity that last modified the resource.
CreatedAt string
The timestamp of resource creation (UTC).
CreatedBy string
The identity that created the resource.
CreatedByType string
The type of identity that created the resource.
LastModifiedAt string
The timestamp of resource last modification (UTC)
LastModifiedBy string
The identity that last modified the resource.
LastModifiedByType string
The type of identity that last modified the resource.
createdAt String
The timestamp of resource creation (UTC).
createdBy String
The identity that created the resource.
createdByType String
The type of identity that created the resource.
lastModifiedAt String
The timestamp of resource last modification (UTC)
lastModifiedBy String
The identity that last modified the resource.
lastModifiedByType String
The type of identity that last modified the resource.
createdAt string
The timestamp of resource creation (UTC).
createdBy string
The identity that created the resource.
createdByType string
The type of identity that created the resource.
lastModifiedAt string
The timestamp of resource last modification (UTC)
lastModifiedBy string
The identity that last modified the resource.
lastModifiedByType string
The type of identity that last modified the resource.
created_at str
The timestamp of resource creation (UTC).
created_by str
The identity that created the resource.
created_by_type str
The type of identity that created the resource.
last_modified_at str
The timestamp of resource last modification (UTC)
last_modified_by str
The identity that last modified the resource.
last_modified_by_type str
The type of identity that last modified the resource.
createdAt String
The timestamp of resource creation (UTC).
createdBy String
The identity that created the resource.
createdByType String
The type of identity that created the resource.
lastModifiedAt String
The timestamp of resource last modification (UTC)
lastModifiedBy String
The identity that last modified the resource.
lastModifiedByType String
The type of identity that last modified the resource.

Package Details

Repository
azure-native-v2 pulumi/pulumi-azure-native
License
Apache-2.0
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi