# Pulumi Service Provider
[](https://slack.pulumi.com)
[](https://www.npmjs.com/package/@pulumi/pulumiservice)
[](https://pypi.org/project/pulumi-pulumiservice)
[](https://badge.fury.io/nu/pulumi.pulumiservice)
[](https://pkg.go.dev/github.com/pulumi/pulumi-pulumiservice/sdk/go)
[](https://github.com/pulumi/pulumi-pulumiservice/blob/main/LICENSE)
Pulumi Service Provider for creating Pulumi Cloud resources.
The Pulumi Service Provider (PSP) is built on top of the [Pulumi Cloud REST API](https://www.pulumi.com/docs/pulumi-cloud/reference/cloud-rest-api/), allowing Pulumi customers to create Pulumi Cloud resources using Pulumi programs. That includes Stacks, Environments, Teams, Tokens, Webhooks, Tags, Deployment Settings, Deployment Schedules and much more! Pulumi Service Provider is especially powerful when used in combination with theĀ [Automation API](https://pulumi.com/automation).
For a full list of supported resources, visit the [Pulumi Registry](https://www.pulumi.com/registry/packages/pulumiservice/). For the REST API reference documentation, visit [Pulumi Cloud API Documentation](https://www.pulumi.com/docs/pulumi-cloud/reference/cloud-rest-api/).
For now, PSP is in public preview, but we're working on releasing v1.0 in the near future.
## Installing
This package is available in many languages in the standard packaging formats.
### Node.js (Java/TypeScript)
To use from JavaScript or TypeScript in Node.js, install using either `npm`:
$ npm install @pulumi/pulumiservice
or `yarn`:
$ yarn add @pulumi/pulumiservice
### Python
To use from Python, install using `pip`:
$ pip install pulumi_pulumiservice
### Go
To use from Go, use `go get` to grab the latest version of the library
$ go get github.com/pulumi/pulumi-pulumiservice/sdk/go
### .NET
To use from .NET, install using `dotnet add package`:
$ dotnet add package Pulumi.PulumiService
### Java
To use from Java, add an entry to your `build.gradle` file:
$ implementation 'com.pulumi:pulumiservice:%Fill in latest version from the badge up top%'
Or to your `pom.xml` file:
$ <dependency>
$ <groupId>com.pulumi</groupId>
$ <artifactId>pulumiservice</artifactId>
$ <version>%Fill in latest version from the badge up top%</version>
$ </dependency>
## Setup
Ensure that you have ran `pulumi login`. Run `pulumi whoami` to verify that you are logged in.
### Configuration Options
Use `pulumi config set pulumiservice:<option>` or pass options to the [constructor of `new pulumiservice.Provider`][1].
| Option | Environment Variable Name | Required/Optional | Description |
|---------------|---------------------------|-------------------|---------------------------------------------------------------------------------------|
| `accessToken` | `PULUMI_ACCESS_TOKEN` | Optional | Overrides [Pulumi Service Access Tokens][2] |
| `apiUrl` | `PULUMI_BACKEND_URL` | Optional | Allows overriding default [Pulumi Service API URL][3] for [self hosted customers][4]. |
| | | | |
## Examples
```typescript
import * as aws from "@pulumi/awsx"
import * as pulumi from "@pulumi/pulumi";
import * as service from "@pulumi/pulumiservice";
const team = new service.Team("team", {
name: "pulumi-service-team",
displayName: "Pulumi Service",
description: "The Pulumi Service Team",
organizationName: "pulumi",
teamType: "pulumi",
members: [
"piers",
"bryce",
"casey"
"evan",
"devon",
"meagan"
"myles",
"steve"
],
});
export const members = team.members;
```
Check out the [examples/](examples/) directory for more examples.
Raw data
{
"_id": null,
"home_page": null,
"name": "pulumi-pulumiservice",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "pulumi, kind/native, category/infrastructure",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/8b/ed/fbfb78aa4a6d7a51c839ae58ed0b8a3898379de70440092c14b91e5bbecb/pulumi_pulumiservice-0.29.0.tar.gz",
"platform": null,
"description": "# Pulumi Service Provider\n\n[](https://slack.pulumi.com)\n[](https://www.npmjs.com/package/@pulumi/pulumiservice)\n[](https://pypi.org/project/pulumi-pulumiservice)\n[](https://badge.fury.io/nu/pulumi.pulumiservice)\n[](https://pkg.go.dev/github.com/pulumi/pulumi-pulumiservice/sdk/go)\n[](https://github.com/pulumi/pulumi-pulumiservice/blob/main/LICENSE)\n\nPulumi Service Provider for creating Pulumi Cloud resources.\n\nThe Pulumi Service Provider (PSP) is built on top of the [Pulumi Cloud REST API](https://www.pulumi.com/docs/pulumi-cloud/reference/cloud-rest-api/), allowing Pulumi customers to create Pulumi Cloud resources using Pulumi programs. That includes Stacks, Environments, Teams, Tokens, Webhooks, Tags, Deployment Settings, Deployment Schedules and much more! Pulumi Service Provider is especially powerful when used in combination with the\u00a0[Automation API](https://pulumi.com/automation).\n\nFor a full list of supported resources, visit the [Pulumi Registry](https://www.pulumi.com/registry/packages/pulumiservice/). For the REST API reference documentation, visit [Pulumi Cloud API Documentation](https://www.pulumi.com/docs/pulumi-cloud/reference/cloud-rest-api/).\n\nFor now, PSP is in public preview, but we're working on releasing v1.0 in the near future.\n\n## Installing\n\nThis package is available in many languages in the standard packaging formats.\n\n### Node.js (Java/TypeScript)\n\nTo use from JavaScript or TypeScript in Node.js, install using either `npm`:\n\n $ npm install @pulumi/pulumiservice\n\nor `yarn`:\n\n $ yarn add @pulumi/pulumiservice\n\n### Python\n\nTo use from Python, install using `pip`:\n\n $ pip install pulumi_pulumiservice\n\n### Go\n\nTo use from Go, use `go get` to grab the latest version of the library\n\n $ go get github.com/pulumi/pulumi-pulumiservice/sdk/go\n\n### .NET\n\nTo use from .NET, install using `dotnet add package`:\n\n $ dotnet add package Pulumi.PulumiService\n\n### Java\n\nTo use from Java, add an entry to your `build.gradle` file:\n\n $ implementation 'com.pulumi:pulumiservice:%Fill in latest version from the badge up top%'\n \nOr to your `pom.xml` file:\n\n $ <dependency>\n $ <groupId>com.pulumi</groupId>\n $ <artifactId>pulumiservice</artifactId>\n $ <version>%Fill in latest version from the badge up top%</version>\n $ </dependency>\n\n## Setup\n\nEnsure that you have ran `pulumi login`. Run `pulumi whoami` to verify that you are logged in.\n\n### Configuration Options\n\nUse `pulumi config set pulumiservice:<option>` or pass options to the [constructor of `new pulumiservice.Provider`][1].\n\n| Option | Environment Variable Name | Required/Optional | Description |\n|---------------|---------------------------|-------------------|---------------------------------------------------------------------------------------|\n| `accessToken` | `PULUMI_ACCESS_TOKEN` | Optional | Overrides [Pulumi Service Access Tokens][2] |\n| `apiUrl` | `PULUMI_BACKEND_URL` | Optional | Allows overriding default [Pulumi Service API URL][3] for [self hosted customers][4]. |\n| | | | |\n\n## Examples\n\n```typescript\nimport * as aws from \"@pulumi/awsx\"\nimport * as pulumi from \"@pulumi/pulumi\";\nimport * as service from \"@pulumi/pulumiservice\";\n\nconst team = new service.Team(\"team\", {\n name: \"pulumi-service-team\",\n displayName: \"Pulumi Service\",\n description: \"The Pulumi Service Team\",\n organizationName: \"pulumi\",\n teamType: \"pulumi\",\n members: [\n \"piers\",\n \"bryce\",\n \"casey\"\n \"evan\",\n \"devon\",\n \"meagan\"\n \"myles\",\n \"steve\"\n ],\n});\n\nexport const members = team.members;\n```\n\nCheck out the [examples/](examples/) directory for more examples.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "A native Pulumi package for creating and managing Pulumi Cloud constructs",
"version": "0.29.0",
"project_urls": {
"Homepage": "https://pulumi.com",
"Repository": "https://github.com/pulumi/pulumi-pulumiservice"
},
"split_keywords": [
"pulumi",
" kind/native",
" category/infrastructure"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9e9545c8aed80f76be05429eef5ac3c7f42d87f1420bf7a27a21042f308eb4e5",
"md5": "48121521777fae8005ff0707fb0a7c5c",
"sha256": "a0084b5494adf33106c51d67829c51d8f50e8dac1bc5386a5b73b0a969098142"
},
"downloads": -1,
"filename": "pulumi_pulumiservice-0.29.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "48121521777fae8005ff0707fb0a7c5c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 60964,
"upload_time": "2025-02-07T19:58:21",
"upload_time_iso_8601": "2025-02-07T19:58:21.911179Z",
"url": "https://files.pythonhosted.org/packages/9e/95/45c8aed80f76be05429eef5ac3c7f42d87f1420bf7a27a21042f308eb4e5/pulumi_pulumiservice-0.29.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8bedfbfb78aa4a6d7a51c839ae58ed0b8a3898379de70440092c14b91e5bbecb",
"md5": "64aac6cc44423ba916f6f243b56e6663",
"sha256": "75dc7312b9f997b6940e97a86d8affa88b7009b77eefdf637962f823a7b7ca33"
},
"downloads": -1,
"filename": "pulumi_pulumiservice-0.29.0.tar.gz",
"has_sig": false,
"md5_digest": "64aac6cc44423ba916f6f243b56e6663",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 36840,
"upload_time": "2025-02-07T19:58:23",
"upload_time_iso_8601": "2025-02-07T19:58:23.798020Z",
"url": "https://files.pythonhosted.org/packages/8b/ed/fbfb78aa4a6d7a51c839ae58ed0b8a3898379de70440092c14b91e5bbecb/pulumi_pulumiservice-0.29.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-07 19:58:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pulumi",
"github_project": "pulumi-pulumiservice",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pulumi-pulumiservice"
}