1. Packages
  2. Konnect Provider
  3. API Docs
  4. getPortalList
konnect 2.4.1 published on Thursday, Mar 13, 2025 by kong

konnect.getPortalList

Explore with Pulumi AI

PortalList DataSource

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as konnect from "@pulumi/konnect";

const myPortallist = konnect.getPortalList({
    pageNumber: 1,
    pageSize: 10,
    sort: "...my_sort...",
});
Copy
import pulumi
import pulumi_konnect as konnect

my_portallist = konnect.get_portal_list(page_number=1,
    page_size=10,
    sort="...my_sort...")
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/konnect/v2/konnect"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := konnect.GetPortalList(ctx, &konnect.GetPortalListArgs{
			PageNumber: pulumi.Float64Ref(1),
			PageSize:   pulumi.Float64Ref(10),
			Sort:       pulumi.StringRef("...my_sort..."),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Konnect = Pulumi.Konnect;

return await Deployment.RunAsync(() => 
{
    var myPortallist = Konnect.GetPortalList.Invoke(new()
    {
        PageNumber = 1,
        PageSize = 10,
        Sort = "...my_sort...",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.konnect.KonnectFunctions;
import com.pulumi.konnect.inputs.GetPortalListArgs;
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 myPortallist = KonnectFunctions.getPortalList(GetPortalListArgs.builder()
            .pageNumber(1)
            .pageSize(10)
            .sort("...my_sort...")
            .build());

    }
}
Copy
variables:
  myPortallist:
    fn::invoke:
      function: konnect:getPortalList
      arguments:
        pageNumber: 1
        pageSize: 10
        sort: '...my_sort...'
Copy

Using getPortalList

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 getPortalList(args: GetPortalListArgs, opts?: InvokeOptions): Promise<GetPortalListResult>
function getPortalListOutput(args: GetPortalListOutputArgs, opts?: InvokeOptions): Output<GetPortalListResult>
Copy
def get_portal_list(page_number: Optional[float] = None,
                    page_size: Optional[float] = None,
                    sort: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetPortalListResult
def get_portal_list_output(page_number: Optional[pulumi.Input[float]] = None,
                    page_size: Optional[pulumi.Input[float]] = None,
                    sort: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetPortalListResult]
Copy
func GetPortalList(ctx *Context, args *GetPortalListArgs, opts ...InvokeOption) (*GetPortalListResult, error)
func GetPortalListOutput(ctx *Context, args *GetPortalListOutputArgs, opts ...InvokeOption) GetPortalListResultOutput
Copy

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

public static class GetPortalList 
{
    public static Task<GetPortalListResult> InvokeAsync(GetPortalListArgs args, InvokeOptions? opts = null)
    public static Output<GetPortalListResult> Invoke(GetPortalListInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetPortalListResult> getPortalList(GetPortalListArgs args, InvokeOptions options)
public static Output<GetPortalListResult> getPortalList(GetPortalListArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: konnect:index/getPortalList:getPortalList
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

PageNumber double
PageSize double
Sort string
PageNumber float64
PageSize float64
Sort string
pageNumber Double
pageSize Double
sort String
pageNumber number
pageSize number
sort string
page_number float
page_size float
sort str
pageNumber Number
pageSize Number
sort String

getPortalList Result

The following output properties are available:

Datas List<GetPortalListData>
Id string
The provider-assigned unique ID for this managed resource.
Meta GetPortalListMeta
PageNumber double
PageSize double
Sort string
Datas []GetPortalListData
Id string
The provider-assigned unique ID for this managed resource.
Meta GetPortalListMeta
PageNumber float64
PageSize float64
Sort string
datas List<GetPortalListData>
id String
The provider-assigned unique ID for this managed resource.
meta GetPortalListMeta
pageNumber Double
pageSize Double
sort String
datas GetPortalListData[]
id string
The provider-assigned unique ID for this managed resource.
meta GetPortalListMeta
pageNumber number
pageSize number
sort string
datas Sequence[GetPortalListData]
id str
The provider-assigned unique ID for this managed resource.
meta GetPortalListMeta
page_number float
page_size float
sort str
datas List<Property Map>
id String
The provider-assigned unique ID for this managed resource.
meta Property Map
pageNumber Number
pageSize Number
sort String

Supporting Types

GetPortalListData

ApplicationCount This property is required. double
Number of applications created in the portal.
AutoApproveApplications This property is required. bool
Whether the requests from applications to register for products will be automatically approved, or if they will be set to pending until approved by an admin.
AutoApproveDevelopers This property is required. bool
Whether the developer account registrations will be automatically approved, or if they will be set to pending until approved by an admin.
CreatedAt This property is required. string
An ISO-8601 timestamp representation of entity creation date.
CustomClientDomain This property is required. string
The custom domain to access a self-hosted customized developer portal client. If this is set, the Konnect-hosted portal client will no longer be available. custom_domain must be also set for this value to be set. See https://github.com/Kong/konnect-portal for information on how to get started deploying and customizing your own Konnect portal.
CustomDomain This property is required. string
The custom domain to access the developer portal. A CNAME for the portal's default domain must be able to be set for the custom domain for it to be valid. After setting a valid CNAME, an SSL/TLS certificate will be automatically manged for the custom domain, and traffic will be able to use the custom domain to route to the portal's web client and API.
DefaultApplicationAuthStrategyId This property is required. string
Default strategy ID applied on applications for the portal
DefaultDomain This property is required. string
The domain assigned to the portal by Konnect. This is the default place to access the portal and its API if not using a `custom_domain``.
Description This property is required. string
The description of the portal.
DeveloperCount This property is required. double
Number of developers using the portal.
DisplayName This property is required. string
The display name of the portal. This value will be the portal's name in Portal API.
Id This property is required. string
Contains a unique identifier used by the API for this resource.
IsPublic This property is required. bool
Whether the portal catalog can be accessed publicly without any developer authentication. Developer accounts and applications cannot be created if the portal is public.
Labels This property is required. Dictionary<string, string>

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

Name This property is required. string
The name of the portal, used to distinguish it from other portals. Name must be unique.
PublishedProductCount This property is required. double
Number of api products published to the portal
RbacEnabled This property is required. bool
Whether the portal resources are protected by Role Based Access Control (RBAC). If enabled, developers view or register for products until unless assigned to teams with access to view and consume specific products.
UpdatedAt This property is required. string
An ISO-8601 timestamp representation of entity update date.
ApplicationCount This property is required. float64
Number of applications created in the portal.
AutoApproveApplications This property is required. bool
Whether the requests from applications to register for products will be automatically approved, or if they will be set to pending until approved by an admin.
AutoApproveDevelopers This property is required. bool
Whether the developer account registrations will be automatically approved, or if they will be set to pending until approved by an admin.
CreatedAt This property is required. string
An ISO-8601 timestamp representation of entity creation date.
CustomClientDomain This property is required. string
The custom domain to access a self-hosted customized developer portal client. If this is set, the Konnect-hosted portal client will no longer be available. custom_domain must be also set for this value to be set. See https://github.com/Kong/konnect-portal for information on how to get started deploying and customizing your own Konnect portal.
CustomDomain This property is required. string
The custom domain to access the developer portal. A CNAME for the portal's default domain must be able to be set for the custom domain for it to be valid. After setting a valid CNAME, an SSL/TLS certificate will be automatically manged for the custom domain, and traffic will be able to use the custom domain to route to the portal's web client and API.
DefaultApplicationAuthStrategyId This property is required. string
Default strategy ID applied on applications for the portal
DefaultDomain This property is required. string
The domain assigned to the portal by Konnect. This is the default place to access the portal and its API if not using a `custom_domain``.
Description This property is required. string
The description of the portal.
DeveloperCount This property is required. float64
Number of developers using the portal.
DisplayName This property is required. string
The display name of the portal. This value will be the portal's name in Portal API.
Id This property is required. string
Contains a unique identifier used by the API for this resource.
IsPublic This property is required. bool
Whether the portal catalog can be accessed publicly without any developer authentication. Developer accounts and applications cannot be created if the portal is public.
Labels This property is required. map[string]string

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

Name This property is required. string
The name of the portal, used to distinguish it from other portals. Name must be unique.
PublishedProductCount This property is required. float64
Number of api products published to the portal
RbacEnabled This property is required. bool
Whether the portal resources are protected by Role Based Access Control (RBAC). If enabled, developers view or register for products until unless assigned to teams with access to view and consume specific products.
UpdatedAt This property is required. string
An ISO-8601 timestamp representation of entity update date.
applicationCount This property is required. Double
Number of applications created in the portal.
autoApproveApplications This property is required. Boolean
Whether the requests from applications to register for products will be automatically approved, or if they will be set to pending until approved by an admin.
autoApproveDevelopers This property is required. Boolean
Whether the developer account registrations will be automatically approved, or if they will be set to pending until approved by an admin.
createdAt This property is required. String
An ISO-8601 timestamp representation of entity creation date.
customClientDomain This property is required. String
The custom domain to access a self-hosted customized developer portal client. If this is set, the Konnect-hosted portal client will no longer be available. custom_domain must be also set for this value to be set. See https://github.com/Kong/konnect-portal for information on how to get started deploying and customizing your own Konnect portal.
customDomain This property is required. String
The custom domain to access the developer portal. A CNAME for the portal's default domain must be able to be set for the custom domain for it to be valid. After setting a valid CNAME, an SSL/TLS certificate will be automatically manged for the custom domain, and traffic will be able to use the custom domain to route to the portal's web client and API.
defaultApplicationAuthStrategyId This property is required. String
Default strategy ID applied on applications for the portal
defaultDomain This property is required. String
The domain assigned to the portal by Konnect. This is the default place to access the portal and its API if not using a `custom_domain``.
description This property is required. String
The description of the portal.
developerCount This property is required. Double
Number of developers using the portal.
displayName This property is required. String
The display name of the portal. This value will be the portal's name in Portal API.
id This property is required. String
Contains a unique identifier used by the API for this resource.
isPublic This property is required. Boolean
Whether the portal catalog can be accessed publicly without any developer authentication. Developer accounts and applications cannot be created if the portal is public.
labels This property is required. Map<String,String>

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

name This property is required. String
The name of the portal, used to distinguish it from other portals. Name must be unique.
publishedProductCount This property is required. Double
Number of api products published to the portal
rbacEnabled This property is required. Boolean
Whether the portal resources are protected by Role Based Access Control (RBAC). If enabled, developers view or register for products until unless assigned to teams with access to view and consume specific products.
updatedAt This property is required. String
An ISO-8601 timestamp representation of entity update date.
applicationCount This property is required. number
Number of applications created in the portal.
autoApproveApplications This property is required. boolean
Whether the requests from applications to register for products will be automatically approved, or if they will be set to pending until approved by an admin.
autoApproveDevelopers This property is required. boolean
Whether the developer account registrations will be automatically approved, or if they will be set to pending until approved by an admin.
createdAt This property is required. string
An ISO-8601 timestamp representation of entity creation date.
customClientDomain This property is required. string
The custom domain to access a self-hosted customized developer portal client. If this is set, the Konnect-hosted portal client will no longer be available. custom_domain must be also set for this value to be set. See https://github.com/Kong/konnect-portal for information on how to get started deploying and customizing your own Konnect portal.
customDomain This property is required. string
The custom domain to access the developer portal. A CNAME for the portal's default domain must be able to be set for the custom domain for it to be valid. After setting a valid CNAME, an SSL/TLS certificate will be automatically manged for the custom domain, and traffic will be able to use the custom domain to route to the portal's web client and API.
defaultApplicationAuthStrategyId This property is required. string
Default strategy ID applied on applications for the portal
defaultDomain This property is required. string
The domain assigned to the portal by Konnect. This is the default place to access the portal and its API if not using a `custom_domain``.
description This property is required. string
The description of the portal.
developerCount This property is required. number
Number of developers using the portal.
displayName This property is required. string
The display name of the portal. This value will be the portal's name in Portal API.
id This property is required. string
Contains a unique identifier used by the API for this resource.
isPublic This property is required. boolean
Whether the portal catalog can be accessed publicly without any developer authentication. Developer accounts and applications cannot be created if the portal is public.
labels This property is required. {[key: string]: string}

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

name This property is required. string
The name of the portal, used to distinguish it from other portals. Name must be unique.
publishedProductCount This property is required. number
Number of api products published to the portal
rbacEnabled This property is required. boolean
Whether the portal resources are protected by Role Based Access Control (RBAC). If enabled, developers view or register for products until unless assigned to teams with access to view and consume specific products.
updatedAt This property is required. string
An ISO-8601 timestamp representation of entity update date.
application_count This property is required. float
Number of applications created in the portal.
auto_approve_applications This property is required. bool
Whether the requests from applications to register for products will be automatically approved, or if they will be set to pending until approved by an admin.
auto_approve_developers This property is required. bool
Whether the developer account registrations will be automatically approved, or if they will be set to pending until approved by an admin.
created_at This property is required. str
An ISO-8601 timestamp representation of entity creation date.
custom_client_domain This property is required. str
The custom domain to access a self-hosted customized developer portal client. If this is set, the Konnect-hosted portal client will no longer be available. custom_domain must be also set for this value to be set. See https://github.com/Kong/konnect-portal for information on how to get started deploying and customizing your own Konnect portal.
custom_domain This property is required. str
The custom domain to access the developer portal. A CNAME for the portal's default domain must be able to be set for the custom domain for it to be valid. After setting a valid CNAME, an SSL/TLS certificate will be automatically manged for the custom domain, and traffic will be able to use the custom domain to route to the portal's web client and API.
default_application_auth_strategy_id This property is required. str
Default strategy ID applied on applications for the portal
default_domain This property is required. str
The domain assigned to the portal by Konnect. This is the default place to access the portal and its API if not using a `custom_domain``.
description This property is required. str
The description of the portal.
developer_count This property is required. float
Number of developers using the portal.
display_name This property is required. str
The display name of the portal. This value will be the portal's name in Portal API.
id This property is required. str
Contains a unique identifier used by the API for this resource.
is_public This property is required. bool
Whether the portal catalog can be accessed publicly without any developer authentication. Developer accounts and applications cannot be created if the portal is public.
labels This property is required. Mapping[str, str]

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

name This property is required. str
The name of the portal, used to distinguish it from other portals. Name must be unique.
published_product_count This property is required. float
Number of api products published to the portal
rbac_enabled This property is required. bool
Whether the portal resources are protected by Role Based Access Control (RBAC). If enabled, developers view or register for products until unless assigned to teams with access to view and consume specific products.
updated_at This property is required. str
An ISO-8601 timestamp representation of entity update date.
applicationCount This property is required. Number
Number of applications created in the portal.
autoApproveApplications This property is required. Boolean
Whether the requests from applications to register for products will be automatically approved, or if they will be set to pending until approved by an admin.
autoApproveDevelopers This property is required. Boolean
Whether the developer account registrations will be automatically approved, or if they will be set to pending until approved by an admin.
createdAt This property is required. String
An ISO-8601 timestamp representation of entity creation date.
customClientDomain This property is required. String
The custom domain to access a self-hosted customized developer portal client. If this is set, the Konnect-hosted portal client will no longer be available. custom_domain must be also set for this value to be set. See https://github.com/Kong/konnect-portal for information on how to get started deploying and customizing your own Konnect portal.
customDomain This property is required. String
The custom domain to access the developer portal. A CNAME for the portal's default domain must be able to be set for the custom domain for it to be valid. After setting a valid CNAME, an SSL/TLS certificate will be automatically manged for the custom domain, and traffic will be able to use the custom domain to route to the portal's web client and API.
defaultApplicationAuthStrategyId This property is required. String
Default strategy ID applied on applications for the portal
defaultDomain This property is required. String
The domain assigned to the portal by Konnect. This is the default place to access the portal and its API if not using a `custom_domain``.
description This property is required. String
The description of the portal.
developerCount This property is required. Number
Number of developers using the portal.
displayName This property is required. String
The display name of the portal. This value will be the portal's name in Portal API.
id This property is required. String
Contains a unique identifier used by the API for this resource.
isPublic This property is required. Boolean
Whether the portal catalog can be accessed publicly without any developer authentication. Developer accounts and applications cannot be created if the portal is public.
labels This property is required. Map<String>

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

name This property is required. String
The name of the portal, used to distinguish it from other portals. Name must be unique.
publishedProductCount This property is required. Number
Number of api products published to the portal
rbacEnabled This property is required. Boolean
Whether the portal resources are protected by Role Based Access Control (RBAC). If enabled, developers view or register for products until unless assigned to teams with access to view and consume specific products.
updatedAt This property is required. String
An ISO-8601 timestamp representation of entity update date.

GetPortalListMeta

Page This property is required. GetPortalListMetaPage
Contains pagination query parameters and the total number of objects returned.
Page This property is required. GetPortalListMetaPage
Contains pagination query parameters and the total number of objects returned.
page This property is required. GetPortalListMetaPage
Contains pagination query parameters and the total number of objects returned.
page This property is required. GetPortalListMetaPage
Contains pagination query parameters and the total number of objects returned.
page This property is required. GetPortalListMetaPage
Contains pagination query parameters and the total number of objects returned.
page This property is required. Property Map
Contains pagination query parameters and the total number of objects returned.

GetPortalListMetaPage

Number This property is required. double
Size This property is required. double
Total This property is required. double
Number This property is required. float64
Size This property is required. float64
Total This property is required. float64
number This property is required. Double
size This property is required. Double
total This property is required. Double
number This property is required. number
size This property is required. number
total This property is required. number
number This property is required. float
size This property is required. float
total This property is required. float
number This property is required. Number
size This property is required. Number
total This property is required. Number

Package Details

Repository
konnect kong/terraform-provider-konnect
License
Notes
This Pulumi package is based on the konnect Terraform Provider.