Equinix v0.19.0 published on Thursday, Oct 24, 2024 by Equinix
equinix.fabric.getNetwork
Explore with Pulumi AI
Fabric V4 API compatible data resource that allow user to fetch Fabric Network for a given UUID
Additional documentation:
- Getting Started: https://docs.equinix.com/en-us/Content/Interconnection/Fabric/IMPLEMENTATION/fabric-networks-implement.htm
- API: https://developer.equinix.com/dev-docs/fabric/api-reference/fabric-v4-apis#fabric-networks
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as equinix from "@pulumi/equinix";
const networkDataName = equinix.fabric.getNetwork({
uuid: "<uuid_of_network>",
});
export const id = networkDataName.then(networkDataName => networkDataName.id);
export const name = networkDataName.then(networkDataName => networkDataName.name);
export const scope = networkDataName.then(networkDataName => networkDataName.scope);
export const type = networkDataName.then(networkDataName => networkDataName.type);
export const region = networkDataName.then(networkDataName => networkDataName.locations?.[0]?.region);
import pulumi
import pulumi_equinix as equinix
network_data_name = equinix.fabric.get_network(uuid="<uuid_of_network>")
pulumi.export("id", network_data_name.id)
pulumi.export("name", network_data_name.name)
pulumi.export("scope", network_data_name.scope)
pulumi.export("type", network_data_name.type)
pulumi.export("region", network_data_name.locations[0].region)
package main
import (
"github.com/equinix/pulumi-equinix/sdk/go/equinix/fabric"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
networkDataName, err := fabric.LookupNetwork(ctx, &fabric.LookupNetworkArgs{
Uuid: "<uuid_of_network>",
}, nil)
if err != nil {
return err
}
ctx.Export("id", networkDataName.Id)
ctx.Export("name", networkDataName.Name)
ctx.Export("scope", networkDataName.Scope)
ctx.Export("type", networkDataName.Type)
ctx.Export("region", networkDataName.Locations[0].Region)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Equinix = Pulumi.Equinix;
return await Deployment.RunAsync(() =>
{
var networkDataName = Equinix.Fabric.GetNetwork.Invoke(new()
{
Uuid = "<uuid_of_network>",
});
return new Dictionary<string, object?>
{
["id"] = networkDataName.Apply(getNetworkResult => getNetworkResult.Id),
["name"] = networkDataName.Apply(getNetworkResult => getNetworkResult.Name),
["scope"] = networkDataName.Apply(getNetworkResult => getNetworkResult.Scope),
["type"] = networkDataName.Apply(getNetworkResult => getNetworkResult.Type),
["region"] = networkDataName.Apply(getNetworkResult => getNetworkResult.Locations[0]?.Region),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.equinix.fabric.FabricFunctions;
import com.pulumi.equinix.fabric.inputs.GetNetworkArgs;
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 networkDataName = FabricFunctions.getNetwork(GetNetworkArgs.builder()
.uuid("<uuid_of_network>")
.build());
ctx.export("id", networkDataName.applyValue(getNetworkResult -> getNetworkResult.id()));
ctx.export("name", networkDataName.applyValue(getNetworkResult -> getNetworkResult.name()));
ctx.export("scope", networkDataName.applyValue(getNetworkResult -> getNetworkResult.scope()));
ctx.export("type", networkDataName.applyValue(getNetworkResult -> getNetworkResult.type()));
ctx.export("region", networkDataName.applyValue(getNetworkResult -> getNetworkResult.locations()[0].region()));
}
}
variables:
networkDataName:
fn::invoke:
Function: equinix:fabric:getNetwork
Arguments:
uuid: <uuid_of_network>
outputs:
id: ${networkDataName.id}
name: ${networkDataName.name}
scope: ${networkDataName.scope}
type: ${networkDataName.type}
region: ${networkDataName.locations[0].region}
Using getNetwork
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 getNetwork(args: GetNetworkArgs, opts?: InvokeOptions): Promise<GetNetworkResult>
function getNetworkOutput(args: GetNetworkOutputArgs, opts?: InvokeOptions): Output<GetNetworkResult>
def get_network(uuid: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetNetworkResult
def get_network_output(uuid: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetNetworkResult]
func LookupNetwork(ctx *Context, args *LookupNetworkArgs, opts ...InvokeOption) (*LookupNetworkResult, error)
func LookupNetworkOutput(ctx *Context, args *LookupNetworkOutputArgs, opts ...InvokeOption) LookupNetworkResultOutput
> Note: This function is named LookupNetwork
in the Go SDK.
public static class GetNetwork
{
public static Task<GetNetworkResult> InvokeAsync(GetNetworkArgs args, InvokeOptions? opts = null)
public static Output<GetNetworkResult> Invoke(GetNetworkInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetNetworkResult> getNetwork(GetNetworkArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: equinix:fabric/getNetwork:getNetwork
arguments:
# arguments dictionary
The following arguments are supported:
- Uuid string
- Equinix-assigned network identifier
- Uuid string
- Equinix-assigned network identifier
- uuid String
- Equinix-assigned network identifier
- uuid string
- Equinix-assigned network identifier
- uuid str
- Equinix-assigned network identifier
- uuid String
- Equinix-assigned network identifier
getNetwork Result
The following output properties are available:
- Change
Get
Network Change - Information on asset change operation
- Change
Log GetNetwork Change Log - A permanent record of asset creation, modification, or deletion
- Connections
Count int - Number of connections associated with this network
- Href string
- Fabric Network URI information
- Id string
- The provider-assigned unique ID for this managed resource.
- Locations
List<Get
Network Location> - Fabric Network location
- Name string
- Fabric Network name. An alpha-numeric 24 characters string which can include only hyphens and underscores
- Notifications
List<Get
Network Notification> - Preferences for notifications on Fabric Network configuration or status changes
- Operation
Get
Network Operation - Network operation information that is associated with this Fabric Network
- Project
Get
Network Project - Fabric Network project
- Scope string
- Fabric Network scope
- State string
- Fabric Network overall state
- Type string
- Supported Network types - EVPLAN, EPLAN, IPWAN
- Uuid string
- Equinix-assigned network identifier
- Change
Get
Network Change - Information on asset change operation
- Change
Log GetNetwork Change Log - A permanent record of asset creation, modification, or deletion
- Connections
Count int - Number of connections associated with this network
- Href string
- Fabric Network URI information
- Id string
- The provider-assigned unique ID for this managed resource.
- Locations
[]Get
Network Location - Fabric Network location
- Name string
- Fabric Network name. An alpha-numeric 24 characters string which can include only hyphens and underscores
- Notifications
[]Get
Network Notification - Preferences for notifications on Fabric Network configuration or status changes
- Operation
Get
Network Operation - Network operation information that is associated with this Fabric Network
- Project
Get
Network Project - Fabric Network project
- Scope string
- Fabric Network scope
- State string
- Fabric Network overall state
- Type string
- Supported Network types - EVPLAN, EPLAN, IPWAN
- Uuid string
- Equinix-assigned network identifier
- change
Get
Network Change - Information on asset change operation
- change
Log GetNetwork Change Log - A permanent record of asset creation, modification, or deletion
- connections
Count Integer - Number of connections associated with this network
- href String
- Fabric Network URI information
- id String
- The provider-assigned unique ID for this managed resource.
- locations
List<Get
Network Location> - Fabric Network location
- name String
- Fabric Network name. An alpha-numeric 24 characters string which can include only hyphens and underscores
- notifications
List<Get
Network Notification> - Preferences for notifications on Fabric Network configuration or status changes
- operation
Get
Network Operation - Network operation information that is associated with this Fabric Network
- project
Get
Network Project - Fabric Network project
- scope String
- Fabric Network scope
- state String
- Fabric Network overall state
- type String
- Supported Network types - EVPLAN, EPLAN, IPWAN
- uuid String
- Equinix-assigned network identifier
- change
Get
Network Change - Information on asset change operation
- change
Log GetNetwork Change Log - A permanent record of asset creation, modification, or deletion
- connections
Count number - Number of connections associated with this network
- href string
- Fabric Network URI information
- id string
- The provider-assigned unique ID for this managed resource.
- locations
Get
Network Location[] - Fabric Network location
- name string
- Fabric Network name. An alpha-numeric 24 characters string which can include only hyphens and underscores
- notifications
Get
Network Notification[] - Preferences for notifications on Fabric Network configuration or status changes
- operation
Get
Network Operation - Network operation information that is associated with this Fabric Network
- project
Get
Network Project - Fabric Network project
- scope string
- Fabric Network scope
- state string
- Fabric Network overall state
- type string
- Supported Network types - EVPLAN, EPLAN, IPWAN
- uuid string
- Equinix-assigned network identifier
- change
Get
Network Change - Information on asset change operation
- change_
log GetNetwork Change Log - A permanent record of asset creation, modification, or deletion
- connections_
count int - Number of connections associated with this network
- href str
- Fabric Network URI information
- id str
- The provider-assigned unique ID for this managed resource.
- locations
Sequence[Get
Network Location] - Fabric Network location
- name str
- Fabric Network name. An alpha-numeric 24 characters string which can include only hyphens and underscores
- notifications
Sequence[Get
Network Notification] - Preferences for notifications on Fabric Network configuration or status changes
- operation
Get
Network Operation - Network operation information that is associated with this Fabric Network
- project
Get
Network Project - Fabric Network project
- scope str
- Fabric Network scope
- state str
- Fabric Network overall state
- type str
- Supported Network types - EVPLAN, EPLAN, IPWAN
- uuid str
- Equinix-assigned network identifier
- change Property Map
- Information on asset change operation
- change
Log Property Map - A permanent record of asset creation, modification, or deletion
- connections
Count Number - Number of connections associated with this network
- href String
- Fabric Network URI information
- id String
- The provider-assigned unique ID for this managed resource.
- locations List<Property Map>
- Fabric Network location
- name String
- Fabric Network name. An alpha-numeric 24 characters string which can include only hyphens and underscores
- notifications List<Property Map>
- Preferences for notifications on Fabric Network configuration or status changes
- operation Property Map
- Network operation information that is associated with this Fabric Network
- project Property Map
- Fabric Network project
- scope String
- Fabric Network scope
- state String
- Fabric Network overall state
- type String
- Supported Network types - EVPLAN, EPLAN, IPWAN
- uuid String
- Equinix-assigned network identifier
Supporting Types
GetNetworkChange
GetNetworkChangeLog
- Created
By string - Created by User Key
- Created
By stringEmail - Created by User Email Address
- Created
By stringFull Name - Created by User Full Name
- Created
Date stringTime - Created by Date and Time
- Deleted
By string - Deleted by User Key
- Deleted
By stringEmail - Deleted by User Email Address
- Deleted
By stringFull Name - Deleted by User Full Name
- Deleted
Date stringTime - Deleted by Date and Time
- Updated
By string - Updated by User Key
- Updated
By stringEmail - Updated by User Email Address
- Updated
By stringFull Name - Updated by User Full Name
- Updated
Date stringTime - Updated by Date and Time
- Created
By string - Created by User Key
- Created
By stringEmail - Created by User Email Address
- Created
By stringFull Name - Created by User Full Name
- Created
Date stringTime - Created by Date and Time
- Deleted
By string - Deleted by User Key
- Deleted
By stringEmail - Deleted by User Email Address
- Deleted
By stringFull Name - Deleted by User Full Name
- Deleted
Date stringTime - Deleted by Date and Time
- Updated
By string - Updated by User Key
- Updated
By stringEmail - Updated by User Email Address
- Updated
By stringFull Name - Updated by User Full Name
- Updated
Date stringTime - Updated by Date and Time
- created
By String - Created by User Key
- created
By StringEmail - Created by User Email Address
- created
By StringFull Name - Created by User Full Name
- created
Date StringTime - Created by Date and Time
- deleted
By String - Deleted by User Key
- deleted
By StringEmail - Deleted by User Email Address
- deleted
By StringFull Name - Deleted by User Full Name
- deleted
Date StringTime - Deleted by Date and Time
- updated
By String - Updated by User Key
- updated
By StringEmail - Updated by User Email Address
- updated
By StringFull Name - Updated by User Full Name
- updated
Date StringTime - Updated by Date and Time
- created
By string - Created by User Key
- created
By stringEmail - Created by User Email Address
- created
By stringFull Name - Created by User Full Name
- created
Date stringTime - Created by Date and Time
- deleted
By string - Deleted by User Key
- deleted
By stringEmail - Deleted by User Email Address
- deleted
By stringFull Name - Deleted by User Full Name
- deleted
Date stringTime - Deleted by Date and Time
- updated
By string - Updated by User Key
- updated
By stringEmail - Updated by User Email Address
- updated
By stringFull Name - Updated by User Full Name
- updated
Date stringTime - Updated by Date and Time
- created_
by str - Created by User Key
- created_
by_ stremail - Created by User Email Address
- created_
by_ strfull_ name - Created by User Full Name
- created_
date_ strtime - Created by Date and Time
- deleted_
by str - Deleted by User Key
- deleted_
by_ stremail - Deleted by User Email Address
- deleted_
by_ strfull_ name - Deleted by User Full Name
- deleted_
date_ strtime - Deleted by Date and Time
- updated_
by str - Updated by User Key
- updated_
by_ stremail - Updated by User Email Address
- updated_
by_ strfull_ name - Updated by User Full Name
- updated_
date_ strtime - Updated by Date and Time
- created
By String - Created by User Key
- created
By StringEmail - Created by User Email Address
- created
By StringFull Name - Created by User Full Name
- created
Date StringTime - Created by Date and Time
- deleted
By String - Deleted by User Key
- deleted
By StringEmail - Deleted by User Email Address
- deleted
By StringFull Name - Deleted by User Full Name
- deleted
Date StringTime - Deleted by Date and Time
- updated
By String - Updated by User Key
- updated
By StringEmail - Updated by User Email Address
- updated
By StringFull Name - Updated by User Full Name
- updated
Date StringTime - Updated by Date and Time
GetNetworkLocation
- ibx str
- IBX Code
- metro_
code str - Access point metro code
- metro_
name str - Access point metro name
- region str
- Access point region
GetNetworkNotification
- Emails List<string>
- Array of contact emails
- Type string
- Notification Type - ALL,CONNECTION_APPROVAL,SALES_REP_NOTIFICATIONS, NOTIFICATIONS
- Send
Interval string - Send interval
- Emails []string
- Array of contact emails
- Type string
- Notification Type - ALL,CONNECTION_APPROVAL,SALES_REP_NOTIFICATIONS, NOTIFICATIONS
- Send
Interval string - Send interval
- emails List<String>
- Array of contact emails
- type String
- Notification Type - ALL,CONNECTION_APPROVAL,SALES_REP_NOTIFICATIONS, NOTIFICATIONS
- send
Interval String - Send interval
- emails string[]
- Array of contact emails
- type string
- Notification Type - ALL,CONNECTION_APPROVAL,SALES_REP_NOTIFICATIONS, NOTIFICATIONS
- send
Interval string - Send interval
- emails Sequence[str]
- Array of contact emails
- type str
- Notification Type - ALL,CONNECTION_APPROVAL,SALES_REP_NOTIFICATIONS, NOTIFICATIONS
- send_
interval str - Send interval
- emails List<String>
- Array of contact emails
- type String
- Notification Type - ALL,CONNECTION_APPROVAL,SALES_REP_NOTIFICATIONS, NOTIFICATIONS
- send
Interval String - Send interval
GetNetworkOperation
- Equinix
Status string - Progress towards provisioning a given asset.
- Equinix
Status string - Progress towards provisioning a given asset.
- equinix
Status String - Progress towards provisioning a given asset.
- equinix
Status string - Progress towards provisioning a given asset.
- equinix_
status str - Progress towards provisioning a given asset.
- equinix
Status String - Progress towards provisioning a given asset.
GetNetworkProject
- Project
Id string - Customer project identifier
- Project
Id string - Customer project identifier
- project
Id String - Customer project identifier
- project
Id string - Customer project identifier
- project_
id str - Customer project identifier
- project
Id String - Customer project identifier
Package Details
- Repository
- equinix equinix/pulumi-equinix
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
equinix
Terraform Provider.