The Cloudflare resource provider for Pulumi lets you use Cloudflare resources in your cloud programs. To use this package, please install the Pulumi CLI first.
This package is available in many languages in the standard packaging formats.
To use from JavaScript or TypeScript in Node.js, install using either npm
:
$ npm install @pulumi/cloudflare
or yarn
:
$ yarn add @pulumi/cloudflare
To use from Python, install using pip
:
$ pip install pulumi_cloudflare
To use from Go, use go get
to grab the latest version of the library
$ go get github.com/pulumi/pulumi-cloudflare/sdk/v6
To use from .NET, install using dotnet add package
:
$ dotnet add package Pulumi.Cloudflare
The following configuration points are available:
-
cloudflare:apiKey
- (Optional) The API key for operations. Alternatively, can be configured using theCLOUDFLARE_API_KEY
environment variable. API keys are now considered legacy by Cloudflare, API tokens should be used instead. Must provide only one ofcloudflare:apiKey
,cloudflare:apiToken
,cloudflare:apiUserServiceKey
. -
cloudflare:apiToken
- (Optional) The API Token for operations. Alternatively, can be configured using theCLOUDFLARE_API_TOKEN
environment variable. Must provide only one ofcloudflare:apiKey
,cloudflare:apiToken
,cloudflare:apiUserServiceKey
. -
cloudflare:apiUserServiceKey
- (Optional) A special Cloudflare API key good for a restricted set of endpoints. Alternatively, can be configured using theCLOUDFLARE_API_USER_SERVICE_KEY
environment variable. Must provide only one ofcloudflare:apiKey
,cloudflare:apiToken
,cloudflare:apiUserServiceKey
. -
cloudflare:baseUrl
(String) Value to override the default HTTP client base URL. Alternatively, can be configured using theCLOUDFLARE_BASE_URL
environment variable. -
cloudflare:email
- (Optional) A registered Cloudflare email address. Alternatively, can be configured using theCLOUDFLARE_EMAIL
environment variable. Required when usingcloudflare:apiKey
. Conflicts withcloudflare:apiToken
. -
cloudflare:userAgentOperatorSuffix
- (Optional) A value to append to the HTTP User Agent for all API calls. This value is not something most users need to modify however, if you are using a non-standard provider or operator configuration, this is recommended to assist in uniquely identifying your traffic. Setting this value will remove the Pulumi version from the HTTP User Agent string and may have unintended consequences. Alternatively, can be configured using theCLOUDFLARE_USER_AGENT_OPERATOR_SUFFIX
environment variable.
For further information, please visit the Cloudflare provider docs or for detailed reference documentation, please visit the API docs.