1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. AtpMalwareSettings
Viewing docs for pulumi-resource-zia v1.3.8
published on Friday, Mar 13, 2026 by Zscaler
zia logo
Viewing docs for pulumi-resource-zia v1.3.8
published on Friday, Mar 13, 2026 by Zscaler

    The zia_atp_malware_settings resource manages the Advanced Threat Protection (ATP) malware settings in the Zscaler Internet Access (ZIA) cloud service. This singleton resource controls the block and capture actions for different malware categories such as viruses, trojans, worms, adware, spyware, ransomware, remote access tools, and unwanted applications.

    For more information, see the ZIA ATP documentation.

    Example Usage

    Basic ATP Malware Settings

    Example coming soon!

    Example coming soon!

    Example coming soon!

    import * as zia from "@bdzscaler/pulumi-zia";
    
    const example = new zia.AtpMalwareSettings("example", {
        virusBlocked: true,
        virusCapture: true,
        ransomwareBlocked: true,
        ransomwareCapture: true,
        spywareBlocked: true,
        trojanBlocked: true,
    });
    
    import zscaler_pulumi_zia as zia
    
    example = zia.AtpMalwareSettings("example",
        virus_blocked=True,
        virus_capture=True,
        ransomware_blocked=True,
        ransomware_capture=True,
        spyware_blocked=True,
        trojan_blocked=True,
    )
    
    resources:
      example:
        type: zia:AtpMalwareSettings
        properties:
          virusBlocked: true
          virusCapture: true
          ransomwareBlocked: true
          ransomwareCapture: true
          spywareBlocked: true
          trojanBlocked: true
    

    Create AtpMalwareSettings Resource

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

    Constructor syntax

    new AtpMalwareSettings(name: string, args?: AtpMalwareSettingsArgs, opts?: CustomResourceOptions);
    @overload
    def AtpMalwareSettings(resource_name: str,
                           args: Optional[AtpMalwareSettingsArgs] = None,
                           opts: Optional[ResourceOptions] = None)
    
    @overload
    def AtpMalwareSettings(resource_name: str,
                           opts: Optional[ResourceOptions] = None,
                           adware_blocked: Optional[bool] = None,
                           adware_capture: Optional[bool] = None,
                           ransomware_blocked: Optional[bool] = None,
                           ransomware_capture: Optional[bool] = None,
                           remote_access_tool_blocked: Optional[bool] = None,
                           remote_access_tool_capture: Optional[bool] = None,
                           spyware_blocked: Optional[bool] = None,
                           spyware_capture: Optional[bool] = None,
                           trojan_blocked: Optional[bool] = None,
                           trojan_capture: Optional[bool] = None,
                           unwanted_applications_blocked: Optional[bool] = None,
                           unwanted_applications_capture: Optional[bool] = None,
                           virus_blocked: Optional[bool] = None,
                           virus_capture: Optional[bool] = None,
                           worm_blocked: Optional[bool] = None,
                           worm_capture: Optional[bool] = None)
    func NewAtpMalwareSettings(ctx *Context, name string, args *AtpMalwareSettingsArgs, opts ...ResourceOption) (*AtpMalwareSettings, error)
    public AtpMalwareSettings(string name, AtpMalwareSettingsArgs? args = null, CustomResourceOptions? opts = null)
    public AtpMalwareSettings(String name, AtpMalwareSettingsArgs args)
    public AtpMalwareSettings(String name, AtpMalwareSettingsArgs args, CustomResourceOptions options)
    
    type: zia:AtpMalwareSettings
    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 AtpMalwareSettingsArgs
    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 AtpMalwareSettingsArgs
    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 AtpMalwareSettingsArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AtpMalwareSettingsArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AtpMalwareSettingsArgs
    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 atpMalwareSettingsResource = new Zia.AtpMalwareSettings("atpMalwareSettingsResource", new()
    {
        AdwareBlocked = false,
        AdwareCapture = false,
        RansomwareBlocked = false,
        RansomwareCapture = false,
        RemoteAccessToolBlocked = false,
        RemoteAccessToolCapture = false,
        SpywareBlocked = false,
        SpywareCapture = false,
        TrojanBlocked = false,
        TrojanCapture = false,
        UnwantedApplicationsBlocked = false,
        UnwantedApplicationsCapture = false,
        VirusBlocked = false,
        VirusCapture = false,
        WormBlocked = false,
        WormCapture = false,
    });
    
    example, err := zia.NewAtpMalwareSettings(ctx, "atpMalwareSettingsResource", &zia.AtpMalwareSettingsArgs{
    	AdwareBlocked:               pulumi.Bool(false),
    	AdwareCapture:               pulumi.Bool(false),
    	RansomwareBlocked:           pulumi.Bool(false),
    	RansomwareCapture:           pulumi.Bool(false),
    	RemoteAccessToolBlocked:     pulumi.Bool(false),
    	RemoteAccessToolCapture:     pulumi.Bool(false),
    	SpywareBlocked:              pulumi.Bool(false),
    	SpywareCapture:              pulumi.Bool(false),
    	TrojanBlocked:               pulumi.Bool(false),
    	TrojanCapture:               pulumi.Bool(false),
    	UnwantedApplicationsBlocked: pulumi.Bool(false),
    	UnwantedApplicationsCapture: pulumi.Bool(false),
    	VirusBlocked:                pulumi.Bool(false),
    	VirusCapture:                pulumi.Bool(false),
    	WormBlocked:                 pulumi.Bool(false),
    	WormCapture:                 pulumi.Bool(false),
    })
    
    var atpMalwareSettingsResource = new AtpMalwareSettings("atpMalwareSettingsResource", AtpMalwareSettingsArgs.builder()
        .adwareBlocked(false)
        .adwareCapture(false)
        .ransomwareBlocked(false)
        .ransomwareCapture(false)
        .remoteAccessToolBlocked(false)
        .remoteAccessToolCapture(false)
        .spywareBlocked(false)
        .spywareCapture(false)
        .trojanBlocked(false)
        .trojanCapture(false)
        .unwantedApplicationsBlocked(false)
        .unwantedApplicationsCapture(false)
        .virusBlocked(false)
        .virusCapture(false)
        .wormBlocked(false)
        .wormCapture(false)
        .build());
    
    atp_malware_settings_resource = zia.AtpMalwareSettings("atpMalwareSettingsResource",
        adware_blocked=False,
        adware_capture=False,
        ransomware_blocked=False,
        ransomware_capture=False,
        remote_access_tool_blocked=False,
        remote_access_tool_capture=False,
        spyware_blocked=False,
        spyware_capture=False,
        trojan_blocked=False,
        trojan_capture=False,
        unwanted_applications_blocked=False,
        unwanted_applications_capture=False,
        virus_blocked=False,
        virus_capture=False,
        worm_blocked=False,
        worm_capture=False)
    
    const atpMalwareSettingsResource = new zia.AtpMalwareSettings("atpMalwareSettingsResource", {
        adwareBlocked: false,
        adwareCapture: false,
        ransomwareBlocked: false,
        ransomwareCapture: false,
        remoteAccessToolBlocked: false,
        remoteAccessToolCapture: false,
        spywareBlocked: false,
        spywareCapture: false,
        trojanBlocked: false,
        trojanCapture: false,
        unwantedApplicationsBlocked: false,
        unwantedApplicationsCapture: false,
        virusBlocked: false,
        virusCapture: false,
        wormBlocked: false,
        wormCapture: false,
    });
    
    type: zia:AtpMalwareSettings
    properties:
        adwareBlocked: false
        adwareCapture: false
        ransomwareBlocked: false
        ransomwareCapture: false
        remoteAccessToolBlocked: false
        remoteAccessToolCapture: false
        spywareBlocked: false
        spywareCapture: false
        trojanBlocked: false
        trojanCapture: false
        unwantedApplicationsBlocked: false
        unwantedApplicationsCapture: false
        virusBlocked: false
        virusCapture: false
        wormBlocked: false
        wormCapture: false
    

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

    AdwareBlocked bool
    When set to true, adware threats are blocked.
    AdwareCapture bool
    When set to true, adware threats are captured for analysis.
    RansomwareBlocked bool
    When set to true, ransomware threats are blocked.
    RansomwareCapture bool
    When set to true, ransomware threats are captured for analysis.
    RemoteAccessToolBlocked bool
    When set to true, remote access tools are blocked.
    RemoteAccessToolCapture bool
    When set to true, remote access tools are captured for analysis.
    SpywareBlocked bool
    When set to true, spyware threats are blocked.
    SpywareCapture bool
    When set to true, spyware threats are captured for analysis.
    TrojanBlocked bool
    When set to true, trojan threats are blocked.
    TrojanCapture bool
    When set to true, trojan threats are captured for analysis.
    UnwantedApplicationsBlocked bool
    When set to true, unwanted applications are blocked.
    UnwantedApplicationsCapture bool
    When set to true, unwanted applications are captured for analysis.
    VirusBlocked bool
    When set to true, virus threats are blocked.
    VirusCapture bool
    When set to true, virus threats are captured for analysis.
    WormBlocked bool
    When set to true, worm threats are blocked.
    WormCapture bool
    When set to true, worm threats are captured for analysis.
    AdwareBlocked bool
    When set to true, adware threats are blocked.
    AdwareCapture bool
    When set to true, adware threats are captured for analysis.
    RansomwareBlocked bool
    When set to true, ransomware threats are blocked.
    RansomwareCapture bool
    When set to true, ransomware threats are captured for analysis.
    RemoteAccessToolBlocked bool
    When set to true, remote access tools are blocked.
    RemoteAccessToolCapture bool
    When set to true, remote access tools are captured for analysis.
    SpywareBlocked bool
    When set to true, spyware threats are blocked.
    SpywareCapture bool
    When set to true, spyware threats are captured for analysis.
    TrojanBlocked bool
    When set to true, trojan threats are blocked.
    TrojanCapture bool
    When set to true, trojan threats are captured for analysis.
    UnwantedApplicationsBlocked bool
    When set to true, unwanted applications are blocked.
    UnwantedApplicationsCapture bool
    When set to true, unwanted applications are captured for analysis.
    VirusBlocked bool
    When set to true, virus threats are blocked.
    VirusCapture bool
    When set to true, virus threats are captured for analysis.
    WormBlocked bool
    When set to true, worm threats are blocked.
    WormCapture bool
    When set to true, worm threats are captured for analysis.
    adwareBlocked Boolean
    When set to true, adware threats are blocked.
    adwareCapture Boolean
    When set to true, adware threats are captured for analysis.
    ransomwareBlocked Boolean
    When set to true, ransomware threats are blocked.
    ransomwareCapture Boolean
    When set to true, ransomware threats are captured for analysis.
    remoteAccessToolBlocked Boolean
    When set to true, remote access tools are blocked.
    remoteAccessToolCapture Boolean
    When set to true, remote access tools are captured for analysis.
    spywareBlocked Boolean
    When set to true, spyware threats are blocked.
    spywareCapture Boolean
    When set to true, spyware threats are captured for analysis.
    trojanBlocked Boolean
    When set to true, trojan threats are blocked.
    trojanCapture Boolean
    When set to true, trojan threats are captured for analysis.
    unwantedApplicationsBlocked Boolean
    When set to true, unwanted applications are blocked.
    unwantedApplicationsCapture Boolean
    When set to true, unwanted applications are captured for analysis.
    virusBlocked Boolean
    When set to true, virus threats are blocked.
    virusCapture Boolean
    When set to true, virus threats are captured for analysis.
    wormBlocked Boolean
    When set to true, worm threats are blocked.
    wormCapture Boolean
    When set to true, worm threats are captured for analysis.
    adwareBlocked boolean
    When set to true, adware threats are blocked.
    adwareCapture boolean
    When set to true, adware threats are captured for analysis.
    ransomwareBlocked boolean
    When set to true, ransomware threats are blocked.
    ransomwareCapture boolean
    When set to true, ransomware threats are captured for analysis.
    remoteAccessToolBlocked boolean
    When set to true, remote access tools are blocked.
    remoteAccessToolCapture boolean
    When set to true, remote access tools are captured for analysis.
    spywareBlocked boolean
    When set to true, spyware threats are blocked.
    spywareCapture boolean
    When set to true, spyware threats are captured for analysis.
    trojanBlocked boolean
    When set to true, trojan threats are blocked.
    trojanCapture boolean
    When set to true, trojan threats are captured for analysis.
    unwantedApplicationsBlocked boolean
    When set to true, unwanted applications are blocked.
    unwantedApplicationsCapture boolean
    When set to true, unwanted applications are captured for analysis.
    virusBlocked boolean
    When set to true, virus threats are blocked.
    virusCapture boolean
    When set to true, virus threats are captured for analysis.
    wormBlocked boolean
    When set to true, worm threats are blocked.
    wormCapture boolean
    When set to true, worm threats are captured for analysis.
    adware_blocked bool
    When set to true, adware threats are blocked.
    adware_capture bool
    When set to true, adware threats are captured for analysis.
    ransomware_blocked bool
    When set to true, ransomware threats are blocked.
    ransomware_capture bool
    When set to true, ransomware threats are captured for analysis.
    remote_access_tool_blocked bool
    When set to true, remote access tools are blocked.
    remote_access_tool_capture bool
    When set to true, remote access tools are captured for analysis.
    spyware_blocked bool
    When set to true, spyware threats are blocked.
    spyware_capture bool
    When set to true, spyware threats are captured for analysis.
    trojan_blocked bool
    When set to true, trojan threats are blocked.
    trojan_capture bool
    When set to true, trojan threats are captured for analysis.
    unwanted_applications_blocked bool
    When set to true, unwanted applications are blocked.
    unwanted_applications_capture bool
    When set to true, unwanted applications are captured for analysis.
    virus_blocked bool
    When set to true, virus threats are blocked.
    virus_capture bool
    When set to true, virus threats are captured for analysis.
    worm_blocked bool
    When set to true, worm threats are blocked.
    worm_capture bool
    When set to true, worm threats are captured for analysis.
    adwareBlocked Boolean
    When set to true, adware threats are blocked.
    adwareCapture Boolean
    When set to true, adware threats are captured for analysis.
    ransomwareBlocked Boolean
    When set to true, ransomware threats are blocked.
    ransomwareCapture Boolean
    When set to true, ransomware threats are captured for analysis.
    remoteAccessToolBlocked Boolean
    When set to true, remote access tools are blocked.
    remoteAccessToolCapture Boolean
    When set to true, remote access tools are captured for analysis.
    spywareBlocked Boolean
    When set to true, spyware threats are blocked.
    spywareCapture Boolean
    When set to true, spyware threats are captured for analysis.
    trojanBlocked Boolean
    When set to true, trojan threats are blocked.
    trojanCapture Boolean
    When set to true, trojan threats are captured for analysis.
    unwantedApplicationsBlocked Boolean
    When set to true, unwanted applications are blocked.
    unwantedApplicationsCapture Boolean
    When set to true, unwanted applications are captured for analysis.
    virusBlocked Boolean
    When set to true, virus threats are blocked.
    virusCapture Boolean
    When set to true, virus threats are captured for analysis.
    wormBlocked Boolean
    When set to true, worm threats are blocked.
    wormCapture Boolean
    When set to true, worm threats are captured for analysis.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceId string
    The internal resource identifier for the ATP malware settings.
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceId string
    The internal resource identifier for the ATP malware settings.
    id String
    The provider-assigned unique ID for this managed resource.
    resourceId String
    The internal resource identifier for the ATP malware settings.
    id string
    The provider-assigned unique ID for this managed resource.
    resourceId string
    The internal resource identifier for the ATP malware settings.
    id str
    The provider-assigned unique ID for this managed resource.
    resource_id str
    The internal resource identifier for the ATP malware settings.
    id String
    The provider-assigned unique ID for this managed resource.
    resourceId String
    The internal resource identifier for the ATP malware settings.

    Import

    This is a singleton resource and does not support traditional import. It is automatically managed by the provider.

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

    Package Details

    Repository
    zia zscaler/pulumi-zia
    License
    zia logo
    Viewing docs for pulumi-resource-zia v1.3.8
    published on Friday, Mar 13, 2026 by Zscaler
      Try Pulumi Cloud free. Your team will thank you.