1. Packages
  2. Equinix
  3. API Docs
  4. fabric
  5. getConnectionRouteAggregations
Equinix v0.22.0 published on Wednesday, Apr 23, 2025 by Equinix

equinix.fabric.getConnectionRouteAggregations

Explore with Pulumi AI

equinix logo
Equinix v0.22.0 published on Wednesday, Apr 23, 2025 by Equinix

    Fabric V4 API compatible data resource that allow user to fetch Equinix Fabric Connection Route Aggregations 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 attachedPolicies = equinix.fabric.getConnectionRouteAggregations({
        connectionId: "connection_id",
    });
    export const connectionFirstRouteAggregationUuid = attachedPolicies.then(attachedPolicies => attachedPolicies.datas?.[0]?.uuid);
    export const connectionFirstRouteAggregationType = attachedPolicies.then(attachedPolicies => attachedPolicies.datas?.[0]?.type);
    export const connectionFirstRouteAggregationAttachmentStatus = attachedPolicies.then(attachedPolicies => attachedPolicies.datas?.[0]?.attachmentStatus);
    
    import pulumi
    import pulumi_equinix as equinix
    
    attached_policies = equinix.fabric.get_connection_route_aggregations(connection_id="connection_id")
    pulumi.export("connectionFirstRouteAggregationUuid", attached_policies.datas[0].uuid)
    pulumi.export("connectionFirstRouteAggregationType", attached_policies.datas[0].type)
    pulumi.export("connectionFirstRouteAggregationAttachmentStatus", attached_policies.datas[0].attachment_status)
    
    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 {
    		attachedPolicies, err := fabric.GetConnectionRouteAggregations(ctx, &fabric.GetConnectionRouteAggregationsArgs{
    			ConnectionId: "connection_id",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("connectionFirstRouteAggregationUuid", attachedPolicies.Datas[0].Uuid)
    		ctx.Export("connectionFirstRouteAggregationType", attachedPolicies.Datas[0].Type)
    		ctx.Export("connectionFirstRouteAggregationAttachmentStatus", attachedPolicies.Datas[0].AttachmentStatus)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Equinix = Pulumi.Equinix;
    
    return await Deployment.RunAsync(() => 
    {
        var attachedPolicies = Equinix.Fabric.GetConnectionRouteAggregations.Invoke(new()
        {
            ConnectionId = "connection_id",
        });
    
        return new Dictionary<string, object?>
        {
            ["connectionFirstRouteAggregationUuid"] = attachedPolicies.Apply(getConnectionRouteAggregationsResult => getConnectionRouteAggregationsResult.Datas[0]?.Uuid),
            ["connectionFirstRouteAggregationType"] = attachedPolicies.Apply(getConnectionRouteAggregationsResult => getConnectionRouteAggregationsResult.Datas[0]?.Type),
            ["connectionFirstRouteAggregationAttachmentStatus"] = attachedPolicies.Apply(getConnectionRouteAggregationsResult => getConnectionRouteAggregationsResult.Datas[0]?.AttachmentStatus),
        };
    });
    
    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.GetConnectionRouteAggregationsArgs;
    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 attachedPolicies = FabricFunctions.getConnectionRouteAggregations(GetConnectionRouteAggregationsArgs.builder()
                .connectionId("connection_id")
                .build());
    
            ctx.export("connectionFirstRouteAggregationUuid", attachedPolicies.applyValue(getConnectionRouteAggregationsResult -> getConnectionRouteAggregationsResult.datas()[0].uuid()));
            ctx.export("connectionFirstRouteAggregationType", attachedPolicies.applyValue(getConnectionRouteAggregationsResult -> getConnectionRouteAggregationsResult.datas()[0].type()));
            ctx.export("connectionFirstRouteAggregationAttachmentStatus", attachedPolicies.applyValue(getConnectionRouteAggregationsResult -> getConnectionRouteAggregationsResult.datas()[0].attachmentStatus()));
        }
    }
    
    variables:
      attachedPolicies:
        fn::invoke:
          function: equinix:fabric:getConnectionRouteAggregations
          arguments:
            connectionId: connection_id
    outputs:
      connectionFirstRouteAggregationUuid: ${attachedPolicies.datas[0].uuid}
      connectionFirstRouteAggregationType: ${attachedPolicies.datas[0].type}
      connectionFirstRouteAggregationAttachmentStatus: ${attachedPolicies.datas[0].attachmentStatus}
    

    Using getConnectionRouteAggregations

    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 getConnectionRouteAggregations(args: GetConnectionRouteAggregationsArgs, opts?: InvokeOptions): Promise<GetConnectionRouteAggregationsResult>
    function getConnectionRouteAggregationsOutput(args: GetConnectionRouteAggregationsOutputArgs, opts?: InvokeOptions): Output<GetConnectionRouteAggregationsResult>
    def get_connection_route_aggregations(connection_id: Optional[str] = None,
                                          pagination: Optional[GetConnectionRouteAggregationsPagination] = None,
                                          opts: Optional[InvokeOptions] = None) -> GetConnectionRouteAggregationsResult
    def get_connection_route_aggregations_output(connection_id: Optional[pulumi.Input[str]] = None,
                                          pagination: Optional[pulumi.Input[GetConnectionRouteAggregationsPaginationArgs]] = None,
                                          opts: Optional[InvokeOptions] = None) -> Output[GetConnectionRouteAggregationsResult]
    func GetConnectionRouteAggregations(ctx *Context, args *GetConnectionRouteAggregationsArgs, opts ...InvokeOption) (*GetConnectionRouteAggregationsResult, error)
    func GetConnectionRouteAggregationsOutput(ctx *Context, args *GetConnectionRouteAggregationsOutputArgs, opts ...InvokeOption) GetConnectionRouteAggregationsResultOutput

    > Note: This function is named GetConnectionRouteAggregations in the Go SDK.

    public static class GetConnectionRouteAggregations 
    {
        public static Task<GetConnectionRouteAggregationsResult> InvokeAsync(GetConnectionRouteAggregationsArgs args, InvokeOptions? opts = null)
        public static Output<GetConnectionRouteAggregationsResult> Invoke(GetConnectionRouteAggregationsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetConnectionRouteAggregationsResult> getConnectionRouteAggregations(GetConnectionRouteAggregationsArgs args, InvokeOptions options)
    public static Output<GetConnectionRouteAggregationsResult> getConnectionRouteAggregations(GetConnectionRouteAggregationsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: equinix:fabric/getConnectionRouteAggregations:getConnectionRouteAggregations
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ConnectionId string
    The uuid of the connection this data source should retrieve
    Pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    ConnectionId string
    The uuid of the connection this data source should retrieve
    Pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connectionId String
    The uuid of the connection this data source should retrieve
    pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connectionId string
    The uuid of the connection this data source should retrieve
    pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connection_id str
    The uuid of the connection this data source should retrieve
    pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connectionId String
    The uuid of the connection this data source should retrieve
    pagination Property Map
    Pagination details for the returned connection route aggregations list

    getConnectionRouteAggregations Result

    The following output properties are available:

    ConnectionId string
    The uuid of the connection this data source should retrieve
    Datas List<GetConnectionRouteAggregationsData>
    Returned list of connection route aggregation objects
    Id string
    The unique identifier of the resource
    Pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    ConnectionId string
    The uuid of the connection this data source should retrieve
    Datas []GetConnectionRouteAggregationsData
    Returned list of connection route aggregation objects
    Id string
    The unique identifier of the resource
    Pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connectionId String
    The uuid of the connection this data source should retrieve
    datas List<GetConnectionRouteAggregationsData>
    Returned list of connection route aggregation objects
    id String
    The unique identifier of the resource
    pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connectionId string
    The uuid of the connection this data source should retrieve
    datas GetConnectionRouteAggregationsData[]
    Returned list of connection route aggregation objects
    id string
    The unique identifier of the resource
    pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connection_id str
    The uuid of the connection this data source should retrieve
    datas Sequence[GetConnectionRouteAggregationsData]
    Returned list of connection route aggregation objects
    id str
    The unique identifier of the resource
    pagination GetConnectionRouteAggregationsPagination
    Pagination details for the returned connection route aggregations list
    connectionId String
    The uuid of the connection this data source should retrieve
    datas List<Property Map>
    Returned list of connection route aggregation objects
    id String
    The unique identifier of the resource
    pagination Property Map
    Pagination details for the returned connection route aggregations list

    Supporting Types

    GetConnectionRouteAggregationsData

    AttachmentStatus string
    Status of the Route Aggregation Policy attachment lifecycle
    ConnectionId string
    UUID of the Connection to attach this Route Aggregation to
    Href string
    URI to the attached Route Aggregation Policy on the Connection
    RouteAggregationId string
    UUID of the Route Aggregation to attach this Connection to
    Type string
    Route Aggregation Type. One of ["BGPIPv4PREFIX_AGGREGATION"]
    Uuid string
    Equinix Assigned ID for Route Aggregation Policy
    AttachmentStatus string
    Status of the Route Aggregation Policy attachment lifecycle
    ConnectionId string
    UUID of the Connection to attach this Route Aggregation to
    Href string
    URI to the attached Route Aggregation Policy on the Connection
    RouteAggregationId string
    UUID of the Route Aggregation to attach this Connection to
    Type string
    Route Aggregation Type. One of ["BGPIPv4PREFIX_AGGREGATION"]
    Uuid string
    Equinix Assigned ID for Route Aggregation Policy
    attachmentStatus String
    Status of the Route Aggregation Policy attachment lifecycle
    connectionId String
    UUID of the Connection to attach this Route Aggregation to
    href String
    URI to the attached Route Aggregation Policy on the Connection
    routeAggregationId String
    UUID of the Route Aggregation to attach this Connection to
    type String
    Route Aggregation Type. One of ["BGPIPv4PREFIX_AGGREGATION"]
    uuid String
    Equinix Assigned ID for Route Aggregation Policy
    attachmentStatus string
    Status of the Route Aggregation Policy attachment lifecycle
    connectionId string
    UUID of the Connection to attach this Route Aggregation to
    href string
    URI to the attached Route Aggregation Policy on the Connection
    routeAggregationId string
    UUID of the Route Aggregation to attach this Connection to
    type string
    Route Aggregation Type. One of ["BGPIPv4PREFIX_AGGREGATION"]
    uuid string
    Equinix Assigned ID for Route Aggregation Policy
    attachment_status str
    Status of the Route Aggregation Policy attachment lifecycle
    connection_id str
    UUID of the Connection to attach this Route Aggregation to
    href str
    URI to the attached Route Aggregation Policy on the Connection
    route_aggregation_id str
    UUID of the Route Aggregation to attach this Connection to
    type str
    Route Aggregation Type. One of ["BGPIPv4PREFIX_AGGREGATION"]
    uuid str
    Equinix Assigned ID for Route Aggregation Policy
    attachmentStatus String
    Status of the Route Aggregation Policy attachment lifecycle
    connectionId String
    UUID of the Connection to attach this Route Aggregation to
    href String
    URI to the attached Route Aggregation Policy on the Connection
    routeAggregationId String
    UUID of the Route Aggregation to attach this Connection to
    type String
    Route Aggregation Type. One of ["BGPIPv4PREFIX_AGGREGATION"]
    uuid String
    Equinix Assigned ID for Route Aggregation Policy

    GetConnectionRouteAggregationsPagination

    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 connection route aggregations 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 connection route aggregations 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 connection route aggregations 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 connection route aggregations 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 connection route aggregations 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 connection route aggregations 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 equinix Terraform Provider.
    equinix logo
    Equinix v0.22.0 published on Wednesday, Apr 23, 2025 by Equinix