1. Packages
  2. Azure Classic
  3. API Docs
  4. synapse
  5. SqlPoolVulnerabilityAssessment

We recommend using Azure Native.

Azure Classic v6.2.0 published on Friday, Sep 27, 2024 by Pulumi

azure.synapse.SqlPoolVulnerabilityAssessment

Explore with Pulumi AI

azure logo

We recommend using Azure Native.

Azure Classic v6.2.0 published on Friday, Sep 27, 2024 by Pulumi

    Manages the Vulnerability Assessment for a Synapse SQL Pool.

    Example Usage

    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    resources:
      example:
        type: azure:core:ResourceGroup
        properties:
          name: example-resources
          location: West Europe
      exampleAccount:
        type: azure:storage:Account
        name: example
        properties:
          name: examplestorageacc
          resourceGroupName: ${example.name}
          location: ${example.location}
          accountTier: Standard
          accountReplicationType: LRS
          accountKind: StorageV2
          isHnsEnabled: 'true'
      exampleContainer:
        type: azure:storage:Container
        name: example
        properties:
          name: example
          storageAccountName: ${exampleAccount.name}
      exampleDataLakeGen2Filesystem:
        type: azure:storage:DataLakeGen2Filesystem
        name: example
        properties:
          name: example
          storageAccountId: ${exampleAccount.id}
      exampleWorkspace:
        type: azure:synapse:Workspace
        name: example
        properties:
          name: example
          resourceGroupName: ${example.name}
          location: ${example.location}
          storageDataLakeGen2FilesystemId: ${exampleDataLakeGen2Filesystem.id}
          sqlAdministratorLogin: sqladminuser
          sqlAdministratorLoginPassword: H@Sh1CoR3!
          aadAdmin:
            - login: AzureAD Admin
              objectId: 00000000-0000-0000-0000-000000000000
              tenantId: 00000000-0000-0000-0000-000000000000
          identity:
            type: SystemAssigned
          tags:
            Env: production
      exampleSqlPool:
        type: azure:synapse:SqlPool
        name: example
        properties:
          name: examplesqlpool
          synapseWorkspaceId: ${exampleWorkspace.id}
          skuName: DW100c
          createMode: Default
      auditLogs:
        type: azure:storage:Account
        name: audit_logs
        properties:
          name: examplesa
          resourceGroupName: ${example.name}
          location: ${example.location}
          accountTier: Standard
          accountReplicationType: LRS
      exampleSqlPoolSecurityAlertPolicy:
        type: azure:synapse:SqlPoolSecurityAlertPolicy
        name: example
        properties:
          sqlPoolId: ${exampleSqlPool.id}
          policyState: Enabled
          storageEndpoint: ${auditLogs.primaryBlobEndpoint}
          storageAccountAccessKey: ${auditLogs.primaryAccessKey}
          disabledAlerts:
            - Sql_Injection
            - Data_Exfiltration
          retentionDays: 20
      exampleSqlPoolVulnerabilityAssessment:
        type: azure:synapse:SqlPoolVulnerabilityAssessment
        name: example
        properties:
          sqlPoolSecurityAlertPolicyId: ${exampleSqlPoolSecurityAlertPolicy.id}
          storageContainerPath: ${exampleAccount.primaryBlobEndpoint}${exampleContainer.name}/
          storageAccountAccessKey: ${exampleAccount.primaryAccessKey}
          recurringScans:
            enabled: true
            emails:
              - email@example1.com
              - email@example2.com
    

    Create SqlPoolVulnerabilityAssessment Resource

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

    Constructor syntax

    new SqlPoolVulnerabilityAssessment(name: string, args: SqlPoolVulnerabilityAssessmentArgs, opts?: CustomResourceOptions);
    @overload
    def SqlPoolVulnerabilityAssessment(resource_name: str,
                                       args: SqlPoolVulnerabilityAssessmentArgs,
                                       opts: Optional[ResourceOptions] = None)
    
    @overload
    def SqlPoolVulnerabilityAssessment(resource_name: str,
                                       opts: Optional[ResourceOptions] = None,
                                       sql_pool_security_alert_policy_id: Optional[str] = None,
                                       storage_container_path: Optional[str] = None,
                                       recurring_scans: Optional[SqlPoolVulnerabilityAssessmentRecurringScansArgs] = None,
                                       storage_account_access_key: Optional[str] = None,
                                       storage_container_sas_key: Optional[str] = None)
    func NewSqlPoolVulnerabilityAssessment(ctx *Context, name string, args SqlPoolVulnerabilityAssessmentArgs, opts ...ResourceOption) (*SqlPoolVulnerabilityAssessment, error)
    public SqlPoolVulnerabilityAssessment(string name, SqlPoolVulnerabilityAssessmentArgs args, CustomResourceOptions? opts = null)
    public SqlPoolVulnerabilityAssessment(String name, SqlPoolVulnerabilityAssessmentArgs args)
    public SqlPoolVulnerabilityAssessment(String name, SqlPoolVulnerabilityAssessmentArgs args, CustomResourceOptions options)
    
    type: azure:synapse:SqlPoolVulnerabilityAssessment
    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 SqlPoolVulnerabilityAssessmentArgs
    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 SqlPoolVulnerabilityAssessmentArgs
    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 SqlPoolVulnerabilityAssessmentArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args SqlPoolVulnerabilityAssessmentArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args SqlPoolVulnerabilityAssessmentArgs
    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 sqlPoolVulnerabilityAssessmentResource = new Azure.Synapse.SqlPoolVulnerabilityAssessment("sqlPoolVulnerabilityAssessmentResource", new()
    {
        SqlPoolSecurityAlertPolicyId = "string",
        StorageContainerPath = "string",
        RecurringScans = new Azure.Synapse.Inputs.SqlPoolVulnerabilityAssessmentRecurringScansArgs
        {
            EmailSubscriptionAdminsEnabled = false,
            Emails = new[]
            {
                "string",
            },
            Enabled = false,
        },
        StorageAccountAccessKey = "string",
        StorageContainerSasKey = "string",
    });
    
    example, err := synapse.NewSqlPoolVulnerabilityAssessment(ctx, "sqlPoolVulnerabilityAssessmentResource", &synapse.SqlPoolVulnerabilityAssessmentArgs{
    	SqlPoolSecurityAlertPolicyId: pulumi.String("string"),
    	StorageContainerPath:         pulumi.String("string"),
    	RecurringScans: &synapse.SqlPoolVulnerabilityAssessmentRecurringScansArgs{
    		EmailSubscriptionAdminsEnabled: pulumi.Bool(false),
    		Emails: pulumi.StringArray{
    			pulumi.String("string"),
    		},
    		Enabled: pulumi.Bool(false),
    	},
    	StorageAccountAccessKey: pulumi.String("string"),
    	StorageContainerSasKey:  pulumi.String("string"),
    })
    
    var sqlPoolVulnerabilityAssessmentResource = new SqlPoolVulnerabilityAssessment("sqlPoolVulnerabilityAssessmentResource", SqlPoolVulnerabilityAssessmentArgs.builder()
        .sqlPoolSecurityAlertPolicyId("string")
        .storageContainerPath("string")
        .recurringScans(SqlPoolVulnerabilityAssessmentRecurringScansArgs.builder()
            .emailSubscriptionAdminsEnabled(false)
            .emails("string")
            .enabled(false)
            .build())
        .storageAccountAccessKey("string")
        .storageContainerSasKey("string")
        .build());
    
    sql_pool_vulnerability_assessment_resource = azure.synapse.SqlPoolVulnerabilityAssessment("sqlPoolVulnerabilityAssessmentResource",
        sql_pool_security_alert_policy_id="string",
        storage_container_path="string",
        recurring_scans={
            "emailSubscriptionAdminsEnabled": False,
            "emails": ["string"],
            "enabled": False,
        },
        storage_account_access_key="string",
        storage_container_sas_key="string")
    
    const sqlPoolVulnerabilityAssessmentResource = new azure.synapse.SqlPoolVulnerabilityAssessment("sqlPoolVulnerabilityAssessmentResource", {
        sqlPoolSecurityAlertPolicyId: "string",
        storageContainerPath: "string",
        recurringScans: {
            emailSubscriptionAdminsEnabled: false,
            emails: ["string"],
            enabled: false,
        },
        storageAccountAccessKey: "string",
        storageContainerSasKey: "string",
    });
    
    type: azure:synapse:SqlPoolVulnerabilityAssessment
    properties:
        recurringScans:
            emailSubscriptionAdminsEnabled: false
            emails:
                - string
            enabled: false
        sqlPoolSecurityAlertPolicyId: string
        storageAccountAccessKey: string
        storageContainerPath: string
        storageContainerSasKey: string
    

    SqlPoolVulnerabilityAssessment 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 SqlPoolVulnerabilityAssessment resource accepts the following input properties:

    SqlPoolSecurityAlertPolicyId string
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    StorageContainerPath string
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    RecurringScans SqlPoolVulnerabilityAssessmentRecurringScans
    The recurring scans settings. The recurring_scans block supports fields documented below.
    StorageAccountAccessKey string
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    StorageContainerSasKey string
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    SqlPoolSecurityAlertPolicyId string
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    StorageContainerPath string
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    RecurringScans SqlPoolVulnerabilityAssessmentRecurringScansArgs
    The recurring scans settings. The recurring_scans block supports fields documented below.
    StorageAccountAccessKey string
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    StorageContainerSasKey string
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    sqlPoolSecurityAlertPolicyId String
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storageContainerPath String
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    recurringScans SqlPoolVulnerabilityAssessmentRecurringScans
    The recurring scans settings. The recurring_scans block supports fields documented below.
    storageAccountAccessKey String
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storageContainerSasKey String
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    sqlPoolSecurityAlertPolicyId string
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storageContainerPath string
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    recurringScans SqlPoolVulnerabilityAssessmentRecurringScans
    The recurring scans settings. The recurring_scans block supports fields documented below.
    storageAccountAccessKey string
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storageContainerSasKey string
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    sql_pool_security_alert_policy_id str
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storage_container_path str
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    recurring_scans SqlPoolVulnerabilityAssessmentRecurringScansArgs
    The recurring scans settings. The recurring_scans block supports fields documented below.
    storage_account_access_key str
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storage_container_sas_key str
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    sqlPoolSecurityAlertPolicyId String
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storageContainerPath String
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    recurringScans Property Map
    The recurring scans settings. The recurring_scans block supports fields documented below.
    storageAccountAccessKey String
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storageContainerSasKey String
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing SqlPoolVulnerabilityAssessment Resource

    Get an existing SqlPoolVulnerabilityAssessment resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: SqlPoolVulnerabilityAssessmentState, opts?: CustomResourceOptions): SqlPoolVulnerabilityAssessment
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            recurring_scans: Optional[SqlPoolVulnerabilityAssessmentRecurringScansArgs] = None,
            sql_pool_security_alert_policy_id: Optional[str] = None,
            storage_account_access_key: Optional[str] = None,
            storage_container_path: Optional[str] = None,
            storage_container_sas_key: Optional[str] = None) -> SqlPoolVulnerabilityAssessment
    func GetSqlPoolVulnerabilityAssessment(ctx *Context, name string, id IDInput, state *SqlPoolVulnerabilityAssessmentState, opts ...ResourceOption) (*SqlPoolVulnerabilityAssessment, error)
    public static SqlPoolVulnerabilityAssessment Get(string name, Input<string> id, SqlPoolVulnerabilityAssessmentState? state, CustomResourceOptions? opts = null)
    public static SqlPoolVulnerabilityAssessment get(String name, Output<String> id, SqlPoolVulnerabilityAssessmentState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    RecurringScans SqlPoolVulnerabilityAssessmentRecurringScans
    The recurring scans settings. The recurring_scans block supports fields documented below.
    SqlPoolSecurityAlertPolicyId string
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    StorageAccountAccessKey string
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    StorageContainerPath string
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    StorageContainerSasKey string
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    RecurringScans SqlPoolVulnerabilityAssessmentRecurringScansArgs
    The recurring scans settings. The recurring_scans block supports fields documented below.
    SqlPoolSecurityAlertPolicyId string
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    StorageAccountAccessKey string
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    StorageContainerPath string
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    StorageContainerSasKey string
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    recurringScans SqlPoolVulnerabilityAssessmentRecurringScans
    The recurring scans settings. The recurring_scans block supports fields documented below.
    sqlPoolSecurityAlertPolicyId String
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storageAccountAccessKey String
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storageContainerPath String
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    storageContainerSasKey String
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    recurringScans SqlPoolVulnerabilityAssessmentRecurringScans
    The recurring scans settings. The recurring_scans block supports fields documented below.
    sqlPoolSecurityAlertPolicyId string
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storageAccountAccessKey string
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storageContainerPath string
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    storageContainerSasKey string
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    recurring_scans SqlPoolVulnerabilityAssessmentRecurringScansArgs
    The recurring scans settings. The recurring_scans block supports fields documented below.
    sql_pool_security_alert_policy_id str
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storage_account_access_key str
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storage_container_path str
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    storage_container_sas_key str
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.
    recurringScans Property Map
    The recurring scans settings. The recurring_scans block supports fields documented below.
    sqlPoolSecurityAlertPolicyId String
    The ID of the security alert policy of the Synapse SQL Pool. Changing this forces a new resource to be created.
    storageAccountAccessKey String
    Specifies the identifier key of the storage account for vulnerability assessment scan results. If storage_container_sas_key isn't specified, storage_account_access_key is required.
    storageContainerPath String
    A blob storage container path to hold the scan results (e.g. https://example.blob.core.windows.net/VaScans/).
    storageContainerSasKey String
    A shared access signature (SAS Key) that has write access to the blob container specified in storage_container_path parameter. If storage_account_access_key isn't specified, storage_container_sas_key is required.

    Supporting Types

    SqlPoolVulnerabilityAssessmentRecurringScans, SqlPoolVulnerabilityAssessmentRecurringScansArgs

    EmailSubscriptionAdminsEnabled bool
    Boolean flag which specifies if the schedule scan notification will be sent to the subscription administrators. Defaults to true.
    Emails List<string>
    Specifies an array of email addresses to which the scan notification is sent.
    Enabled bool
    Boolean flag which specifies if recurring scans is enabled or disabled. Defaults to false.
    EmailSubscriptionAdminsEnabled bool
    Boolean flag which specifies if the schedule scan notification will be sent to the subscription administrators. Defaults to true.
    Emails []string
    Specifies an array of email addresses to which the scan notification is sent.
    Enabled bool
    Boolean flag which specifies if recurring scans is enabled or disabled. Defaults to false.
    emailSubscriptionAdminsEnabled Boolean
    Boolean flag which specifies if the schedule scan notification will be sent to the subscription administrators. Defaults to true.
    emails List<String>
    Specifies an array of email addresses to which the scan notification is sent.
    enabled Boolean
    Boolean flag which specifies if recurring scans is enabled or disabled. Defaults to false.
    emailSubscriptionAdminsEnabled boolean
    Boolean flag which specifies if the schedule scan notification will be sent to the subscription administrators. Defaults to true.
    emails string[]
    Specifies an array of email addresses to which the scan notification is sent.
    enabled boolean
    Boolean flag which specifies if recurring scans is enabled or disabled. Defaults to false.
    email_subscription_admins_enabled bool
    Boolean flag which specifies if the schedule scan notification will be sent to the subscription administrators. Defaults to true.
    emails Sequence[str]
    Specifies an array of email addresses to which the scan notification is sent.
    enabled bool
    Boolean flag which specifies if recurring scans is enabled or disabled. Defaults to false.
    emailSubscriptionAdminsEnabled Boolean
    Boolean flag which specifies if the schedule scan notification will be sent to the subscription administrators. Defaults to true.
    emails List<String>
    Specifies an array of email addresses to which the scan notification is sent.
    enabled Boolean
    Boolean flag which specifies if recurring scans is enabled or disabled. Defaults to false.

    Import

    Synapse SQL Pool Vulnerability Assessment can be imported using the resource id, e.g.

    $ pulumi import azure:synapse/sqlPoolVulnerabilityAssessment:SqlPoolVulnerabilityAssessment example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Synapse/workspaces/workspace1/sqlPools/sqlPool1/vulnerabilityAssessments/default
    

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

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the azurerm Terraform Provider.
    azure logo

    We recommend using Azure Native.

    Azure Classic v6.2.0 published on Friday, Sep 27, 2024 by Pulumi