published on Friday, Nov 6, 2026 by Pulumi
published on Friday, Nov 6, 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.
Note
LIST_MIRRORSreturns only the mirrors on Postgres instances that the role used by the provider owns. For an instance owned by another role, the data source returns no mirrors.
Note When the source Postgres instance cannot be reached,
DESCRIBE_MIRRORreturns no tables or schemas, sodescribeOutputshows emptypostgresTablesandpostgresSchemas, and the data source reports a warning.
Data source used to get details of filtered Postgres mirrors. Filtering is aligned with the current possibilities for the LIST_MIRRORS procedure. The results of LIST_MIRRORS and DESCRIBE_MIRROR are encapsulated in one output collection postgresMirrors.
Using getPostgresMirrors
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 getPostgresMirrors(args: GetPostgresMirrorsArgs, opts?: InvokeOptions): Promise<GetPostgresMirrorsResult>
function getPostgresMirrorsOutput(args: GetPostgresMirrorsOutputArgs, opts?: InvokeOutputOptions): Output<GetPostgresMirrorsResult>def get_postgres_mirrors(postgres_instance: Optional[str] = None,
with_describe: Optional[bool] = None,
opts: Optional[InvokeOptions] = None) -> GetPostgresMirrorsResult
def get_postgres_mirrors_output(postgres_instance: pulumi.Input[Optional[str]] = None,
with_describe: pulumi.Input[Optional[bool]] = None,
opts: Optional[InvokeOutputOptions] = None) -> Output[GetPostgresMirrorsResult]func GetPostgresMirrors(ctx *Context, args *GetPostgresMirrorsArgs, opts ...InvokeOption) (*GetPostgresMirrorsResult, error)
func GetPostgresMirrorsOutput(ctx *Context, args *GetPostgresMirrorsOutputArgs, opts ...InvokeOption) GetPostgresMirrorsResultOutput> Note: This function is named GetPostgresMirrors in the Go SDK.
public static class GetPostgresMirrors
{
public static Task<GetPostgresMirrorsResult> InvokeAsync(GetPostgresMirrorsArgs args, InvokeOptions? opts = null)
public static Output<GetPostgresMirrorsResult> Invoke(GetPostgresMirrorsInvokeArgs args, InvokeOptions? opts = null)
public static Output<GetPostgresMirrorsResult> Invoke(GetPostgresMirrorsInvokeArgs args, InvokeOutputOptions opts)
}public static CompletableFuture<GetPostgresMirrorsResult> getPostgresMirrors(GetPostgresMirrorsArgs args, InvokeOptions options)
public static Output<GetPostgresMirrorsResult> getPostgresMirrors(GetPostgresMirrorsArgs args, InvokeOptions options)
public static Output<GetPostgresMirrorsResult> getPostgresMirrors(GetPostgresMirrorsArgs args, InvokeOutputOptions options)
fn::invoke:
function: snowflake:index/getPostgresMirrors:getPostgresMirrors
arguments:
# arguments dictionarydata "snowflake_get_postgres_mirrors" "name" {
# arguments
}The following arguments are supported:
- Postgres
Instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - With
Describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- Postgres
Instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - With
Describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- postgres_
instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with_
describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- postgres
Instance String - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with
Describe Boolean - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- postgres
Instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with
Describe boolean - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- postgres_
instance str - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with_
describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- postgres
Instance String - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with
Describe Boolean - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
getPostgresMirrors Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Postgres
Mirrors List<GetPostgres Mirrors Postgres Mirror> - Holds the aggregated output of all Postgres mirror details queries.
- Postgres
Instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - With
Describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- Id string
- The provider-assigned unique ID for this managed resource.
- Postgres
Mirrors []GetPostgres Mirrors Postgres Mirror - Holds the aggregated output of all Postgres mirror details queries.
- Postgres
Instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - With
Describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- id string
- The provider-assigned unique ID for this managed resource.
- postgres_
mirrors list(object) - Holds the aggregated output of all Postgres mirror details queries.
- postgres_
instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with_
describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- id String
- The provider-assigned unique ID for this managed resource.
- postgres
Mirrors List<GetPostgres Mirrors Postgres Mirror> - Holds the aggregated output of all Postgres mirror details queries.
- postgres
Instance String - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with
Describe Boolean - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- id string
- The provider-assigned unique ID for this managed resource.
- postgres
Mirrors GetPostgres Mirrors Postgres Mirror[] - Holds the aggregated output of all Postgres mirror details queries.
- postgres
Instance string - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with
Describe boolean - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- id str
- The provider-assigned unique ID for this managed resource.
- postgres_
mirrors Sequence[GetPostgres Mirrors Postgres Mirror] - Holds the aggregated output of all Postgres mirror details queries.
- postgres_
instance str - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with_
describe bool - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
- id String
- The provider-assigned unique ID for this managed resource.
- postgres
Mirrors List<Property Map> - Holds the aggregated output of all Postgres mirror details queries.
- postgres
Instance String - Lists only the mirrors that replicate from this Postgres instance. The name is case-sensitive. A quoted identifier, such as the instance's
fullyQualifiedName, is also accepted. - with
Describe Boolean - (Default:
true) Runs DESCRIBEMIRROR for each mirror returned by LISTMIRRORS. The output of describe is saved to the describeOutput field. By default this value is set to true.
Supporting Types
GetPostgresMirrorsPostgresMirror
- Describe
Outputs List<GetPostgres Mirrors Postgres Mirror Describe Output> - Holds the output of DESCRIBE_MIRROR.
- Show
Outputs List<GetPostgres Mirrors Postgres Mirror Show Output> - Holds the output of LIST_MIRRORS.
- Describe
Outputs []GetPostgres Mirrors Postgres Mirror Describe Output - Holds the output of DESCRIBE_MIRROR.
- Show
Outputs []GetPostgres Mirrors Postgres Mirror Show Output - Holds the output of LIST_MIRRORS.
- describe_
outputs list(object) - Holds the output of DESCRIBE_MIRROR.
- show_
outputs list(object) - Holds the output of LIST_MIRRORS.
- describe
Outputs List<GetPostgres Mirrors Postgres Mirror Describe Output> - Holds the output of DESCRIBE_MIRROR.
- show
Outputs List<GetPostgres Mirrors Postgres Mirror Show Output> - Holds the output of LIST_MIRRORS.
- describe
Outputs GetPostgres Mirrors Postgres Mirror Describe Output[] - Holds the output of DESCRIBE_MIRROR.
- show
Outputs GetPostgres Mirrors Postgres Mirror Show Output[] - Holds the output of LIST_MIRRORS.
- describe_
outputs Sequence[GetPostgres Mirrors Postgres Mirror Describe Output] - Holds the output of DESCRIBE_MIRROR.
- show_
outputs Sequence[GetPostgres Mirrors Postgres Mirror Show Output] - Holds the output of LIST_MIRRORS.
- describe
Outputs List<Property Map> - Holds the output of DESCRIBE_MIRROR.
- show
Outputs List<Property Map> - Holds the output of LIST_MIRRORS.
GetPostgresMirrorsPostgresMirrorDescribeOutput
- Apply
Lag intBytes - Apply
Lag intOperations - Apply
Lag intSeconds - Catalog
Integration stringName - Error
Message string - External
Volume string - Feed
Only bool - Last
Applied stringCommit Lsn - Last
Applied stringCommit Time - Last
Apply stringTime - Last
Operation intId - Last
Operation stringTime - Name string
- Postgres
Database string - Postgres
Instance string - Postgres
Schemas List<string> - Postgres
Status string - Postgres
Tables List<string> - Recent
Query stringDurations - Refresh
Interval string - Status string
- Target
Database string - Target
Table stringType - Warehouse string
- Apply
Lag intBytes - Apply
Lag intOperations - Apply
Lag intSeconds - Catalog
Integration stringName - Error
Message string - External
Volume string - Feed
Only bool - Last
Applied stringCommit Lsn - Last
Applied stringCommit Time - Last
Apply stringTime - Last
Operation intId - Last
Operation stringTime - Name string
- Postgres
Database string - Postgres
Instance string - Postgres
Schemas []string - Postgres
Status string - Postgres
Tables []string - Recent
Query stringDurations - Refresh
Interval string - Status string
- Target
Database string - Target
Table stringType - Warehouse string
- apply_
lag_ numberbytes - apply_
lag_ numberoperations - apply_
lag_ numberseconds - catalog_
integration_ stringname - error_
message string - external_
volume string - feed_
only bool - last_
applied_ stringcommit_ lsn - last_
applied_ stringcommit_ time - last_
apply_ stringtime - last_
operation_ numberid - last_
operation_ stringtime - name string
- postgres_
database string - postgres_
instance string - postgres_
schemas list(string) - postgres_
status string - postgres_
tables list(string) - recent_
query_ stringdurations - refresh_
interval string - status string
- target_
database string - target_
table_ stringtype - warehouse string
- apply
Lag IntegerBytes - apply
Lag IntegerOperations - apply
Lag IntegerSeconds - catalog
Integration StringName - error
Message String - external
Volume String - feed
Only Boolean - last
Applied StringCommit Lsn - last
Applied StringCommit Time - last
Apply StringTime - last
Operation IntegerId - last
Operation StringTime - name String
- postgres
Database String - postgres
Instance String - postgres
Schemas List<String> - postgres
Status String - postgres
Tables List<String> - recent
Query StringDurations - refresh
Interval String - status String
- target
Database String - target
Table StringType - warehouse String
- apply
Lag numberBytes - apply
Lag numberOperations - apply
Lag numberSeconds - catalog
Integration stringName - error
Message string - external
Volume string - feed
Only boolean - last
Applied stringCommit Lsn - last
Applied stringCommit Time - last
Apply stringTime - last
Operation numberId - last
Operation stringTime - name string
- postgres
Database string - postgres
Instance string - postgres
Schemas string[] - postgres
Status string - postgres
Tables string[] - recent
Query stringDurations - refresh
Interval string - status string
- target
Database string - target
Table stringType - warehouse string
- apply_
lag_ intbytes - apply_
lag_ intoperations - apply_
lag_ intseconds - catalog_
integration_ strname - error_
message str - external_
volume str - feed_
only bool - last_
applied_ strcommit_ lsn - last_
applied_ strcommit_ time - last_
apply_ strtime - last_
operation_ intid - last_
operation_ strtime - name str
- postgres_
database str - postgres_
instance str - postgres_
schemas Sequence[str] - postgres_
status str - postgres_
tables Sequence[str] - recent_
query_ strdurations - refresh_
interval str - status str
- target_
database str - target_
table_ strtype - warehouse str
- apply
Lag NumberBytes - apply
Lag NumberOperations - apply
Lag NumberSeconds - catalog
Integration StringName - error
Message String - external
Volume String - feed
Only Boolean - last
Applied StringCommit Lsn - last
Applied StringCommit Time - last
Apply StringTime - last
Operation NumberId - last
Operation StringTime - name String
- postgres
Database String - postgres
Instance String - postgres
Schemas List<String> - postgres
Status String - postgres
Tables List<String> - recent
Query StringDurations - refresh
Interval String - status String
- target
Database String - target
Table StringType - warehouse String
GetPostgresMirrorsPostgresMirrorShowOutput
- Error
Message string - Initial
Snapshot intTables Remaining - Last
Apply stringTime - Last
Operation stringTime - Name string
- Postgres
Database string - Postgres
Instance string - Refresh
Interval string - Status string
- Table
Count int - Target
Database string
- Error
Message string - Initial
Snapshot intTables Remaining - Last
Apply stringTime - Last
Operation stringTime - Name string
- Postgres
Database string - Postgres
Instance string - Refresh
Interval string - Status string
- Table
Count int - Target
Database string
- error_
message string - initial_
snapshot_ numbertables_ remaining - last_
apply_ stringtime - last_
operation_ stringtime - name string
- postgres_
database string - postgres_
instance string - refresh_
interval string - status string
- table_
count number - target_
database string
- error
Message String - initial
Snapshot IntegerTables Remaining - last
Apply StringTime - last
Operation StringTime - name String
- postgres
Database String - postgres
Instance String - refresh
Interval String - status String
- table
Count Integer - target
Database String
- error
Message string - initial
Snapshot numberTables Remaining - last
Apply stringTime - last
Operation stringTime - name string
- postgres
Database string - postgres
Instance string - refresh
Interval string - status string
- table
Count number - target
Database string
- error_
message str - initial_
snapshot_ inttables_ remaining - last_
apply_ strtime - last_
operation_ strtime - name str
- postgres_
database str - postgres_
instance str - refresh_
interval str - status str
- table_
count int - target_
database str
- error
Message String - initial
Snapshot NumberTables Remaining - last
Apply StringTime - last
Operation StringTime - name String
- postgres
Database String - postgres
Instance String - refresh
Interval String - status String
- table
Count Number - target
Database String
Package Details
- Repository
- Snowflake pulumi/pulumi-snowflake
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
snowflakeTerraform Provider.
published on Friday, Nov 6, 2026 by Pulumi