Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  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.73.0 published on Wednesday, Nov 20, 2024 by Pulumi
pulumi/pulumi-azure-native

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.73.0 published on Wednesday, Nov 20, 2024 by Pulumi
pulumi/pulumi-azure-native

    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.

    Other available API versions: 2017-08-01-preview, 2023-12-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 = AzureNative.Security.MinimalSeverity.Low,
            State = AzureNative.Security.State.On,
        },
        Emails = "john@contoso.com;jane@contoso.com",
        NotificationsByRole = new AzureNative.Security.Inputs.SecurityContactPropertiesNotificationsByRoleArgs
        {
            Roles = new[]
            {
                AzureNative.Security.Roles.Owner,
            },
            State = AzureNative.Security.State.On,
        },
        Phone = "(214)275-4038",
        SecurityContactName = "default",
    });

});

    package main

import (
	security "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(security.MinimalSeverityLow),
				State:           pulumi.String(security.StateOn),
			},
			Emails: pulumi.String("john@contoso.com;jane@contoso.com"),
			NotificationsByRole: &security.SecurityContactPropertiesNotificationsByRoleArgs{
				Roles: pulumi.StringArray{
					pulumi.String(security.RolesOwner),
				},
				State: pulumi.String(security.StateOn),
			},
			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 com.pulumi.azurenative.security.inputs.SecurityContactPropertiesAlertNotificationsArgs;
import com.pulumi.azurenative.security.inputs.SecurityContactPropertiesNotificationsByRoleArgs;
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(SecurityContactPropertiesAlertNotificationsArgs.builder()
                .minimalSeverity("Low")
                .state("On")
                .build())
            .emails("john@contoso.com;jane@contoso.com")
            .notificationsByRole(SecurityContactPropertiesNotificationsByRoleArgs.builder()
                .roles("Owner")
                .state("On")
                .build())
            .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={
        "minimal_severity": azure_native.security.MinimalSeverity.LOW,
        "state": azure_native.security.State.ON,
    },
    emails="john@contoso.com;jane@contoso.com",
    notifications_by_role={
        "roles": [azure_native.security.Roles.OWNER],
        "state": azure_native.security.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: azure_native.security.MinimalSeverity.Low,
        state: azure_native.security.State.On,
    },
    emails: "john@contoso.com;jane@contoso.com",
    notificationsByRole: {
        roles: [azure_native.security.Roles.Owner],
        state: azure_native.security.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

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new SecurityContact(name: string, args?: SecurityContactArgs, opts?: CustomResourceOptions);
    @overload
def SecurityContact(resource_name: str,
                    args: Optional[SecurityContactArgs] = None,
                    opts: Optional[ResourceOptions] = None)

@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)
    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.

    Parameters

    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.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var securityContactResource = new AzureNative.Security.SecurityContact("securityContactResource", new()
{
    AlertNotifications = new AzureNative.Security.Inputs.SecurityContactPropertiesAlertNotificationsArgs
    {
        MinimalSeverity = "string",
        State = "string",
    },
    Emails = "string",
    NotificationsByRole = new AzureNative.Security.Inputs.SecurityContactPropertiesNotificationsByRoleArgs
    {
        Roles = new[]
        {
            "string",
        },
        State = "string",
    },
    Phone = "string",
    SecurityContactName = "string",
});

    example, err := security.NewSecurityContact(ctx, "securityContactResource", &security.SecurityContactArgs{
	AlertNotifications: &security.SecurityContactPropertiesAlertNotificationsArgs{
		MinimalSeverity: pulumi.String("string"),
		State:           pulumi.String("string"),
	},
	Emails: pulumi.String("string"),
	NotificationsByRole: &security.SecurityContactPropertiesNotificationsByRoleArgs{
		Roles: pulumi.StringArray{
			pulumi.String("string"),
		},
		State: pulumi.String("string"),
	},
	Phone:               pulumi.String("string"),
	SecurityContactName: pulumi.String("string"),
})

    var securityContactResource = new SecurityContact("securityContactResource", SecurityContactArgs.builder()
    .alertNotifications(SecurityContactPropertiesAlertNotificationsArgs.builder()
        .minimalSeverity("string")
        .state("string")
        .build())
    .emails("string")
    .notificationsByRole(SecurityContactPropertiesNotificationsByRoleArgs.builder()
        .roles("string")
        .state("string")
        .build())
    .phone("string")
    .securityContactName("string")
    .build());

    security_contact_resource = azure_native.security.SecurityContact("securityContactResource",
    alert_notifications={
        "minimal_severity": "string",
        "state": "string",
    },
    emails="string",
    notifications_by_role={
        "roles": ["string"],
        "state": "string",
    },
    phone="string",
    security_contact_name="string")

    const securityContactResource = new azure_native.security.SecurityContact("securityContactResource", {
    alertNotifications: {
        minimalSeverity: "string",
        state: "string",
    },
    emails: "string",
    notificationsByRole: {
        roles: ["string"],
        state: "string",
    },
    phone: "string",
    securityContactName: "string",
});

    type: azure-native:security:SecurityContact
properties:
    alertNotifications:
        minimalSeverity: string
        state: string
    emails: string
    notificationsByRole:
        roles:
            - string
        state: string
    phone: string
    securityContactName: string

    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

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    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
    HighGet notifications on new alerts with High severity
    Medium
    MediumGet notifications on new alerts with medium or high severity
    Low
    LowDon't get notifications on new alerts with low, medium or high severity
    MinimalSeverityHigh
    HighGet notifications on new alerts with High severity
    MinimalSeverityMedium
    MediumGet notifications on new alerts with medium or high severity
    MinimalSeverityLow
    LowDon't get notifications on new alerts with low, medium or high severity
    High
    HighGet notifications on new alerts with High severity
    Medium
    MediumGet notifications on new alerts with medium or high severity
    Low
    LowDon't get notifications on new alerts with low, medium or high severity
    High
    HighGet notifications on new alerts with High severity
    Medium
    MediumGet notifications on new alerts with medium or high severity
    Low
    LowDon't get notifications on new alerts with low, medium or high severity
    HIGH
    HighGet notifications on new alerts with High severity
    MEDIUM
    MediumGet notifications on new alerts with medium or high severity
    LOW
    LowDon't get notifications on new alerts with low, medium or high severity
    "High"
    HighGet notifications on new alerts with High severity
    "Medium"
    MediumGet notifications on new alerts with medium or high severity
    "Low"
    LowDon't get notifications on new alerts with low, medium or high severity

    Roles, RolesArgs

    AccountAdmin
    AccountAdminIf enabled, send notification on new alerts to the account admins
    ServiceAdmin
    ServiceAdminIf enabled, send notification on new alerts to the service admins
    Owner
    OwnerIf enabled, send notification on new alerts to the subscription owners
    Contributor
    ContributorIf enabled, send notification on new alerts to the subscription contributors
    RolesAccountAdmin
    AccountAdminIf enabled, send notification on new alerts to the account admins
    RolesServiceAdmin
    ServiceAdminIf enabled, send notification on new alerts to the service admins
    RolesOwner
    OwnerIf enabled, send notification on new alerts to the subscription owners
    RolesContributor
    ContributorIf enabled, send notification on new alerts to the subscription contributors
    AccountAdmin
    AccountAdminIf enabled, send notification on new alerts to the account admins
    ServiceAdmin
    ServiceAdminIf enabled, send notification on new alerts to the service admins
    Owner
    OwnerIf enabled, send notification on new alerts to the subscription owners
    Contributor
    ContributorIf enabled, send notification on new alerts to the subscription contributors
    AccountAdmin
    AccountAdminIf enabled, send notification on new alerts to the account admins
    ServiceAdmin
    ServiceAdminIf enabled, send notification on new alerts to the service admins
    Owner
    OwnerIf enabled, send notification on new alerts to the subscription owners
    Contributor
    ContributorIf enabled, send notification on new alerts to the subscription contributors
    ACCOUNT_ADMIN
    AccountAdminIf enabled, send notification on new alerts to the account admins
    SERVICE_ADMIN
    ServiceAdminIf enabled, send notification on new alerts to the service admins
    OWNER
    OwnerIf enabled, send notification on new alerts to the subscription owners
    CONTRIBUTOR
    ContributorIf enabled, send notification on new alerts to the subscription contributors
    "AccountAdmin"
    AccountAdminIf enabled, send notification on new alerts to the account admins
    "ServiceAdmin"
    ServiceAdminIf enabled, send notification on new alerts to the service admins
    "Owner"
    OwnerIf enabled, send notification on new alerts to the subscription owners
    "Contributor"
    ContributorIf 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
    OnSend notification on new alerts to the subscription's admins
    Off
    OffDon't send notification on new alerts to the subscription's admins
    StateOn
    OnSend notification on new alerts to the subscription's admins
    StateOff
    OffDon't send notification on new alerts to the subscription's admins
    On
    OnSend notification on new alerts to the subscription's admins
    Off
    OffDon't send notification on new alerts to the subscription's admins
    On
    OnSend notification on new alerts to the subscription's admins
    Off
    OffDon't send notification on new alerts to the subscription's admins
    ON
    OnSend notification on new alerts to the subscription's admins
    OFF
    OffDon't send notification on new alerts to the subscription's admins
    "On"
    OnSend notification on new alerts to the subscription's admins
    "Off"
    OffDon'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}

    To learn more about importing existing cloud resources, see Importing resources.

    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.73.0 published on Wednesday, Nov 20, 2024 by Pulumi
    pulumi/pulumi-azure-native