Topic

class Topic : KotlinCustomResource

EventGrid Topic Uses Azure REST API version 2025-02-15. In version 2.x of the Azure Native provider, it used API version 2022-06-15. Other available API versions: 2022-06-15, 2023-06-01-preview, 2023-12-15-preview, 2024-06-01-preview, 2024-12-15-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native eventgrid [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.

Example Usage

Topics_CreateOrUpdate

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var topic = new AzureNative.EventGrid.Topic("topic", new()
{
InboundIpRules = new[]
{
new AzureNative.EventGrid.Inputs.InboundIpRuleArgs
{
Action = AzureNative.EventGrid.IpActionType.Allow,
IpMask = "12.18.30.15",
},
new AzureNative.EventGrid.Inputs.InboundIpRuleArgs
{
Action = AzureNative.EventGrid.IpActionType.Allow,
IpMask = "12.18.176.1",
},
},
Location = "westus2",
PublicNetworkAccess = AzureNative.EventGrid.PublicNetworkAccess.Enabled,
ResourceGroupName = "examplerg",
Tags =
{
{ "tag1", "value1" },
{ "tag2", "value2" },
},
TopicName = "exampletopic1",
});
});
package main
import (
eventgrid "github.com/pulumi/pulumi-azure-native-sdk/eventgrid/v3"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := eventgrid.NewTopic(ctx, "topic", &eventgrid.TopicArgs{
InboundIpRules: eventgrid.InboundIpRuleArray{
&eventgrid.InboundIpRuleArgs{
Action: pulumi.String(eventgrid.IpActionTypeAllow),
IpMask: pulumi.String("12.18.30.15"),
},
&eventgrid.InboundIpRuleArgs{
Action: pulumi.String(eventgrid.IpActionTypeAllow),
IpMask: pulumi.String("12.18.176.1"),
},
},
Location: pulumi.String("westus2"),
PublicNetworkAccess: pulumi.String(eventgrid.PublicNetworkAccessEnabled),
ResourceGroupName: pulumi.String("examplerg"),
Tags: pulumi.StringMap{
"tag1": pulumi.String("value1"),
"tag2": pulumi.String("value2"),
},
TopicName: pulumi.String("exampletopic1"),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.eventgrid.Topic;
import com.pulumi.azurenative.eventgrid.TopicArgs;
import com.pulumi.azurenative.eventgrid.inputs.InboundIpRuleArgs;
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 topic = new Topic("topic", TopicArgs.builder()
.inboundIpRules(
InboundIpRuleArgs.builder()
.action("Allow")
.ipMask("12.18.30.15")
.build(),
InboundIpRuleArgs.builder()
.action("Allow")
.ipMask("12.18.176.1")
.build())
.location("westus2")
.publicNetworkAccess("Enabled")
.resourceGroupName("examplerg")
.tags(Map.ofEntries(
Map.entry("tag1", "value1"),
Map.entry("tag2", "value2")
))
.topicName("exampletopic1")
.build());
}
}

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:eventgrid:Topic exampletopic1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}

Properties

Link copied to clipboard
val azureApiVersion: Output<String>

The Azure API version of the resource.

Link copied to clipboard

Data Residency Boundary of the resource.

Link copied to clipboard

This boolean is used to enable or disable local auth. Default value is false. When the property is set to true, only AAD token will be used to authenticate if user is allowed to publish to the topic.

Link copied to clipboard
val endpoint: Output<String>

Endpoint for the topic.

Link copied to clipboard

Event Type Information for the user topic. This information is provided by the publisher and can be used by the subscriber to view different types of events that are published.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard

Identity information for the resource.

Link copied to clipboard

This can be used to restrict traffic from specific IPs instead of all IPs. Note: These are considered only if PublicNetworkAccess is enabled.

Link copied to clipboard
val inputSchema: Output<String>?

This determines the format that Event Grid should expect for incoming events published to the topic.

Link copied to clipboard

This enables publishing using custom event schemas. An InputSchemaMapping can be specified to map various properties of a source schema to various required properties of the EventGridEvent schema.

Link copied to clipboard
val location: Output<String>

Location of the resource.

Link copied to clipboard

Metric resource id for the topic.

Link copied to clipboard

Minimum TLS version of the publisher allowed to publish to this topic

Link copied to clipboard
val name: Output<String>

Name of the resource.

Link copied to clipboard

List of private endpoint connections.

Link copied to clipboard

Provisioning state of the topic.

Link copied to clipboard

This determines if traffic is allowed over public network. By default it is enabled. You can further restrict to specific IPs by configuring

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard

The system metadata relating to the Event Grid resource.

Link copied to clipboard
val tags: Output<Map<String, String>>?

Tags of the resource.

Link copied to clipboard
val type: Output<String>

Type of the resource.

Link copied to clipboard
val urn: Output<String>