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

ibm.IamRoleTemplateVersion

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_template_versions with this resource.

    Example Usage

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

const iamRoleTemplateVersionInstance = new ibm.IamRoleTemplateVersion("iam_role_template_version_instance", {
    role: {
        name: "name",
        displayName: "display_name",
        serviceName: "service_name",
        description: "description",
        actions: ["actions"],
    },
    roleTemplateId: "role_template_id",
});

    import pulumi
import pulumi_ibm as ibm

iam_role_template_version_instance = ibm.IamRoleTemplateVersion("iam_role_template_version_instance",
    role={
        "name": "name",
        "display_name": "display_name",
        "service_name": "service_name",
        "description": "description",
        "actions": ["actions"],
    },
    role_template_id="role_template_id")

    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.NewIamRoleTemplateVersion(ctx, "iam_role_template_version_instance", &ibm.IamRoleTemplateVersionArgs{
			Role: &ibm.IamRoleTemplateVersionRoleArgs{
				Name:        pulumi.String("name"),
				DisplayName: pulumi.String("display_name"),
				ServiceName: pulumi.String("service_name"),
				Description: pulumi.String("description"),
				Actions: pulumi.StringArray{
					pulumi.String("actions"),
				},
			},
			RoleTemplateId: pulumi.String("role_template_id"),
		})
		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 iamRoleTemplateVersionInstance = new Ibm.IamRoleTemplateVersion("iam_role_template_version_instance", new()
    {
        Role = new Ibm.Inputs.IamRoleTemplateVersionRoleArgs
        {
            Name = "name",
            DisplayName = "display_name",
            ServiceName = "service_name",
            Description = "description",
            Actions = new[]
            {
                "actions",
            },
        },
        RoleTemplateId = "role_template_id",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IamRoleTemplateVersion;
import com.pulumi.ibm.IamRoleTemplateVersionArgs;
import com.pulumi.ibm.inputs.IamRoleTemplateVersionRoleArgs;
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 iamRoleTemplateVersionInstance = new IamRoleTemplateVersion("iamRoleTemplateVersionInstance", IamRoleTemplateVersionArgs.builder()
            .role(IamRoleTemplateVersionRoleArgs.builder()
                .name("name")
                .displayName("display_name")
                .serviceName("service_name")
                .description("description")
                .actions("actions")
                .build())
            .roleTemplateId("role_template_id")
            .build());

    }
}

    resources:
  iamRoleTemplateVersionInstance:
    type: ibm:IamRoleTemplateVersion
    name: iam_role_template_version_instance
    properties:
      role:
        name: name
        displayName: display_name
        serviceName: service_name
        description: description
        actions:
          - actions
      roleTemplateId: role_template_id

    Create IamRoleTemplateVersion Resource

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

    Constructor syntax

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

@overload
def IamRoleTemplateVersion(resource_name: str,
                           opts: Optional[ResourceOptions] = None,
                           role_template_id: Optional[str] = None,
                           committed: Optional[bool] = None,
                           description: Optional[str] = None,
                           name: Optional[str] = None,
                           role: Optional[IamRoleTemplateVersionRoleArgs] = None)
    func NewIamRoleTemplateVersion(ctx *Context, name string, args IamRoleTemplateVersionArgs, opts ...ResourceOption) (*IamRoleTemplateVersion, error)
    public IamRoleTemplateVersion(string name, IamRoleTemplateVersionArgs args, CustomResourceOptions? opts = null)
    public IamRoleTemplateVersion(String name, IamRoleTemplateVersionArgs args)
public IamRoleTemplateVersion(String name, IamRoleTemplateVersionArgs args, CustomResourceOptions options)

    type: ibm:IamRoleTemplateVersion
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 IamRoleTemplateVersionArgs
    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 IamRoleTemplateVersionArgs
    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 IamRoleTemplateVersionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IamRoleTemplateVersionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IamRoleTemplateVersionArgs
    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 iamRoleTemplateVersionResource = new Ibm.IamRoleTemplateVersion("iamRoleTemplateVersionResource", new()
{
    RoleTemplateId = "string",
    Committed = false,
    Description = "string",
    Name = "string",
    Role = new Ibm.Inputs.IamRoleTemplateVersionRoleArgs
    {
        Actions = new[]
        {
            "string",
        },
        DisplayName = "string",
        Name = "string",
        ServiceName = "string",
        Description = "string",
    },
});

    example, err := ibm.NewIamRoleTemplateVersion(ctx, "iamRoleTemplateVersionResource", &ibm.IamRoleTemplateVersionArgs{
	RoleTemplateId: pulumi.String("string"),
	Committed:      pulumi.Bool(false),
	Description:    pulumi.String("string"),
	Name:           pulumi.String("string"),
	Role: &ibm.IamRoleTemplateVersionRoleArgs{
		Actions: pulumi.StringArray{
			pulumi.String("string"),
		},
		DisplayName: pulumi.String("string"),
		Name:        pulumi.String("string"),
		ServiceName: pulumi.String("string"),
		Description: pulumi.String("string"),
	},
})

    var iamRoleTemplateVersionResource = new IamRoleTemplateVersion("iamRoleTemplateVersionResource", IamRoleTemplateVersionArgs.builder()
    .roleTemplateId("string")
    .committed(false)
    .description("string")
    .name("string")
    .role(IamRoleTemplateVersionRoleArgs.builder()
        .actions("string")
        .displayName("string")
        .name("string")
        .serviceName("string")
        .description("string")
        .build())
    .build());

    iam_role_template_version_resource = ibm.IamRoleTemplateVersion("iamRoleTemplateVersionResource",
    role_template_id="string",
    committed=False,
    description="string",
    name="string",
    role={
        "actions": ["string"],
        "display_name": "string",
        "name": "string",
        "service_name": "string",
        "description": "string",
    })

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

    type: ibm:IamRoleTemplateVersion
properties:
    committed: false
    description: string
    name: string
    role:
        actions:
            - string
        description: string
        displayName: string
        name: string
        serviceName: string
    roleTemplateId: string

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

    RoleTemplateId string
    The role template ID.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    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 /^.*$/.
    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 IamRoleTemplateVersionRole
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    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 /^.*$/.
    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 IamRoleTemplateVersionRoleArgs
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    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 /^.*$/.
    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 IamRoleTemplateVersionRole
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    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 /^.*$/.
    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 IamRoleTemplateVersionRole
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    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 /^.*$/.
    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 IamRoleTemplateVersionRoleArgs
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    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 /^.*$/.
    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 IamRoleTemplateVersion resource produces the following output properties:

    AccountId string
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    The version number of the template used to identify different versions of same template.
    AccountId string
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    The version number of the template used to identify different versions of same template.
    accountId String
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    state String
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version String
    The version number of the template used to identify different versions of same template.
    accountId string
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    state string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version string
    The version number of the template used to identify different versions of same template.
    account_id str
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    state str
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version str
    The version number of the template used to identify different versions of same template.
    accountId String
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    state String
    (String) State of role template.

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

    Look up Existing IamRoleTemplateVersion Resource

    Get an existing IamRoleTemplateVersion 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?: IamRoleTemplateVersionState, opts?: CustomResourceOptions): IamRoleTemplateVersion
    @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,
        last_modified_at: Optional[str] = None,
        last_modified_by_id: Optional[str] = None,
        name: Optional[str] = None,
        role: Optional[IamRoleTemplateVersionRoleArgs] = None,
        role_template_id: Optional[str] = None,
        state: Optional[str] = None,
        version: Optional[str] = None) -> IamRoleTemplateVersion
    func GetIamRoleTemplateVersion(ctx *Context, name string, id IDInput, state *IamRoleTemplateVersionState, opts ...ResourceOption) (*IamRoleTemplateVersion, error)
    public static IamRoleTemplateVersion Get(string name, Input<string> id, IamRoleTemplateVersionState? state, CustomResourceOptions? opts = null)
    public static IamRoleTemplateVersion get(String name, Output<String> id, IamRoleTemplateVersionState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IamRoleTemplateVersion    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 is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    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 IamRoleTemplateVersionRole
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    The version number of the template used to identify different versions of same template.
    AccountId string
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    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 IamRoleTemplateVersionRoleArgs
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    State string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    Version string
    The version number of the template used to identify different versions of same template.
    accountId String
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    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 IamRoleTemplateVersionRole
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    state String
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version String
    The version number of the template used to identify different versions of same template.
    accountId string
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    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 IamRoleTemplateVersionRole
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    state string
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version string
    The version number of the template used to identify different versions of same template.
    account_id str
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    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 IamRoleTemplateVersionRoleArgs
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    state str
    (String) State of role template.

    • Constraints: Allowable values are: active, deleted.
    version str
    The version number of the template used to identify different versions of same template.
    accountId String
    (String) Enterprise account ID where this template is created.

    • Constraints: The maximum length is 32 characters. The minimum length is 1 character. The value must match regular expression /^[A-Za-z0-9-]*$/.
    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.
    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.

    • Constraints: The maximum length is 49 characters. The minimum length is 1 character. The value must match regular expression /^roleTemplate-[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.
    state String
    (String) State of role template.

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

    Supporting Types

    IamRoleTemplateVersionRole, IamRoleTemplateVersionRoleArgs

    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/iamRoleTemplateVersion:IamRoleTemplateVersion 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