Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Equinix
  3. API Docs
  4. networkedge
  5. getDeviceSoftware
Equinix v0.21.0 published on Friday, Feb 28, 2025 by Equinix
equinix/pulumi-equinix

equinix.networkedge.getDeviceSoftware

Explore with Pulumi AI

Equinix v0.21.0 published on Friday, Feb 28, 2025 by Equinix
equinix/pulumi-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.+",
});
Copy
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.+")
Copy
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
	})
}
Copy
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.+",
    });

});
Copy
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());

    }
}
Copy
variables:
  csrLatest1609:
    fn::invoke:
      Function: equinix:networkedge:getDeviceSoftware
      Arguments:
        deviceType: CSR1000V
        mostRecent: true
        packages:
          - IPBASE
        versionRegex: ^16.09.+
Copy

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>
Copy
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]
Copy
func GetDeviceSoftware(ctx *Context, args *GetDeviceSoftwareArgs, opts ...InvokeOption) (*GetDeviceSoftwareResult, error)
func GetDeviceSoftwareOutput(ctx *Context, args *GetDeviceSoftwareOutputArgs, opts ...InvokeOption) GetDeviceSoftwareResultOutput
Copy

> 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)
}
Copy
public static CompletableFuture<GetDeviceSoftwareResult> getDeviceSoftware(GetDeviceSoftwareArgs args, InvokeOptions options)
public static Output<GetDeviceSoftwareResult> getDeviceSoftware(GetDeviceSoftwareArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: equinix:networkedge/getDeviceSoftware:getDeviceSoftware
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

DeviceType This property is required. 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 This property is required. 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 This property is required. 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 This property is required. 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 This property is required. 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 This property is required. 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 v0.21.0 published on Friday, Feb 28, 2025 by Equinix
equinix/pulumi-equinix