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

using System.Collections.Generic;
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 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
	})
}
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());

    }
}
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.+")
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.+",
});
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.