1. Packages
  2. Alibaba Cloud Provider
  3. API Docs
  4. directmail
  5. MailAddress
Alibaba Cloud v3.86.0 published on Saturday, Sep 20, 2025 by Pulumi

alicloud.directmail.MailAddress

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.86.0 published on Saturday, Sep 20, 2025 by Pulumi

    Provides a Direct Mail Mail Address resource.

    For information about Direct Mail Mail Address and how to use it, see What is Mail Address.

    NOTE: Available since v1.134.0.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as alicloud from "@pulumi/alicloud";
    import * as std from "@pulumi/std";
    
    const config = new pulumi.Config();
    const accountName = config.get("accountName") || "tfexample";
    const domainName = config.get("domainName") || "alicloud-provider.online";
    const example = new alicloud.directmail.Domain("example", {domainName: domainName});
    const exampleMailAddress = new alicloud.directmail.MailAddress("example", {
        accountName: std.format({
            input: "%s@%s",
            args: [
                accountName,
                example.domainName,
            ],
        }).then(invoke => invoke.result),
        sendtype: "batch",
    });
    
    import pulumi
    import pulumi_alicloud as alicloud
    import pulumi_std as std
    
    config = pulumi.Config()
    account_name = config.get("accountName")
    if account_name is None:
        account_name = "tfexample"
    domain_name = config.get("domainName")
    if domain_name is None:
        domain_name = "alicloud-provider.online"
    example = alicloud.directmail.Domain("example", domain_name=domain_name)
    example_mail_address = alicloud.directmail.MailAddress("example",
        account_name=std.format(input="%s@%s",
            args=[
                account_name,
                example.domain_name,
            ]).result,
        sendtype="batch")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/directmail"
    	"github.com/pulumi/pulumi-std/sdk/go/std"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		cfg := config.New(ctx, "")
    		accountName := "tfexample"
    		if param := cfg.Get("accountName"); param != "" {
    			accountName = param
    		}
    		domainName := "alicloud-provider.online"
    		if param := cfg.Get("domainName"); param != "" {
    			domainName = param
    		}
    		example, err := directmail.NewDomain(ctx, "example", &directmail.DomainArgs{
    			DomainName: pulumi.String(domainName),
    		})
    		if err != nil {
    			return err
    		}
    		invokeFormat, err := std.Format(ctx, &std.FormatArgs{
    			Input: "%s@%s",
    			Args: []interface{}{
    				accountName,
    				example.DomainName,
    			},
    		}, nil)
    		if err != nil {
    			return err
    		}
    		_, err = directmail.NewMailAddress(ctx, "example", &directmail.MailAddressArgs{
    			AccountName: pulumi.String(invokeFormat.Result),
    			Sendtype:    pulumi.String("batch"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using AliCloud = Pulumi.AliCloud;
    using Std = Pulumi.Std;
    
    return await Deployment.RunAsync(() => 
    {
        var config = new Config();
        var accountName = config.Get("accountName") ?? "tfexample";
        var domainName = config.Get("domainName") ?? "alicloud-provider.online";
        var example = new AliCloud.DirectMail.Domain("example", new()
        {
            DomainName = domainName,
        });
    
        var exampleMailAddress = new AliCloud.DirectMail.MailAddress("example", new()
        {
            AccountName = Std.Format.Invoke(new()
            {
                Input = "%s@%s",
                Args = new[]
                {
                    accountName,
                    example.DomainName,
                },
            }).Apply(invoke => invoke.Result),
            Sendtype = "batch",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.alicloud.directmail.Domain;
    import com.pulumi.alicloud.directmail.DomainArgs;
    import com.pulumi.alicloud.directmail.MailAddress;
    import com.pulumi.alicloud.directmail.MailAddressArgs;
    import com.pulumi.std.StdFunctions;
    import com.pulumi.std.inputs.FormatArgs;
    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) {
            final var config = ctx.config();
            final var accountName = config.get("accountName").orElse("tfexample");
            final var domainName = config.get("domainName").orElse("alicloud-provider.online");
            var example = new Domain("example", DomainArgs.builder()
                .domainName(domainName)
                .build());
    
            var exampleMailAddress = new MailAddress("exampleMailAddress", MailAddressArgs.builder()
                .accountName(StdFunctions.format(FormatArgs.builder()
                    .input("%s@%s")
                    .args(                
                        accountName,
                        example.domainName())
                    .build()).result())
                .sendtype("batch")
                .build());
    
        }
    }
    
    configuration:
      accountName:
        type: string
        default: tfexample
      domainName:
        type: string
        default: alicloud-provider.online
    resources:
      example:
        type: alicloud:directmail:Domain
        properties:
          domainName: ${domainName}
      exampleMailAddress:
        type: alicloud:directmail:MailAddress
        name: example
        properties:
          accountName:
            fn::invoke:
              function: std:format
              arguments:
                input: '%s@%s'
                args:
                  - ${accountName}
                  - ${example.domainName}
              return: result
          sendtype: batch
    

    Note: A maximum of 10 mailing addresses can be added. Individual users: Up to 10 mailing addresses can be deleted within a month. Enterprise users: Up to 10 mailing addresses can be deleted within a month.

    Create MailAddress Resource

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

    Constructor syntax

    new MailAddress(name: string, args: MailAddressArgs, opts?: CustomResourceOptions);
    @overload
    def MailAddress(resource_name: str,
                    args: MailAddressArgs,
                    opts: Optional[ResourceOptions] = None)
    
    @overload
    def MailAddress(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    account_name: Optional[str] = None,
                    sendtype: Optional[str] = None,
                    password: Optional[str] = None,
                    reply_address: Optional[str] = None)
    func NewMailAddress(ctx *Context, name string, args MailAddressArgs, opts ...ResourceOption) (*MailAddress, error)
    public MailAddress(string name, MailAddressArgs args, CustomResourceOptions? opts = null)
    public MailAddress(String name, MailAddressArgs args)
    public MailAddress(String name, MailAddressArgs args, CustomResourceOptions options)
    
    type: alicloud:directmail:MailAddress
    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 MailAddressArgs
    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 MailAddressArgs
    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 MailAddressArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MailAddressArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MailAddressArgs
    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 mailAddressResource = new AliCloud.DirectMail.MailAddress("mailAddressResource", new()
    {
        AccountName = "string",
        Sendtype = "string",
        Password = "string",
        ReplyAddress = "string",
    });
    
    example, err := directmail.NewMailAddress(ctx, "mailAddressResource", &directmail.MailAddressArgs{
    	AccountName:  pulumi.String("string"),
    	Sendtype:     pulumi.String("string"),
    	Password:     pulumi.String("string"),
    	ReplyAddress: pulumi.String("string"),
    })
    
    var mailAddressResource = new MailAddress("mailAddressResource", MailAddressArgs.builder()
        .accountName("string")
        .sendtype("string")
        .password("string")
        .replyAddress("string")
        .build());
    
    mail_address_resource = alicloud.directmail.MailAddress("mailAddressResource",
        account_name="string",
        sendtype="string",
        password="string",
        reply_address="string")
    
    const mailAddressResource = new alicloud.directmail.MailAddress("mailAddressResource", {
        accountName: "string",
        sendtype: "string",
        password: "string",
        replyAddress: "string",
    });
    
    type: alicloud:directmail:MailAddress
    properties:
        accountName: string
        password: string
        replyAddress: string
        sendtype: string
    

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

    AccountName string
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    Sendtype string
    Account type. Valid values: batch, trigger.
    Password string
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    ReplyAddress string
    Return address.
    AccountName string
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    Sendtype string
    Account type. Valid values: batch, trigger.
    Password string
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    ReplyAddress string
    Return address.
    accountName String
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    sendtype String
    Account type. Valid values: batch, trigger.
    password String
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    replyAddress String
    Return address.
    accountName string
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    sendtype string
    Account type. Valid values: batch, trigger.
    password string
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    replyAddress string
    Return address.
    account_name str
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    sendtype str
    Account type. Valid values: batch, trigger.
    password str
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    reply_address str
    Return address.
    accountName String
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    sendtype String
    Account type. Valid values: batch, trigger.
    password String
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    replyAddress String
    Return address.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Account Status freeze: 1, normal: 0.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Account Status freeze: 1, normal: 0.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Account Status freeze: 1, normal: 0.
    id string
    The provider-assigned unique ID for this managed resource.
    status string
    Account Status freeze: 1, normal: 0.
    id str
    The provider-assigned unique ID for this managed resource.
    status str
    Account Status freeze: 1, normal: 0.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Account Status freeze: 1, normal: 0.

    Look up Existing MailAddress Resource

    Get an existing MailAddress 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?: MailAddressState, opts?: CustomResourceOptions): MailAddress
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            account_name: Optional[str] = None,
            password: Optional[str] = None,
            reply_address: Optional[str] = None,
            sendtype: Optional[str] = None,
            status: Optional[str] = None) -> MailAddress
    func GetMailAddress(ctx *Context, name string, id IDInput, state *MailAddressState, opts ...ResourceOption) (*MailAddress, error)
    public static MailAddress Get(string name, Input<string> id, MailAddressState? state, CustomResourceOptions? opts = null)
    public static MailAddress get(String name, Output<String> id, MailAddressState state, CustomResourceOptions options)
    resources:  _:    type: alicloud:directmail:MailAddress    get:      id: ${id}
    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:
    AccountName string
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    Password string
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    ReplyAddress string
    Return address.
    Sendtype string
    Account type. Valid values: batch, trigger.
    Status string
    Account Status freeze: 1, normal: 0.
    AccountName string
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    Password string
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    ReplyAddress string
    Return address.
    Sendtype string
    Account type. Valid values: batch, trigger.
    Status string
    Account Status freeze: 1, normal: 0.
    accountName String
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    password String
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    replyAddress String
    Return address.
    sendtype String
    Account type. Valid values: batch, trigger.
    status String
    Account Status freeze: 1, normal: 0.
    accountName string
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    password string
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    replyAddress string
    Return address.
    sendtype string
    Account type. Valid values: batch, trigger.
    status string
    Account Status freeze: 1, normal: 0.
    account_name str
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    password str
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    reply_address str
    Return address.
    sendtype str
    Account type. Valid values: batch, trigger.
    status str
    Account Status freeze: 1, normal: 0.
    accountName String
    The sender address. The email address must be filled in the format of account@domain, and only lowercase letters or numbers can be used.
    password String
    Account password. The password must be length 10-20 string, contains numbers, uppercase letters, lowercase letters at the same time.
    replyAddress String
    Return address.
    sendtype String
    Account type. Valid values: batch, trigger.
    status String
    Account Status freeze: 1, normal: 0.

    Import

    Direct Mail Mail Address can be imported using the id, e.g.

    $ pulumi import alicloud:directmail/mailAddress:MailAddress example <id>
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the alicloud Terraform Provider.
    alicloud logo
    Alibaba Cloud v3.86.0 published on Saturday, Sep 20, 2025 by Pulumi