IotSecuritySolution

class IotSecuritySolution : KotlinCustomResource

IoT Security solution configuration and resource information. Uses Azure REST API version 2019-08-01. In version 2.x of the Azure Native provider, it used API version 2019-08-01. Other available API versions: 2017-08-01-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native security [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create or update a IoT security solution

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var iotSecuritySolution = new AzureNative.Security.IotSecuritySolution("iotSecuritySolution", new()
{
DisabledDataSources = new[] {},
DisplayName = "Solution Default",
Export = new[] {},
IotHubs = new[]
{
"/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub",
},
Location = "East Us",
RecommendationsConfiguration = new[]
{
new AzureNative.Security.Inputs.RecommendationConfigurationPropertiesArgs
{
RecommendationType = AzureNative.Security.RecommendationType.IoT_OpenPorts,
Status = AzureNative.Security.RecommendationConfigStatus.Disabled,
},
new AzureNative.Security.Inputs.RecommendationConfigurationPropertiesArgs
{
RecommendationType = AzureNative.Security.RecommendationType.IoT_SharedCredentials,
Status = AzureNative.Security.RecommendationConfigStatus.Disabled,
},
},
ResourceGroupName = "MyGroup",
SolutionName = "default",
Status = AzureNative.Security.SecuritySolutionStatus.Enabled,
Tags = null,
UnmaskedIpLoggingStatus = AzureNative.Security.UnmaskedIpLoggingStatus.Enabled,
UserDefinedResources = new AzureNative.Security.Inputs.UserDefinedResourcesPropertiesArgs
{
Query = "where type != \"microsoft.devices/iothubs\" | where name contains \"iot\"",
QuerySubscriptions = new[]
{
"075423e9-7d33-4166-8bdf-3920b04e3735",
},
},
Workspace = "/subscriptions/c4930e90-cd72-4aa5-93e9-2d081d129569/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace1",
});
});
package main
import (
security "github.com/pulumi/pulumi-azure-native-sdk/security/v3"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := security.NewIotSecuritySolution(ctx, "iotSecuritySolution", &security.IotSecuritySolutionArgs{
DisabledDataSources: pulumi.StringArray{},
DisplayName: pulumi.String("Solution Default"),
Export: pulumi.StringArray{},
IotHubs: pulumi.StringArray{
pulumi.String("/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub"),
},
Location: pulumi.String("East Us"),
RecommendationsConfiguration: security.RecommendationConfigurationPropertiesArray{
&security.RecommendationConfigurationPropertiesArgs{
RecommendationType: pulumi.String(security.RecommendationType_IoT_OpenPorts),
Status: pulumi.String(security.RecommendationConfigStatusDisabled),
},
&security.RecommendationConfigurationPropertiesArgs{
RecommendationType: pulumi.String(security.RecommendationType_IoT_SharedCredentials),
Status: pulumi.String(security.RecommendationConfigStatusDisabled),
},
},
ResourceGroupName: pulumi.String("MyGroup"),
SolutionName: pulumi.String("default"),
Status: pulumi.String(security.SecuritySolutionStatusEnabled),
Tags: pulumi.StringMap{},
UnmaskedIpLoggingStatus: pulumi.String(security.UnmaskedIpLoggingStatusEnabled),
UserDefinedResources: &security.UserDefinedResourcesPropertiesArgs{
Query: pulumi.String("where type != \"microsoft.devices/iothubs\" | where name contains \"iot\""),
QuerySubscriptions: pulumi.StringArray{
pulumi.String("075423e9-7d33-4166-8bdf-3920b04e3735"),
},
},
Workspace: pulumi.String("/subscriptions/c4930e90-cd72-4aa5-93e9-2d081d129569/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace1"),
})
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.security.IotSecuritySolution;
import com.pulumi.azurenative.security.IotSecuritySolutionArgs;
import com.pulumi.azurenative.security.inputs.RecommendationConfigurationPropertiesArgs;
import com.pulumi.azurenative.security.inputs.UserDefinedResourcesPropertiesArgs;
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 iotSecuritySolution = new IotSecuritySolution("iotSecuritySolution", IotSecuritySolutionArgs.builder()
.disabledDataSources()
.displayName("Solution Default")
.export()
.iotHubs("/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub")
.location("East Us")
.recommendationsConfiguration(
RecommendationConfigurationPropertiesArgs.builder()
.recommendationType("IoT_OpenPorts")
.status("Disabled")
.build(),
RecommendationConfigurationPropertiesArgs.builder()
.recommendationType("IoT_SharedCredentials")
.status("Disabled")
.build())
.resourceGroupName("MyGroup")
.solutionName("default")
.status("Enabled")
.tags(Map.ofEntries(
))
.unmaskedIpLoggingStatus("Enabled")
.userDefinedResources(UserDefinedResourcesPropertiesArgs.builder()
.query("where type != \"microsoft.devices/iothubs\" | where name contains \"iot\"")
.querySubscriptions("075423e9-7d33-4166-8bdf-3920b04e3735")
.build())
.workspace("/subscriptions/c4930e90-cd72-4aa5-93e9-2d081d129569/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace1")
.build());
}
}

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:security:IotSecuritySolution default /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/iotSecuritySolutions/{solutionName}

Properties

Link copied to clipboard

List of additional workspaces

Link copied to clipboard

List of resources that were automatically discovered as relevant to the security solution.

Link copied to clipboard
val azureApiVersion: Output<String>

The Azure API version of the resource.

Link copied to clipboard

Disabled data sources. Disabling these data sources compromises the system.

Link copied to clipboard
val displayName: Output<String>

Resource display name.

Link copied to clipboard
val export: Output<List<String>>?

List of additional options for exporting to workspace data.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val iotHubs: Output<List<String>>

IoT Hub resource IDs

Link copied to clipboard
val location: Output<String>?

The resource location.

Link copied to clipboard
val name: Output<String>

Resource name

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard

List of the configuration status for each recommendation type.

Link copied to clipboard
val status: Output<String>?

Status of the IoT Security solution.

Link copied to clipboard

Azure Resource Manager metadata containing createdBy and modifiedBy information.

Link copied to clipboard
val tags: Output<Map<String, String>>?

Resource tags

Link copied to clipboard
val type: Output<String>

Resource type

Link copied to clipboard

Unmasked IP address logging status

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard

Properties of the IoT Security solution's user defined resources.

Link copied to clipboard
val workspace: Output<String>?

Workspace resource ID