Equinix v0.11.2 published on Wednesday, Jun 26, 2024 by Equinix
equinix.networkedge.getDeviceSoftware
Explore with Pulumi AI
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 dictionaryThe following arguments are supported:
- Device
Type string - 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 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.
 - Version
Regex string - A regex string to apply on returned versions and filter search results.
 
- Device
Type string - 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 []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.
 - Version
Regex string - A regex string to apply on returned versions and filter search results.
 
- device
Type String - Code of a device type.
 - most
Recent 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.
 - version
Regex String - A regex string to apply on returned versions and filter search results.
 
- device
Type string - Code of a device type.
 - most
Recent 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.
 - version
Regex 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.
 
- device
Type String - Code of a device type.
 - most
Recent 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.
 - version
Regex 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.
 - Device
Type string - Id string
 - The provider-assigned unique ID for this managed resource.
 - Image
Name string - Software image name.
 - Packages List<string>
 - Release
Notes stringLink  - Link to version release notes.
 - Stable bool
 - Status string
 - Version status.
 - Version string
 - Version number.
 - Most
Recent bool - Version
Regex string 
- Date string
 - Version release date.
 - Device
Type string - Id string
 - The provider-assigned unique ID for this managed resource.
 - Image
Name string - Software image name.
 - Packages []string
 - Release
Notes stringLink  - Link to version release notes.
 - Stable bool
 - Status string
 - Version status.
 - Version string
 - Version number.
 - Most
Recent bool - Version
Regex string 
- date String
 - Version release date.
 - device
Type String - id String
 - The provider-assigned unique ID for this managed resource.
 - image
Name String - Software image name.
 - packages List<String>
 - release
Notes StringLink  - Link to version release notes.
 - stable Boolean
 - status String
 - Version status.
 - version String
 - Version number.
 - most
Recent Boolean - version
Regex String 
- date string
 - Version release date.
 - device
Type string - id string
 - The provider-assigned unique ID for this managed resource.
 - image
Name string - Software image name.
 - packages string[]
 - release
Notes stringLink  - Link to version release notes.
 - stable boolean
 - status string
 - Version status.
 - version string
 - Version number.
 - most
Recent boolean - version
Regex 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_ strlink  - 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.
 - device
Type String - id String
 - The provider-assigned unique ID for this managed resource.
 - image
Name String - Software image name.
 - packages List<String>
 - release
Notes StringLink  - Link to version release notes.
 - stable Boolean
 - status String
 - Version status.
 - version String
 - Version number.
 - most
Recent Boolean - version
Regex String 
Package Details
- Repository
 - equinix equinix/pulumi-equinix
 - License
 - Apache-2.0
 - Notes
 - This Pulumi package is based on the 
equinixTerraform Provider.