1. Packages
  2. Equinix
  3. API Docs
  4. networkedge
  5. getDeviceSoftware
Equinix v0.8.0 published on Tuesday, Apr 2, 2024 by Equinix

equinix.networkedge.getDeviceSoftware

Explore with Pulumi AI

equinix logo
Equinix v0.8.0 published on Tuesday, Apr 2, 2024 by Equinix

    Use this data source to get Equinix Network Edge device software details for a given device type. For further details, check supported Network Edge Vendors and Devices.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as equinix from "@pulumi/equinix";
    
    const csrLatest1609 = equinix.networkedge.getDeviceSoftware({
        deviceType: "CSR1000V",
        mostRecent: true,
        packages: ["IPBASE"],
        versionRegex: "^16.09.+",
    });
    
    import pulumi
    import pulumi_equinix as equinix
    
    csr_latest1609 = equinix.networkedge.get_device_software(device_type="CSR1000V",
        most_recent=True,
        packages=["IPBASE"],
        version_regex="^16.09.+")
    
    package main
    
    import (
    	"github.com/equinix/pulumi-equinix/sdk/go/equinix/networkedge"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := networkedge.GetDeviceSoftware(ctx, &networkedge.GetDeviceSoftwareArgs{
    			DeviceType: "CSR1000V",
    			MostRecent: pulumi.BoolRef(true),
    			Packages: []string{
    				"IPBASE",
    			},
    			VersionRegex: pulumi.StringRef("^16.09.+"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Equinix = Pulumi.Equinix;
    
    return await Deployment.RunAsync(() => 
    {
        var csrLatest1609 = Equinix.NetworkEdge.GetDeviceSoftware.Invoke(new()
        {
            DeviceType = "CSR1000V",
            MostRecent = true,
            Packages = new[]
            {
                "IPBASE",
            },
            VersionRegex = "^16.09.+",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.equinix.networkedge.NetworkedgeFunctions;
    import com.pulumi.equinix.networkedge.inputs.GetDeviceSoftwareArgs;
    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) {
            final var csrLatest1609 = NetworkedgeFunctions.getDeviceSoftware(GetDeviceSoftwareArgs.builder()
                .deviceType("CSR1000V")
                .mostRecent(true)
                .packages("IPBASE")
                .versionRegex("^16.09.+")
                .build());
    
        }
    }
    
    variables:
      csrLatest1609:
        fn::invoke:
          Function: equinix:networkedge:getDeviceSoftware
          Arguments:
            deviceType: CSR1000V
            mostRecent: true
            packages:
              - IPBASE
            versionRegex: ^16.09.+
    

    Using getDeviceSoftware

    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 getDeviceSoftware(args: GetDeviceSoftwareArgs, opts?: InvokeOptions): Promise<GetDeviceSoftwareResult>
    function getDeviceSoftwareOutput(args: GetDeviceSoftwareOutputArgs, opts?: InvokeOptions): Output<GetDeviceSoftwareResult>
    def get_device_software(device_type: Optional[str] = None,
                            most_recent: Optional[bool] = None,
                            packages: Optional[Sequence[str]] = None,
                            stable: Optional[bool] = None,
                            version_regex: Optional[str] = None,
                            opts: Optional[InvokeOptions] = None) -> GetDeviceSoftwareResult
    def get_device_software_output(device_type: Optional[pulumi.Input[str]] = None,
                            most_recent: Optional[pulumi.Input[bool]] = None,
                            packages: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                            stable: Optional[pulumi.Input[bool]] = None,
                            version_regex: Optional[pulumi.Input[str]] = None,
                            opts: Optional[InvokeOptions] = None) -> Output[GetDeviceSoftwareResult]
    func GetDeviceSoftware(ctx *Context, args *GetDeviceSoftwareArgs, opts ...InvokeOption) (*GetDeviceSoftwareResult, error)
    func GetDeviceSoftwareOutput(ctx *Context, args *GetDeviceSoftwareOutputArgs, opts ...InvokeOption) GetDeviceSoftwareResultOutput

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

    public static class GetDeviceSoftware 
    {
        public static Task<GetDeviceSoftwareResult> InvokeAsync(GetDeviceSoftwareArgs args, InvokeOptions? opts = null)
        public static Output<GetDeviceSoftwareResult> Invoke(GetDeviceSoftwareInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetDeviceSoftwareResult> getDeviceSoftware(GetDeviceSoftwareArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: equinix:networkedge/getDeviceSoftware:getDeviceSoftware
      arguments:
        # arguments dictionary

    The following arguments are supported:

    DeviceType string
    Code of a device type.
    MostRecent bool
    Boolean value to indicate that most recent version should be used (in case when more than one result is returned).
    Packages List<string>
    Limits returned versions to those that are supported by given software package codes.
    Stable bool
    Boolean value to limit query results to stable versions only.
    VersionRegex string
    A regex string to apply on returned versions and filter search results.
    DeviceType string
    Code of a device type.
    MostRecent bool
    Boolean value to indicate that most recent version should be used (in case when more than one result is returned).
    Packages []string
    Limits returned versions to those that are supported by given software package codes.
    Stable bool
    Boolean value to limit query results to stable versions only.
    VersionRegex string
    A regex string to apply on returned versions and filter search results.
    deviceType String
    Code of a device type.
    mostRecent Boolean
    Boolean value to indicate that most recent version should be used (in case when more than one result is returned).
    packages List<String>
    Limits returned versions to those that are supported by given software package codes.
    stable Boolean
    Boolean value to limit query results to stable versions only.
    versionRegex String
    A regex string to apply on returned versions and filter search results.
    deviceType string
    Code of a device type.
    mostRecent boolean
    Boolean value to indicate that most recent version should be used (in case when more than one result is returned).
    packages string[]
    Limits returned versions to those that are supported by given software package codes.
    stable boolean
    Boolean value to limit query results to stable versions only.
    versionRegex string
    A regex string to apply on returned versions and filter search results.
    device_type str
    Code of a device type.
    most_recent bool
    Boolean value to indicate that most recent version should be used (in case when more than one result is returned).
    packages Sequence[str]
    Limits returned versions to those that are supported by given software package codes.
    stable bool
    Boolean value to limit query results to stable versions only.
    version_regex str
    A regex string to apply on returned versions and filter search results.
    deviceType String
    Code of a device type.
    mostRecent Boolean
    Boolean value to indicate that most recent version should be used (in case when more than one result is returned).
    packages List<String>
    Limits returned versions to those that are supported by given software package codes.
    stable Boolean
    Boolean value to limit query results to stable versions only.
    versionRegex String
    A regex string to apply on returned versions and filter search results.

    getDeviceSoftware Result

    The following output properties are available:

    Date string
    Version release date.
    DeviceType string
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageName string
    Software image name.
    Packages List<string>
    ReleaseNotesLink string
    Link to version release notes.
    Stable bool
    Status string
    Version status.
    Version string
    Version number.
    MostRecent bool
    VersionRegex string
    Date string
    Version release date.
    DeviceType string
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageName string
    Software image name.
    Packages []string
    ReleaseNotesLink string
    Link to version release notes.
    Stable bool
    Status string
    Version status.
    Version string
    Version number.
    MostRecent bool
    VersionRegex string
    date String
    Version release date.
    deviceType String
    id String
    The provider-assigned unique ID for this managed resource.
    imageName String
    Software image name.
    packages List<String>
    releaseNotesLink String
    Link to version release notes.
    stable Boolean
    status String
    Version status.
    version String
    Version number.
    mostRecent Boolean
    versionRegex String
    date string
    Version release date.
    deviceType string
    id string
    The provider-assigned unique ID for this managed resource.
    imageName string
    Software image name.
    packages string[]
    releaseNotesLink string
    Link to version release notes.
    stable boolean
    status string
    Version status.
    version string
    Version number.
    mostRecent boolean
    versionRegex string
    date str
    Version release date.
    device_type str
    id str
    The provider-assigned unique ID for this managed resource.
    image_name str
    Software image name.
    packages Sequence[str]
    release_notes_link str
    Link to version release notes.
    stable bool
    status str
    Version status.
    version str
    Version number.
    most_recent bool
    version_regex str
    date String
    Version release date.
    deviceType String
    id String
    The provider-assigned unique ID for this managed resource.
    imageName String
    Software image name.
    packages List<String>
    releaseNotesLink String
    Link to version release notes.
    stable Boolean
    status String
    Version status.
    version String
    Version number.
    mostRecent Boolean
    versionRegex String

    Package Details

    Repository
    equinix equinix/pulumi-equinix
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the equinix Terraform Provider.
    equinix logo
    Equinix v0.8.0 published on Tuesday, Apr 2, 2024 by Equinix