Azure Native v1.102.0, May 2 23

azure-native.security.SecurityContact

Explore with Pulumi AI

Contact details and configurations for notifications coming from Microsoft Defender for Cloud. API Version: 2020-01-01-preview.

Example Usage

Create security contact data

using System.Collections.Generic;
using Pulumi;
using AzureNative = Pulumi.AzureNative;

return await Deployment.RunAsync(() => 
{
    var securityContact = new AzureNative.Security.SecurityContact("securityContact", new()
    {
        AlertNotifications = new AzureNative.Security.Inputs.SecurityContactPropertiesAlertNotificationsArgs
        {
            MinimalSeverity = "Low",
            State = "On",
        },
        Emails = "john@contoso.com;jane@contoso.com",
        NotificationsByRole = new AzureNative.Security.Inputs.SecurityContactPropertiesNotificationsByRoleArgs
        {
            Roles = new[]
            {
                "Owner",
            },
            State = "On",
        },
        Phone = "(214)275-4038",
        SecurityContactName = "default",
    });

});

package main

import (
	security "github.com/pulumi/pulumi-azure-native/sdk/go/azure/security"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := security.NewSecurityContact(ctx, "securityContact", &security.SecurityContactArgs{
			AlertNotifications: &security.SecurityContactPropertiesAlertNotificationsArgs{
				MinimalSeverity: pulumi.String("Low"),
				State:           pulumi.String("On"),
			},
			Emails: pulumi.String("john@contoso.com;jane@contoso.com"),
			NotificationsByRole: &security.SecurityContactPropertiesNotificationsByRoleArgs{
				Roles: pulumi.StringArray{
					pulumi.String("Owner"),
				},
				State: pulumi.String("On"),
			},
			Phone:               pulumi.String("(214)275-4038"),
			SecurityContactName: pulumi.String("default"),
		})
		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.SecurityContact;
import com.pulumi.azurenative.security.SecurityContactArgs;
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 securityContact = new SecurityContact("securityContact", SecurityContactArgs.builder()        
            .alertNotifications(Map.ofEntries(
                Map.entry("minimalSeverity", "Low"),
                Map.entry("state", "On")
            ))
            .emails("john@contoso.com;jane@contoso.com")
            .notificationsByRole(Map.ofEntries(
                Map.entry("roles", "Owner"),
                Map.entry("state", "On")
            ))
            .phone("(214)275-4038")
            .securityContactName("default")
            .build());

    }
}

import pulumi
import pulumi_azure_native as azure_native

security_contact = azure_native.security.SecurityContact("securityContact",
    alert_notifications=azure_native.security.SecurityContactPropertiesAlertNotificationsArgs(
        minimal_severity="Low",
        state="On",
    ),
    emails="john@contoso.com;jane@contoso.com",
    notifications_by_role=azure_native.security.SecurityContactPropertiesNotificationsByRoleArgs(
        roles=["Owner"],
        state="On",
    ),
    phone="(214)275-4038",
    security_contact_name="default")

import * as pulumi from "@pulumi/pulumi";
import * as azure_native from "@pulumi/azure-native";

const securityContact = new azure_native.security.SecurityContact("securityContact", {
    alertNotifications: {
        minimalSeverity: "Low",
        state: "On",
    },
    emails: "john@contoso.com;jane@contoso.com",
    notificationsByRole: {
        roles: ["Owner"],
        state: "On",
    },
    phone: "(214)275-4038",
    securityContactName: "default",
});

resources:
  securityContact:
    type: azure-native:security:SecurityContact
    properties:
      alertNotifications:
        minimalSeverity: Low
        state: On
      emails: john@contoso.com;jane@contoso.com
      notificationsByRole:
        roles:
          - Owner
        state: On
      phone: (214)275-4038
      securityContactName: default

Create SecurityContact Resource

new SecurityContact(name: string, args?: SecurityContactArgs, opts?: CustomResourceOptions);

@overload
def SecurityContact(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    alert_notifications: Optional[SecurityContactPropertiesAlertNotificationsArgs] = None,
                    emails: Optional[str] = None,
                    notifications_by_role: Optional[SecurityContactPropertiesNotificationsByRoleArgs] = None,
                    phone: Optional[str] = None,
                    security_contact_name: Optional[str] = None)
@overload
def SecurityContact(resource_name: str,
                    args: Optional[SecurityContactArgs] = None,
                    opts: Optional[ResourceOptions] = None)

func NewSecurityContact(ctx *Context, name string, args *SecurityContactArgs, opts ...ResourceOption) (*SecurityContact, error)

public SecurityContact(string name, SecurityContactArgs? args = null, CustomResourceOptions? opts = null)

public SecurityContact(String name, SecurityContactArgs args)
public SecurityContact(String name, SecurityContactArgs args, CustomResourceOptions options)

type: azure-native:security:SecurityContact
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string: The unique name of the resource.
args SecurityContactArgs: 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 SecurityContactArgs: 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 SecurityContactArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args SecurityContactArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args SecurityContactArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

SecurityContact Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The SecurityContact resource accepts the following input properties:

AlertNotifications Pulumi.AzureNative.Security.Inputs.SecurityContactPropertiesAlertNotificationsArgs: Defines whether to send email notifications about new security alerts
Emails string: List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
NotificationsByRole Pulumi.AzureNative.Security.Inputs.SecurityContactPropertiesNotificationsByRoleArgs: Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
Phone string: The security contact's phone number
SecurityContactName string: Name of the security contact object

AlertNotifications SecurityContactPropertiesAlertNotificationsArgs: Defines whether to send email notifications about new security alerts
Emails string: List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
NotificationsByRole SecurityContactPropertiesNotificationsByRoleArgs: Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
Phone string: The security contact's phone number
SecurityContactName string: Name of the security contact object

alertNotifications SecurityContactPropertiesAlertNotificationsArgs: Defines whether to send email notifications about new security alerts
emails String: List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
notificationsByRole SecurityContactPropertiesNotificationsByRoleArgs: Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
phone String: The security contact's phone number
securityContactName String: Name of the security contact object

alertNotifications SecurityContactPropertiesAlertNotificationsArgs: Defines whether to send email notifications about new security alerts
emails string: List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
notificationsByRole SecurityContactPropertiesNotificationsByRoleArgs: Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
phone string: The security contact's phone number
securityContactName string: Name of the security contact object

alert_notifications SecurityContactPropertiesAlertNotificationsArgs: Defines whether to send email notifications about new security alerts
emails str: List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
notifications_by_role SecurityContactPropertiesNotificationsByRoleArgs: Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
phone str: The security contact's phone number
security_contact_name str: Name of the security contact object

alertNotifications Property Map: Defines whether to send email notifications about new security alerts
emails String: List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
notificationsByRole Property Map: Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
phone String: The security contact's phone number
securityContactName String: Name of the security contact object

Outputs

All input properties are implicitly available as output properties. Additionally, the SecurityContact resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.
Name string: Resource name
Type string: Resource type

Id string: The provider-assigned unique ID for this managed resource.
Name string: Resource name
Type string: Resource type

id String: The provider-assigned unique ID for this managed resource.
name String: Resource name
type String: Resource type

id string: The provider-assigned unique ID for this managed resource.
name string: Resource name
type string: Resource type

id str: The provider-assigned unique ID for this managed resource.
name str: Resource name
type str: Resource type

id String: The provider-assigned unique ID for this managed resource.
name String: Resource name
type String: Resource type

Supporting Types

MinimalSeverity

High: High
Get notifications on new alerts with High severity
Medium: Medium
Get notifications on new alerts with medium or high severity
Low: Low
Don't get notifications on new alerts with low, medium or high severity

MinimalSeverityHigh: High
Get notifications on new alerts with High severity
MinimalSeverityMedium: Medium
Get notifications on new alerts with medium or high severity
MinimalSeverityLow: Low
Don't get notifications on new alerts with low, medium or high severity

High: High
Get notifications on new alerts with High severity
Medium: Medium
Get notifications on new alerts with medium or high severity
Low: Low
Don't get notifications on new alerts with low, medium or high severity

High: High
Get notifications on new alerts with High severity
Medium: Medium
Get notifications on new alerts with medium or high severity
Low: Low
Don't get notifications on new alerts with low, medium or high severity

HIGH: High
Get notifications on new alerts with High severity
MEDIUM: Medium
Get notifications on new alerts with medium or high severity
LOW: Low
Don't get notifications on new alerts with low, medium or high severity

"High": High
Get notifications on new alerts with High severity
"Medium": Medium
Get notifications on new alerts with medium or high severity
"Low": Low
Don't get notifications on new alerts with low, medium or high severity

Roles

AccountAdmin: AccountAdmin
If enabled, send notification on new alerts to the account admins
ServiceAdmin: ServiceAdmin
If enabled, send notification on new alerts to the service admins
Owner: Owner
If enabled, send notification on new alerts to the subscription owners
Contributor: Contributor
If enabled, send notification on new alerts to the subscription contributors

RolesAccountAdmin: AccountAdmin
If enabled, send notification on new alerts to the account admins
RolesServiceAdmin: ServiceAdmin
If enabled, send notification on new alerts to the service admins
RolesOwner: Owner
If enabled, send notification on new alerts to the subscription owners
RolesContributor: Contributor
If enabled, send notification on new alerts to the subscription contributors

AccountAdmin: AccountAdmin
If enabled, send notification on new alerts to the account admins
ServiceAdmin: ServiceAdmin
If enabled, send notification on new alerts to the service admins
Owner: Owner
If enabled, send notification on new alerts to the subscription owners
Contributor: Contributor
If enabled, send notification on new alerts to the subscription contributors

AccountAdmin: AccountAdmin
If enabled, send notification on new alerts to the account admins
ServiceAdmin: ServiceAdmin
If enabled, send notification on new alerts to the service admins
Owner: Owner
If enabled, send notification on new alerts to the subscription owners
Contributor: Contributor
If enabled, send notification on new alerts to the subscription contributors

ACCOUNT_ADMIN: AccountAdmin
If enabled, send notification on new alerts to the account admins
SERVICE_ADMIN: ServiceAdmin
If enabled, send notification on new alerts to the service admins
OWNER: Owner
If enabled, send notification on new alerts to the subscription owners
CONTRIBUTOR: Contributor
If enabled, send notification on new alerts to the subscription contributors

"AccountAdmin": AccountAdmin
If enabled, send notification on new alerts to the account admins
"ServiceAdmin": ServiceAdmin
If enabled, send notification on new alerts to the service admins
"Owner": Owner
If enabled, send notification on new alerts to the subscription owners
"Contributor": Contributor
If enabled, send notification on new alerts to the subscription contributors

SecurityContactPropertiesAlertNotifications

MinimalSeverity string | Pulumi.AzureNative.Security.MinimalSeverity: Defines the minimal alert severity which will be sent as email notifications
State string | Pulumi.AzureNative.Security.State: Defines if email notifications will be sent about new security alerts

MinimalSeverity string | MinimalSeverity: Defines the minimal alert severity which will be sent as email notifications
State string | State: Defines if email notifications will be sent about new security alerts

minimalSeverity String | MinimalSeverity: Defines the minimal alert severity which will be sent as email notifications
state String | State: Defines if email notifications will be sent about new security alerts

minimalSeverity string | MinimalSeverity: Defines the minimal alert severity which will be sent as email notifications
state string | State: Defines if email notifications will be sent about new security alerts

minimal_severity str | MinimalSeverity: Defines the minimal alert severity which will be sent as email notifications
state str | State: Defines if email notifications will be sent about new security alerts

minimalSeverity String | "High" | "Medium" | "Low": Defines the minimal alert severity which will be sent as email notifications
state String | "On" | "Off": Defines if email notifications will be sent about new security alerts

SecurityContactPropertiesNotificationsByRole

Roles List<Union<string, Pulumi.AzureNative.Security.Roles>>: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
State string | Pulumi.AzureNative.Security.State: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

Roles []string: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
State string | State: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<Either<String,Roles>>: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state String | State: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles (string | Roles)[]: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state string | State: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles Sequence[Union[str, Roles]]: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state str | State: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<String | "AccountAdmin" | "ServiceAdmin" | "Owner" | "Contributor">: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state String | "On" | "Off": Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

SecurityContactPropertiesResponseAlertNotifications

MinimalSeverity string: Defines the minimal alert severity which will be sent as email notifications
State string: Defines if email notifications will be sent about new security alerts

MinimalSeverity string: Defines the minimal alert severity which will be sent as email notifications
State string: Defines if email notifications will be sent about new security alerts

minimalSeverity String: Defines the minimal alert severity which will be sent as email notifications
state String: Defines if email notifications will be sent about new security alerts

minimalSeverity string: Defines the minimal alert severity which will be sent as email notifications
state string: Defines if email notifications will be sent about new security alerts

minimal_severity str: Defines the minimal alert severity which will be sent as email notifications
state str: Defines if email notifications will be sent about new security alerts

minimalSeverity String: Defines the minimal alert severity which will be sent as email notifications
state String: Defines if email notifications will be sent about new security alerts

SecurityContactPropertiesResponseNotificationsByRole

Roles List<string>: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
State string: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

Roles []string: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
State string: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<String>: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state String: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles string[]: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state string: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles Sequence[str]: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state str: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

roles List<String>: Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
state String: Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

State

On: On
Send notification on new alerts to the subscription's admins
Off: Off
Don't send notification on new alerts to the subscription's admins

StateOn: On
Send notification on new alerts to the subscription's admins
StateOff: Off
Don't send notification on new alerts to the subscription's admins

On: On
Send notification on new alerts to the subscription's admins
Off: Off
Don't send notification on new alerts to the subscription's admins

On: On
Send notification on new alerts to the subscription's admins
Off: Off
Don't send notification on new alerts to the subscription's admins

ON: On
Send notification on new alerts to the subscription's admins
OFF: Off
Don't send notification on new alerts to the subscription's admins

"On": On
Send notification on new alerts to the subscription's admins
"Off": Off
Don't send notification on new alerts to the subscription's admins

Import

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

$ pulumi import azure-native:security:SecurityContact default /subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default

Package Details

Repository: Azure Native pulumi/pulumi-azure-native
License: Apache-2.0