published on Saturday, May 9, 2026 by Pulumi
published on Saturday, May 9, 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 previewFeaturesEnabled field 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.
Required warehouse For this resource, the provider now uses policy references to get information about policies attached to users. This function requires a warehouse in the connection. Please, make sure you have either set a
DEFAULT_WAREHOUSEfor the user, or specified a warehouse in the provider configuration.
Specifies the session policy to use for a certain user.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as snowflake from "@pulumi/snowflake";
const sp = new snowflake.SessionPolicy("sp", {
database: "prod",
schema: "security",
name: "default_session_policy",
});
const user = new snowflake.User("user", {name: "USER_NAME"});
const spa = new snowflake.UserSessionPolicyAttachment("spa", {
sessionPolicyName: sp.fullyQualifiedName,
userName: user.name,
});
import pulumi
import pulumi_snowflake as snowflake
sp = snowflake.SessionPolicy("sp",
database="prod",
schema="security",
name="default_session_policy")
user = snowflake.User("user", name="USER_NAME")
spa = snowflake.UserSessionPolicyAttachment("spa",
session_policy_name=sp.fully_qualified_name,
user_name=user.name)
package main
import (
"github.com/pulumi/pulumi-snowflake/sdk/v2/go/snowflake"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
sp, err := snowflake.NewSessionPolicy(ctx, "sp", &snowflake.SessionPolicyArgs{
Database: pulumi.String("prod"),
Schema: pulumi.String("security"),
Name: pulumi.String("default_session_policy"),
})
if err != nil {
return err
}
user, err := snowflake.NewUser(ctx, "user", &snowflake.UserArgs{
Name: pulumi.String("USER_NAME"),
})
if err != nil {
return err
}
_, err = snowflake.NewUserSessionPolicyAttachment(ctx, "spa", &snowflake.UserSessionPolicyAttachmentArgs{
SessionPolicyName: sp.FullyQualifiedName,
UserName: user.Name,
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Snowflake = Pulumi.Snowflake;
return await Deployment.RunAsync(() =>
{
var sp = new Snowflake.SessionPolicy("sp", new()
{
Database = "prod",
Schema = "security",
Name = "default_session_policy",
});
var user = new Snowflake.User("user", new()
{
Name = "USER_NAME",
});
var spa = new Snowflake.UserSessionPolicyAttachment("spa", new()
{
SessionPolicyName = sp.FullyQualifiedName,
UserName = user.Name,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.snowflake.SessionPolicy;
import com.pulumi.snowflake.SessionPolicyArgs;
import com.pulumi.snowflake.User;
import com.pulumi.snowflake.UserArgs;
import com.pulumi.snowflake.UserSessionPolicyAttachment;
import com.pulumi.snowflake.UserSessionPolicyAttachmentArgs;
import java.util.ArrayList;
import java.util.Arrays;
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) {
var sp = new SessionPolicy("sp", SessionPolicyArgs.builder()
.database("prod")
.schema("security")
.name("default_session_policy")
.build());
var user = new User("user", UserArgs.builder()
.name("USER_NAME")
.build());
var spa = new UserSessionPolicyAttachment("spa", UserSessionPolicyAttachmentArgs.builder()
.sessionPolicyName(sp.fullyQualifiedName())
.userName(user.name())
.build());
}
}
resources:
sp:
type: snowflake:SessionPolicy
properties:
database: prod
schema: security
name: default_session_policy
user:
type: snowflake:User
properties:
name: USER_NAME
spa:
type: snowflake:UserSessionPolicyAttachment
properties:
sessionPolicyName: ${sp.fullyQualifiedName}
userName: ${user.name}
Example coming soon!
Note Instead of using fully_qualified_name, you can reference objects managed outside Terraform by constructing a correct ID, consult identifiers guide.
Note If a field has a default value, it is shown next to the type in the schema.
Create UserSessionPolicyAttachment Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new UserSessionPolicyAttachment(name: string, args: UserSessionPolicyAttachmentArgs, opts?: CustomResourceOptions);@overload
def UserSessionPolicyAttachment(resource_name: str,
args: UserSessionPolicyAttachmentArgs,
opts: Optional[ResourceOptions] = None)
@overload
def UserSessionPolicyAttachment(resource_name: str,
opts: Optional[ResourceOptions] = None,
session_policy_name: Optional[str] = None,
user_name: Optional[str] = None)func NewUserSessionPolicyAttachment(ctx *Context, name string, args UserSessionPolicyAttachmentArgs, opts ...ResourceOption) (*UserSessionPolicyAttachment, error)public UserSessionPolicyAttachment(string name, UserSessionPolicyAttachmentArgs args, CustomResourceOptions? opts = null)
public UserSessionPolicyAttachment(String name, UserSessionPolicyAttachmentArgs args)
public UserSessionPolicyAttachment(String name, UserSessionPolicyAttachmentArgs args, CustomResourceOptions options)
type: snowflake:UserSessionPolicyAttachment
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "snowflake_usersessionpolicyattachment" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args UserSessionPolicyAttachmentArgs
- 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 UserSessionPolicyAttachmentArgs
- 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 UserSessionPolicyAttachmentArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args UserSessionPolicyAttachmentArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args UserSessionPolicyAttachmentArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var userSessionPolicyAttachmentResource = new Snowflake.UserSessionPolicyAttachment("userSessionPolicyAttachmentResource", new()
{
SessionPolicyName = "string",
UserName = "string",
});
example, err := snowflake.NewUserSessionPolicyAttachment(ctx, "userSessionPolicyAttachmentResource", &snowflake.UserSessionPolicyAttachmentArgs{
SessionPolicyName: pulumi.String("string"),
UserName: pulumi.String("string"),
})
resource "snowflake_usersessionpolicyattachment" "userSessionPolicyAttachmentResource" {
session_policy_name = "string"
user_name = "string"
}
var userSessionPolicyAttachmentResource = new UserSessionPolicyAttachment("userSessionPolicyAttachmentResource", UserSessionPolicyAttachmentArgs.builder()
.sessionPolicyName("string")
.userName("string")
.build());
user_session_policy_attachment_resource = snowflake.UserSessionPolicyAttachment("userSessionPolicyAttachmentResource",
session_policy_name="string",
user_name="string")
const userSessionPolicyAttachmentResource = new snowflake.UserSessionPolicyAttachment("userSessionPolicyAttachmentResource", {
sessionPolicyName: "string",
userName: "string",
});
type: snowflake:UserSessionPolicyAttachment
properties:
sessionPolicyName: string
userName: string
UserSessionPolicyAttachment Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The UserSessionPolicyAttachment resource accepts the following input properties:
- Session
Policy stringName - Fully qualified name of the session policy.
- User
Name string - User name of the user you want to attach the session policy to.
- Session
Policy stringName - Fully qualified name of the session policy.
- User
Name string - User name of the user you want to attach the session policy to.
- session_
policy_ stringname - Fully qualified name of the session policy.
- user_
name string - User name of the user you want to attach the session policy to.
- session
Policy StringName - Fully qualified name of the session policy.
- user
Name String - User name of the user you want to attach the session policy to.
- session
Policy stringName - Fully qualified name of the session policy.
- user
Name string - User name of the user you want to attach the session policy to.
- session_
policy_ strname - Fully qualified name of the session policy.
- user_
name str - User name of the user you want to attach the session policy to.
- session
Policy StringName - Fully qualified name of the session policy.
- user
Name String - User name of the user you want to attach the session policy to.
Outputs
All input properties are implicitly available as output properties. Additionally, the UserSessionPolicyAttachment 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 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.
Look up Existing UserSessionPolicyAttachment Resource
Get an existing UserSessionPolicyAttachment resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: UserSessionPolicyAttachmentState, opts?: CustomResourceOptions): UserSessionPolicyAttachment@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
session_policy_name: Optional[str] = None,
user_name: Optional[str] = None) -> UserSessionPolicyAttachmentfunc GetUserSessionPolicyAttachment(ctx *Context, name string, id IDInput, state *UserSessionPolicyAttachmentState, opts ...ResourceOption) (*UserSessionPolicyAttachment, error)public static UserSessionPolicyAttachment Get(string name, Input<string> id, UserSessionPolicyAttachmentState? state, CustomResourceOptions? opts = null)public static UserSessionPolicyAttachment get(String name, Output<String> id, UserSessionPolicyAttachmentState state, CustomResourceOptions options)resources: _: type: snowflake:UserSessionPolicyAttachment get: id: ${id}import {
to = snowflake_usersessionpolicyattachment.example
id = "${id}"
}
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Session
Policy stringName - Fully qualified name of the session policy.
- User
Name string - User name of the user you want to attach the session policy to.
- Session
Policy stringName - Fully qualified name of the session policy.
- User
Name string - User name of the user you want to attach the session policy to.
- session_
policy_ stringname - Fully qualified name of the session policy.
- user_
name string - User name of the user you want to attach the session policy to.
- session
Policy StringName - Fully qualified name of the session policy.
- user
Name String - User name of the user you want to attach the session policy to.
- session
Policy stringName - Fully qualified name of the session policy.
- user
Name string - User name of the user you want to attach the session policy to.
- session_
policy_ strname - Fully qualified name of the session policy.
- user_
name str - User name of the user you want to attach the session policy to.
- session
Policy StringName - Fully qualified name of the session policy.
- user
Name String - User name of the user you want to attach the session policy to.
Import
$ pulumi import snowflake:index/userSessionPolicyAttachment:UserSessionPolicyAttachment example '"<user_name>"|"<database_name>"."<schema_name>"."<session_policy_name>"'
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Snowflake pulumi/pulumi-snowflake
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
snowflakeTerraform Provider.
published on Saturday, May 9, 2026 by Pulumi
