Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Volcengine
  3. API Docs
  4. tos
  5. BucketNotification
Volcengine v0.0.35 published on Friday, Aug 29, 2025 by Volcengine
volcengine/pulumi-volcengine

volcengine.tos.BucketNotification

Explore with Pulumi AI

volcengine logo
Volcengine v0.0.35 published on Friday, Aug 29, 2025 by Volcengine
volcengine/pulumi-volcengine

    Provides a resource to manage tos bucket notification

    Example Usage

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

const fooBucket = new volcengine.tos.Bucket("fooBucket", {
    bucketName: "tf-acc-test-bucket",
    publicAcl: "private",
    azRedundancy: "multi-az",
    projectName: "default",
    tags: [{
        key: "k1",
        value: "v1",
    }],
});
const fooBucketNotification = new volcengine.tos.BucketNotification("fooBucketNotification", {
    bucketName: fooBucket.id,
    rules: {
        ruleId: "acc-test-rule",
        events: [
            "tos:ObjectCreated:Put",
            "tos:ObjectCreated:Post",
        ],
        destination: {
            veFaas: [
                {
                    functionId: "80w95pns",
                },
                {
                    functionId: "crnrfajj",
                },
            ],
        },
        filter: {
            tosKey: {
                filterRules: [
                    {
                        name: "prefix",
                        value: "a",
                    },
                    {
                        name: "suffix",
                        value: "b",
                    },
                ],
            },
        },
    },
});
const foo1 = new volcengine.tos.BucketNotification("foo1", {
    bucketName: fooBucket.id,
    rules: {
        ruleId: "acc-test-rule-1",
        events: [
            "tos:ObjectRemoved:Delete",
            "tos:ObjectRemoved:DeleteMarkerCreated",
        ],
        destination: {
            veFaas: [
                {
                    functionId: "80w95pns",
                },
                {
                    functionId: "crnrfajj",
                },
            ],
        },
        filter: {
            tosKey: {
                filterRules: [
                    {
                        name: "prefix",
                        value: "aaa",
                    },
                    {
                        name: "suffix",
                        value: "bbb",
                    },
                ],
            },
        },
    },
});

    import pulumi
import pulumi_volcengine as volcengine

foo_bucket = volcengine.tos.Bucket("fooBucket",
    bucket_name="tf-acc-test-bucket",
    public_acl="private",
    az_redundancy="multi-az",
    project_name="default",
    tags=[volcengine.tos.BucketTagArgs(
        key="k1",
        value="v1",
    )])
foo_bucket_notification = volcengine.tos.BucketNotification("fooBucketNotification",
    bucket_name=foo_bucket.id,
    rules=volcengine.tos.BucketNotificationRulesArgs(
        rule_id="acc-test-rule",
        events=[
            "tos:ObjectCreated:Put",
            "tos:ObjectCreated:Post",
        ],
        destination=volcengine.tos.BucketNotificationRulesDestinationArgs(
            ve_faas=[
                volcengine.tos.BucketNotificationRulesDestinationVeFaaArgs(
                    function_id="80w95pns",
                ),
                volcengine.tos.BucketNotificationRulesDestinationVeFaaArgs(
                    function_id="crnrfajj",
                ),
            ],
        ),
        filter=volcengine.tos.BucketNotificationRulesFilterArgs(
            tos_key=volcengine.tos.BucketNotificationRulesFilterTosKeyArgs(
                filter_rules=[
                    volcengine.tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs(
                        name="prefix",
                        value="a",
                    ),
                    volcengine.tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs(
                        name="suffix",
                        value="b",
                    ),
                ],
            ),
        ),
    ))
foo1 = volcengine.tos.BucketNotification("foo1",
    bucket_name=foo_bucket.id,
    rules=volcengine.tos.BucketNotificationRulesArgs(
        rule_id="acc-test-rule-1",
        events=[
            "tos:ObjectRemoved:Delete",
            "tos:ObjectRemoved:DeleteMarkerCreated",
        ],
        destination=volcengine.tos.BucketNotificationRulesDestinationArgs(
            ve_faas=[
                volcengine.tos.BucketNotificationRulesDestinationVeFaaArgs(
                    function_id="80w95pns",
                ),
                volcengine.tos.BucketNotificationRulesDestinationVeFaaArgs(
                    function_id="crnrfajj",
                ),
            ],
        ),
        filter=volcengine.tos.BucketNotificationRulesFilterArgs(
            tos_key=volcengine.tos.BucketNotificationRulesFilterTosKeyArgs(
                filter_rules=[
                    volcengine.tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs(
                        name="prefix",
                        value="aaa",
                    ),
                    volcengine.tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs(
                        name="suffix",
                        value="bbb",
                    ),
                ],
            ),
        ),
    ))

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/tos"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		fooBucket, err := tos.NewBucket(ctx, "fooBucket", &tos.BucketArgs{
			BucketName:   pulumi.String("tf-acc-test-bucket"),
			PublicAcl:    pulumi.String("private"),
			AzRedundancy: pulumi.String("multi-az"),
			ProjectName:  pulumi.String("default"),
			Tags: tos.BucketTagArray{
				&tos.BucketTagArgs{
					Key:   pulumi.String("k1"),
					Value: pulumi.String("v1"),
				},
			},
		})
		if err != nil {
			return err
		}
		_, err = tos.NewBucketNotification(ctx, "fooBucketNotification", &tos.BucketNotificationArgs{
			BucketName: fooBucket.ID(),
			Rules: &tos.BucketNotificationRulesArgs{
				RuleId: pulumi.String("acc-test-rule"),
				Events: pulumi.StringArray{
					pulumi.String("tos:ObjectCreated:Put"),
					pulumi.String("tos:ObjectCreated:Post"),
				},
				Destination: &tos.BucketNotificationRulesDestinationArgs{
					VeFaas: tos.BucketNotificationRulesDestinationVeFaaArray{
						&tos.BucketNotificationRulesDestinationVeFaaArgs{
							FunctionId: pulumi.String("80w95pns"),
						},
						&tos.BucketNotificationRulesDestinationVeFaaArgs{
							FunctionId: pulumi.String("crnrfajj"),
						},
					},
				},
				Filter: &tos.BucketNotificationRulesFilterArgs{
					TosKey: &tos.BucketNotificationRulesFilterTosKeyArgs{
						FilterRules: tos.BucketNotificationRulesFilterTosKeyFilterRuleArray{
							&tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs{
								Name:  pulumi.String("prefix"),
								Value: pulumi.String("a"),
							},
							&tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs{
								Name:  pulumi.String("suffix"),
								Value: pulumi.String("b"),
							},
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		_, err = tos.NewBucketNotification(ctx, "foo1", &tos.BucketNotificationArgs{
			BucketName: fooBucket.ID(),
			Rules: &tos.BucketNotificationRulesArgs{
				RuleId: pulumi.String("acc-test-rule-1"),
				Events: pulumi.StringArray{
					pulumi.String("tos:ObjectRemoved:Delete"),
					pulumi.String("tos:ObjectRemoved:DeleteMarkerCreated"),
				},
				Destination: &tos.BucketNotificationRulesDestinationArgs{
					VeFaas: tos.BucketNotificationRulesDestinationVeFaaArray{
						&tos.BucketNotificationRulesDestinationVeFaaArgs{
							FunctionId: pulumi.String("80w95pns"),
						},
						&tos.BucketNotificationRulesDestinationVeFaaArgs{
							FunctionId: pulumi.String("crnrfajj"),
						},
					},
				},
				Filter: &tos.BucketNotificationRulesFilterArgs{
					TosKey: &tos.BucketNotificationRulesFilterTosKeyArgs{
						FilterRules: tos.BucketNotificationRulesFilterTosKeyFilterRuleArray{
							&tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs{
								Name:  pulumi.String("prefix"),
								Value: pulumi.String("aaa"),
							},
							&tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs{
								Name:  pulumi.String("suffix"),
								Value: pulumi.String("bbb"),
							},
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var fooBucket = new Volcengine.Tos.Bucket("fooBucket", new()
    {
        BucketName = "tf-acc-test-bucket",
        PublicAcl = "private",
        AzRedundancy = "multi-az",
        ProjectName = "default",
        Tags = new[]
        {
            new Volcengine.Tos.Inputs.BucketTagArgs
            {
                Key = "k1",
                Value = "v1",
            },
        },
    });

    var fooBucketNotification = new Volcengine.Tos.BucketNotification("fooBucketNotification", new()
    {
        BucketName = fooBucket.Id,
        Rules = new Volcengine.Tos.Inputs.BucketNotificationRulesArgs
        {
            RuleId = "acc-test-rule",
            Events = new[]
            {
                "tos:ObjectCreated:Put",
                "tos:ObjectCreated:Post",
            },
            Destination = new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationArgs
            {
                VeFaas = new[]
                {
                    new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationVeFaaArgs
                    {
                        FunctionId = "80w95pns",
                    },
                    new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationVeFaaArgs
                    {
                        FunctionId = "crnrfajj",
                    },
                },
            },
            Filter = new Volcengine.Tos.Inputs.BucketNotificationRulesFilterArgs
            {
                TosKey = new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyArgs
                {
                    FilterRules = new[]
                    {
                        new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyFilterRuleArgs
                        {
                            Name = "prefix",
                            Value = "a",
                        },
                        new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyFilterRuleArgs
                        {
                            Name = "suffix",
                            Value = "b",
                        },
                    },
                },
            },
        },
    });

    var foo1 = new Volcengine.Tos.BucketNotification("foo1", new()
    {
        BucketName = fooBucket.Id,
        Rules = new Volcengine.Tos.Inputs.BucketNotificationRulesArgs
        {
            RuleId = "acc-test-rule-1",
            Events = new[]
            {
                "tos:ObjectRemoved:Delete",
                "tos:ObjectRemoved:DeleteMarkerCreated",
            },
            Destination = new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationArgs
            {
                VeFaas = new[]
                {
                    new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationVeFaaArgs
                    {
                        FunctionId = "80w95pns",
                    },
                    new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationVeFaaArgs
                    {
                        FunctionId = "crnrfajj",
                    },
                },
            },
            Filter = new Volcengine.Tos.Inputs.BucketNotificationRulesFilterArgs
            {
                TosKey = new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyArgs
                {
                    FilterRules = new[]
                    {
                        new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyFilterRuleArgs
                        {
                            Name = "prefix",
                            Value = "aaa",
                        },
                        new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyFilterRuleArgs
                        {
                            Name = "suffix",
                            Value = "bbb",
                        },
                    },
                },
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.volcengine.tos.Bucket;
import com.pulumi.volcengine.tos.BucketArgs;
import com.pulumi.volcengine.tos.inputs.BucketTagArgs;
import com.pulumi.volcengine.tos.BucketNotification;
import com.pulumi.volcengine.tos.BucketNotificationArgs;
import com.pulumi.volcengine.tos.inputs.BucketNotificationRulesArgs;
import com.pulumi.volcengine.tos.inputs.BucketNotificationRulesDestinationArgs;
import com.pulumi.volcengine.tos.inputs.BucketNotificationRulesFilterArgs;
import com.pulumi.volcengine.tos.inputs.BucketNotificationRulesFilterTosKeyArgs;
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 fooBucket = new Bucket("fooBucket", BucketArgs.builder()        
            .bucketName("tf-acc-test-bucket")
            .publicAcl("private")
            .azRedundancy("multi-az")
            .projectName("default")
            .tags(BucketTagArgs.builder()
                .key("k1")
                .value("v1")
                .build())
            .build());

        var fooBucketNotification = new BucketNotification("fooBucketNotification", BucketNotificationArgs.builder()        
            .bucketName(fooBucket.id())
            .rules(BucketNotificationRulesArgs.builder()
                .ruleId("acc-test-rule")
                .events(                
                    "tos:ObjectCreated:Put",
                    "tos:ObjectCreated:Post")
                .destination(BucketNotificationRulesDestinationArgs.builder()
                    .veFaas(                    
                        BucketNotificationRulesDestinationVeFaaArgs.builder()
                            .functionId("80w95pns")
                            .build(),
                        BucketNotificationRulesDestinationVeFaaArgs.builder()
                            .functionId("crnrfajj")
                            .build())
                    .build())
                .filter(BucketNotificationRulesFilterArgs.builder()
                    .tosKey(BucketNotificationRulesFilterTosKeyArgs.builder()
                        .filterRules(                        
                            BucketNotificationRulesFilterTosKeyFilterRuleArgs.builder()
                                .name("prefix")
                                .value("a")
                                .build(),
                            BucketNotificationRulesFilterTosKeyFilterRuleArgs.builder()
                                .name("suffix")
                                .value("b")
                                .build())
                        .build())
                    .build())
                .build())
            .build());

        var foo1 = new BucketNotification("foo1", BucketNotificationArgs.builder()        
            .bucketName(fooBucket.id())
            .rules(BucketNotificationRulesArgs.builder()
                .ruleId("acc-test-rule-1")
                .events(                
                    "tos:ObjectRemoved:Delete",
                    "tos:ObjectRemoved:DeleteMarkerCreated")
                .destination(BucketNotificationRulesDestinationArgs.builder()
                    .veFaas(                    
                        BucketNotificationRulesDestinationVeFaaArgs.builder()
                            .functionId("80w95pns")
                            .build(),
                        BucketNotificationRulesDestinationVeFaaArgs.builder()
                            .functionId("crnrfajj")
                            .build())
                    .build())
                .filter(BucketNotificationRulesFilterArgs.builder()
                    .tosKey(BucketNotificationRulesFilterTosKeyArgs.builder()
                        .filterRules(                        
                            BucketNotificationRulesFilterTosKeyFilterRuleArgs.builder()
                                .name("prefix")
                                .value("aaa")
                                .build(),
                            BucketNotificationRulesFilterTosKeyFilterRuleArgs.builder()
                                .name("suffix")
                                .value("bbb")
                                .build())
                        .build())
                    .build())
                .build())
            .build());

    }
}

    resources:
  fooBucket:
    type: volcengine:tos:Bucket
    properties:
      bucketName: tf-acc-test-bucket
      publicAcl: private
      azRedundancy: multi-az
      projectName: default
      tags:
        - key: k1
          value: v1
  fooBucketNotification:
    type: volcengine:tos:BucketNotification
    properties:
      bucketName: ${fooBucket.id}
      rules:
        ruleId: acc-test-rule
        events:
          - tos:ObjectCreated:Put
          - tos:ObjectCreated:Post
        destination:
          veFaas:
            - functionId: 80w95pns
            - functionId: crnrfajj
        filter:
          tosKey:
            filterRules:
              - name: prefix
                value: a
              - name: suffix
                value: b
  foo1:
    type: volcengine:tos:BucketNotification
    properties:
      bucketName: ${fooBucket.id}
      rules:
        ruleId: acc-test-rule-1
        events:
          - tos:ObjectRemoved:Delete
          - tos:ObjectRemoved:DeleteMarkerCreated
        destination:
          veFaas:
            - functionId: 80w95pns
            - functionId: crnrfajj
        filter:
          tosKey:
            filterRules:
              - name: prefix
                value: aaa
              - name: suffix
                value: bbb

    Create BucketNotification Resource

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

    Constructor syntax

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

@overload
def BucketNotification(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       bucket_name: Optional[str] = None,
                       rules: Optional[BucketNotificationRulesArgs] = None)
    func NewBucketNotification(ctx *Context, name string, args BucketNotificationArgs, opts ...ResourceOption) (*BucketNotification, error)
    public BucketNotification(string name, BucketNotificationArgs args, CustomResourceOptions? opts = null)
    public BucketNotification(String name, BucketNotificationArgs args)
public BucketNotification(String name, BucketNotificationArgs args, CustomResourceOptions options)

    type: volcengine:tos:BucketNotification
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 BucketNotificationArgs
    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 BucketNotificationArgs
    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 BucketNotificationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BucketNotificationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BucketNotificationArgs
    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 bucketNotificationResource = new Volcengine.Tos.BucketNotification("bucketNotificationResource", new()
{
    BucketName = "string",
    Rules = new Volcengine.Tos.Inputs.BucketNotificationRulesArgs
    {
        Destination = new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationArgs
        {
            VeFaas = new[]
            {
                new Volcengine.Tos.Inputs.BucketNotificationRulesDestinationVeFaaArgs
                {
                    FunctionId = "string",
                },
            },
        },
        Events = new[]
        {
            "string",
        },
        RuleId = "string",
        Filter = new Volcengine.Tos.Inputs.BucketNotificationRulesFilterArgs
        {
            TosKey = new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyArgs
            {
                FilterRules = new[]
                {
                    new Volcengine.Tos.Inputs.BucketNotificationRulesFilterTosKeyFilterRuleArgs
                    {
                        Name = "string",
                        Value = "string",
                    },
                },
            },
        },
    },
});

    example, err := tos.NewBucketNotification(ctx, "bucketNotificationResource", &tos.BucketNotificationArgs{
	BucketName: pulumi.String("string"),
	Rules: &tos.BucketNotificationRulesArgs{
		Destination: &tos.BucketNotificationRulesDestinationArgs{
			VeFaas: tos.BucketNotificationRulesDestinationVeFaaArray{
				&tos.BucketNotificationRulesDestinationVeFaaArgs{
					FunctionId: pulumi.String("string"),
				},
			},
		},
		Events: pulumi.StringArray{
			pulumi.String("string"),
		},
		RuleId: pulumi.String("string"),
		Filter: &tos.BucketNotificationRulesFilterArgs{
			TosKey: &tos.BucketNotificationRulesFilterTosKeyArgs{
				FilterRules: tos.BucketNotificationRulesFilterTosKeyFilterRuleArray{
					&tos.BucketNotificationRulesFilterTosKeyFilterRuleArgs{
						Name:  pulumi.String("string"),
						Value: pulumi.String("string"),
					},
				},
			},
		},
	},
})

    var bucketNotificationResource = new BucketNotification("bucketNotificationResource", BucketNotificationArgs.builder()
    .bucketName("string")
    .rules(BucketNotificationRulesArgs.builder()
        .destination(BucketNotificationRulesDestinationArgs.builder()
            .veFaas(BucketNotificationRulesDestinationVeFaaArgs.builder()
                .functionId("string")
                .build())
            .build())
        .events("string")
        .ruleId("string")
        .filter(BucketNotificationRulesFilterArgs.builder()
            .tosKey(BucketNotificationRulesFilterTosKeyArgs.builder()
                .filterRules(BucketNotificationRulesFilterTosKeyFilterRuleArgs.builder()
                    .name("string")
                    .value("string")
                    .build())
                .build())
            .build())
        .build())
    .build());

    bucket_notification_resource = volcengine.tos.BucketNotification("bucketNotificationResource",
    bucket_name="string",
    rules={
        "destination": {
            "ve_faas": [{
                "function_id": "string",
            }],
        },
        "events": ["string"],
        "rule_id": "string",
        "filter": {
            "tos_key": {
                "filter_rules": [{
                    "name": "string",
                    "value": "string",
                }],
            },
        },
    })

    const bucketNotificationResource = new volcengine.tos.BucketNotification("bucketNotificationResource", {
    bucketName: "string",
    rules: {
        destination: {
            veFaas: [{
                functionId: "string",
            }],
        },
        events: ["string"],
        ruleId: "string",
        filter: {
            tosKey: {
                filterRules: [{
                    name: "string",
                    value: "string",
                }],
            },
        },
    },
});

    type: volcengine:tos:BucketNotification
properties:
    bucketName: string
    rules:
        destination:
            veFaas:
                - functionId: string
        events:
            - string
        filter:
            tosKey:
                filterRules:
                    - name: string
                      value: string
        ruleId: string

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

    BucketName string
    The name of the bucket.
    Rules BucketNotificationRules
    The notification rule of the bucket.
    BucketName string
    The name of the bucket.
    Rules BucketNotificationRulesArgs
    The notification rule of the bucket.
    bucketName String
    The name of the bucket.
    rules BucketNotificationRules
    The notification rule of the bucket.
    bucketName string
    The name of the bucket.
    rules BucketNotificationRules
    The notification rule of the bucket.
    bucket_name str
    The name of the bucket.
    rules BucketNotificationRulesArgs
    The notification rule of the bucket.
    bucketName String
    The name of the bucket.
    rules Property Map
    The notification rule of the bucket.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Version string
    The version of the notification.
    Id string
    The provider-assigned unique ID for this managed resource.
    Version string
    The version of the notification.
    id String
    The provider-assigned unique ID for this managed resource.
    version String
    The version of the notification.
    id string
    The provider-assigned unique ID for this managed resource.
    version string
    The version of the notification.
    id str
    The provider-assigned unique ID for this managed resource.
    version str
    The version of the notification.
    id String
    The provider-assigned unique ID for this managed resource.
    version String
    The version of the notification.

    Look up Existing BucketNotification Resource

    Get an existing BucketNotification 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?: BucketNotificationState, opts?: CustomResourceOptions): BucketNotification
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        bucket_name: Optional[str] = None,
        rules: Optional[BucketNotificationRulesArgs] = None,
        version: Optional[str] = None) -> BucketNotification
    func GetBucketNotification(ctx *Context, name string, id IDInput, state *BucketNotificationState, opts ...ResourceOption) (*BucketNotification, error)
    public static BucketNotification Get(string name, Input<string> id, BucketNotificationState? state, CustomResourceOptions? opts = null)
    public static BucketNotification get(String name, Output<String> id, BucketNotificationState state, CustomResourceOptions options)
    resources:  _:    type: volcengine:tos:BucketNotification    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:
    BucketName string
    The name of the bucket.
    Rules BucketNotificationRules
    The notification rule of the bucket.
    Version string
    The version of the notification.
    BucketName string
    The name of the bucket.
    Rules BucketNotificationRulesArgs
    The notification rule of the bucket.
    Version string
    The version of the notification.
    bucketName String
    The name of the bucket.
    rules BucketNotificationRules
    The notification rule of the bucket.
    version String
    The version of the notification.
    bucketName string
    The name of the bucket.
    rules BucketNotificationRules
    The notification rule of the bucket.
    version string
    The version of the notification.
    bucket_name str
    The name of the bucket.
    rules BucketNotificationRulesArgs
    The notification rule of the bucket.
    version str
    The version of the notification.
    bucketName String
    The name of the bucket.
    rules Property Map
    The notification rule of the bucket.
    version String
    The version of the notification.

    Supporting Types

    BucketNotificationRules, BucketNotificationRulesArgs

    Destination BucketNotificationRulesDestination
    The destination info of the notification.
    Events List<string>
    The event type of the notification.
    RuleId string
    The rule name of the notification.
    Filter BucketNotificationRulesFilter
    The filter of the notification.
    Destination BucketNotificationRulesDestination
    The destination info of the notification.
    Events []string
    The event type of the notification.
    RuleId string
    The rule name of the notification.
    Filter BucketNotificationRulesFilter
    The filter of the notification.
    destination BucketNotificationRulesDestination
    The destination info of the notification.
    events List<String>
    The event type of the notification.
    ruleId String
    The rule name of the notification.
    filter BucketNotificationRulesFilter
    The filter of the notification.
    destination BucketNotificationRulesDestination
    The destination info of the notification.
    events string[]
    The event type of the notification.
    ruleId string
    The rule name of the notification.
    filter BucketNotificationRulesFilter
    The filter of the notification.
    destination BucketNotificationRulesDestination
    The destination info of the notification.
    events Sequence[str]
    The event type of the notification.
    rule_id str
    The rule name of the notification.
    filter BucketNotificationRulesFilter
    The filter of the notification.
    destination Property Map
    The destination info of the notification.
    events List<String>
    The event type of the notification.
    ruleId String
    The rule name of the notification.
    filter Property Map
    The filter of the notification.

    BucketNotificationRulesDestination, BucketNotificationRulesDestinationArgs

    VeFaas List<BucketNotificationRulesDestinationVeFaa>
    The VeFaas info of the destination.
    VeFaas []BucketNotificationRulesDestinationVeFaa
    The VeFaas info of the destination.
    veFaas List<BucketNotificationRulesDestinationVeFaa>
    The VeFaas info of the destination.
    veFaas BucketNotificationRulesDestinationVeFaa[]
    The VeFaas info of the destination.
    veFaas List<Property Map>
    The VeFaas info of the destination.

    BucketNotificationRulesDestinationVeFaa, BucketNotificationRulesDestinationVeFaaArgs

    FunctionId string
    The function id of the destination.
    FunctionId string
    The function id of the destination.
    functionId String
    The function id of the destination.
    functionId string
    The function id of the destination.
    function_id str
    The function id of the destination.
    functionId String
    The function id of the destination.

    BucketNotificationRulesFilter, BucketNotificationRulesFilterArgs

    TosKey BucketNotificationRulesFilterTosKey
    The tos filter of the notification.
    TosKey BucketNotificationRulesFilterTosKey
    The tos filter of the notification.
    tosKey BucketNotificationRulesFilterTosKey
    The tos filter of the notification.
    tosKey BucketNotificationRulesFilterTosKey
    The tos filter of the notification.
    tos_key BucketNotificationRulesFilterTosKey
    The tos filter of the notification.
    tosKey Property Map
    The tos filter of the notification.

    BucketNotificationRulesFilterTosKey, BucketNotificationRulesFilterTosKeyArgs

    filterRules List<Property Map>
    The filter rules of the notification.

    BucketNotificationRulesFilterTosKeyFilterRule, BucketNotificationRulesFilterTosKeyFilterRuleArgs

    Name string
    The name of the filter rule. Valid values: prefix, suffix.
    Value string
    The value of the filter rule.
    Name string
    The name of the filter rule. Valid values: prefix, suffix.
    Value string
    The value of the filter rule.
    name String
    The name of the filter rule. Valid values: prefix, suffix.
    value String
    The value of the filter rule.
    name string
    The name of the filter rule. Valid values: prefix, suffix.
    value string
    The value of the filter rule.
    name str
    The name of the filter rule. Valid values: prefix, suffix.
    value str
    The value of the filter rule.
    name String
    The name of the filter rule. Valid values: prefix, suffix.
    value String
    The value of the filter rule.

    Import

    TosBucketNotification can be imported using the bucketName, e.g.

    $ pulumi import volcengine:tos/bucketNotification:BucketNotification default resource_id

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

    Package Details

    Repository
    volcengine volcengine/pulumi-volcengine
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the volcengine Terraform Provider.
    volcengine logo
    Volcengine v0.0.35 published on Friday, Aug 29, 2025 by Volcengine
    volcengine/pulumi-volcengine