published on Thursday, Jun 25, 2026 by Pulumi
published on Thursday, Jun 25, 2026 by Pulumi
Caution: Preview Feature This feature is considered a preview feature in the provider, regardless of the state of the resource in Snowflake. We do not guarantee its stability. It will be reworked and marked as a stable feature in future releases. Breaking changes are expected, even without bumping the major version. To use this feature, add the relevant feature name to
previewFeaturesEnabledfield in the provider configuration. Please always refer to the Getting Help section in our Github repo to best determine how to get help for your questions.
Data source used to get details of filtered Cortex agents. Filtering is aligned with the current possibilities for SHOW AGENTS query. The results of SHOW and DESCRIBE are encapsulated in one output collection cortexAgents.
Using getCortexAgents
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 getCortexAgents(args: GetCortexAgentsArgs, opts?: InvokeOptions): Promise<GetCortexAgentsResult>
function getCortexAgentsOutput(args: GetCortexAgentsOutputArgs, opts?: InvokeOptions): Output<GetCortexAgentsResult>def get_cortex_agents(in_: Optional[GetCortexAgentsIn] = None,
like: Optional[str] = None,
limit: Optional[GetCortexAgentsLimit] = None,
starts_with: Optional[str] = None,
with_describe: Optional[bool] = None,
opts: Optional[InvokeOptions] = None) -> GetCortexAgentsResult
def get_cortex_agents_output(in_: pulumi.Input[Optional[GetCortexAgentsInArgs]] = None,
like: pulumi.Input[Optional[str]] = None,
limit: pulumi.Input[Optional[GetCortexAgentsLimitArgs]] = None,
starts_with: pulumi.Input[Optional[str]] = None,
with_describe: pulumi.Input[Optional[bool]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetCortexAgentsResult]func GetCortexAgents(ctx *Context, args *GetCortexAgentsArgs, opts ...InvokeOption) (*GetCortexAgentsResult, error)
func GetCortexAgentsOutput(ctx *Context, args *GetCortexAgentsOutputArgs, opts ...InvokeOption) GetCortexAgentsResultOutput> Note: This function is named GetCortexAgents in the Go SDK.
public static class GetCortexAgents
{
public static Task<GetCortexAgentsResult> InvokeAsync(GetCortexAgentsArgs args, InvokeOptions? opts = null)
public static Output<GetCortexAgentsResult> Invoke(GetCortexAgentsInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetCortexAgentsResult> getCortexAgents(GetCortexAgentsArgs args, InvokeOptions options)
public static Output<GetCortexAgentsResult> getCortexAgents(GetCortexAgentsArgs args, InvokeOptions options)
fn::invoke:
function: snowflake:index/getCortexAgents:getCortexAgents
arguments:
# arguments dictionarydata "snowflake_getcortexagents" "name" {
# arguments
}The following arguments are supported:
- In
Get
Cortex Agents In - IN clause to filter the list of objects
- Like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - Limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - Starts
With string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- With
Describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- In
Get
Cortex Agents In - IN clause to filter the list of objects
- Like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - Limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - Starts
With string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- With
Describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- in object
- IN clause to filter the list of objects
- like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit object
- Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts_
with string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with_
describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- in
Get
Cortex Agents In - IN clause to filter the list of objects
- like String
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts
With String - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with
Describe Boolean - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- in
Get
Cortex Agents In - IN clause to filter the list of objects
- like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts
With string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with
Describe boolean - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- in_
Get
Cortex Agents In - IN clause to filter the list of objects
- like str
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts_
with str - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with_
describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- in Property Map
- IN clause to filter the list of objects
- like String
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit Property Map
- Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts
With String - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with
Describe Boolean - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
getCortexAgents Result
The following output properties are available:
- Cortex
Agents List<GetCortex Agents Cortex Agent> - Holds the aggregated output of all cortex agent details queries.
- Id string
- The provider-assigned unique ID for this managed resource.
- In
Get
Cortex Agents In - IN clause to filter the list of objects
- Like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - Limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - Starts
With string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- With
Describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- Cortex
Agents []GetCortex Agents Cortex Agent - Holds the aggregated output of all cortex agent details queries.
- Id string
- The provider-assigned unique ID for this managed resource.
- In
Get
Cortex Agents In - IN clause to filter the list of objects
- Like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - Limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - Starts
With string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- With
Describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- cortex_
agents list(object) - Holds the aggregated output of all cortex agent details queries.
- id string
- The provider-assigned unique ID for this managed resource.
- in object
- IN clause to filter the list of objects
- like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit object
- Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts_
with string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with_
describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- cortex
Agents List<GetCortex Agents Cortex Agent> - Holds the aggregated output of all cortex agent details queries.
- id String
- The provider-assigned unique ID for this managed resource.
- in
Get
Cortex Agents In - IN clause to filter the list of objects
- like String
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts
With String - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with
Describe Boolean - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- cortex
Agents GetCortex Agents Cortex Agent[] - Holds the aggregated output of all cortex agent details queries.
- id string
- The provider-assigned unique ID for this managed resource.
- in
Get
Cortex Agents In - IN clause to filter the list of objects
- like string
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts
With string - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with
Describe boolean - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- cortex_
agents Sequence[GetCortex Agents Cortex Agent] - Holds the aggregated output of all cortex agent details queries.
- id str
- The provider-assigned unique ID for this managed resource.
- in_
Get
Cortex Agents In - IN clause to filter the list of objects
- like str
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit
Get
Cortex Agents Limit - Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts_
with str - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with_
describe bool - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- cortex
Agents List<Property Map> - Holds the aggregated output of all cortex agent details queries.
- id String
- The provider-assigned unique ID for this managed resource.
- in Property Map
- IN clause to filter the list of objects
- like String
- Filters the output with case-insensitive pattern, with support for SQL wildcard characters (
%and_). - limit Property Map
- Limits the number of rows returned. If the
limit.fromis set, then the limit will start from the first element matched by the expression. The expression is only used to match with the first element, later on the elements are not matched by the prefix, but you can enforce a certain pattern withstartsWithorlike. - starts
With String - Filters the output with case-sensitive characters indicating the beginning of the object name.
- with
Describe Boolean - (Default:
true) Runs DESC AGENT for each object returned by SHOW AGENTS. The output of describe is saved to the describeOutput field. By default this value is set to true.
Supporting Types
GetCortexAgentsCortexAgent
- Describe
Outputs List<GetCortex Agents Cortex Agent Describe Output> - Holds the output of DESCRIBE AGENT.
- Show
Outputs List<GetCortex Agents Cortex Agent Show Output> - Holds the output of SHOW AGENTS.
- Describe
Outputs []GetCortex Agents Cortex Agent Describe Output - Holds the output of DESCRIBE AGENT.
- Show
Outputs []GetCortex Agents Cortex Agent Show Output - Holds the output of SHOW AGENTS.
- describe_
outputs list(object) - Holds the output of DESCRIBE AGENT.
- show_
outputs list(object) - Holds the output of SHOW AGENTS.
- describe
Outputs List<GetCortex Agents Cortex Agent Describe Output> - Holds the output of DESCRIBE AGENT.
- show
Outputs List<GetCortex Agents Cortex Agent Show Output> - Holds the output of SHOW AGENTS.
- describe
Outputs GetCortex Agents Cortex Agent Describe Output[] - Holds the output of DESCRIBE AGENT.
- show
Outputs GetCortex Agents Cortex Agent Show Output[] - Holds the output of SHOW AGENTS.
- describe_
outputs Sequence[GetCortex Agents Cortex Agent Describe Output] - Holds the output of DESCRIBE AGENT.
- show_
outputs Sequence[GetCortex Agents Cortex Agent Show Output] - Holds the output of SHOW AGENTS.
- describe
Outputs List<Property Map> - Holds the output of DESCRIBE AGENT.
- show
Outputs List<Property Map> - Holds the output of SHOW AGENTS.
GetCortexAgentsCortexAgentDescribeOutput
- Agent
Spec string - Aliases string
- Comment string
- Created
On string - Database
Name string - Default
Version stringName - Name string
- Owner string
- Profiles
List<Get
Cortex Agents Cortex Agent Describe Output Profile> - Schema
Name string - Versions string
- Agent
Spec string - Aliases string
- Comment string
- Created
On string - Database
Name string - Default
Version stringName - Name string
- Owner string
- Profiles
[]Get
Cortex Agents Cortex Agent Describe Output Profile - Schema
Name string - Versions string
- agent_
spec string - aliases string
- comment string
- created_
on string - database_
name string - default_
version_ stringname - name string
- owner string
- profiles list(object)
- schema_
name string - versions string
- agent
Spec String - aliases String
- comment String
- created
On String - database
Name String - default
Version StringName - name String
- owner String
- profiles
List<Get
Cortex Agents Cortex Agent Describe Output Profile> - schema
Name String - versions String
- agent
Spec string - aliases string
- comment string
- created
On string - database
Name string - default
Version stringName - name string
- owner string
- profiles
Get
Cortex Agents Cortex Agent Describe Output Profile[] - schema
Name string - versions string
- agent_
spec str - aliases str
- comment str
- created_
on str - database_
name str - default_
version_ strname - name str
- owner str
- profiles
Sequence[Get
Cortex Agents Cortex Agent Describe Output Profile] - schema_
name str - versions str
- agent
Spec String - aliases String
- comment String
- created
On String - database
Name String - default
Version StringName - name String
- owner String
- profiles List<Property Map>
- schema
Name String - versions String
GetCortexAgentsCortexAgentDescribeOutputProfile
- Avatar string
- Color string
- Display
Name string
- Avatar string
- Color string
- Display
Name string
- avatar string
- color string
- display_
name string
- avatar String
- color String
- display
Name String
- avatar string
- color string
- display
Name string
- avatar str
- color str
- display_
name str
- avatar String
- color String
- display
Name String
GetCortexAgentsCortexAgentShowOutput
- Comment string
- Created
On string - Database
Name string - Name string
- Owner string
- Profiles
List<Get
Cortex Agents Cortex Agent Show Output Profile> - Schema
Name string
- Comment string
- Created
On string - Database
Name string - Name string
- Owner string
- Profiles
[]Get
Cortex Agents Cortex Agent Show Output Profile - Schema
Name string
- comment string
- created_
on string - database_
name string - name string
- owner string
- profiles list(object)
- schema_
name string
- comment String
- created
On String - database
Name String - name String
- owner String
- profiles
List<Get
Cortex Agents Cortex Agent Show Output Profile> - schema
Name String
- comment string
- created
On string - database
Name string - name string
- owner string
- profiles
Get
Cortex Agents Cortex Agent Show Output Profile[] - schema
Name string
- comment String
- created
On String - database
Name String - name String
- owner String
- profiles List<Property Map>
- schema
Name String
GetCortexAgentsCortexAgentShowOutputProfile
- Avatar string
- Color string
- Display
Name string
- Avatar string
- Color string
- Display
Name string
- avatar string
- color string
- display_
name string
- avatar String
- color String
- display
Name String
- avatar string
- color string
- display
Name string
- avatar str
- color str
- display_
name str
- avatar String
- color String
- display
Name String
GetCortexAgentsIn
- Account bool
- Returns records for the entire account.
- Application string
- Returns records for the specified application.
- Application
Package string - Returns records for the specified application package.
- Database string
- Returns records for the current database in use or for a specified database.
- Schema string
- Returns records for the current schema in use or a specified schema. Use fully qualified name.
- Account bool
- Returns records for the entire account.
- Application string
- Returns records for the specified application.
- Application
Package string - Returns records for the specified application package.
- Database string
- Returns records for the current database in use or for a specified database.
- Schema string
- Returns records for the current schema in use or a specified schema. Use fully qualified name.
- account bool
- Returns records for the entire account.
- application string
- Returns records for the specified application.
- application_
package string - Returns records for the specified application package.
- database string
- Returns records for the current database in use or for a specified database.
- schema string
- Returns records for the current schema in use or a specified schema. Use fully qualified name.
- account Boolean
- Returns records for the entire account.
- application String
- Returns records for the specified application.
- application
Package String - Returns records for the specified application package.
- database String
- Returns records for the current database in use or for a specified database.
- schema String
- Returns records for the current schema in use or a specified schema. Use fully qualified name.
- account boolean
- Returns records for the entire account.
- application string
- Returns records for the specified application.
- application
Package string - Returns records for the specified application package.
- database string
- Returns records for the current database in use or for a specified database.
- schema string
- Returns records for the current schema in use or a specified schema. Use fully qualified name.
- account bool
- Returns records for the entire account.
- application str
- Returns records for the specified application.
- application_
package str - Returns records for the specified application package.
- database str
- Returns records for the current database in use or for a specified database.
- schema str
- Returns records for the current schema in use or a specified schema. Use fully qualified name.
- account Boolean
- Returns records for the entire account.
- application String
- Returns records for the specified application.
- application
Package String - Returns records for the specified application package.
- database String
- Returns records for the current database in use or for a specified database.
- schema String
- Returns records for the current schema in use or a specified schema. Use fully qualified name.
GetCortexAgentsLimit
Package Details
- Repository
- Snowflake pulumi/pulumi-snowflake
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
snowflakeTerraform Provider.
published on Thursday, Jun 25, 2026 by Pulumi