Equinix v0.27.1 published on Wednesday, Oct 29, 2025 by Equinix
equinix.fabric.getRouteAggregationRules
Start a Neo task
Explain and create an equinix.fabric.getRouteAggregationRules resource
Fabric V4 API compatible data resource that allow user to fetch Equinix Fabric Route Aggregation Rules with pagination details Additional Documentation:
- API: https://developer.equinix.com/catalog/fabricv4#tag/Route-Aggregations
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as equinix from "@pulumi/equinix";
const raRules = equinix.fabric.getRouteAggregationRules({
routeAggregationId: "<route_aggregation_id>",
pagination: {
limit: 2,
offset: 1,
},
});
export const routeAggregationRuleName = raRules.then(raRules => raRules.datas?.[0]?.name);
export const routeAggregationRuleDescription = raRules.then(raRules => raRules.datas?.[0]?.description);
export const routeAggregationRulePrefix = raRules.then(raRules => raRules.datas?.[0]?.prefix);
export const routeAggregationRuleState = raRules.then(raRules => raRules.datas?.[0]?.state);
import pulumi
import pulumi_equinix as equinix
ra_rules = equinix.fabric.get_route_aggregation_rules(route_aggregation_id="<route_aggregation_id>",
pagination={
"limit": 2,
"offset": 1,
})
pulumi.export("routeAggregationRuleName", ra_rules.datas[0].name)
pulumi.export("routeAggregationRuleDescription", ra_rules.datas[0].description)
pulumi.export("routeAggregationRulePrefix", ra_rules.datas[0].prefix)
pulumi.export("routeAggregationRuleState", ra_rules.datas[0].state)
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 {
raRules, err := fabric.GetRouteAggregationRules(ctx, &fabric.GetRouteAggregationRulesArgs{
RouteAggregationId: "<route_aggregation_id>",
Pagination: fabric.GetRouteAggregationRulesPagination{
Limit: 2,
Offset: 1,
},
}, nil)
if err != nil {
return err
}
ctx.Export("routeAggregationRuleName", raRules.Datas[0].Name)
ctx.Export("routeAggregationRuleDescription", raRules.Datas[0].Description)
ctx.Export("routeAggregationRulePrefix", raRules.Datas[0].Prefix)
ctx.Export("routeAggregationRuleState", raRules.Datas[0].State)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Equinix = Pulumi.Equinix;
return await Deployment.RunAsync(() =>
{
var raRules = Equinix.Fabric.GetRouteAggregationRules.Invoke(new()
{
RouteAggregationId = "<route_aggregation_id>",
Pagination = new Equinix.Fabric.Inputs.GetRouteAggregationRulesPaginationInputArgs
{
Limit = 2,
Offset = 1,
},
});
return new Dictionary<string, object?>
{
["routeAggregationRuleName"] = raRules.Apply(getRouteAggregationRulesResult => getRouteAggregationRulesResult.Datas[0]?.Name),
["routeAggregationRuleDescription"] = raRules.Apply(getRouteAggregationRulesResult => getRouteAggregationRulesResult.Datas[0]?.Description),
["routeAggregationRulePrefix"] = raRules.Apply(getRouteAggregationRulesResult => getRouteAggregationRulesResult.Datas[0]?.Prefix),
["routeAggregationRuleState"] = raRules.Apply(getRouteAggregationRulesResult => getRouteAggregationRulesResult.Datas[0]?.State),
};
});
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.GetRouteAggregationRulesArgs;
import com.pulumi.equinix.fabric.inputs.GetRouteAggregationRulesPaginationArgs;
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 raRules = FabricFunctions.getRouteAggregationRules(GetRouteAggregationRulesArgs.builder()
.routeAggregationId("<route_aggregation_id>")
.pagination(GetRouteAggregationRulesPaginationArgs.builder()
.limit(2)
.offset(1)
.build())
.build());
ctx.export("routeAggregationRuleName", raRules.applyValue(getRouteAggregationRulesResult -> getRouteAggregationRulesResult.datas()[0].name()));
ctx.export("routeAggregationRuleDescription", raRules.applyValue(getRouteAggregationRulesResult -> getRouteAggregationRulesResult.datas()[0].description()));
ctx.export("routeAggregationRulePrefix", raRules.applyValue(getRouteAggregationRulesResult -> getRouteAggregationRulesResult.datas()[0].prefix()));
ctx.export("routeAggregationRuleState", raRules.applyValue(getRouteAggregationRulesResult -> getRouteAggregationRulesResult.datas()[0].state()));
}
}
variables:
raRules:
fn::invoke:
function: equinix:fabric:getRouteAggregationRules
arguments:
routeAggregationId: <route_aggregation_id>
pagination:
limit: 2
offset: 1
outputs:
routeAggregationRuleName: ${raRules.datas[0].name}
routeAggregationRuleDescription: ${raRules.datas[0].description}
routeAggregationRulePrefix: ${raRules.datas[0].prefix}
routeAggregationRuleState: ${raRules.datas[0].state}
Using getRouteAggregationRules
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 getRouteAggregationRules(args: GetRouteAggregationRulesArgs, opts?: InvokeOptions): Promise<GetRouteAggregationRulesResult>
function getRouteAggregationRulesOutput(args: GetRouteAggregationRulesOutputArgs, opts?: InvokeOptions): Output<GetRouteAggregationRulesResult>def get_route_aggregation_rules(pagination: Optional[GetRouteAggregationRulesPagination] = None,
route_aggregation_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetRouteAggregationRulesResult
def get_route_aggregation_rules_output(pagination: Optional[pulumi.Input[GetRouteAggregationRulesPaginationArgs]] = None,
route_aggregation_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetRouteAggregationRulesResult]func GetRouteAggregationRules(ctx *Context, args *GetRouteAggregationRulesArgs, opts ...InvokeOption) (*GetRouteAggregationRulesResult, error)
func GetRouteAggregationRulesOutput(ctx *Context, args *GetRouteAggregationRulesOutputArgs, opts ...InvokeOption) GetRouteAggregationRulesResultOutput> Note: This function is named GetRouteAggregationRules in the Go SDK.
public static class GetRouteAggregationRules
{
public static Task<GetRouteAggregationRulesResult> InvokeAsync(GetRouteAggregationRulesArgs args, InvokeOptions? opts = null)
public static Output<GetRouteAggregationRulesResult> Invoke(GetRouteAggregationRulesInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetRouteAggregationRulesResult> getRouteAggregationRules(GetRouteAggregationRulesArgs args, InvokeOptions options)
public static Output<GetRouteAggregationRulesResult> getRouteAggregationRules(GetRouteAggregationRulesArgs args, InvokeOptions options)
fn::invoke:
function: equinix:fabric/getRouteAggregationRules:getRouteAggregationRules
arguments:
# arguments dictionaryThe following arguments are supported:
- Route
Aggregation stringId - The uuid of the route aggregation rule this data source should retrieve
- Pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- Route
Aggregation stringId - The uuid of the route aggregation rule this data source should retrieve
- Pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- route
Aggregation StringId - The uuid of the route aggregation rule this data source should retrieve
- pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- route
Aggregation stringId - The uuid of the route aggregation rule this data source should retrieve
- pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- route_
aggregation_ strid - The uuid of the route aggregation rule this data source should retrieve
- pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- route
Aggregation StringId - The uuid of the route aggregation rule this data source should retrieve
- pagination Property Map
- Pagination details for the returned route aggregation rules list
getRouteAggregationRules Result
The following output properties are available:
- Datas
List<Get
Route Aggregation Rules Data> - Returned list of route aggregation rule objects
- Id string
- The unique identifier of the resource
- Route
Aggregation stringId - The uuid of the route aggregation rule this data source should retrieve
- Pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- Datas
[]Get
Route Aggregation Rules Data - Returned list of route aggregation rule objects
- Id string
- The unique identifier of the resource
- Route
Aggregation stringId - The uuid of the route aggregation rule this data source should retrieve
- Pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- datas
List<Get
Route Aggregation Rules Data> - Returned list of route aggregation rule objects
- id String
- The unique identifier of the resource
- route
Aggregation StringId - The uuid of the route aggregation rule this data source should retrieve
- pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- datas
Get
Route Aggregation Rules Data[] - Returned list of route aggregation rule objects
- id string
- The unique identifier of the resource
- route
Aggregation stringId - The uuid of the route aggregation rule this data source should retrieve
- pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- datas
Sequence[Get
Route Aggregation Rules Data] - Returned list of route aggregation rule objects
- id str
- The unique identifier of the resource
- route_
aggregation_ strid - The uuid of the route aggregation rule this data source should retrieve
- pagination
Get
Route Aggregation Rules Pagination - Pagination details for the returned route aggregation rules list
- datas List<Property Map>
- Returned list of route aggregation rule objects
- id String
- The unique identifier of the resource
- route
Aggregation StringId - The uuid of the route aggregation rule this data source should retrieve
- pagination Property Map
- Pagination details for the returned route aggregation rules list
Supporting Types
GetRouteAggregationRulesData
- Change
Get
Route Aggregation Rules Data Change - Current state of latest route aggregation rule change
- Change
Log GetRoute Aggregation Rules Data Change Log - Details of the last change on the stream resource
- Href string
- Equinix auto generated URI to the route aggregation rule resource
- Name string
- Customer provided name of the route aggregation rule
- Prefix string
- Customer-provided route aggregation rule prefix
- Route
Aggregation stringId - UUID of the Route Aggregation to apply this Rule to
- State string
- Value representing provisioning status for the route aggregation rule resource
- Type string
- Equinix defined Route Aggregation Type; BGPIPv4PREFIXAGGREGATION, BGPIPv6PREFIXAGGREGATION
- Uuid string
- Equinix-assigned unique id for the route aggregation rule resource
- Description string
- Customer-provided route aggregation rule description
- Change
Get
Route Aggregation Rules Data Change - Current state of latest route aggregation rule change
- Change
Log GetRoute Aggregation Rules Data Change Log - Details of the last change on the stream resource
- Href string
- Equinix auto generated URI to the route aggregation rule resource
- Name string
- Customer provided name of the route aggregation rule
- Prefix string
- Customer-provided route aggregation rule prefix
- Route
Aggregation stringId - UUID of the Route Aggregation to apply this Rule to
- State string
- Value representing provisioning status for the route aggregation rule resource
- Type string
- Equinix defined Route Aggregation Type; BGPIPv4PREFIXAGGREGATION, BGPIPv6PREFIXAGGREGATION
- Uuid string
- Equinix-assigned unique id for the route aggregation rule resource
- Description string
- Customer-provided route aggregation rule description
- change
Get
Route Aggregation Rules Data Change - Current state of latest route aggregation rule change
- change
Log GetRoute Aggregation Rules Data Change Log - Details of the last change on the stream resource
- href String
- Equinix auto generated URI to the route aggregation rule resource
- name String
- Customer provided name of the route aggregation rule
- prefix String
- Customer-provided route aggregation rule prefix
- route
Aggregation StringId - UUID of the Route Aggregation to apply this Rule to
- state String
- Value representing provisioning status for the route aggregation rule resource
- type String
- Equinix defined Route Aggregation Type; BGPIPv4PREFIXAGGREGATION, BGPIPv6PREFIXAGGREGATION
- uuid String
- Equinix-assigned unique id for the route aggregation rule resource
- description String
- Customer-provided route aggregation rule description
- change
Get
Route Aggregation Rules Data Change - Current state of latest route aggregation rule change
- change
Log GetRoute Aggregation Rules Data Change Log - Details of the last change on the stream resource
- href string
- Equinix auto generated URI to the route aggregation rule resource
- name string
- Customer provided name of the route aggregation rule
- prefix string
- Customer-provided route aggregation rule prefix
- route
Aggregation stringId - UUID of the Route Aggregation to apply this Rule to
- state string
- Value representing provisioning status for the route aggregation rule resource
- type string
- Equinix defined Route Aggregation Type; BGPIPv4PREFIXAGGREGATION, BGPIPv6PREFIXAGGREGATION
- uuid string
- Equinix-assigned unique id for the route aggregation rule resource
- description string
- Customer-provided route aggregation rule description
- change
Get
Route Aggregation Rules Data Change - Current state of latest route aggregation rule change
- change_
log GetRoute Aggregation Rules Data Change Log - Details of the last change on the stream resource
- href str
- Equinix auto generated URI to the route aggregation rule resource
- name str
- Customer provided name of the route aggregation rule
- prefix str
- Customer-provided route aggregation rule prefix
- route_
aggregation_ strid - UUID of the Route Aggregation to apply this Rule to
- state str
- Value representing provisioning status for the route aggregation rule resource
- type str
- Equinix defined Route Aggregation Type; BGPIPv4PREFIXAGGREGATION, BGPIPv6PREFIXAGGREGATION
- uuid str
- Equinix-assigned unique id for the route aggregation rule resource
- description str
- Customer-provided route aggregation rule description
- change Property Map
- Current state of latest route aggregation rule change
- change
Log Property Map - Details of the last change on the stream resource
- href String
- Equinix auto generated URI to the route aggregation rule resource
- name String
- Customer provided name of the route aggregation rule
- prefix String
- Customer-provided route aggregation rule prefix
- route
Aggregation StringId - UUID of the Route Aggregation to apply this Rule to
- state String
- Value representing provisioning status for the route aggregation rule resource
- type String
- Equinix defined Route Aggregation Type; BGPIPv4PREFIXAGGREGATION, BGPIPv6PREFIXAGGREGATION
- uuid String
- Equinix-assigned unique id for the route aggregation rule resource
- description String
- Customer-provided route aggregation rule description
GetRouteAggregationRulesDataChange
GetRouteAggregationRulesDataChangeLog
- Created
By string - User name of creator of the stream resource
- Created
By stringEmail - Email of creator of the stream resource
- Created
By stringFull Name - Legal name of creator of the stream resource
- Created
Date stringTime - Creation time of the stream resource
- Deleted
By string - User name of deleter of the stream resource
- Deleted
By stringEmail - Email of deleter of the stream resource
- Deleted
By stringFull Name - Legal name of deleter of the stream resource
- Deleted
Date stringTime - Deletion time of the stream resource
- Updated
By string - User name of last updater of the stream resource
- Updated
By stringEmail - Email of last updater of the stream resource
- Updated
By stringFull Name - Legal name of last updater of the stream resource
- Updated
Date stringTime - Last update time of the stream resource
- Created
By string - User name of creator of the stream resource
- Created
By stringEmail - Email of creator of the stream resource
- Created
By stringFull Name - Legal name of creator of the stream resource
- Created
Date stringTime - Creation time of the stream resource
- Deleted
By string - User name of deleter of the stream resource
- Deleted
By stringEmail - Email of deleter of the stream resource
- Deleted
By stringFull Name - Legal name of deleter of the stream resource
- Deleted
Date stringTime - Deletion time of the stream resource
- Updated
By string - User name of last updater of the stream resource
- Updated
By stringEmail - Email of last updater of the stream resource
- Updated
By stringFull Name - Legal name of last updater of the stream resource
- Updated
Date stringTime - Last update time of the stream resource
- created
By String - User name of creator of the stream resource
- created
By StringEmail - Email of creator of the stream resource
- created
By StringFull Name - Legal name of creator of the stream resource
- created
Date StringTime - Creation time of the stream resource
- deleted
By String - User name of deleter of the stream resource
- deleted
By StringEmail - Email of deleter of the stream resource
- deleted
By StringFull Name - Legal name of deleter of the stream resource
- deleted
Date StringTime - Deletion time of the stream resource
- updated
By String - User name of last updater of the stream resource
- updated
By StringEmail - Email of last updater of the stream resource
- updated
By StringFull Name - Legal name of last updater of the stream resource
- updated
Date StringTime - Last update time of the stream resource
- created
By string - User name of creator of the stream resource
- created
By stringEmail - Email of creator of the stream resource
- created
By stringFull Name - Legal name of creator of the stream resource
- created
Date stringTime - Creation time of the stream resource
- deleted
By string - User name of deleter of the stream resource
- deleted
By stringEmail - Email of deleter of the stream resource
- deleted
By stringFull Name - Legal name of deleter of the stream resource
- deleted
Date stringTime - Deletion time of the stream resource
- updated
By string - User name of last updater of the stream resource
- updated
By stringEmail - Email of last updater of the stream resource
- updated
By stringFull Name - Legal name of last updater of the stream resource
- updated
Date stringTime - Last update time of the stream resource
- created_
by str - User name of creator of the stream resource
- created_
by_ stremail - Email of creator of the stream resource
- created_
by_ strfull_ name - Legal name of creator of the stream resource
- created_
date_ strtime - Creation time of the stream resource
- deleted_
by str - User name of deleter of the stream resource
- deleted_
by_ stremail - Email of deleter of the stream resource
- deleted_
by_ strfull_ name - Legal name of deleter of the stream resource
- deleted_
date_ strtime - Deletion time of the stream resource
- updated_
by str - User name of last updater of the stream resource
- updated_
by_ stremail - Email of last updater of the stream resource
- updated_
by_ strfull_ name - Legal name of last updater of the stream resource
- updated_
date_ strtime - Last update time of the stream resource
- created
By String - User name of creator of the stream resource
- created
By StringEmail - Email of creator of the stream resource
- created
By StringFull Name - Legal name of creator of the stream resource
- created
Date StringTime - Creation time of the stream resource
- deleted
By String - User name of deleter of the stream resource
- deleted
By StringEmail - Email of deleter of the stream resource
- deleted
By StringFull Name - Legal name of deleter of the stream resource
- deleted
Date StringTime - Deletion time of the stream resource
- updated
By String - User name of last updater of the stream resource
- updated
By StringEmail - Email of last updater of the stream resource
- updated
By StringFull Name - Legal name of last updater of the stream resource
- updated
Date StringTime - Last update time of the stream resource
GetRouteAggregationRulesPagination
- Limit int
- Maximum number of search results returned per page. Number must be between 1 and 100, and the default is 20
- Next string
- The URL relative to the next item in the response
- Offset int
- Index of the first item returned in the response. The default is 0
- Previous string
- The URL relative to the previous item in the response
- Total int
- The total number of route agrgegation rules available to the user making the request
- Limit int
- Maximum number of search results returned per page. Number must be between 1 and 100, and the default is 20
- Next string
- The URL relative to the next item in the response
- Offset int
- Index of the first item returned in the response. The default is 0
- Previous string
- The URL relative to the previous item in the response
- Total int
- The total number of route agrgegation rules available to the user making the request
- limit Integer
- Maximum number of search results returned per page. Number must be between 1 and 100, and the default is 20
- next String
- The URL relative to the next item in the response
- offset Integer
- Index of the first item returned in the response. The default is 0
- previous String
- The URL relative to the previous item in the response
- total Integer
- The total number of route agrgegation rules available to the user making the request
- limit number
- Maximum number of search results returned per page. Number must be between 1 and 100, and the default is 20
- next string
- The URL relative to the next item in the response
- offset number
- Index of the first item returned in the response. The default is 0
- previous string
- The URL relative to the previous item in the response
- total number
- The total number of route agrgegation rules available to the user making the request
- limit int
- Maximum number of search results returned per page. Number must be between 1 and 100, and the default is 20
- next str
- The URL relative to the next item in the response
- offset int
- Index of the first item returned in the response. The default is 0
- previous str
- The URL relative to the previous item in the response
- total int
- The total number of route agrgegation rules available to the user making the request
- limit Number
- Maximum number of search results returned per page. Number must be between 1 and 100, and the default is 20
- next String
- The URL relative to the next item in the response
- offset Number
- Index of the first item returned in the response. The default is 0
- previous String
- The URL relative to the previous item in the response
- total Number
- The total number of route agrgegation rules available to the user making the request
Package Details
- Repository
- equinix equinix/pulumi-equinix
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
equinixTerraform Provider.
