import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Manages the Vulnerability Assessment for an MS SQL Server. * * > **Note:** Vulnerability Assessment is currently only available for MS SQL databases. * * > **Note:** This resource cannot be used to enable the Express SQL Vulnerability Assessment configuration, to enable the express configuration, use `expressVulnerabilityAssessmentEnabled` in the `azure.mssql.Server` resource. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "example-resources", * location: "West Europe", * }); * const exampleServer = new azure.mssql.Server("example", { * name: "mysqlserver", * resourceGroupName: example.name, * location: example.location, * version: "12.0", * administratorLogin: "4dm1n157r470r", * administratorLoginPassword: "4-v3ry-53cr37-p455w0rd", * }); * const exampleAccount = new azure.storage.Account("example", { * name: "example", * resourceGroupName: example.name, * location: example.location, * accountTier: "Standard", * accountReplicationType: "GRS", * }); * const exampleContainer = new azure.storage.Container("example", { * name: "example", * storageAccountName: exampleAccount.name, * containerAccessType: "private", * }); * const exampleServerSecurityAlertPolicy = new azure.mssql.ServerSecurityAlertPolicy("example", { * resourceGroupName: example.name, * serverName: exampleServer.name, * state: "Enabled", * }); * const exampleServerVulnerabilityAssessment = new azure.mssql.ServerVulnerabilityAssessment("example", { * serverSecurityAlertPolicyId: exampleServerSecurityAlertPolicy.id, * storageContainerPath: pulumi.interpolate`${exampleAccount.primaryBlobEndpoint}${exampleContainer.name}/`, * storageAccountAccessKey: exampleAccount.primaryAccessKey, * recurringScans: { * enabled: true, * emailSubscriptionAdmins: true, * emails: [ * "email@example1.com", * "email@example2.com", * ], * }, * }); * ``` * * ## API Providers * * * This resource uses the following Azure API Providers: * * * `Microsoft.Sql` - 2023-08-01-preview * * ## Import * * MS SQL Server Vulnerability Assessment can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:mssql/serverVulnerabilityAssessment:ServerVulnerabilityAssessment example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/acceptanceTestResourceGroup1/providers/Microsoft.Sql/servers/mssqlserver/vulnerabilityAssessments/Default * ``` */ export declare class ServerVulnerabilityAssessment extends pulumi.CustomResource { /** * Get an existing ServerVulnerabilityAssessment resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: ServerVulnerabilityAssessmentState, opts?: pulumi.CustomResourceOptions): ServerVulnerabilityAssessment; /** * Returns true if the given object is an instance of ServerVulnerabilityAssessment. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is ServerVulnerabilityAssessment; /** * A `recurringScans` block as defined below. * * > **Note:** To reset the `recurringScans` code block to it's default values you must explicitly define an empty `recurringScans` code block (e.g., `recurringScans {}`) in your configuration file. */ readonly recurringScans: pulumi.Output; /** * The id of the security alert policy of the MS SQL Server. Changing this forces a new resource to be created. */ readonly serverSecurityAlertPolicyId: pulumi.Output; /** * Specifies the primary access key of the blob storage endpoint. * * > **Note:** The `storageAccountAccessKey` only applies if the storage account is not behind a virtual network or a firewall. * * > **Note:** If the `storageAccountAccessKey` property is not defined the `storageContainerSasKey` property is required. */ readonly storageAccountAccessKey: pulumi.Output; /** * Specifies the blob storage container path that will hold the scan results (e.g., ). */ readonly storageContainerPath: pulumi.Output; /** * Specifies the shared access signature (SAS Key) that has write access to the blob container specified in `storageContainerPath` property. * * > **Note:** The `storageContainerSasKey` only applies if the storage account is not behind a virtual network or a firewall. * * > **Note:** If the `storageContainerSasKey` property is not defined the `storageAccountAccessKey` property is required. */ readonly storageContainerSasKey: pulumi.Output; /** * Create a ServerVulnerabilityAssessment resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: ServerVulnerabilityAssessmentArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering ServerVulnerabilityAssessment resources. */ export interface ServerVulnerabilityAssessmentState { /** * A `recurringScans` block as defined below. * * > **Note:** To reset the `recurringScans` code block to it's default values you must explicitly define an empty `recurringScans` code block (e.g., `recurringScans {}`) in your configuration file. */ recurringScans?: pulumi.Input; /** * The id of the security alert policy of the MS SQL Server. Changing this forces a new resource to be created. */ serverSecurityAlertPolicyId?: pulumi.Input; /** * Specifies the primary access key of the blob storage endpoint. * * > **Note:** The `storageAccountAccessKey` only applies if the storage account is not behind a virtual network or a firewall. * * > **Note:** If the `storageAccountAccessKey` property is not defined the `storageContainerSasKey` property is required. */ storageAccountAccessKey?: pulumi.Input; /** * Specifies the blob storage container path that will hold the scan results (e.g., ). */ storageContainerPath?: pulumi.Input; /** * Specifies the shared access signature (SAS Key) that has write access to the blob container specified in `storageContainerPath` property. * * > **Note:** The `storageContainerSasKey` only applies if the storage account is not behind a virtual network or a firewall. * * > **Note:** If the `storageContainerSasKey` property is not defined the `storageAccountAccessKey` property is required. */ storageContainerSasKey?: pulumi.Input; } /** * The set of arguments for constructing a ServerVulnerabilityAssessment resource. */ export interface ServerVulnerabilityAssessmentArgs { /** * A `recurringScans` block as defined below. * * > **Note:** To reset the `recurringScans` code block to it's default values you must explicitly define an empty `recurringScans` code block (e.g., `recurringScans {}`) in your configuration file. */ recurringScans?: pulumi.Input; /** * The id of the security alert policy of the MS SQL Server. Changing this forces a new resource to be created. */ serverSecurityAlertPolicyId: pulumi.Input; /** * Specifies the primary access key of the blob storage endpoint. * * > **Note:** The `storageAccountAccessKey` only applies if the storage account is not behind a virtual network or a firewall. * * > **Note:** If the `storageAccountAccessKey` property is not defined the `storageContainerSasKey` property is required. */ storageAccountAccessKey?: pulumi.Input; /** * Specifies the blob storage container path that will hold the scan results (e.g., ). */ storageContainerPath: pulumi.Input; /** * Specifies the shared access signature (SAS Key) that has write access to the blob container specified in `storageContainerPath` property. * * > **Note:** The `storageContainerSasKey` only applies if the storage account is not behind a virtual network or a firewall. * * > **Note:** If the `storageContainerSasKey` property is not defined the `storageAccountAccessKey` property is required. */ storageContainerSasKey?: pulumi.Input; }