1. Packages
  2. Packages
  3. Ibm Provider
  4. API Docs
  5. IamServiceId
Viewing docs for ibm 2.4.0
published on Wednesday, Jul 1, 2026 by ibm-cloud
Viewing docs for ibm 2.4.0
published on Wednesday, Jul 1, 2026 by ibm-cloud

    Create, update, and delete an IAM service ID with this resource. For more information, about IAM role action, see managing service ID API keys.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const iamServiceIdInstance = new ibm.IamServiceId("iam_service_id_instance", {
        name: "test",
        description: "New ServiceID",
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    iam_service_id_instance = ibm.IamServiceId("iam_service_id_instance",
        name="test",
        description="New ServiceID")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/v2/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.NewIamServiceId(ctx, "iam_service_id_instance", &ibm.IamServiceIdArgs{
    			Name:        pulumi.String("test"),
    			Description: pulumi.String("New ServiceID"),
    		})
    		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 iamServiceIdInstance = new Ibm.IamServiceId("iam_service_id_instance", new()
        {
            Name = "test",
            Description = "New ServiceID",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IamServiceId;
    import com.pulumi.ibm.IamServiceIdArgs;
    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 iamServiceIdInstance = new IamServiceId("iamServiceIdInstance", IamServiceIdArgs.builder()
                .name("test")
                .description("New ServiceID")
                .build());
    
        }
    }
    
    resources:
      iamServiceIdInstance:
        type: ibm:IamServiceId
        name: iam_service_id_instance
        properties:
          name: test
          description: New ServiceID
    
    Example coming soon!
    

    Create IamServiceId Resource

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

    Constructor syntax

    new IamServiceId(name: string, args?: IamServiceIdArgs, opts?: CustomResourceOptions);
    @overload
    def IamServiceId(resource_name: str,
                     args: Optional[IamServiceIdArgs] = None,
                     opts: Optional[ResourceOptions] = None)
    
    @overload
    def IamServiceId(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     description: Optional[str] = None,
                     iam_service_id_id: Optional[str] = None,
                     name: Optional[str] = None,
                     tags: Optional[Sequence[str]] = None)
    func NewIamServiceId(ctx *Context, name string, args *IamServiceIdArgs, opts ...ResourceOption) (*IamServiceId, error)
    public IamServiceId(string name, IamServiceIdArgs? args = null, CustomResourceOptions? opts = null)
    public IamServiceId(String name, IamServiceIdArgs args)
    public IamServiceId(String name, IamServiceIdArgs args, CustomResourceOptions options)
    
    type: ibm:IamServiceId
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "ibm_iamserviceid" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args IamServiceIdArgs
    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 IamServiceIdArgs
    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 IamServiceIdArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IamServiceIdArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IamServiceIdArgs
    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 iamServiceIdResource = new Ibm.IamServiceId("iamServiceIdResource", new()
    {
        Description = "string",
        IamServiceIdId = "string",
        Name = "string",
        Tags = new[]
        {
            "string",
        },
    });
    
    example, err := ibm.NewIamServiceId(ctx, "iamServiceIdResource", &ibm.IamServiceIdArgs{
    	Description:    pulumi.String("string"),
    	IamServiceIdId: pulumi.String("string"),
    	Name:           pulumi.String("string"),
    	Tags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    })
    
    resource "ibm_iamserviceid" "iamServiceIdResource" {
      description       = "string"
      iam_service_id_id = "string"
      name              = "string"
      tags              = ["string"]
    }
    
    var iamServiceIdResource = new IamServiceId("iamServiceIdResource", IamServiceIdArgs.builder()
        .description("string")
        .iamServiceIdId("string")
        .name("string")
        .tags("string")
        .build());
    
    iam_service_id_resource = ibm.IamServiceId("iamServiceIdResource",
        description="string",
        iam_service_id_id="string",
        name="string",
        tags=["string"])
    
    const iamServiceIdResource = new ibm.IamServiceId("iamServiceIdResource", {
        description: "string",
        iamServiceIdId: "string",
        name: "string",
        tags: ["string"],
    });
    
    type: ibm:IamServiceId
    properties:
        description: string
        iamServiceIdId: string
        name: string
        tags:
            - string
    

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

    Description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    IamServiceIdId string
    The unique identifier of the iam_service_id.
    Name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    Tags List<string>
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    Description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    IamServiceIdId string
    The unique identifier of the iam_service_id.
    Name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    Tags []string
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iam_service_id_id string
    The unique identifier of the iam_service_id.
    name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags list(string)
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    description String
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iamServiceIdId String
    The unique identifier of the iam_service_id.
    name String
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags List<String>
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iamServiceIdId string
    The unique identifier of the iam_service_id.
    name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags string[]
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    description str
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iam_service_id_id str
    The unique identifier of the iam_service_id.
    name str
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags Sequence[str]
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    description String
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iamServiceIdId String
    The unique identifier of the iam_service_id.
    name String
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags List<String>
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.

    Outputs

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

    AccountId string
    ID of the account.
    CreatedAt string
    (String) If set contains a date time string of the creation date in ISO format.
    Crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    IamId string
    (String) Cloud wide identifier for identities of this service ID.
    Id string
    The provider-assigned unique ID for this managed resource.
    Locked bool
    (Boolean) The service ID cannot be changed if set to true.
    ModifiedAt string
    (String) If set contains a date time string of the last modification date in ISO format.
    Version string
    (String) The version of the ServiceID object.
    AccountId string
    ID of the account.
    CreatedAt string
    (String) If set contains a date time string of the creation date in ISO format.
    Crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    IamId string
    (String) Cloud wide identifier for identities of this service ID.
    Id string
    The provider-assigned unique ID for this managed resource.
    Locked bool
    (Boolean) The service ID cannot be changed if set to true.
    ModifiedAt string
    (String) If set contains a date time string of the last modification date in ISO format.
    Version string
    (String) The version of the ServiceID object.
    account_id string
    ID of the account.
    created_at string
    (String) If set contains a date time string of the creation date in ISO format.
    crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    iam_id string
    (String) Cloud wide identifier for identities of this service ID.
    id string
    The provider-assigned unique ID for this managed resource.
    locked bool
    (Boolean) The service ID cannot be changed if set to true.
    modified_at string
    (String) If set contains a date time string of the last modification date in ISO format.
    version string
    (String) The version of the ServiceID object.
    accountId String
    ID of the account.
    createdAt String
    (String) If set contains a date time string of the creation date in ISO format.
    crn String
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    iamId String
    (String) Cloud wide identifier for identities of this service ID.
    id String
    The provider-assigned unique ID for this managed resource.
    locked Boolean
    (Boolean) The service ID cannot be changed if set to true.
    modifiedAt String
    (String) If set contains a date time string of the last modification date in ISO format.
    version String
    (String) The version of the ServiceID object.
    accountId string
    ID of the account.
    createdAt string
    (String) If set contains a date time string of the creation date in ISO format.
    crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    iamId string
    (String) Cloud wide identifier for identities of this service ID.
    id string
    The provider-assigned unique ID for this managed resource.
    locked boolean
    (Boolean) The service ID cannot be changed if set to true.
    modifiedAt string
    (String) If set contains a date time string of the last modification date in ISO format.
    version string
    (String) The version of the ServiceID object.
    account_id str
    ID of the account.
    created_at str
    (String) If set contains a date time string of the creation date in ISO format.
    crn str
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    iam_id str
    (String) Cloud wide identifier for identities of this service ID.
    id str
    The provider-assigned unique ID for this managed resource.
    locked bool
    (Boolean) The service ID cannot be changed if set to true.
    modified_at str
    (String) If set contains a date time string of the last modification date in ISO format.
    version str
    (String) The version of the ServiceID object.
    accountId String
    ID of the account.
    createdAt String
    (String) If set contains a date time string of the creation date in ISO format.
    crn String
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    iamId String
    (String) Cloud wide identifier for identities of this service ID.
    id String
    The provider-assigned unique ID for this managed resource.
    locked Boolean
    (Boolean) The service ID cannot be changed if set to true.
    modifiedAt String
    (String) If set contains a date time string of the last modification date in ISO format.
    version String
    (String) The version of the ServiceID object.

    Look up Existing IamServiceId Resource

    Get an existing IamServiceId 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?: IamServiceIdState, opts?: CustomResourceOptions): IamServiceId
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            account_id: Optional[str] = None,
            created_at: Optional[str] = None,
            crn: Optional[str] = None,
            description: Optional[str] = None,
            iam_id: Optional[str] = None,
            iam_service_id_id: Optional[str] = None,
            locked: Optional[bool] = None,
            modified_at: Optional[str] = None,
            name: Optional[str] = None,
            tags: Optional[Sequence[str]] = None,
            version: Optional[str] = None) -> IamServiceId
    func GetIamServiceId(ctx *Context, name string, id IDInput, state *IamServiceIdState, opts ...ResourceOption) (*IamServiceId, error)
    public static IamServiceId Get(string name, Input<string> id, IamServiceIdState? state, CustomResourceOptions? opts = null)
    public static IamServiceId get(String name, Output<String> id, IamServiceIdState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IamServiceId    get:      id: ${id}
    import {
      to = ibm_iamserviceid.example
      id = "${id}"
    }
    
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AccountId string
    ID of the account.
    CreatedAt string
    (String) If set contains a date time string of the creation date in ISO format.
    Crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    Description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    IamId string
    (String) Cloud wide identifier for identities of this service ID.
    IamServiceIdId string
    The unique identifier of the iam_service_id.
    Locked bool
    (Boolean) The service ID cannot be changed if set to true.
    ModifiedAt string
    (String) If set contains a date time string of the last modification date in ISO format.
    Name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    Tags List<string>
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    Version string
    (String) The version of the ServiceID object.
    AccountId string
    ID of the account.
    CreatedAt string
    (String) If set contains a date time string of the creation date in ISO format.
    Crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    Description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    IamId string
    (String) Cloud wide identifier for identities of this service ID.
    IamServiceIdId string
    The unique identifier of the iam_service_id.
    Locked bool
    (Boolean) The service ID cannot be changed if set to true.
    ModifiedAt string
    (String) If set contains a date time string of the last modification date in ISO format.
    Name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    Tags []string
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    Version string
    (String) The version of the ServiceID object.
    account_id string
    ID of the account.
    created_at string
    (String) If set contains a date time string of the creation date in ISO format.
    crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iam_id string
    (String) Cloud wide identifier for identities of this service ID.
    iam_service_id_id string
    The unique identifier of the iam_service_id.
    locked bool
    (Boolean) The service ID cannot be changed if set to true.
    modified_at string
    (String) If set contains a date time string of the last modification date in ISO format.
    name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags list(string)
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    version string
    (String) The version of the ServiceID object.
    accountId String
    ID of the account.
    createdAt String
    (String) If set contains a date time string of the creation date in ISO format.
    crn String
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    description String
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iamId String
    (String) Cloud wide identifier for identities of this service ID.
    iamServiceIdId String
    The unique identifier of the iam_service_id.
    locked Boolean
    (Boolean) The service ID cannot be changed if set to true.
    modifiedAt String
    (String) If set contains a date time string of the last modification date in ISO format.
    name String
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags List<String>
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    version String
    (String) The version of the ServiceID object.
    accountId string
    ID of the account.
    createdAt string
    (String) If set contains a date time string of the creation date in ISO format.
    crn string
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    description string
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iamId string
    (String) Cloud wide identifier for identities of this service ID.
    iamServiceIdId string
    The unique identifier of the iam_service_id.
    locked boolean
    (Boolean) The service ID cannot be changed if set to true.
    modifiedAt string
    (String) If set contains a date time string of the last modification date in ISO format.
    name string
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags string[]
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    version string
    (String) The version of the ServiceID object.
    account_id str
    ID of the account.
    created_at str
    (String) If set contains a date time string of the creation date in ISO format.
    crn str
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    description str
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iam_id str
    (String) Cloud wide identifier for identities of this service ID.
    iam_service_id_id str
    The unique identifier of the iam_service_id.
    locked bool
    (Boolean) The service ID cannot be changed if set to true.
    modified_at str
    (String) If set contains a date time string of the last modification date in ISO format.
    name str
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags Sequence[str]
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    version str
    (String) The version of the ServiceID object.
    accountId String
    ID of the account.
    createdAt String
    (String) If set contains a date time string of the creation date in ISO format.
    crn String
    (String) Cloud Resource Name of the item. Example Cloud Resource Name: 'crn:v1:bluemix:public:iam-identity:us-south:a/myaccount::serviceid:1234-5678-9012'.
    description String
    The optional description of the Service Id. The 'description' property is only available if a description was provided during a create of a Service Id.
    iamId String
    (String) Cloud wide identifier for identities of this service ID.
    iamServiceIdId String
    The unique identifier of the iam_service_id.
    locked Boolean
    (Boolean) The service ID cannot be changed if set to true.
    modifiedAt String
    (String) If set contains a date time string of the last modification date in ISO format.
    name String
    Name of the Service Id. The name is not checked for uniqueness. Therefore multiple names with the same value can exist. Access is done via the UUID of the Service Id.
    tags List<String>
    A list of tags that you want to add to the service ID. Note The tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.
    version String
    (String) The version of the ServiceID object.

    Import

    You can import the ibm_iam_service_id resource by using id. Unique identifier of this Service Id.

    Syntax

    
    ```sh
    $ pulumi import ibm:index/iamServiceId:IamServiceId iam_service_id <id>
    ```
    
    

    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.
    Viewing docs for ibm 2.4.0
    published on Wednesday, Jul 1, 2026 by ibm-cloud

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial