azure-native.deviceupdate.Instance
Explore with Pulumi AI
Device Update instance details. Azure REST API version: 2023-07-01. Prior API version in Azure Native 1.x: 2020-03-01-preview.
Example Usage
Creates or updates Instance
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() => 
{
    var instance = new AzureNative.DeviceUpdate.Instance("instance", new()
    {
        AccountName = "contoso",
        DiagnosticStorageProperties = new AzureNative.DeviceUpdate.Inputs.DiagnosticStoragePropertiesArgs
        {
            AuthenticationType = AzureNative.DeviceUpdate.AuthenticationType.KeyBased,
            ConnectionString = "string",
            ResourceId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount",
        },
        EnableDiagnostics = false,
        InstanceName = "blue",
        IotHubs = new[]
        {
            new AzureNative.DeviceUpdate.Inputs.IotHubSettingsArgs
            {
                ResourceId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub",
            },
        },
        Location = "westus2",
        ResourceGroupName = "test-rg",
    });
});
package main
import (
	deviceupdate "github.com/pulumi/pulumi-azure-native-sdk/deviceupdate/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := deviceupdate.NewInstance(ctx, "instance", &deviceupdate.InstanceArgs{
			AccountName: pulumi.String("contoso"),
			DiagnosticStorageProperties: &deviceupdate.DiagnosticStoragePropertiesArgs{
				AuthenticationType: pulumi.String(deviceupdate.AuthenticationTypeKeyBased),
				ConnectionString:   pulumi.String("string"),
				ResourceId:         pulumi.String("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount"),
			},
			EnableDiagnostics: pulumi.Bool(false),
			InstanceName:      pulumi.String("blue"),
			IotHubs: deviceupdate.IotHubSettingsArray{
				&deviceupdate.IotHubSettingsArgs{
					ResourceId: pulumi.String("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub"),
				},
			},
			Location:          pulumi.String("westus2"),
			ResourceGroupName: pulumi.String("test-rg"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.deviceupdate.Instance;
import com.pulumi.azurenative.deviceupdate.InstanceArgs;
import com.pulumi.azurenative.deviceupdate.inputs.DiagnosticStoragePropertiesArgs;
import com.pulumi.azurenative.deviceupdate.inputs.IotHubSettingsArgs;
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 instance = new Instance("instance", InstanceArgs.builder()
            .accountName("contoso")
            .diagnosticStorageProperties(DiagnosticStoragePropertiesArgs.builder()
                .authenticationType("KeyBased")
                .connectionString("string")
                .resourceId("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount")
                .build())
            .enableDiagnostics(false)
            .instanceName("blue")
            .iotHubs(IotHubSettingsArgs.builder()
                .resourceId("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub")
                .build())
            .location("westus2")
            .resourceGroupName("test-rg")
            .build());
    }
}
import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";
const instance = new azure_native.deviceupdate.Instance("instance", {
    accountName: "contoso",
    diagnosticStorageProperties: {
        authenticationType: azure_native.deviceupdate.AuthenticationType.KeyBased,
        connectionString: "string",
        resourceId: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount",
    },
    enableDiagnostics: false,
    instanceName: "blue",
    iotHubs: [{
        resourceId: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub",
    }],
    location: "westus2",
    resourceGroupName: "test-rg",
});
import pulumi
import pulumi_azure_native as azure_native
instance = azure_native.deviceupdate.Instance("instance",
    account_name="contoso",
    diagnostic_storage_properties={
        "authentication_type": azure_native.deviceupdate.AuthenticationType.KEY_BASED,
        "connection_string": "string",
        "resource_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount",
    },
    enable_diagnostics=False,
    instance_name="blue",
    iot_hubs=[{
        "resource_id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub",
    }],
    location="westus2",
    resource_group_name="test-rg")
resources:
  instance:
    type: azure-native:deviceupdate:Instance
    properties:
      accountName: contoso
      diagnosticStorageProperties:
        authenticationType: KeyBased
        connectionString: string
        resourceId: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount
      enableDiagnostics: false
      instanceName: blue
      iotHubs:
        - resourceId: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub
      location: westus2
      resourceGroupName: test-rg
Create Instance Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Instance(name: string, args: InstanceArgs, opts?: CustomResourceOptions);@overload
def Instance(resource_name: str,
             args: InstanceArgs,
             opts: Optional[ResourceOptions] = None)
@overload
def Instance(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             account_name: Optional[str] = None,
             resource_group_name: Optional[str] = None,
             diagnostic_storage_properties: Optional[DiagnosticStoragePropertiesArgs] = None,
             enable_diagnostics: Optional[bool] = None,
             instance_name: Optional[str] = None,
             iot_hubs: Optional[Sequence[IotHubSettingsArgs]] = None,
             location: Optional[str] = None,
             tags: Optional[Mapping[str, str]] = None)func NewInstance(ctx *Context, name string, args InstanceArgs, opts ...ResourceOption) (*Instance, error)public Instance(string name, InstanceArgs args, CustomResourceOptions? opts = null)
public Instance(String name, InstanceArgs args)
public Instance(String name, InstanceArgs args, CustomResourceOptions options)
type: azure-native:deviceupdate:Instance
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 InstanceArgs
- 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 InstanceArgs
- 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 InstanceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args InstanceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args InstanceArgs
- 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 instanceResource = new AzureNative.DeviceUpdate.Instance("instanceResource", new()
{
    AccountName = "string",
    ResourceGroupName = "string",
    DiagnosticStorageProperties = new AzureNative.DeviceUpdate.Inputs.DiagnosticStoragePropertiesArgs
    {
        AuthenticationType = "string",
        ResourceId = "string",
        ConnectionString = "string",
    },
    EnableDiagnostics = false,
    InstanceName = "string",
    IotHubs = new[]
    {
        new AzureNative.DeviceUpdate.Inputs.IotHubSettingsArgs
        {
            ResourceId = "string",
        },
    },
    Location = "string",
    Tags = 
    {
        { "string", "string" },
    },
});
example, err := deviceupdate.NewInstance(ctx, "instanceResource", &deviceupdate.InstanceArgs{
	AccountName:       pulumi.String("string"),
	ResourceGroupName: pulumi.String("string"),
	DiagnosticStorageProperties: &deviceupdate.DiagnosticStoragePropertiesArgs{
		AuthenticationType: pulumi.String("string"),
		ResourceId:         pulumi.String("string"),
		ConnectionString:   pulumi.String("string"),
	},
	EnableDiagnostics: pulumi.Bool(false),
	InstanceName:      pulumi.String("string"),
	IotHubs: deviceupdate.IotHubSettingsArray{
		&deviceupdate.IotHubSettingsArgs{
			ResourceId: pulumi.String("string"),
		},
	},
	Location: pulumi.String("string"),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
})
var instanceResource = new Instance("instanceResource", InstanceArgs.builder()
    .accountName("string")
    .resourceGroupName("string")
    .diagnosticStorageProperties(DiagnosticStoragePropertiesArgs.builder()
        .authenticationType("string")
        .resourceId("string")
        .connectionString("string")
        .build())
    .enableDiagnostics(false)
    .instanceName("string")
    .iotHubs(IotHubSettingsArgs.builder()
        .resourceId("string")
        .build())
    .location("string")
    .tags(Map.of("string", "string"))
    .build());
instance_resource = azure_native.deviceupdate.Instance("instanceResource",
    account_name="string",
    resource_group_name="string",
    diagnostic_storage_properties={
        "authentication_type": "string",
        "resource_id": "string",
        "connection_string": "string",
    },
    enable_diagnostics=False,
    instance_name="string",
    iot_hubs=[{
        "resource_id": "string",
    }],
    location="string",
    tags={
        "string": "string",
    })
const instanceResource = new azure_native.deviceupdate.Instance("instanceResource", {
    accountName: "string",
    resourceGroupName: "string",
    diagnosticStorageProperties: {
        authenticationType: "string",
        resourceId: "string",
        connectionString: "string",
    },
    enableDiagnostics: false,
    instanceName: "string",
    iotHubs: [{
        resourceId: "string",
    }],
    location: "string",
    tags: {
        string: "string",
    },
});
type: azure-native:deviceupdate:Instance
properties:
    accountName: string
    diagnosticStorageProperties:
        authenticationType: string
        connectionString: string
        resourceId: string
    enableDiagnostics: false
    instanceName: string
    iotHubs:
        - resourceId: string
    location: string
    resourceGroupName: string
    tags:
        string: string
Instance 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 Instance resource accepts the following input properties:
- AccountName string
- Account name.
- ResourceGroup stringName 
- The resource group name.
- DiagnosticStorage Pulumi.Properties Azure Native. Device Update. Inputs. Diagnostic Storage Properties 
- Customer-initiated diagnostic log collection storage properties
- EnableDiagnostics bool
- Enables or Disables the diagnostic logs collection
- InstanceName string
- Instance name.
- IotHubs List<Pulumi.Azure Native. Device Update. Inputs. Iot Hub Settings> 
- List of IoT Hubs associated with the account.
- Location string
- The geo-location where the resource lives
- Dictionary<string, string>
- Resource tags.
- AccountName string
- Account name.
- ResourceGroup stringName 
- The resource group name.
- DiagnosticStorage DiagnosticProperties Storage Properties Args 
- Customer-initiated diagnostic log collection storage properties
- EnableDiagnostics bool
- Enables or Disables the diagnostic logs collection
- InstanceName string
- Instance name.
- IotHubs []IotHub Settings Args 
- List of IoT Hubs associated with the account.
- Location string
- The geo-location where the resource lives
- map[string]string
- Resource tags.
- accountName String
- Account name.
- resourceGroup StringName 
- The resource group name.
- diagnosticStorage DiagnosticProperties Storage Properties 
- Customer-initiated diagnostic log collection storage properties
- enableDiagnostics Boolean
- Enables or Disables the diagnostic logs collection
- instanceName String
- Instance name.
- iotHubs List<IotHub Settings> 
- List of IoT Hubs associated with the account.
- location String
- The geo-location where the resource lives
- Map<String,String>
- Resource tags.
- accountName string
- Account name.
- resourceGroup stringName 
- The resource group name.
- diagnosticStorage DiagnosticProperties Storage Properties 
- Customer-initiated diagnostic log collection storage properties
- enableDiagnostics boolean
- Enables or Disables the diagnostic logs collection
- instanceName string
- Instance name.
- iotHubs IotHub Settings[] 
- List of IoT Hubs associated with the account.
- location string
- The geo-location where the resource lives
- {[key: string]: string}
- Resource tags.
- account_name str
- Account name.
- resource_group_ strname 
- The resource group name.
- diagnostic_storage_ Diagnosticproperties Storage Properties Args 
- Customer-initiated diagnostic log collection storage properties
- enable_diagnostics bool
- Enables or Disables the diagnostic logs collection
- instance_name str
- Instance name.
- iot_hubs Sequence[IotHub Settings Args] 
- List of IoT Hubs associated with the account.
- location str
- The geo-location where the resource lives
- Mapping[str, str]
- Resource tags.
- accountName String
- Account name.
- resourceGroup StringName 
- The resource group name.
- diagnosticStorage Property MapProperties 
- Customer-initiated diagnostic log collection storage properties
- enableDiagnostics Boolean
- Enables or Disables the diagnostic logs collection
- instanceName String
- Instance name.
- iotHubs List<Property Map>
- List of IoT Hubs associated with the account.
- location String
- The geo-location where the resource lives
- Map<String>
- Resource tags.
Outputs
All input properties are implicitly available as output properties. Additionally, the Instance resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- ProvisioningState string
- Provisioning state.
- SystemData Pulumi.Azure Native. Device Update. Outputs. System Data Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- The name of the resource
- ProvisioningState string
- Provisioning state.
- SystemData SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- Type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioningState String
- Provisioning state.
- systemData SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- The name of the resource
- provisioningState string
- Provisioning state.
- systemData SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type string
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- The name of the resource
- provisioning_state str
- Provisioning state.
- system_data SystemData Response 
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type str
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- The name of the resource
- provisioningState String
- Provisioning state.
- systemData Property Map
- Azure Resource Manager metadata containing createdBy and modifiedBy information.
- type String
- The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
Supporting Types
AuthenticationType, AuthenticationTypeArgs    
- KeyBased 
- KeyBased
- AuthenticationType Key Based 
- KeyBased
- KeyBased 
- KeyBased
- KeyBased 
- KeyBased
- KEY_BASED
- KeyBased
- "KeyBased" 
- KeyBased
DiagnosticStorageProperties, DiagnosticStoragePropertiesArgs      
- AuthenticationType string | Pulumi.Azure Native. Device Update. Authentication Type 
- Authentication Type
- ResourceId string
- ResourceId of the diagnostic storage account
- ConnectionString string
- ConnectionString of the diagnostic storage account
- AuthenticationType string | AuthenticationType 
- Authentication Type
- ResourceId string
- ResourceId of the diagnostic storage account
- ConnectionString string
- ConnectionString of the diagnostic storage account
- authenticationType String | AuthenticationType 
- Authentication Type
- resourceId String
- ResourceId of the diagnostic storage account
- connectionString String
- ConnectionString of the diagnostic storage account
- authenticationType string | AuthenticationType 
- Authentication Type
- resourceId string
- ResourceId of the diagnostic storage account
- connectionString string
- ConnectionString of the diagnostic storage account
- authentication_type str | AuthenticationType 
- Authentication Type
- resource_id str
- ResourceId of the diagnostic storage account
- connection_string str
- ConnectionString of the diagnostic storage account
- authenticationType String | "KeyBased" 
- Authentication Type
- resourceId String
- ResourceId of the diagnostic storage account
- connectionString String
- ConnectionString of the diagnostic storage account
DiagnosticStoragePropertiesResponse, DiagnosticStoragePropertiesResponseArgs        
- AuthenticationType string
- Authentication Type
- ResourceId string
- ResourceId of the diagnostic storage account
- ConnectionString string
- ConnectionString of the diagnostic storage account
- AuthenticationType string
- Authentication Type
- ResourceId string
- ResourceId of the diagnostic storage account
- ConnectionString string
- ConnectionString of the diagnostic storage account
- authenticationType String
- Authentication Type
- resourceId String
- ResourceId of the diagnostic storage account
- connectionString String
- ConnectionString of the diagnostic storage account
- authenticationType string
- Authentication Type
- resourceId string
- ResourceId of the diagnostic storage account
- connectionString string
- ConnectionString of the diagnostic storage account
- authentication_type str
- Authentication Type
- resource_id str
- ResourceId of the diagnostic storage account
- connection_string str
- ConnectionString of the diagnostic storage account
- authenticationType String
- Authentication Type
- resourceId String
- ResourceId of the diagnostic storage account
- connectionString String
- ConnectionString of the diagnostic storage account
IotHubSettings, IotHubSettingsArgs      
- ResourceId string
- IoTHub resource ID
- ResourceId string
- IoTHub resource ID
- resourceId String
- IoTHub resource ID
- resourceId string
- IoTHub resource ID
- resource_id str
- IoTHub resource ID
- resourceId String
- IoTHub resource ID
IotHubSettingsResponse, IotHubSettingsResponseArgs        
- ResourceId string
- IoTHub resource ID
- ResourceId string
- IoTHub resource ID
- resourceId String
- IoTHub resource ID
- resourceId string
- IoTHub resource ID
- resource_id str
- IoTHub resource ID
- resourceId String
- IoTHub resource ID
SystemDataResponse, SystemDataResponseArgs      
- CreatedAt string
- The timestamp of resource creation (UTC).
- CreatedBy string
- The identity that created the resource.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The timestamp of resource last modification (UTC)
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- 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.
- CreatedBy stringType 
- The type of identity that created the resource.
- LastModified stringAt 
- The timestamp of resource last modification (UTC)
- LastModified stringBy 
- The identity that last modified the resource.
- LastModified stringBy Type 
- 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.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The timestamp of resource last modification (UTC)
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- 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.
- createdBy stringType 
- The type of identity that created the resource.
- lastModified stringAt 
- The timestamp of resource last modification (UTC)
- lastModified stringBy 
- The identity that last modified the resource.
- lastModified stringBy Type 
- 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_ strtype 
- The type of identity that created the resource.
- last_modified_ strat 
- The timestamp of resource last modification (UTC)
- last_modified_ strby 
- The identity that last modified the resource.
- last_modified_ strby_ type 
- 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.
- createdBy StringType 
- The type of identity that created the resource.
- lastModified StringAt 
- The timestamp of resource last modification (UTC)
- lastModified StringBy 
- The identity that last modified the resource.
- lastModified StringBy Type 
- The type of identity that last modified the resource.
Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:deviceupdate:Instance blue /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName} 
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Native pulumi/pulumi-azure-native
- License
- Apache-2.0