postgresql.Provider
Explore with Pulumi AI
The provider type for the postgresql package. By default, resources use package-wide configuration
settings, however an explicit Provider
instance may be created and passed during resource
construction to achieve fine-grained programmatic control over provider settings. See the
documentation for more information.
Create Provider Resource
new Provider(name: string, args?: ProviderArgs, opts?: CustomResourceOptions);
@overload
def Provider(resource_name: str,
opts: Optional[ResourceOptions] = None,
aws_rds_iam_auth: Optional[bool] = None,
aws_rds_iam_profile: Optional[str] = None,
aws_rds_iam_region: Optional[str] = None,
azure_identity_auth: Optional[bool] = None,
azure_tenant_id: Optional[str] = None,
clientcert: Optional[ProviderClientcertArgs] = None,
connect_timeout: Optional[int] = None,
database: Optional[str] = None,
database_username: Optional[str] = None,
expected_version: Optional[str] = None,
host: Optional[str] = None,
max_connections: Optional[int] = None,
password: Optional[str] = None,
port: Optional[int] = None,
scheme: Optional[str] = None,
ssl_mode: Optional[str] = None,
sslmode: Optional[str] = None,
sslrootcert: Optional[str] = None,
superuser: Optional[bool] = None,
username: Optional[str] = None)
@overload
def Provider(resource_name: str,
args: Optional[ProviderArgs] = None,
opts: Optional[ResourceOptions] = None)
func NewProvider(ctx *Context, name string, args *ProviderArgs, opts ...ResourceOption) (*Provider, error)
public Provider(string name, ProviderArgs? args = null, CustomResourceOptions? opts = null)
public Provider(String name, ProviderArgs args)
public Provider(String name, ProviderArgs args, CustomResourceOptions options)
type: pulumi:providers:postgresql
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ProviderArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Provider Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Provider resource accepts the following input properties:
- Aws
Rds boolIam Auth Use rds_iam instead of password authentication (see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
- Aws
Rds stringIam Profile AWS profile to use for IAM auth
- Aws
Rds stringIam Region AWS region to use for IAM auth
- Azure
Identity boolAuth Use MS Azure identity OAuth token (see: https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-configure-sign-in-azure-ad-authentication)
- Azure
Tenant stringId MS Azure tenant ID (see: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/client_config.html)
- Clientcert
Pulumi.
Postgre Sql. Inputs. Provider Clientcert SSL client certificate if required by the database.
- Connect
Timeout int Maximum wait for connection, in seconds. Zero or not specified means wait indefinitely. It can also be sourced from the following environment variable:
PGCONNECT_TIMEOUT
- Database string
The name of the database to connect to in order to conenct to (defaults to
postgres
).- Database
Username string Database username associated to the connected user (for user name maps)
- Expected
Version string Specify the expected version of PostgreSQL.
- Host string
Name of PostgreSQL server address to connect to
- Max
Connections int Maximum number of connections to establish to the database. Zero means unlimited.
- Password string
Password to be used if the PostgreSQL server demands password authentication
- Port int
The PostgreSQL port number to connect to at the server host, or socket file name extension for Unix-domain connections
- Scheme string
- Ssl
Mode string Rename PostgreSQL provider
ssl_mode
attribute tosslmode
- Sslmode string
This option determines whether or with what priority a secure SSL TCP/IP connection will be negotiated with the PostgreSQL server It can also be sourced from the following environment variable:
PGSSLMODE
- Sslrootcert string
The SSL server root certificate file path. The file must contain PEM encoded data.
- Superuser bool
Specify if the user to connect as is a Postgres superuser or not.If not, some feature might be disabled (e.g.: Refreshing state password from Postgres)
- Username string
PostgreSQL user name to connect as
- Aws
Rds boolIam Auth Use rds_iam instead of password authentication (see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
- Aws
Rds stringIam Profile AWS profile to use for IAM auth
- Aws
Rds stringIam Region AWS region to use for IAM auth
- Azure
Identity boolAuth Use MS Azure identity OAuth token (see: https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-configure-sign-in-azure-ad-authentication)
- Azure
Tenant stringId MS Azure tenant ID (see: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/client_config.html)
- Clientcert
Provider
Clientcert Args SSL client certificate if required by the database.
- Connect
Timeout int Maximum wait for connection, in seconds. Zero or not specified means wait indefinitely. It can also be sourced from the following environment variable:
PGCONNECT_TIMEOUT
- Database string
The name of the database to connect to in order to conenct to (defaults to
postgres
).- Database
Username string Database username associated to the connected user (for user name maps)
- Expected
Version string Specify the expected version of PostgreSQL.
- Host string
Name of PostgreSQL server address to connect to
- Max
Connections int Maximum number of connections to establish to the database. Zero means unlimited.
- Password string
Password to be used if the PostgreSQL server demands password authentication
- Port int
The PostgreSQL port number to connect to at the server host, or socket file name extension for Unix-domain connections
- Scheme string
- Ssl
Mode string Rename PostgreSQL provider
ssl_mode
attribute tosslmode
- Sslmode string
This option determines whether or with what priority a secure SSL TCP/IP connection will be negotiated with the PostgreSQL server It can also be sourced from the following environment variable:
PGSSLMODE
- Sslrootcert string
The SSL server root certificate file path. The file must contain PEM encoded data.
- Superuser bool
Specify if the user to connect as is a Postgres superuser or not.If not, some feature might be disabled (e.g.: Refreshing state password from Postgres)
- Username string
PostgreSQL user name to connect as
- aws
Rds BooleanIam Auth Use rds_iam instead of password authentication (see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
- aws
Rds StringIam Profile AWS profile to use for IAM auth
- aws
Rds StringIam Region AWS region to use for IAM auth
- azure
Identity BooleanAuth Use MS Azure identity OAuth token (see: https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-configure-sign-in-azure-ad-authentication)
- azure
Tenant StringId MS Azure tenant ID (see: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/client_config.html)
- clientcert
Provider
Clientcert SSL client certificate if required by the database.
- connect
Timeout Integer Maximum wait for connection, in seconds. Zero or not specified means wait indefinitely. It can also be sourced from the following environment variable:
PGCONNECT_TIMEOUT
- database String
The name of the database to connect to in order to conenct to (defaults to
postgres
).- database
Username String Database username associated to the connected user (for user name maps)
- expected
Version String Specify the expected version of PostgreSQL.
- host String
Name of PostgreSQL server address to connect to
- max
Connections Integer Maximum number of connections to establish to the database. Zero means unlimited.
- password String
Password to be used if the PostgreSQL server demands password authentication
- port Integer
The PostgreSQL port number to connect to at the server host, or socket file name extension for Unix-domain connections
- scheme String
- ssl
Mode String Rename PostgreSQL provider
ssl_mode
attribute tosslmode
- sslmode String
This option determines whether or with what priority a secure SSL TCP/IP connection will be negotiated with the PostgreSQL server It can also be sourced from the following environment variable:
PGSSLMODE
- sslrootcert String
The SSL server root certificate file path. The file must contain PEM encoded data.
- superuser Boolean
Specify if the user to connect as is a Postgres superuser or not.If not, some feature might be disabled (e.g.: Refreshing state password from Postgres)
- username String
PostgreSQL user name to connect as
- aws
Rds booleanIam Auth Use rds_iam instead of password authentication (see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
- aws
Rds stringIam Profile AWS profile to use for IAM auth
- aws
Rds stringIam Region AWS region to use for IAM auth
- azure
Identity booleanAuth Use MS Azure identity OAuth token (see: https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-configure-sign-in-azure-ad-authentication)
- azure
Tenant stringId MS Azure tenant ID (see: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/client_config.html)
- clientcert
Provider
Clientcert SSL client certificate if required by the database.
- connect
Timeout number Maximum wait for connection, in seconds. Zero or not specified means wait indefinitely. It can also be sourced from the following environment variable:
PGCONNECT_TIMEOUT
- database string
The name of the database to connect to in order to conenct to (defaults to
postgres
).- database
Username string Database username associated to the connected user (for user name maps)
- expected
Version string Specify the expected version of PostgreSQL.
- host string
Name of PostgreSQL server address to connect to
- max
Connections number Maximum number of connections to establish to the database. Zero means unlimited.
- password string
Password to be used if the PostgreSQL server demands password authentication
- port number
The PostgreSQL port number to connect to at the server host, or socket file name extension for Unix-domain connections
- scheme string
- ssl
Mode string Rename PostgreSQL provider
ssl_mode
attribute tosslmode
- sslmode string
This option determines whether or with what priority a secure SSL TCP/IP connection will be negotiated with the PostgreSQL server It can also be sourced from the following environment variable:
PGSSLMODE
- sslrootcert string
The SSL server root certificate file path. The file must contain PEM encoded data.
- superuser boolean
Specify if the user to connect as is a Postgres superuser or not.If not, some feature might be disabled (e.g.: Refreshing state password from Postgres)
- username string
PostgreSQL user name to connect as
- aws_
rds_ booliam_ auth Use rds_iam instead of password authentication (see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
- aws_
rds_ striam_ profile AWS profile to use for IAM auth
- aws_
rds_ striam_ region AWS region to use for IAM auth
- azure_
identity_ boolauth Use MS Azure identity OAuth token (see: https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-configure-sign-in-azure-ad-authentication)
- azure_
tenant_ strid MS Azure tenant ID (see: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/client_config.html)
- clientcert
Provider
Clientcert Args SSL client certificate if required by the database.
- connect_
timeout int Maximum wait for connection, in seconds. Zero or not specified means wait indefinitely. It can also be sourced from the following environment variable:
PGCONNECT_TIMEOUT
- database str
The name of the database to connect to in order to conenct to (defaults to
postgres
).- database_
username str Database username associated to the connected user (for user name maps)
- expected_
version str Specify the expected version of PostgreSQL.
- host str
Name of PostgreSQL server address to connect to
- max_
connections int Maximum number of connections to establish to the database. Zero means unlimited.
- password str
Password to be used if the PostgreSQL server demands password authentication
- port int
The PostgreSQL port number to connect to at the server host, or socket file name extension for Unix-domain connections
- scheme str
- ssl_
mode str Rename PostgreSQL provider
ssl_mode
attribute tosslmode
- sslmode str
This option determines whether or with what priority a secure SSL TCP/IP connection will be negotiated with the PostgreSQL server It can also be sourced from the following environment variable:
PGSSLMODE
- sslrootcert str
The SSL server root certificate file path. The file must contain PEM encoded data.
- superuser bool
Specify if the user to connect as is a Postgres superuser or not.If not, some feature might be disabled (e.g.: Refreshing state password from Postgres)
- username str
PostgreSQL user name to connect as
- aws
Rds BooleanIam Auth Use rds_iam instead of password authentication (see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
- aws
Rds StringIam Profile AWS profile to use for IAM auth
- aws
Rds StringIam Region AWS region to use for IAM auth
- azure
Identity BooleanAuth Use MS Azure identity OAuth token (see: https://learn.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-configure-sign-in-azure-ad-authentication)
- azure
Tenant StringId MS Azure tenant ID (see: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/data-sources/client_config.html)
- clientcert Property Map
SSL client certificate if required by the database.
- connect
Timeout Number Maximum wait for connection, in seconds. Zero or not specified means wait indefinitely. It can also be sourced from the following environment variable:
PGCONNECT_TIMEOUT
- database String
The name of the database to connect to in order to conenct to (defaults to
postgres
).- database
Username String Database username associated to the connected user (for user name maps)
- expected
Version String Specify the expected version of PostgreSQL.
- host String
Name of PostgreSQL server address to connect to
- max
Connections Number Maximum number of connections to establish to the database. Zero means unlimited.
- password String
Password to be used if the PostgreSQL server demands password authentication
- port Number
The PostgreSQL port number to connect to at the server host, or socket file name extension for Unix-domain connections
- scheme String
- ssl
Mode String Rename PostgreSQL provider
ssl_mode
attribute tosslmode
- sslmode String
This option determines whether or with what priority a secure SSL TCP/IP connection will be negotiated with the PostgreSQL server It can also be sourced from the following environment variable:
PGSSLMODE
- sslrootcert String
The SSL server root certificate file path. The file must contain PEM encoded data.
- superuser Boolean
Specify if the user to connect as is a Postgres superuser or not.If not, some feature might be disabled (e.g.: Refreshing state password from Postgres)
- username String
PostgreSQL user name to connect as
Outputs
All input properties are implicitly available as output properties. Additionally, the Provider resource produces the following output properties:
- Id string
The provider-assigned unique ID for this managed resource.
- Id string
The provider-assigned unique ID for this managed resource.
- id String
The provider-assigned unique ID for this managed resource.
- id string
The provider-assigned unique ID for this managed resource.
- id str
The provider-assigned unique ID for this managed resource.
- id String
The provider-assigned unique ID for this managed resource.
Supporting Types
ProviderClientcert, ProviderClientcertArgs
Package Details
- Repository
- PostgreSQL pulumi/pulumi-postgresql
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
postgresql
Terraform Provider.