Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Cloudflare Provider
  3. API Docs
  4. EmailRoutingCatchAll
Cloudflare v5.43.0 published on Wednesday, Nov 13, 2024 by Pulumi
pulumi/pulumi-cloudflare

cloudflare.EmailRoutingCatchAll

Explore with Pulumi AI

cloudflare logo
Cloudflare v5.43.0 published on Wednesday, Nov 13, 2024 by Pulumi
pulumi/pulumi-cloudflare

    Provides a resource for managing Email Routing Addresses catch all behaviour.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";

const example = new cloudflare.EmailRoutingCatchAll("example", {
    zoneId: "0da42c8d2132a9ddaf714f9e7c920711",
    name: "example catch all",
    enabled: true,
    matchers: [{
        type: "all",
    }],
    actions: [{
        type: "forward",
        values: ["destinationaddress@example.net"],
    }],
});

    import pulumi
import pulumi_cloudflare as cloudflare

example = cloudflare.EmailRoutingCatchAll("example",
    zone_id="0da42c8d2132a9ddaf714f9e7c920711",
    name="example catch all",
    enabled=True,
    matchers=[{
        "type": "all",
    }],
    actions=[{
        "type": "forward",
        "values": ["destinationaddress@example.net"],
    }])

    package main

import (
	"github.com/pulumi/pulumi-cloudflare/sdk/v5/go/cloudflare"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudflare.NewEmailRoutingCatchAll(ctx, "example", &cloudflare.EmailRoutingCatchAllArgs{
			ZoneId:  pulumi.String("0da42c8d2132a9ddaf714f9e7c920711"),
			Name:    pulumi.String("example catch all"),
			Enabled: pulumi.Bool(true),
			Matchers: cloudflare.EmailRoutingCatchAllMatcherArray{
				&cloudflare.EmailRoutingCatchAllMatcherArgs{
					Type: pulumi.String("all"),
				},
			},
			Actions: cloudflare.EmailRoutingCatchAllActionArray{
				&cloudflare.EmailRoutingCatchAllActionArgs{
					Type: pulumi.String("forward"),
					Values: pulumi.StringArray{
						pulumi.String("destinationaddress@example.net"),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Cloudflare = Pulumi.Cloudflare;

return await Deployment.RunAsync(() => 
{
    var example = new Cloudflare.EmailRoutingCatchAll("example", new()
    {
        ZoneId = "0da42c8d2132a9ddaf714f9e7c920711",
        Name = "example catch all",
        Enabled = true,
        Matchers = new[]
        {
            new Cloudflare.Inputs.EmailRoutingCatchAllMatcherArgs
            {
                Type = "all",
            },
        },
        Actions = new[]
        {
            new Cloudflare.Inputs.EmailRoutingCatchAllActionArgs
            {
                Type = "forward",
                Values = new[]
                {
                    "destinationaddress@example.net",
                },
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.cloudflare.EmailRoutingCatchAll;
import com.pulumi.cloudflare.EmailRoutingCatchAllArgs;
import com.pulumi.cloudflare.inputs.EmailRoutingCatchAllMatcherArgs;
import com.pulumi.cloudflare.inputs.EmailRoutingCatchAllActionArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new EmailRoutingCatchAll("example", EmailRoutingCatchAllArgs.builder()
            .zoneId("0da42c8d2132a9ddaf714f9e7c920711")
            .name("example catch all")
            .enabled(true)
            .matchers(EmailRoutingCatchAllMatcherArgs.builder()
                .type("all")
                .build())
            .actions(EmailRoutingCatchAllActionArgs.builder()
                .type("forward")
                .values("destinationaddress@example.net")
                .build())
            .build());

    }
}

    resources:
  example:
    type: cloudflare:EmailRoutingCatchAll
    properties:
      zoneId: 0da42c8d2132a9ddaf714f9e7c920711
      name: example catch all
      enabled: true
      matchers:
        - type: all
      actions:
        - type: forward
          values:
            - destinationaddress@example.net

    Create EmailRoutingCatchAll Resource

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

    Constructor syntax

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

@overload
def EmailRoutingCatchAll(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         actions: Optional[Sequence[EmailRoutingCatchAllActionArgs]] = None,
                         matchers: Optional[Sequence[EmailRoutingCatchAllMatcherArgs]] = None,
                         name: Optional[str] = None,
                         zone_id: Optional[str] = None,
                         enabled: Optional[bool] = None)
    func NewEmailRoutingCatchAll(ctx *Context, name string, args EmailRoutingCatchAllArgs, opts ...ResourceOption) (*EmailRoutingCatchAll, error)
    public EmailRoutingCatchAll(string name, EmailRoutingCatchAllArgs args, CustomResourceOptions? opts = null)
    public EmailRoutingCatchAll(String name, EmailRoutingCatchAllArgs args)
public EmailRoutingCatchAll(String name, EmailRoutingCatchAllArgs args, CustomResourceOptions options)

    type: cloudflare:EmailRoutingCatchAll
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args EmailRoutingCatchAllArgs
    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 EmailRoutingCatchAllArgs
    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 EmailRoutingCatchAllArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args EmailRoutingCatchAllArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args EmailRoutingCatchAllArgs
    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 emailRoutingCatchAllResource = new Cloudflare.EmailRoutingCatchAll("emailRoutingCatchAllResource", new()
{
    Actions = new[]
    {
        new Cloudflare.Inputs.EmailRoutingCatchAllActionArgs
        {
            Type = "string",
            Values = new[]
            {
                "string",
            },
        },
    },
    Matchers = new[]
    {
        new Cloudflare.Inputs.EmailRoutingCatchAllMatcherArgs
        {
            Type = "string",
        },
    },
    Name = "string",
    ZoneId = "string",
    Enabled = false,
});

    example, err := cloudflare.NewEmailRoutingCatchAll(ctx, "emailRoutingCatchAllResource", &cloudflare.EmailRoutingCatchAllArgs{
	Actions: cloudflare.EmailRoutingCatchAllActionArray{
		&cloudflare.EmailRoutingCatchAllActionArgs{
			Type: pulumi.String("string"),
			Values: pulumi.StringArray{
				pulumi.String("string"),
			},
		},
	},
	Matchers: cloudflare.EmailRoutingCatchAllMatcherArray{
		&cloudflare.EmailRoutingCatchAllMatcherArgs{
			Type: pulumi.String("string"),
		},
	},
	Name:    pulumi.String("string"),
	ZoneId:  pulumi.String("string"),
	Enabled: pulumi.Bool(false),
})

    var emailRoutingCatchAllResource = new EmailRoutingCatchAll("emailRoutingCatchAllResource", EmailRoutingCatchAllArgs.builder()
    .actions(EmailRoutingCatchAllActionArgs.builder()
        .type("string")
        .values("string")
        .build())
    .matchers(EmailRoutingCatchAllMatcherArgs.builder()
        .type("string")
        .build())
    .name("string")
    .zoneId("string")
    .enabled(false)
    .build());

    email_routing_catch_all_resource = cloudflare.EmailRoutingCatchAll("emailRoutingCatchAllResource",
    actions=[{
        "type": "string",
        "values": ["string"],
    }],
    matchers=[{
        "type": "string",
    }],
    name="string",
    zone_id="string",
    enabled=False)

    const emailRoutingCatchAllResource = new cloudflare.EmailRoutingCatchAll("emailRoutingCatchAllResource", {
    actions: [{
        type: "string",
        values: ["string"],
    }],
    matchers: [{
        type: "string",
    }],
    name: "string",
    zoneId: "string",
    enabled: false,
});

    type: cloudflare:EmailRoutingCatchAll
properties:
    actions:
        - type: string
          values:
            - string
    enabled: false
    matchers:
        - type: string
    name: string
    zoneId: string

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

    Actions List<EmailRoutingCatchAllAction>
    List actions patterns.
    Matchers List<EmailRoutingCatchAllMatcher>
    Matching patterns to forward to your actions.
    Name string
    Routing rule name.
    ZoneId string
    The zone identifier to target for the resource.
    Enabled bool
    Routing rule status.
    Actions []EmailRoutingCatchAllActionArgs
    List actions patterns.
    Matchers []EmailRoutingCatchAllMatcherArgs
    Matching patterns to forward to your actions.
    Name string
    Routing rule name.
    ZoneId string
    The zone identifier to target for the resource.
    Enabled bool
    Routing rule status.
    actions List<EmailRoutingCatchAllAction>
    List actions patterns.
    matchers List<EmailRoutingCatchAllMatcher>
    Matching patterns to forward to your actions.
    name String
    Routing rule name.
    zoneId String
    The zone identifier to target for the resource.
    enabled Boolean
    Routing rule status.
    actions EmailRoutingCatchAllAction[]
    List actions patterns.
    matchers EmailRoutingCatchAllMatcher[]
    Matching patterns to forward to your actions.
    name string
    Routing rule name.
    zoneId string
    The zone identifier to target for the resource.
    enabled boolean
    Routing rule status.
    actions Sequence[EmailRoutingCatchAllActionArgs]
    List actions patterns.
    matchers Sequence[EmailRoutingCatchAllMatcherArgs]
    Matching patterns to forward to your actions.
    name str
    Routing rule name.
    zone_id str
    The zone identifier to target for the resource.
    enabled bool
    Routing rule status.
    actions List<Property Map>
    List actions patterns.
    matchers List<Property Map>
    Matching patterns to forward to your actions.
    name String
    Routing rule name.
    zoneId String
    The zone identifier to target for the resource.
    enabled Boolean
    Routing rule status.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Tag string
    Routing rule identifier.
    Id string
    The provider-assigned unique ID for this managed resource.
    Tag string
    Routing rule identifier.
    id String
    The provider-assigned unique ID for this managed resource.
    tag String
    Routing rule identifier.
    id string
    The provider-assigned unique ID for this managed resource.
    tag string
    Routing rule identifier.
    id str
    The provider-assigned unique ID for this managed resource.
    tag str
    Routing rule identifier.
    id String
    The provider-assigned unique ID for this managed resource.
    tag String
    Routing rule identifier.

    Look up Existing EmailRoutingCatchAll Resource

    Get an existing EmailRoutingCatchAll resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: EmailRoutingCatchAllState, opts?: CustomResourceOptions): EmailRoutingCatchAll
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        actions: Optional[Sequence[EmailRoutingCatchAllActionArgs]] = None,
        enabled: Optional[bool] = None,
        matchers: Optional[Sequence[EmailRoutingCatchAllMatcherArgs]] = None,
        name: Optional[str] = None,
        tag: Optional[str] = None,
        zone_id: Optional[str] = None) -> EmailRoutingCatchAll
    func GetEmailRoutingCatchAll(ctx *Context, name string, id IDInput, state *EmailRoutingCatchAllState, opts ...ResourceOption) (*EmailRoutingCatchAll, error)
    public static EmailRoutingCatchAll Get(string name, Input<string> id, EmailRoutingCatchAllState? state, CustomResourceOptions? opts = null)
    public static EmailRoutingCatchAll get(String name, Output<String> id, EmailRoutingCatchAllState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Actions List<EmailRoutingCatchAllAction>
    List actions patterns.
    Enabled bool
    Routing rule status.
    Matchers List<EmailRoutingCatchAllMatcher>
    Matching patterns to forward to your actions.
    Name string
    Routing rule name.
    Tag string
    Routing rule identifier.
    ZoneId string
    The zone identifier to target for the resource.
    Actions []EmailRoutingCatchAllActionArgs
    List actions patterns.
    Enabled bool
    Routing rule status.
    Matchers []EmailRoutingCatchAllMatcherArgs
    Matching patterns to forward to your actions.
    Name string
    Routing rule name.
    Tag string
    Routing rule identifier.
    ZoneId string
    The zone identifier to target for the resource.
    actions List<EmailRoutingCatchAllAction>
    List actions patterns.
    enabled Boolean
    Routing rule status.
    matchers List<EmailRoutingCatchAllMatcher>
    Matching patterns to forward to your actions.
    name String
    Routing rule name.
    tag String
    Routing rule identifier.
    zoneId String
    The zone identifier to target for the resource.
    actions EmailRoutingCatchAllAction[]
    List actions patterns.
    enabled boolean
    Routing rule status.
    matchers EmailRoutingCatchAllMatcher[]
    Matching patterns to forward to your actions.
    name string
    Routing rule name.
    tag string
    Routing rule identifier.
    zoneId string
    The zone identifier to target for the resource.
    actions Sequence[EmailRoutingCatchAllActionArgs]
    List actions patterns.
    enabled bool
    Routing rule status.
    matchers Sequence[EmailRoutingCatchAllMatcherArgs]
    Matching patterns to forward to your actions.
    name str
    Routing rule name.
    tag str
    Routing rule identifier.
    zone_id str
    The zone identifier to target for the resource.
    actions List<Property Map>
    List actions patterns.
    enabled Boolean
    Routing rule status.
    matchers List<Property Map>
    Matching patterns to forward to your actions.
    name String
    Routing rule name.
    tag String
    Routing rule identifier.
    zoneId String
    The zone identifier to target for the resource.

    Supporting Types

    EmailRoutingCatchAllAction, EmailRoutingCatchAllActionArgs

    Type string
    Type of supported action. Available values: drop, forward, worker.
    Values List<string>
    A list with items in the following form.
    Type string
    Type of supported action. Available values: drop, forward, worker.
    Values []string
    A list with items in the following form.
    type String
    Type of supported action. Available values: drop, forward, worker.
    values List<String>
    A list with items in the following form.
    type string
    Type of supported action. Available values: drop, forward, worker.
    values string[]
    A list with items in the following form.
    type str
    Type of supported action. Available values: drop, forward, worker.
    values Sequence[str]
    A list with items in the following form.
    type String
    Type of supported action. Available values: drop, forward, worker.
    values List<String>
    A list with items in the following form.

    EmailRoutingCatchAllMatcher, EmailRoutingCatchAllMatcherArgs

    Type string
    Type of matcher. Available values: all.
    Type string
    Type of matcher. Available values: all.
    type String
    Type of matcher. Available values: all.
    type string
    Type of matcher. Available values: all.
    type str
    Type of matcher. Available values: all.
    type String
    Type of matcher. Available values: all.

    Package Details

    Repository
    Cloudflare pulumi/pulumi-cloudflare
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the cloudflare Terraform Provider.
    cloudflare logo
    Cloudflare v5.43.0 published on Wednesday, Nov 13, 2024 by Pulumi
    pulumi/pulumi-cloudflare