Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Pulumi Cloud (Pulumi Service provider)
  4. API Docs
  5. api
  6. api/services
  7. Item
Viewing docs for Pulumi Cloud v1.5.0
published on Monday, Oct 19, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-pulumiservice

pulumiservice.api/services.Item

pulumiservice logo pulumiservice logo
Viewing docs for Pulumi Cloud v1.5.0
published on Monday, Oct 19, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-pulumiservice

    Adds items, such as stacks or ESC environments, to an existing service. A service is a Pulumi Cloud construct that groups stacks, environments, and other resources under shared metadata so members of the service can discover and access them together. Returns the updated service details with the first page of items; if continuationToken is set on the response, pass it to GetService to fetch the remaining pages.

    Prefer AddServiceItemsV2, then GetService to read the items.

    Create Item Resource

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

    Constructor syntax

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

@overload
def Item(resource_name: str,
         opts: Optional[ResourceOptions] = None,
         items: Optional[Sequence[Any]] = None,
         org_name: Optional[str] = None,
         owner_name: Optional[str] = None,
         owner_type: Optional[str] = None,
         service_name: Optional[str] = None,
         max_results: Optional[int] = None)
    func NewItem(ctx *Context, name string, args ItemArgs, opts ...ResourceOption) (*Item, error)
    public Item(string name, ItemArgs args, CustomResourceOptions? opts = null)
    public Item(String name, ItemArgs args)
public Item(String name, ItemArgs args, CustomResourceOptions options)

    type: pulumiservice:api/services:Item
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "pulumiservice_api_services_item" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args ItemArgs
    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 ItemArgs
    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 ItemArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ItemArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ItemArgs
    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 itemResource = new PulumiService.Api.Services.Item("itemResource", new()
{
    Items = new[]
    {
        "any",
    },
    OrgName = "string",
    OwnerName = "string",
    OwnerType = "string",
    ServiceName = "string",
    MaxResults = 0,
});

    example, err := services.NewItem(ctx, "itemResource", &services.ItemArgs{
	Items: pulumi.Array{
		pulumi.Any("any"),
	},
	OrgName:     pulumi.String("string"),
	OwnerName:   pulumi.String("string"),
	OwnerType:   pulumi.String("string"),
	ServiceName: pulumi.String("string"),
	MaxResults:  pulumi.Int(0),
})

    resource "pulumiservice_api_services_item" "itemResource" {
  lifecycle {
    create_before_destroy = true
  }
  items        = ["any"]
  org_name     = "string"
  owner_name   = "string"
  owner_type   = "string"
  service_name = "string"
  max_results  = 0
}

    var itemResource = new Item("itemResource", ItemArgs.builder()
    .items("any")
    .orgName("string")
    .ownerName("string")
    .ownerType("string")
    .serviceName("string")
    .maxResults(0)
    .build());

    item_resource = pulumiservice.api.services.Item("itemResource",
    items=["any"],
    org_name="string",
    owner_name="string",
    owner_type="string",
    service_name="string",
    max_results=0)

    const itemResource = new pulumiservice.api.services.Item("itemResource", {
    items: ["any"],
    orgName: "string",
    ownerName: "string",
    ownerType: "string",
    serviceName: "string",
    maxResults: 0,
});

    type: pulumiservice:api/services:Item
properties:
    items:
        - any
    maxResults: 0
    orgName: string
    ownerName: string
    ownerType: string
    serviceName: string

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

    Items List<object>
    List of items
    OrgName string
    The organization name
    OwnerName string
    The owner name
    OwnerType string
    The owner type
    ServiceName string
    The service name
    MaxResults int
    Maximum number of items to return on the first page (max 1000)
    Items []interface{}
    List of items
    OrgName string
    The organization name
    OwnerName string
    The owner name
    OwnerType string
    The owner type
    ServiceName string
    The service name
    MaxResults int
    Maximum number of items to return on the first page (max 1000)
    items list(any)
    List of items
    org_name string
    The organization name
    owner_name string
    The owner name
    owner_type string
    The owner type
    service_name string
    The service name
    max_results number
    Maximum number of items to return on the first page (max 1000)
    items List<Object>
    List of items
    orgName String
    The organization name
    ownerName String
    The owner name
    ownerType String
    The owner type
    serviceName String
    The service name
    maxResults Integer
    Maximum number of items to return on the first page (max 1000)
    items any[]
    List of items
    orgName string
    The organization name
    ownerName string
    The owner name
    ownerType string
    The owner type
    serviceName string
    The service name
    maxResults number
    Maximum number of items to return on the first page (max 1000)
    items Sequence[Any]
    List of items
    org_name str
    The organization name
    owner_name str
    The owner name
    owner_type str
    The owner type
    service_name str
    The service name
    max_results int
    Maximum number of items to return on the first page (max 1000)
    items List<Any>
    List of items
    orgName String
    The organization name
    ownerName String
    The owner name
    ownerType String
    The owner type
    serviceName String
    The service name
    maxResults Number
    Maximum number of items to return on the first page (max 1000)

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Service object
    The service details
    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.
    Service interface{}
    The service details
    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.
    service any
    The service details
    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.
    service Object
    The service details
    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.
    service any
    The service details
    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.
    service Any
    The service details
    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.
    service Any
    The service details
    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 pulumiservice logo
    Viewing docs for Pulumi Cloud v1.5.0
    published on Monday, Oct 19, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-pulumiservice

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial