1. Packages
  2. Packages
  3. Pulumi Cloud (Pulumi Service provider)
  4. API Docs
  5. api
  6. api/services
  7. Service

This provider is currently in preview.

Viewing docs for Pulumi Cloud v1.1.0
published on Thursday, May 21, 2026 by Pulumi
pulumiservice logo

This provider is currently in preview.

Viewing docs for Pulumi Cloud v1.1.0
published on Thursday, May 21, 2026 by Pulumi

    Creates a new service account in an organization. Service accounts provide programmatic, non-human identities for accessing Pulumi Cloud resources. They are scoped to an organization and can hold access tokens, belong to teams, and have stack permissions. The service name must be unique within the organization.

    Create Service Resource

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

    Constructor syntax

    new Service(name: string, args: ServiceArgs, opts?: CustomResourceOptions);
    @overload
    def Service(resource_name: str,
                args: ServiceArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def Service(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                description: Optional[str] = None,
                items: Optional[Sequence[Any]] = None,
                name: Optional[str] = None,
                org_name: Optional[str] = None,
                owner_name: Optional[str] = None,
                owner_type: Optional[str] = None,
                properties: Optional[Sequence[Any]] = None)
    func NewService(ctx *Context, name string, args ServiceArgs, opts ...ResourceOption) (*Service, error)
    public Service(string name, ServiceArgs args, CustomResourceOptions? opts = null)
    public Service(String name, ServiceArgs args)
    public Service(String name, ServiceArgs args, CustomResourceOptions options)
    
    type: pulumiservice:api/services:Service
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "pulumiservice_api_services_service" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args ServiceArgs
    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 ServiceArgs
    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 ServiceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ServiceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ServiceArgs
    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 serviceResource = new PulumiService.Api.Services.Service("serviceResource", new()
    {
        Description = "string",
        Items = new[]
        {
            "any",
        },
        Name = "string",
        OrgName = "string",
        OwnerName = "string",
        OwnerType = "string",
        Properties = new[]
        {
            "any",
        },
    });
    
    example, err := services.NewService(ctx, "serviceResource", &services.ServiceArgs{
    	Description: pulumi.String("string"),
    	Items: pulumi.Array{
    		pulumi.Any("any"),
    	},
    	Name:      pulumi.String("string"),
    	OrgName:   pulumi.String("string"),
    	OwnerName: pulumi.String("string"),
    	OwnerType: pulumi.String("string"),
    	Properties: pulumi.Array{
    		pulumi.Any("any"),
    	},
    })
    
    resource "pulumiservice_api_services_service" "serviceResource" {
      description = "string"
      items       = ["any"]
      name        = "string"
      org_name    = "string"
      owner_name  = "string"
      owner_type  = "string"
      properties  = ["any"]
    }
    
    var serviceResource = new Service("serviceResource", ServiceArgs.builder()
        .description("string")
        .items("any")
        .name("string")
        .orgName("string")
        .ownerName("string")
        .ownerType("string")
        .properties("any")
        .build());
    
    service_resource = pulumiservice.api.services.Service("serviceResource",
        description="string",
        items=["any"],
        name="string",
        org_name="string",
        owner_name="string",
        owner_type="string",
        properties=["any"])
    
    const serviceResource = new pulumiservice.api.services.Service("serviceResource", {
        description: "string",
        items: ["any"],
        name: "string",
        orgName: "string",
        ownerName: "string",
        ownerType: "string",
        properties: ["any"],
    });
    
    type: pulumiservice:api/services:Service
    properties:
        description: string
        items:
            - any
        name: string
        orgName: string
        ownerName: string
        ownerType: string
        properties:
            - any
    

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

    Description string
    an optional description of the service
    Items List<object>
    an optional list of items to add during service creation
    Name string
    the name of the service
    OrgName string
    The organization name
    OwnerName string
    the service owner name
    OwnerType string
    the service owner type
    Properties List<object>
    an optional list of properties to set on the service
    Description string
    an optional description of the service
    Items []interface{}
    an optional list of items to add during service creation
    Name string
    the name of the service
    OrgName string
    The organization name
    OwnerName string
    the service owner name
    OwnerType string
    the service owner type
    Properties []interface{}
    an optional list of properties to set on the service
    description string
    an optional description of the service
    items list(any)
    an optional list of items to add during service creation
    name string
    the name of the service
    org_name string
    The organization name
    owner_name string
    the service owner name
    owner_type string
    the service owner type
    properties list(any)
    an optional list of properties to set on the service
    description String
    an optional description of the service
    items List<Object>
    an optional list of items to add during service creation
    name String
    the name of the service
    orgName String
    The organization name
    ownerName String
    the service owner name
    ownerType String
    the service owner type
    properties List<Object>
    an optional list of properties to set on the service
    description string
    an optional description of the service
    items any[]
    an optional list of items to add during service creation
    name string
    the name of the service
    orgName string
    The organization name
    ownerName string
    the service owner name
    ownerType string
    the service owner type
    properties any[]
    an optional list of properties to set on the service
    description str
    an optional description of the service
    items Sequence[Any]
    an optional list of items to add during service creation
    name str
    the name of the service
    org_name str
    The organization name
    owner_name str
    the service owner name
    owner_type str
    the service owner type
    properties Sequence[Any]
    an optional list of properties to set on the service
    description String
    an optional description of the service
    items List<Any>
    an optional list of items to add during service creation
    name String
    the name of the service
    orgName String
    The organization name
    ownerName String
    the service owner name
    ownerType String
    the service owner type
    properties List<Any>
    an optional list of properties to set on the service

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    ContinuationToken string
    ContinuationToken is an opaque value the client can send to fetch additional items. Will be nil once all items have been returned.
    Id string
    The provider-assigned unique ID for this managed resource.
    ContinuationToken string
    ContinuationToken is an opaque value the client can send to fetch additional items. Will be nil once all items have been returned.
    id string
    The provider-assigned unique ID for this managed resource.
    continuation_token string
    ContinuationToken is an opaque value the client can send to fetch additional items. Will be nil once all items have been returned.
    id String
    The provider-assigned unique ID for this managed resource.
    continuationToken String
    ContinuationToken is an opaque value the client can send to fetch additional items. Will be nil once all items have been returned.
    id string
    The provider-assigned unique ID for this managed resource.
    continuationToken string
    ContinuationToken is an opaque value the client can send to fetch additional items. Will be nil once all items have been returned.
    id str
    The provider-assigned unique ID for this managed resource.
    continuation_token str
    ContinuationToken is an opaque value the client can send to fetch additional items. Will be nil once all items have been returned.
    id String
    The provider-assigned unique ID for this managed resource.
    continuationToken String
    ContinuationToken is an opaque value the client can send to fetch additional items. Will be nil once all items have been returned.

    Package Details

    Repository
    pulumiservice pulumi/pulumi-pulumiservice
    License
    Apache-2.0
    pulumiservice logo

    This provider is currently in preview.

    Viewing docs for Pulumi Cloud v1.1.0
    published on Thursday, May 21, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial