1. Packages
  2. Azure Native
  3. API Docs
  4. security
  5. SecurityContact
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.8.0 published on Monday, Sep 18, 2023 by Pulumi

azure-native.security.SecurityContact

Explore with Pulumi AI

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.8.0 published on Monday, Sep 18, 2023 by Pulumi

    Contact details and configurations for notifications coming from Microsoft Defender for Cloud. Azure REST API version: 2020-01-01-preview. Prior API version in Azure Native 1.x: 2020-01-01-preview

    Example Usage

    Create security contact data

    using System.Collections.Generic;
    using System.Linq;
    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 (
    	"github.com/pulumi/pulumi-azure-native-sdk/security/v2"
    	"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.SecurityContactPropertiesAlertNotifications

    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.SecurityContactPropertiesNotificationsByRole

    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 SecurityContactPropertiesAlertNotifications

    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 SecurityContactPropertiesNotificationsByRole

    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 SecurityContactPropertiesAlertNotifications

    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 SecurityContactPropertiesNotificationsByRole

    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, MinimalSeverityArgs

    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, RolesArgs

    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, SecurityContactPropertiesAlertNotificationsArgs

    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, SecurityContactPropertiesNotificationsByRoleArgs

    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, SecurityContactPropertiesResponseAlertNotificationsArgs

    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, SecurityContactPropertiesResponseNotificationsByRoleArgs

    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, StateArgs

    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/{subscriptionId}/providers/Microsoft.Security/securityContacts/{securityContactName} 
    

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
    Azure Native v2.8.0 published on Monday, Sep 18, 2023 by Pulumi