Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents 1.0.0

为.NET的Azure.Messaging.EventGrid库提供CloudNative CloudEvent支持

此库可以用于启用使用Azure Event Grid库发布CloudNative CloudEvents。

入门

安装包

从NuGet安装客户端库

dotnet add package Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents --prerelease

先决条件

您必须有一个Azure订阅和一个具有自定义Event Grid主题或域的Azure资源组。按照此分步教程注册Event Grid资源提供程序和创建Event Grid主题（使用Azure门户）。还有一个使用Azure CLI的类似教程。

验证客户端

为了让客户端库与主题或域交互，您需要Event Grid主题的端点和一个凭证，后者可以使用主题的访问密钥创建。

您可以在Azure门户或使用以下Azure CLI片段中找到您的Event Grid主题端点。

az eventgrid topic show --name <your-resource-name> --resource-group <your-resource-group-name> --query "endpoint"

访问密钥也可以通过门户或以下Azure CLI片段找到

az eventgrid topic key list --name <your-resource-name> --resource-group <your-resource-group-name> --query "key1"

创建和验证 EventGridPublisherClient

一旦您有了访问密钥和主题端点，您可以按照以下方式创建发布客户端

EventGridPublisherClient client = new EventGridPublisherClient(
    new Uri("<endpoint>"),
    new AzureKeyCredential("<access-key>"));

关键概念

有关一般Event Grid概念的信息：Azure Event Grid中的概念。

有关Event Grid客户端库概念的信息：Event Grid客户端库

示例

EventGridPublisherClient client = new EventGridPublisherClient(
        new Uri(TestEnvironment.CloudEventTopicHost),
        new AzureKeyCredential(TestEnvironment.CloudEventTopicKey));

var cloudEvent =
    new CloudEvent
    {
        Type = "record",
        Source = new Uri("http://www.contoso.com"),
        Data = "data"
    };
await client.SendCloudNativeCloudEventAsync(cloudEvent);

故障排除

有关故障排除信息，请参阅Event Grid客户端库文档。

下一步操作

在此处查看更多示例以了解库的常见用法。

贡献

此项目欢迎贡献和建议。大多数贡献需要您同意贡献者许可协议（CLA），声明白您有权，并实际上确实授予我们使用您贡献的权利。有关详细信息，请访问https://cla.microsoft.com。

提交pull request时，CLA机器人将自动确定您是否需要提供CLA，并相应地装饰PR（例如，标记、注释）。只需遵循机器人的说明。您只需在整个使用我们的CLA的repos中这样做一次。

此项目已采用Microsoft开源行为准则。有关更多信息，请参阅行为准则FAQ或通过[email protected]联系以获取任何额外的问题或评论。