Equinix v0.2.1, May 4 23

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.