1. Packages
  2. Ibm Provider
  3. API Docs
  4. IamRoleTemplate
ibm 1.86.0 published on Wednesday, Dec 3, 2025 by ibm-cloud
Schema (JSON)
ibm-cloud/terraform-provider-ibm

ibm.IamRoleTemplate

ibm logo
ibm 1.86.0 published on Wednesday, Dec 3, 2025 by ibm-cloud
Schema (JSON)
ibm-cloud/terraform-provider-ibm

    Create, update, and delete iam_role_templates with this resource.

    Example Usage

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

const iamRoleTemplateInstance = new ibm.IamRoleTemplate("iam_role_template_instance", {
    name: "name",
    role: {
        name: "name",
        displayName: "display_name",
        serviceName: "service_name",
        description: "description",
        actions: ["actions"],
    },
});

    import pulumi
import pulumi_ibm as ibm

iam_role_template_instance = ibm.IamRoleTemplate("iam_role_template_instance",
    name="name",
    role={
        "name": "name",
        "display_name": "display_name",
        "service_name": "service_name",
        "description": "description",
        "actions": ["actions"],
    })

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.NewIamRoleTemplate(ctx, "iam_role_template_instance", &ibm.IamRoleTemplateArgs{
			Name: pulumi.String("name"),
			Role: &ibm.IamRoleTemplateRoleArgs{
				Name:        pulumi.String("name"),
				DisplayName: pulumi.String("display_name"),
				ServiceName: pulumi.String("service_name"),
				Description: pulumi.String("description"),
				Actions: pulumi.StringArray{
					pulumi.String("actions"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;

return await Deployment.RunAsync(() => 
{
    var iamRoleTemplateInstance = new Ibm.IamRoleTemplate("iam_role_template_instance", new()
    {
        Name = "name",
        Role = new Ibm.Inputs.IamRoleTemplateRoleArgs
        {
            Name = "name",
            DisplayName = "display_name",
            ServiceName = "service_name",
            Description = "description",
            Actions = new[]
            {
                "actions",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IamRoleTemplate;
import com.pulumi.ibm.IamRoleTemplateArgs;
import com.pulumi.ibm.inputs.IamRoleTemplateRoleArgs;
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) {
        var iamRoleTemplateInstance = new IamRoleTemplate("iamRoleTemplateInstance", IamRoleTemplateArgs.builder()
            .name("name")
            .role(IamRoleTemplateRoleArgs.builder()
                .name("name")
                .displayName("display_name")
                .serviceName("service_name")
                .description("description")
                .actions("actions")
                .build())
            .build());

    }
}

    resources:
  iamRoleTemplateInstance:
    type: ibm:IamRoleTemplate
    name: iam_role_template_instance
    properties:
      name: name
      role:
        name: name
        displayName: display_name
        serviceName: service_name
        description: description
        actions:
          - actions

    Create IamRoleTemplate Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new IamRoleTemplate(name: string, args?: IamRoleTemplateArgs, opts?: CustomResourceOptions);
    @overload
def IamRoleTemplate(resource_name: str,
                    args: Optional[IamRoleTemplateArgs] = None,
                    opts: Optional[ResourceOptions] = None)

@overload
def IamRoleTemplate(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    committed: Optional[bool] = None,
                    description: Optional[str] = None,
                    iam_role_template_id: Optional[str] = None,
                    name: Optional[str] = None,
                    role: Optional[IamRoleTemplateRoleArgs] = None)
    func NewIamRoleTemplate(ctx *Context, name string, args *IamRoleTemplateArgs, opts ...ResourceOption) (*IamRoleTemplate, error)
    public IamRoleTemplate(string name, IamRoleTemplateArgs? args = null, CustomResourceOptions? opts = null)
    public IamRoleTemplate(String name, IamRoleTemplateArgs args)
public IamRoleTemplate(String name, IamRoleTemplateArgs args, CustomResourceOptions options)

    type: ibm:IamRoleTemplate
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args IamRoleTemplateArgs
    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 IamRoleTemplateArgs
    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 IamRoleTemplateArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IamRoleTemplateArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IamRoleTemplateArgs
    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 iamRoleTemplateResource = new Ibm.IamRoleTemplate("iamRoleTemplateResource", new()
{
    Committed = false,
    Description = "string",
    IamRoleTemplateId = "string",
    Name = "string",
    Role = new Ibm.Inputs.IamRoleTemplateRoleArgs
    {
        Actions = new[]
        {
            "string",
        },
        DisplayName = "string",
        Name = "string",
        ServiceName = "string",
        Description = "string",
    },
});

    example, err := ibm.NewIamRoleTemplate(ctx, "iamRoleTemplateResource", &ibm.IamRoleTemplateArgs{
	Committed:         pulumi.Bool(false),
	Description:       pulumi.String("string"),
	IamRoleTemplateId: pulumi.String("string"),
	Name:              pulumi.String("string"),
	Role: &ibm.IamRoleTemplateRoleArgs{
		Actions: pulumi.StringArray{
			pulumi.String("string"),
		},
		DisplayName: pulumi.String("string"),
		Name:        pulumi.String("string"),
		ServiceName: pulumi.String("string"),
		Description: pulumi.String("string"),
	},
})

    var iamRoleTemplateResource = new IamRoleTemplate("iamRoleTemplateResource", IamRoleTemplateArgs.builder()
    .committed(false)
    .description("string")
    .iamRoleTemplateId("string")
    .name("string")
    .role(IamRoleTemplateRoleArgs.builder()
        .actions("string")
        .displayName("string")
        .name("string")
        .serviceName("string")
        .description("string")
        .build())
    .build());

    iam_role_template_resource = ibm.IamRoleTemplate("iamRoleTemplateResource",
    committed=False,
    description="string",
    iam_role_template_id="string",
    name="string",
    role={
        "actions": ["string"],
        "display_name": "string",
        "name": "string",
        "service_name": "string",
        "description": "string",
    })

    const iamRoleTemplateResource = new ibm.IamRoleTemplate("iamRoleTemplateResource", {
    committed: false,
    description: "string",
    iamRoleTemplateId: "string",
    name: "string",
    role: {
        actions: ["string"],
        displayName: "string",
        name: "string",
        serviceName: "string",
        description: "string",
    },
});

    type: ibm:IamRoleTemplate
properties:
    committed: false
    description: string
    iamRoleTemplateId: string
    name: string
    role:
        actions:
            - string
        description: string
        displayName: string
        name: string
        serviceName: string

    IamRoleTemplate 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 IamRoleTemplate resource accepts the following input properties:

    Committed bool
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    Description string
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    IamRoleTemplateId string
    The unique identifier of the iam_role_template.
    Name string
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    Role IamRoleTemplateRole
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    Committed bool
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    Description string
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    IamRoleTemplateId string
    The unique identifier of the iam_role_template.
    Name string
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    Role IamRoleTemplateRoleArgs
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    committed Boolean
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    description String
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    iamRoleTemplateId String
    The unique identifier of the iam_role_template.
    name String
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role IamRoleTemplateRole
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    committed boolean
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    description string
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    iamRoleTemplateId string
    The unique identifier of the iam_role_template.
    name string
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role IamRoleTemplateRole
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    committed bool
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    description str
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    iam_role_template_id str
    The unique identifier of the iam_role_template.
    name str
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role IamRoleTemplateRoleArgs
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    committed Boolean
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    description String
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    iamRoleTemplateId String
    The unique identifier of the iam_role_template.
    name String
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role Property Map
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:

    Outputs

    All input properties are implicitly available as output properties. Additionally, the IamRoleTemplate resource produces the following output properties:

    AccountId string
    (String) Enterprise account ID where this template will be created.
    CreatedAt string
    (String) The UTC timestamp when the role template was created.
    CreatedById string
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    Href string
    (String) The href URL that links to the role templates API by role template ID.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedAt string
    (String) The UTC timestamp when the role template was last modified.
    LastModifiedById string
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    RoleTemplateId string
    The role template ID.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    AccountId string
    (String) Enterprise account ID where this template will be created.
    CreatedAt string
    (String) The UTC timestamp when the role template was created.
    CreatedById string
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    Href string
    (String) The href URL that links to the role templates API by role template ID.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedAt string
    (String) The UTC timestamp when the role template was last modified.
    LastModifiedById string
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    RoleTemplateId string
    The role template ID.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    accountId String
    (String) Enterprise account ID where this template will be created.
    createdAt String
    (String) The UTC timestamp when the role template was created.
    createdById String
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    href String
    (String) The href URL that links to the role templates API by role template ID.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt String
    (String) The UTC timestamp when the role template was last modified.
    lastModifiedById String
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    roleTemplateId String
    The role template ID.
    state String
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version String
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    accountId string
    (String) Enterprise account ID where this template will be created.
    createdAt string
    (String) The UTC timestamp when the role template was created.
    createdById string
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    href string
    (String) The href URL that links to the role templates API by role template ID.
    id string
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt string
    (String) The UTC timestamp when the role template was last modified.
    lastModifiedById string
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    roleTemplateId string
    The role template ID.
    state string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version string
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    account_id str
    (String) Enterprise account ID where this template will be created.
    created_at str
    (String) The UTC timestamp when the role template was created.
    created_by_id str
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    href str
    (String) The href URL that links to the role templates API by role template ID.
    id str
    The provider-assigned unique ID for this managed resource.
    last_modified_at str
    (String) The UTC timestamp when the role template was last modified.
    last_modified_by_id str
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    role_template_id str
    The role template ID.
    state str
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version str
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    accountId String
    (String) Enterprise account ID where this template will be created.
    createdAt String
    (String) The UTC timestamp when the role template was created.
    createdById String
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    href String
    (String) The href URL that links to the role templates API by role template ID.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedAt String
    (String) The UTC timestamp when the role template was last modified.
    lastModifiedById String
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    roleTemplateId String
    The role template ID.
    state String
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version String
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.

    Look up Existing IamRoleTemplate Resource

    Get an existing IamRoleTemplate 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?: IamRoleTemplateState, opts?: CustomResourceOptions): IamRoleTemplate
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[str] = None,
        committed: Optional[bool] = None,
        created_at: Optional[str] = None,
        created_by_id: Optional[str] = None,
        description: Optional[str] = None,
        href: Optional[str] = None,
        iam_role_template_id: Optional[str] = None,
        last_modified_at: Optional[str] = None,
        last_modified_by_id: Optional[str] = None,
        name: Optional[str] = None,
        role: Optional[IamRoleTemplateRoleArgs] = None,
        role_template_id: Optional[str] = None,
        state: Optional[str] = None,
        version: Optional[str] = None) -> IamRoleTemplate
    func GetIamRoleTemplate(ctx *Context, name string, id IDInput, state *IamRoleTemplateState, opts ...ResourceOption) (*IamRoleTemplate, error)
    public static IamRoleTemplate Get(string name, Input<string> id, IamRoleTemplateState? state, CustomResourceOptions? opts = null)
    public static IamRoleTemplate get(String name, Output<String> id, IamRoleTemplateState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IamRoleTemplate    get:      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.
    The following state arguments are supported:
    AccountId string
    (String) Enterprise account ID where this template will be created.
    Committed bool
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    CreatedAt string
    (String) The UTC timestamp when the role template was created.
    CreatedById string
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    Description string
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    Href string
    (String) The href URL that links to the role templates API by role template ID.
    IamRoleTemplateId string
    The unique identifier of the iam_role_template.
    LastModifiedAt string
    (String) The UTC timestamp when the role template was last modified.
    LastModifiedById string
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    Name string
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    Role IamRoleTemplateRole
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    RoleTemplateId string
    The role template ID.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    AccountId string
    (String) Enterprise account ID where this template will be created.
    Committed bool
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    CreatedAt string
    (String) The UTC timestamp when the role template was created.
    CreatedById string
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    Description string
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    Href string
    (String) The href URL that links to the role templates API by role template ID.
    IamRoleTemplateId string
    The unique identifier of the iam_role_template.
    LastModifiedAt string
    (String) The UTC timestamp when the role template was last modified.
    LastModifiedById string
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    Name string
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    Role IamRoleTemplateRoleArgs
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    RoleTemplateId string
    The role template ID.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    accountId String
    (String) Enterprise account ID where this template will be created.
    committed Boolean
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    createdAt String
    (String) The UTC timestamp when the role template was created.
    createdById String
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    description String
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    href String
    (String) The href URL that links to the role templates API by role template ID.
    iamRoleTemplateId String
    The unique identifier of the iam_role_template.
    lastModifiedAt String
    (String) The UTC timestamp when the role template was last modified.
    lastModifiedById String
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    name String
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role IamRoleTemplateRole
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    roleTemplateId String
    The role template ID.
    state String
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version String
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    accountId string
    (String) Enterprise account ID where this template will be created.
    committed boolean
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    createdAt string
    (String) The UTC timestamp when the role template was created.
    createdById string
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    description string
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    href string
    (String) The href URL that links to the role templates API by role template ID.
    iamRoleTemplateId string
    The unique identifier of the iam_role_template.
    lastModifiedAt string
    (String) The UTC timestamp when the role template was last modified.
    lastModifiedById string
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    name string
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role IamRoleTemplateRole
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    roleTemplateId string
    The role template ID.
    state string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version string
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    account_id str
    (String) Enterprise account ID where this template will be created.
    committed bool
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    created_at str
    (String) The UTC timestamp when the role template was created.
    created_by_id str
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    description str
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    href str
    (String) The href URL that links to the role templates API by role template ID.
    iam_role_template_id str
    The unique identifier of the iam_role_template.
    last_modified_at str
    (String) The UTC timestamp when the role template was last modified.
    last_modified_by_id str
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    name str
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role IamRoleTemplateRoleArgs
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    role_template_id str
    The role template ID.
    state str
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version str
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.
    accountId String
    (String) Enterprise account ID where this template will be created.
    committed Boolean
    Committed status of the template. If committed is set to true, then the template version can no longer be updated.
    createdAt String
    (String) The UTC timestamp when the role template was created.
    createdById String
    (String) The IAM ID of the entity that created the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    description String
    Description of the role template. This is shown to users in the enterprise account. Use this to describe the purpose or context of the role for enterprise users managing IAM templates.

    • Constraints: The maximum length is 300 characters. The minimum length is 0 characters. The value must match regular expression /^.*$/.
    href String
    (String) The href URL that links to the role templates API by role template ID.
    iamRoleTemplateId String
    The unique identifier of the iam_role_template.
    lastModifiedAt String
    (String) The UTC timestamp when the role template was last modified.
    lastModifiedById String
    (String) The IAM ID of the entity that last modified the role template.

    • Constraints: The maximum length is 250 characters. The minimum length is 1 character.
    name String
    Required field when creating a new template. Otherwise, this field is optional. If the field is included, it changes the name value for all existing versions of the template.

    • Constraints: The maximum length is 100 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    role Property Map
    The role properties that are created in an action resource when the template is assigned. Nested schema for role:
    roleTemplateId String
    The role template ID.
    state String
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version String
    (String) The version number of the template used to identify different versions of same template.

    • Constraints: The maximum length is 2 characters. The minimum length is 1 character. The value must match regular expression /^[0-9]*$/.

    Supporting Types

    IamRoleTemplateRole, IamRoleTemplateRoleArgs

    Actions List<string>
    The actions of the role.

    • Constraints: The minimum length is 1 item.
    DisplayName string
    The display the name of the role that is shown in the console.

    • Constraints: The maximum length is 50 characters. The minimum length is 1 character. The value must match regular expression /^((?!<|>).)*$/.
    Name string
    The name of the role that is used in the CRN. This must be alphanumeric and capitalized.

    • Constraints: The maximum length is 30 characters. The minimum length is 1 character. The value must match regular expression /^[A-Z]{1}[A-Za-z0-9]{0,29}$/.
    ServiceName string
    The service name that the role refers.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character.
    Description string
    Description of the role.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    Actions []string
    The actions of the role.

    • Constraints: The minimum length is 1 item.
    DisplayName string
    The display the name of the role that is shown in the console.

    • Constraints: The maximum length is 50 characters. The minimum length is 1 character. The value must match regular expression /^((?!<|>).)*$/.
    Name string
    The name of the role that is used in the CRN. This must be alphanumeric and capitalized.

    • Constraints: The maximum length is 30 characters. The minimum length is 1 character. The value must match regular expression /^[A-Z]{1}[A-Za-z0-9]{0,29}$/.
    ServiceName string
    The service name that the role refers.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character.
    Description string
    Description of the role.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    actions List<String>
    The actions of the role.

    • Constraints: The minimum length is 1 item.
    displayName String
    The display the name of the role that is shown in the console.

    • Constraints: The maximum length is 50 characters. The minimum length is 1 character. The value must match regular expression /^((?!<|>).)*$/.
    name String
    The name of the role that is used in the CRN. This must be alphanumeric and capitalized.

    • Constraints: The maximum length is 30 characters. The minimum length is 1 character. The value must match regular expression /^[A-Z]{1}[A-Za-z0-9]{0,29}$/.
    serviceName String
    The service name that the role refers.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character.
    description String
    Description of the role.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    actions string[]
    The actions of the role.

    • Constraints: The minimum length is 1 item.
    displayName string
    The display the name of the role that is shown in the console.

    • Constraints: The maximum length is 50 characters. The minimum length is 1 character. The value must match regular expression /^((?!<|>).)*$/.
    name string
    The name of the role that is used in the CRN. This must be alphanumeric and capitalized.

    • Constraints: The maximum length is 30 characters. The minimum length is 1 character. The value must match regular expression /^[A-Z]{1}[A-Za-z0-9]{0,29}$/.
    serviceName string
    The service name that the role refers.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character.
    description string
    Description of the role.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    actions Sequence[str]
    The actions of the role.

    • Constraints: The minimum length is 1 item.
    display_name str
    The display the name of the role that is shown in the console.

    • Constraints: The maximum length is 50 characters. The minimum length is 1 character. The value must match regular expression /^((?!<|>).)*$/.
    name str
    The name of the role that is used in the CRN. This must be alphanumeric and capitalized.

    • Constraints: The maximum length is 30 characters. The minimum length is 1 character. The value must match regular expression /^[A-Z]{1}[A-Za-z0-9]{0,29}$/.
    service_name str
    The service name that the role refers.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character.
    description str
    Description of the role.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.
    actions List<String>
    The actions of the role.

    • Constraints: The minimum length is 1 item.
    displayName String
    The display the name of the role that is shown in the console.

    • Constraints: The maximum length is 50 characters. The minimum length is 1 character. The value must match regular expression /^((?!<|>).)*$/.
    name String
    The name of the role that is used in the CRN. This must be alphanumeric and capitalized.

    • Constraints: The maximum length is 30 characters. The minimum length is 1 character. The value must match regular expression /^[A-Z]{1}[A-Za-z0-9]{0,29}$/.
    serviceName String
    The service name that the role refers.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character.
    description String
    Description of the role.

    • Constraints: The maximum length is 300 characters. The minimum length is 1 character. The value must match regular expression /^.*$/.

    Import

    Syntax

    bash

    $ pulumi import ibm:index/iamRoleTemplate:IamRoleTemplate iam_role_template $role_template_id/$version

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.86.0 published on Wednesday, Dec 3, 2025 by ibm-cloud
    Schema (JSON)
    ibm-cloud/terraform-provider-ibm
      Meet Neo: Your AI Platform Teammate