1. Packages
  2. Packages
  3. Nsxt Provider
  4. API Docs
  5. getPolicyIdpsSignatureVersion
Viewing docs for nsxt 3.12.0
published on Monday, May 18, 2026 by vmware
Viewing docs for nsxt 3.12.0
published on Monday, May 18, 2026 by vmware

    This data source provides information about IDPS signature versions in NSX Policy manager. Signature versions are system-managed resources that are automatically created when NSX downloads signature updates.

    This data source is applicable to NSX Policy Manager (NSX version 4.2.0 onwards).

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as nsxt from "@pulumi/nsxt";
    
    // Look up signature version by display name
    const latest = nsxt.getPolicyIdpsSignatureVersion({
        displayName: "2024.01.15",
    });
    // Look up signature version by ID
    const specific = nsxt.getPolicyIdpsSignatureVersion({
        id: "version-2024.01.15",
    });
    export const versionStatus = latest.then(latest => latest.status);
    
    import pulumi
    import pulumi_nsxt as nsxt
    
    # Look up signature version by display name
    latest = nsxt.get_policy_idps_signature_version(display_name="2024.01.15")
    # Look up signature version by ID
    specific = nsxt.get_policy_idps_signature_version(id="version-2024.01.15")
    pulumi.export("versionStatus", latest.status)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/nsxt/v3/nsxt"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Look up signature version by display name
    		latest, err := nsxt.LookupPolicyIdpsSignatureVersion(ctx, &nsxt.LookupPolicyIdpsSignatureVersionArgs{
    			DisplayName: pulumi.StringRef("2024.01.15"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		// Look up signature version by ID
    		_, err = nsxt.LookupPolicyIdpsSignatureVersion(ctx, &nsxt.LookupPolicyIdpsSignatureVersionArgs{
    			Id: pulumi.StringRef("version-2024.01.15"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("versionStatus", latest.Status)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Nsxt = Pulumi.Nsxt;
    
    return await Deployment.RunAsync(() => 
    {
        // Look up signature version by display name
        var latest = Nsxt.GetPolicyIdpsSignatureVersion.Invoke(new()
        {
            DisplayName = "2024.01.15",
        });
    
        // Look up signature version by ID
        var specific = Nsxt.GetPolicyIdpsSignatureVersion.Invoke(new()
        {
            Id = "version-2024.01.15",
        });
    
        return new Dictionary<string, object?>
        {
            ["versionStatus"] = latest.Apply(getPolicyIdpsSignatureVersionResult => getPolicyIdpsSignatureVersionResult.Status),
        };
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.nsxt.NsxtFunctions;
    import com.pulumi.nsxt.inputs.GetPolicyIdpsSignatureVersionArgs;
    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) {
            // Look up signature version by display name
            final var latest = NsxtFunctions.getPolicyIdpsSignatureVersion(GetPolicyIdpsSignatureVersionArgs.builder()
                .displayName("2024.01.15")
                .build());
    
            // Look up signature version by ID
            final var specific = NsxtFunctions.getPolicyIdpsSignatureVersion(GetPolicyIdpsSignatureVersionArgs.builder()
                .id("version-2024.01.15")
                .build());
    
            ctx.export("versionStatus", latest.status());
        }
    }
    
    variables:
      # Look up signature version by display name
      latest:
        fn::invoke:
          function: nsxt:getPolicyIdpsSignatureVersion
          arguments:
            displayName: 2024.01.15
      # Look up signature version by ID
      specific:
        fn::invoke:
          function: nsxt:getPolicyIdpsSignatureVersion
          arguments:
            id: version-2024.01.15
    outputs:
      # Use in other resources
      versionStatus: ${latest.status}
    
    Example coming soon!
    

    Using getPolicyIdpsSignatureVersion

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getPolicyIdpsSignatureVersion(args: GetPolicyIdpsSignatureVersionArgs, opts?: InvokeOptions): Promise<GetPolicyIdpsSignatureVersionResult>
    function getPolicyIdpsSignatureVersionOutput(args: GetPolicyIdpsSignatureVersionOutputArgs, opts?: InvokeOptions): Output<GetPolicyIdpsSignatureVersionResult>
    def get_policy_idps_signature_version(description: Optional[str] = None,
                                          display_name: Optional[str] = None,
                                          id: Optional[str] = None,
                                          opts: Optional[InvokeOptions] = None) -> GetPolicyIdpsSignatureVersionResult
    def get_policy_idps_signature_version_output(description: pulumi.Input[Optional[str]] = None,
                                          display_name: pulumi.Input[Optional[str]] = None,
                                          id: pulumi.Input[Optional[str]] = None,
                                          opts: Optional[InvokeOptions] = None) -> Output[GetPolicyIdpsSignatureVersionResult]
    func LookupPolicyIdpsSignatureVersion(ctx *Context, args *LookupPolicyIdpsSignatureVersionArgs, opts ...InvokeOption) (*LookupPolicyIdpsSignatureVersionResult, error)
    func LookupPolicyIdpsSignatureVersionOutput(ctx *Context, args *LookupPolicyIdpsSignatureVersionOutputArgs, opts ...InvokeOption) LookupPolicyIdpsSignatureVersionResultOutput

    > Note: This function is named LookupPolicyIdpsSignatureVersion in the Go SDK.

    public static class GetPolicyIdpsSignatureVersion 
    {
        public static Task<GetPolicyIdpsSignatureVersionResult> InvokeAsync(GetPolicyIdpsSignatureVersionArgs args, InvokeOptions? opts = null)
        public static Output<GetPolicyIdpsSignatureVersionResult> Invoke(GetPolicyIdpsSignatureVersionInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetPolicyIdpsSignatureVersionResult> getPolicyIdpsSignatureVersion(GetPolicyIdpsSignatureVersionArgs args, InvokeOptions options)
    public static Output<GetPolicyIdpsSignatureVersionResult> getPolicyIdpsSignatureVersion(GetPolicyIdpsSignatureVersionArgs args, InvokeOptions options)
    
    fn::invoke:
      function: nsxt:index/getPolicyIdpsSignatureVersion:getPolicyIdpsSignatureVersion
      arguments:
        # arguments dictionary
    data "nsxt_getpolicyidpssignatureversion" "name" {
        # arguments
    }

    The following arguments are supported:

    Description string
    Description of the resource.
    DisplayName string
    The Display Name prefix of the signature version to retrieve.
    Id string
    The ID of the signature version to retrieve.
    Description string
    Description of the resource.
    DisplayName string
    The Display Name prefix of the signature version to retrieve.
    Id string
    The ID of the signature version to retrieve.
    description string
    Description of the resource.
    display_name string
    The Display Name prefix of the signature version to retrieve.
    id string
    The ID of the signature version to retrieve.
    description String
    Description of the resource.
    displayName String
    The Display Name prefix of the signature version to retrieve.
    id String
    The ID of the signature version to retrieve.
    description string
    Description of the resource.
    displayName string
    The Display Name prefix of the signature version to retrieve.
    id string
    The ID of the signature version to retrieve.
    description str
    Description of the resource.
    display_name str
    The Display Name prefix of the signature version to retrieve.
    id str
    The ID of the signature version to retrieve.
    description String
    Description of the resource.
    displayName String
    The Display Name prefix of the signature version to retrieve.
    id String
    The ID of the signature version to retrieve.

    getPolicyIdpsSignatureVersion Result

    The following output properties are available:

    AutoUpdate bool
    Whether this version came via the auto-update mechanism.
    ChangeLog string
    Version change log describing updates.
    Description string
    Description of the resource.
    DisplayName string
    Id string
    Path string
    NSX policy path.
    Sites List<string>
    List of sites mapped with this signature version.
    State string
    Current state (ACTIVE or NOTACTIVE).
    Status string
    Version status (LATEST or OUTDATED).
    UpdateTime double
    Time when version was downloaded and saved (epoch milliseconds).
    UserUploaded bool
    Whether this version was uploaded by a user.
    VersionId string
    Signature version identifier string.
    VersionName string
    Human-readable version name.
    AutoUpdate bool
    Whether this version came via the auto-update mechanism.
    ChangeLog string
    Version change log describing updates.
    Description string
    Description of the resource.
    DisplayName string
    Id string
    Path string
    NSX policy path.
    Sites []string
    List of sites mapped with this signature version.
    State string
    Current state (ACTIVE or NOTACTIVE).
    Status string
    Version status (LATEST or OUTDATED).
    UpdateTime float64
    Time when version was downloaded and saved (epoch milliseconds).
    UserUploaded bool
    Whether this version was uploaded by a user.
    VersionId string
    Signature version identifier string.
    VersionName string
    Human-readable version name.
    auto_update bool
    Whether this version came via the auto-update mechanism.
    change_log string
    Version change log describing updates.
    description string
    Description of the resource.
    display_name string
    id string
    path string
    NSX policy path.
    sites list(string)
    List of sites mapped with this signature version.
    state string
    Current state (ACTIVE or NOTACTIVE).
    status string
    Version status (LATEST or OUTDATED).
    update_time number
    Time when version was downloaded and saved (epoch milliseconds).
    user_uploaded bool
    Whether this version was uploaded by a user.
    version_id string
    Signature version identifier string.
    version_name string
    Human-readable version name.
    autoUpdate Boolean
    Whether this version came via the auto-update mechanism.
    changeLog String
    Version change log describing updates.
    description String
    Description of the resource.
    displayName String
    id String
    path String
    NSX policy path.
    sites List<String>
    List of sites mapped with this signature version.
    state String
    Current state (ACTIVE or NOTACTIVE).
    status String
    Version status (LATEST or OUTDATED).
    updateTime Double
    Time when version was downloaded and saved (epoch milliseconds).
    userUploaded Boolean
    Whether this version was uploaded by a user.
    versionId String
    Signature version identifier string.
    versionName String
    Human-readable version name.
    autoUpdate boolean
    Whether this version came via the auto-update mechanism.
    changeLog string
    Version change log describing updates.
    description string
    Description of the resource.
    displayName string
    id string
    path string
    NSX policy path.
    sites string[]
    List of sites mapped with this signature version.
    state string
    Current state (ACTIVE or NOTACTIVE).
    status string
    Version status (LATEST or OUTDATED).
    updateTime number
    Time when version was downloaded and saved (epoch milliseconds).
    userUploaded boolean
    Whether this version was uploaded by a user.
    versionId string
    Signature version identifier string.
    versionName string
    Human-readable version name.
    auto_update bool
    Whether this version came via the auto-update mechanism.
    change_log str
    Version change log describing updates.
    description str
    Description of the resource.
    display_name str
    id str
    path str
    NSX policy path.
    sites Sequence[str]
    List of sites mapped with this signature version.
    state str
    Current state (ACTIVE or NOTACTIVE).
    status str
    Version status (LATEST or OUTDATED).
    update_time float
    Time when version was downloaded and saved (epoch milliseconds).
    user_uploaded bool
    Whether this version was uploaded by a user.
    version_id str
    Signature version identifier string.
    version_name str
    Human-readable version name.
    autoUpdate Boolean
    Whether this version came via the auto-update mechanism.
    changeLog String
    Version change log describing updates.
    description String
    Description of the resource.
    displayName String
    id String
    path String
    NSX policy path.
    sites List<String>
    List of sites mapped with this signature version.
    state String
    Current state (ACTIVE or NOTACTIVE).
    status String
    Version status (LATEST or OUTDATED).
    updateTime Number
    Time when version was downloaded and saved (epoch milliseconds).
    userUploaded Boolean
    Whether this version was uploaded by a user.
    versionId String
    Signature version identifier string.
    versionName String
    Human-readable version name.

    Package Details

    Repository
    nsxt vmware/terraform-provider-nsxt
    License
    Notes
    This Pulumi package is based on the nsxt Terraform Provider.
    Viewing docs for nsxt 3.12.0
    published on Monday, May 18, 2026 by vmware

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial