[](https://github.com/equinix/pulumi-equinix/actions)
[](https://www.npmjs.com/package/@equinix-labs/pulumi-equinix)
[](https://pypi.org/project/pulumi-equinix)
[](https://badge.fury.io/nu/pulumi.equinix)
[](https://pkg.go.dev/github.com/equinix/pulumi-equinix/sdk/go)
[](https://github.com/equinix/pulumi-equinix/blob/main/LICENSE)
# Equinix Resource Provider
**PLEASE NOTE:** *This provider supercedes the [Pulumi Equinix Metal provider](https://www.pulumi.com/registry/packages/equinix-metal/).
The Equinix Resource Provider lets you manage [Equinix](http://deploy.equinix.com) resources (Metal, Fabric, and Network Edge).
## Installing
This package is available for several languages/platforms:
### Node.js (JavaScript/TypeScript)
To use from JavaScript or TypeScript in Node.js, install using either `npm`:
```bash
npm install @equinix-labs/pulumi-equinix
```
or `yarn`:
```bash
yarn add @equinix-labs/pulumi-equinix
```
### Python
To use from Python, install using `pip`:
```bash
pip install pulumi_equinix
```
### Go
To use from Go, use `go get` to grab the latest version of the library:
```bash
go get github.com/equinix/pulumi-equinix/sdk/go/...
```
### .NET
To use from .NET, install using `dotnet add package`:
```bash
dotnet add package Pulumi.Equinix
```
### Java
**PLEASE NOTE:** Java is currently in preview. For more details check out [pulumi java documentation](https://www.pulumi.com/docs/intro/languages/java/#how-to-use-java-with-pulumi).
To use from Java, add the dependency below to your `pom.xml` file:
```
<dependency>
<groupId>com.equinix.pulumi</groupId>
<artifactId>equinix</artifactId>
<version>[0.1.0,)</version>
</dependency>
```
## Configuration
For information about obtaining API key and secret required for Equinix Fabric and Network Edge refer to [Generating Client ID and Client Secret key](https://developer.equinix.com/dev-docs/fabric/getting-started/getting-access-token#generating-client-id-and-client-secret) from [Equinix Developer Platform portal](https://developer.equinix.com/).
Interacting with Equinix Metal requires an API auth token that can be generated at Project-level or User-level. User API keys can be obtained by creating them in the [Equinix Metal Portal](https://console.equinix.com/) or by using the [Create a User API Key](https://deploy.equinix.com/developers/api/metal/#operation/createAPIKey) endpoint. Project API keys can also be obtained by creating them in the [Equinix Metal Portal](https://console.equinix.com/) or by using the [Create a Project API Key](https://deploy.equinix.com/developers/api/metal/#operation/createProjectAPIKey) endpoint.
If you are only using Equinix Metal resources, you may omit the Client ID and Client Secret provider configuration parameters needed to access other Equinix resource types (Network Edge, Fabric, etc).
The following configuration points are available for the `equinix` provider:
- `equinix:authToken` (environment: `METAL_AUTH_TOKEN`) - (Optional) the Equinix Metal API auth key for API operations.
- `equinix:clientId` (environment: `EQUINIX_API_CLIENTID`) - (Optional) API Consumer Key available under My Apps section in Equinix developer portal.
- `equinix:clientSecret` (environment: `EQUINIX_API_CLIENTSECRET`) - (Optional) API Consumer secret available under My Apps section in Equinix developer portal.
Advanced configuration points:
- `equinix:token` (environment: `EQUINIX_API_TOKEN`) - (Optional) API token from the developer sandbox. Token's can be generated for the API Client using the OAuth2 Token features described in the [OAuth2 API](https://developer.equinix.com/catalog/accesstokenv1#operation/GetOAuth2AccessToken) documentation. The `client_id` and `client_secret` arguments will be ignored in the presence of a token argument.
- `equinix:endpoint` (environment: `EQUINIX_API_ENDPOINT`) - (Optional) the Equinix API base URL to point out desired environmen. Defaults to `https://api.equinix.com`.
- `equinix:maxRetries` - (Optional) the maximum number of retries in case of network failure.
- `equinix:maxRetryWaitSeconds` - (Optional) the maximum time to wait in case of network failure.
- `equinix:requestTimeout` - (Optional) the duration of time, in seconds, that the Equinix Platform API Client should wait before canceling an API request. Defaults to 30.
- `equinix:responseMaxPageSize` - (Optional) the maximum number of records in a single response for REST queries that produce paginated responses.
## Reference
For detailed reference documentation, please visit [Equinix API Docs in th Pulumi Registry](https://www.pulumi.com/registry/packages/equinix/api-docs/).
Raw data
{
"_id": null,
"home_page": "https://deploy.equinix.com/",
"name": "pulumi-equinix",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "pulumi equinix category/cloud",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f3/8f/bf754b081ef05ac409422ea09af7f188e924dbe3de35af034cae4ddb8ba1/pulumi_equinix-0.20.0.tar.gz",
"platform": null,
"description": "[](https://github.com/equinix/pulumi-equinix/actions)\n[](https://www.npmjs.com/package/@equinix-labs/pulumi-equinix)\n[](https://pypi.org/project/pulumi-equinix)\n[](https://badge.fury.io/nu/pulumi.equinix)\n[](https://pkg.go.dev/github.com/equinix/pulumi-equinix/sdk/go)\n[](https://github.com/equinix/pulumi-equinix/blob/main/LICENSE)\n\n# Equinix Resource Provider\n\n**PLEASE NOTE:** *This provider supercedes the [Pulumi Equinix Metal provider](https://www.pulumi.com/registry/packages/equinix-metal/).\n\nThe Equinix Resource Provider lets you manage [Equinix](http://deploy.equinix.com) resources (Metal, Fabric, and Network Edge).\n\n## Installing\n\nThis package is available for several languages/platforms:\n\n### Node.js (JavaScript/TypeScript)\n\nTo use from JavaScript or TypeScript in Node.js, install using either `npm`:\n\n```bash\nnpm install @equinix-labs/pulumi-equinix\n```\n\nor `yarn`:\n\n```bash\nyarn add @equinix-labs/pulumi-equinix\n```\n\n### Python\n\nTo use from Python, install using `pip`:\n\n```bash\npip install pulumi_equinix\n```\n\n### Go\n\nTo use from Go, use `go get` to grab the latest version of the library:\n\n```bash\ngo get github.com/equinix/pulumi-equinix/sdk/go/...\n```\n\n### .NET\n\nTo use from .NET, install using `dotnet add package`:\n\n```bash\ndotnet add package Pulumi.Equinix\n```\n\n### Java\n\n**PLEASE NOTE:** Java is currently in preview. For more details check out [pulumi java documentation](https://www.pulumi.com/docs/intro/languages/java/#how-to-use-java-with-pulumi).\n\nTo use from Java, add the dependency below to your `pom.xml` file:\n\n```\n<dependency>\n <groupId>com.equinix.pulumi</groupId>\n <artifactId>equinix</artifactId>\n <version>[0.1.0,)</version>\n</dependency>\n```\n\n## Configuration\n\nFor information about obtaining API key and secret required for Equinix Fabric and Network Edge refer to [Generating Client ID and Client Secret key](https://developer.equinix.com/dev-docs/fabric/getting-started/getting-access-token#generating-client-id-and-client-secret) from [Equinix Developer Platform portal](https://developer.equinix.com/).\n\nInteracting with Equinix Metal requires an API auth token that can be generated at Project-level or User-level. User API keys can be obtained by creating them in the [Equinix Metal Portal](https://console.equinix.com/) or by using the [Create a User API Key](https://deploy.equinix.com/developers/api/metal/#operation/createAPIKey) endpoint. Project API keys can also be obtained by creating them in the [Equinix Metal Portal](https://console.equinix.com/) or by using the [Create a Project API Key](https://deploy.equinix.com/developers/api/metal/#operation/createProjectAPIKey) endpoint.\n\nIf you are only using Equinix Metal resources, you may omit the Client ID and Client Secret provider configuration parameters needed to access other Equinix resource types (Network Edge, Fabric, etc).\n\nThe following configuration points are available for the `equinix` provider:\n\n- `equinix:authToken` (environment: `METAL_AUTH_TOKEN`) - (Optional) the Equinix Metal API auth key for API operations.\n- `equinix:clientId` (environment: `EQUINIX_API_CLIENTID`) - (Optional) API Consumer Key available under My Apps section in Equinix developer portal.\n- `equinix:clientSecret` (environment: `EQUINIX_API_CLIENTSECRET`) - (Optional) API Consumer secret available under My Apps section in Equinix developer portal.\n\nAdvanced configuration points:\n\n- `equinix:token` (environment: `EQUINIX_API_TOKEN`) - (Optional) API token from the developer sandbox. Token's can be generated for the API Client using the OAuth2 Token features described in the [OAuth2 API](https://developer.equinix.com/catalog/accesstokenv1#operation/GetOAuth2AccessToken) documentation. The `client_id` and `client_secret` arguments will be ignored in the presence of a token argument.\n- `equinix:endpoint` (environment: `EQUINIX_API_ENDPOINT`) - (Optional) the Equinix API base URL to point out desired environmen. Defaults to `https://api.equinix.com`.\n- `equinix:maxRetries` - (Optional) the maximum number of retries in case of network failure.\n- `equinix:maxRetryWaitSeconds` - (Optional) the maximum time to wait in case of network failure.\n- `equinix:requestTimeout` - (Optional) the duration of time, in seconds, that the Equinix Platform API Client should wait before canceling an API request. Defaults to 30.\n- `equinix:responseMaxPageSize` - (Optional) the maximum number of records in a single response for REST queries that produce paginated responses.\n \n## Reference\n\nFor detailed reference documentation, please visit [Equinix API Docs in th Pulumi Registry](https://www.pulumi.com/registry/packages/equinix/api-docs/).\n\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "A Pulumi package for creating and managing equinix cloud resources.",
"version": "0.20.0",
"project_urls": {
"Homepage": "https://deploy.equinix.com/",
"Repository": "https://github.com/equinix/pulumi-equinix"
},
"split_keywords": [
"pulumi",
"equinix",
"category/cloud"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f38fbf754b081ef05ac409422ea09af7f188e924dbe3de35af034cae4ddb8ba1",
"md5": "af5b8a567e15ad987fac463aa3cd233e",
"sha256": "3745028d2e7842aeb834e1209778229f262992566067d51f31b92920d5fe43b5"
},
"downloads": -1,
"filename": "pulumi_equinix-0.20.0.tar.gz",
"has_sig": false,
"md5_digest": "af5b8a567e15ad987fac463aa3cd233e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 312201,
"upload_time": "2024-12-14T02:38:26",
"upload_time_iso_8601": "2024-12-14T02:38:26.038059Z",
"url": "https://files.pythonhosted.org/packages/f3/8f/bf754b081ef05ac409422ea09af7f188e924dbe3de35af034cae4ddb8ba1/pulumi_equinix-0.20.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-14 02:38:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "equinix",
"github_project": "pulumi-equinix",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pulumi-equinix"
}
JSON
