你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Event Subscriptions - Update

更新事件订阅。
异步更新现有事件订阅。

PATCH https://management.azure.com/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}?api-version=2022-06-15

URI 参数

名称 必需 类型 说明
eventSubscriptionName
path True

string

要更新的事件订阅的名称。

scope
path True

string

现有事件订阅的范围。 范围可以是订阅、资源组、属于资源提供程序命名空间的顶级资源或 EventGrid 主题。 例如,对订阅使用“/subscriptions/{subscriptionId}/”,对资源组使用“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}”, 和“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”表示资源,“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}”。

api-version
query True

string

要与客户端请求一起使用的 API 的版本。

请求正文

名称 类型 说明
deadLetterDestination DeadLetterDestination:

StorageBlobDeadLetterDestination

事件订阅的死信目标。 无法传递到其目标的任何事件都将发送到死信目标。 使用Azure 事件网格的标识获取在传递/死信期间使用的身份验证令牌。

deadLetterWithResourceIdentity

DeadLetterWithResourceIdentity

事件订阅的死信目标。 无法传递到其目标的任何事件都将发送到死信目标。 使用父资源 (主题/域) 的托管标识设置来获取在传递/死信期间使用的身份验证令牌。

deliveryWithResourceIdentity

DeliveryWithResourceIdentity

有关必须为事件订阅传递事件的目标的信息。 使用父资源 (主题/域) 的托管标识设置来获取在传递/死信期间使用的身份验证令牌。

destination EventSubscriptionDestination:

有关必须为事件订阅传递事件的目标的信息。 使用Azure 事件网格的标识获取在传递/死信期间使用的身份验证令牌。

eventDeliverySchema

EventDeliverySchema

事件订阅的事件传递架构。

expirationTimeUtc

string

有关事件订阅的过期时间的信息。

filter

EventSubscriptionFilter

有关事件订阅筛选器的信息。

labels

string[]

用户定义的标签列表。

retryPolicy

RetryPolicy

事件的重试策略。 这可用于配置事件的最大传递尝试次数和生存时间。

响应

名称 类型 说明
201 Created

EventSubscription

EventSubscription 更新请求已接受。

Other Status Codes

错误响应:***

  • 400 错误请求。

  • 500 内部服务器错误。

示例

EventSubscriptions_UpdateForCustomTopic
EventSubscriptions_UpdateForCustomTopic_AzureFunctionDestination
EventSubscriptions_UpdateForCustomTopic_EventHubDestination
EventSubscriptions_UpdateForCustomTopic_HybridConnectionDestination
EventSubscriptions_UpdateForCustomTopic_ServiceBusQueueDestination
EventSubscriptions_UpdateForCustomTopic_ServiceBusTopicDestination
EventSubscriptions_UpdateForCustomTopic_StorageQueueDestination
EventSubscriptions_UpdateForCustomTopic_WebhookDestination
EventSubscriptions_UpdateForResource
EventSubscriptions_UpdateForResourceGroup
EventSubscriptions_UpdateForSubscription

EventSubscriptions_UpdateForCustomTopic

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "WebHook",
    "properties": {
      "endpointUrl": "https://requestb.in/15ksip71"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "endpointBaseUrl": "https://requestb.in/15ksip71"
      },
      "endpointType": "WebHook"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [
      "label1",
      "label2"
    ],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventgrid/topics/exampletopic2"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForCustomTopic_AzureFunctionDestination

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "AzureFunction",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Web/sites/ContosoSite/funtions/ContosoFunc"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": false,
    "subjectBeginsWith": "ExamplePrefix",
    "subjectEndsWith": "ExampleSuffix"
  },
  "deadLetterDestination": {
    "endpointType": "StorageBlob",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
      "blobContainerName": "contosocontainer"
    }
  }
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Web/sites/ContosoSite/funtions/ContosoFunc"
      },
      "endpointType": "AzureFunction"
    },
    "filter": {
      "isSubjectCaseSensitive": false,
      "subjectBeginsWith": "ExamplePrefix",
      "subjectEndsWith": "ExampleSuffix"
    },
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1",
    "provisioningState": "Creating",
    "labels": null,
    "deadLetterDestination": {
      "endpointType": "StorageBlob",
      "properties": {
        "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
        "blobContainerName": "contosocontainer"
      }
    }
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForCustomTopic_EventHubDestination

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "EventHub",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace/eventhubs/EH1"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace/eventhubs/EH1"
      },
      "endpointType": "EventHub"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [
      "label1",
      "label2"
    ],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventgrid/topics/exampletopic2"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForCustomTopic_HybridConnectionDestination

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "HybridConnection",
    "properties": {
      "resourceId": "/subscriptions/d33c5f7a-02ea-40f4-bf52-07f17e84d6a8/resourceGroups/TestRG/providers/Microsoft.Relay/namespaces/ContosoNamespace/hybridConnections/HC1"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "resourceId": "/subscriptions/d33c5f7a-02ea-40f4-bf52-07f17e84d6a8/resourceGroups/TestRG/providers/Microsoft.Relay/namespaces/ContosoNamespace/hybridConnections/HC1"
      },
      "endpointType": "HybridConnection"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [
      "label1",
      "label2"
    ],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventgrid/topics/exampletopic2"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForCustomTopic_ServiceBusQueueDestination

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "ServiceBusQueue",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ContosoNamespace/queues/SBQ"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": false,
    "subjectBeginsWith": "ExamplePrefix",
    "subjectEndsWith": "ExampleSuffix"
  },
  "deadLetterDestination": {
    "endpointType": "StorageBlob",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
      "blobContainerName": "contosocontainer"
    }
  }
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ContosoNamespace/queues/SBQ"
      },
      "endpointType": "ServiceBusQueue"
    },
    "filter": {
      "isSubjectCaseSensitive": false,
      "subjectBeginsWith": "ExamplePrefix",
      "subjectEndsWith": "ExampleSuffix"
    },
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1",
    "provisioningState": "Creating",
    "labels": null,
    "deadLetterDestination": {
      "endpointType": "StorageBlob",
      "properties": {
        "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
        "blobContainerName": "contosocontainer"
      }
    }
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForCustomTopic_ServiceBusTopicDestination

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "ServiceBusTopic",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ContosoNamespace/topics/SBT"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ContosoNamespace/topics/SBT"
      },
      "endpointType": "ServiceBusTopic"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [
      "label1",
      "label2"
    ],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventgrid/topics/exampletopic2"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForCustomTopic_StorageQueueDestination

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "StorageQueue",
    "properties": {
      "resourceId": "/subscriptions/d33c5f7a-02ea-40f4-bf52-07f17e84d6a8/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
      "queueName": "queue1",
      "queueMessageTimeToLiveInSeconds": 300
    }
  },
  "filter": {
    "isSubjectCaseSensitive": false,
    "subjectBeginsWith": "ExamplePrefix",
    "subjectEndsWith": "ExampleSuffix"
  },
  "deadLetterDestination": {
    "endpointType": "StorageBlob",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
      "blobContainerName": "contosocontainer"
    }
  }
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "resourceId": "/subscriptions/d33c5f7a-02ea-40f4-bf52-07f17e84d6a8/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
        "queueName": "queue1",
        "queueMessageTimeToLiveInSeconds": 300
      },
      "endpointType": "StorageQueue"
    },
    "filter": {
      "isSubjectCaseSensitive": false,
      "subjectBeginsWith": "ExamplePrefix",
      "subjectEndsWith": "ExampleSuffix"
    },
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1",
    "provisioningState": "Creating",
    "labels": null,
    "deadLetterDestination": {
      "endpointType": "StorageBlob",
      "properties": {
        "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/contosostg",
        "blobContainerName": "contosocontainer"
      }
    }
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForCustomTopic_WebhookDestination

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "WebHook",
    "properties": {
      "endpointUrl": "https://requestb.in/15ksip71"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "endpointBaseUrl": "https://requestb.in/15ksip71"
      },
      "endpointType": "WebHook"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [
      "label1",
      "label2"
    ],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventgrid/topics/exampletopic2"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForResource

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventHub/namespaces/examplenamespace1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1?api-version=2022-06-15

{
  "destination": {
    "endpointType": "WebHook",
    "properties": {
      "endpointUrl": "https://requestb.in/15ksip71"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "endpointBaseUrl": "https://requestb.in/15ksip71"
      },
      "endpointType": "WebHook"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventHub/namespaces/examplenamespace1"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventHub/namespaces/examplenamespace1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription1",
  "name": "examplesubscription1",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForResourceGroup

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription2?api-version=2022-06-15

{
  "destination": {
    "endpointType": "EventHub",
    "properties": {
      "resourceId": "/subscriptions/55f3dcd4-cac7-43b4-990b-a139d62a1eb2/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/ContosoNamespace/eventhubs/EH1"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "endpointBaseUrl": "https://requestb.in/15ksip71"
      },
      "endpointType": "WebHook"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription2",
  "name": "examplesubscription2",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

EventSubscriptions_UpdateForSubscription

示例请求

PATCH https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription3?api-version=2022-06-15

{
  "destination": {
    "endpointType": "WebHook",
    "properties": {
      "endpointUrl": "https://requestb.in/15ksip71"
    }
  },
  "filter": {
    "isSubjectCaseSensitive": true,
    "subjectBeginsWith": "existingPrefix",
    "subjectEndsWith": "newSuffix"
  },
  "labels": [
    "label1",
    "label2"
  ]
}

示例响应

{
  "properties": {
    "destination": {
      "properties": {
        "endpointBaseUrl": "https://requestb.in/15ksip71"
      },
      "endpointType": "WebHook"
    },
    "filter": {
      "isSubjectCaseSensitive": true,
      "subjectBeginsWith": "existingPrefix",
      "subjectEndsWith": "newSuffix"
    },
    "labels": [],
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.EventGrid/topics/exampletopic2/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription3",
  "name": "examplesubscription3",
  "type": "Microsoft.EventGrid/eventSubscriptions"
}

定义

名称 说明
AzureFunctionEventSubscriptionDestination

有关事件订阅的 Azure 函数目标的信息。

BoolEqualsAdvancedFilter

BoolEquals 高级筛选器。

createdByType

创建资源的标识类型。

DeadLetterWithResourceIdentity

有关具有资源标识的死信目标的信息。

DeliveryWithResourceIdentity

有关使用资源标识的事件订阅传递的信息。

DynamicDeliveryAttributeMapping

动态传递属性映射详细信息。

EventDeliverySchema

事件订阅的事件传递架构。

EventHubEventSubscriptionDestination

有关事件订阅的事件中心目标的信息。

EventSubscription

事件订阅

EventSubscriptionFilter

事件订阅的筛选器。

EventSubscriptionIdentity

事件订阅的标识信息。

EventSubscriptionIdentityType

使用的托管标识的类型。 类型“SystemAssigned,UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除任何标识。

EventSubscriptionProvisioningState

事件订阅的预配状态。

EventSubscriptionUpdateParameters

事件订阅更新的属性。

HybridConnectionEventSubscriptionDestination

有关事件订阅的 HybridConnection 目标的信息。

IsNotNullAdvancedFilter

IsNotNull 高级筛选器。

IsNullOrUndefinedAdvancedFilter

IsNullOrUndefined 高级筛选器。

NumberGreaterThanAdvancedFilter

NumberGreaterThan 高级筛选器。

NumberGreaterThanOrEqualsAdvancedFilter

NumberGreaterThanOrEquals 高级筛选器。

NumberInAdvancedFilter

NumberIn 高级筛选器。

NumberInRangeAdvancedFilter

NumberInRange 高级筛选器。

NumberLessThanAdvancedFilter

NumberLessThan 高级筛选器。

NumberLessThanOrEqualsAdvancedFilter

NumberLessThanOrEquals 高级筛选器。

NumberNotInAdvancedFilter

NumberNotIn 高级筛选器。

NumberNotInRangeAdvancedFilter

NumberNotInRange 高级筛选器。

RetryPolicy

有关事件订阅的重试策略的信息。

ServiceBusQueueEventSubscriptionDestination

有关事件订阅的服务总线目标的信息。

ServiceBusTopicEventSubscriptionDestination

有关事件订阅的服务总线主题目标的信息。

StaticDeliveryAttributeMapping

静态传递属性映射详细信息。

StorageBlobDeadLetterDestination

有关基于存储 Blob 的死信目标的信息。

StorageQueueEventSubscriptionDestination

有关事件订阅的存储队列目标的信息。

StringBeginsWithAdvancedFilter

StringBeginsWith 高级筛选器。

StringContainsAdvancedFilter

StringContains 高级筛选器。

StringEndsWithAdvancedFilter

StringEndsWith 高级筛选器。

StringInAdvancedFilter

StringIn 高级筛选器。

StringNotBeginsWithAdvancedFilter

StringNotBegins 使用高级筛选器。

StringNotContainsAdvancedFilter

StringNotContains 高级筛选器。

StringNotEndsWithAdvancedFilter

StringNotEnds 使用高级筛选器。

StringNotInAdvancedFilter

StringNotIn 高级筛选器。

systemData

与资源的创建和上次修改相关的元数据。

WebHookEventSubscriptionDestination

有关事件订阅的 Webhook 目标的信息。

AzureFunctionEventSubscriptionDestination

有关事件订阅的 Azure 函数目标的信息。

名称 类型 默认值 说明
endpointType string:

AzureFunction

事件订阅目标的终结点的类型。

properties.deliveryAttributeMappings DeliveryAttributeMapping[]:

传递属性详细信息。

properties.maxEventsPerBatch

integer

1

每个批处理的最大事件数。

properties.preferredBatchSizeInKilobytes

integer

64

首选批大小(以千字节为单位)。

properties.resourceId

string

表示事件订阅的 Azure 函数目标的终结点的 Azure 资源 ID。

BoolEqualsAdvancedFilter

BoolEquals 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

BoolEquals

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

value

boolean

布尔筛选器值。

createdByType

创建资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

DeadLetterWithResourceIdentity

有关具有资源标识的死信目标的信息。

名称 类型 说明
deadLetterDestination DeadLetterDestination:

StorageBlobDeadLetterDestination

有关事件订阅必须传递事件的目标的信息。 使用父资源上的托管标识设置 (主题或域) 来获取在传递/死信期间使用的身份验证令牌。

identity

EventSubscriptionIdentity

死信事件时要使用的标识。

DeliveryWithResourceIdentity

有关使用资源标识的事件订阅传递的信息。

名称 类型 说明
destination EventSubscriptionDestination:

有关事件订阅必须传递事件的目标的信息。 使用Azure 事件网格标识来获取传递/死信期间使用的身份验证令牌。

identity

EventSubscriptionIdentity

传递事件时要使用的标识。

DynamicDeliveryAttributeMapping

动态传递属性映射详细信息。

名称 类型 说明
name

string

传递属性或标头的名称。

properties.sourceField

string

包含属性值的事件中的 JSON 路径。

type string:

Dynamic

传递属性或标头名称的类型。

EventDeliverySchema

事件订阅的事件传递架构。

名称 类型 说明
CloudEventSchemaV1_0

string

CustomInputSchema

string

EventGridSchema

string

EventHubEventSubscriptionDestination

有关事件订阅的事件中心目标的信息。

名称 类型 说明
endpointType string:

EventHub

事件订阅目标的终结点的类型。

properties.deliveryAttributeMappings DeliveryAttributeMapping[]:

传递属性详细信息。

properties.resourceId

string

表示事件订阅的事件中心目标的终结点的 Azure 资源 ID。

EventSubscription

事件订阅

名称 类型 默认值 说明
id

string

资源的完全限定标识符。

name

string

资源的名称。

properties.deadLetterDestination DeadLetterDestination:

StorageBlobDeadLetterDestination

事件订阅的死信目标。 无法传递到其目标的任何事件都将发送到死信目标。 使用Azure 事件网格标识来获取传递/死信期间使用的身份验证令牌。

properties.deadLetterWithResourceIdentity

DeadLetterWithResourceIdentity

事件订阅的死信目标。 无法传递到其目标的任何事件都将发送到死信目标。 使用父资源上的托管标识设置 (主题或域) 来获取在传递/死信期间使用的身份验证令牌。

properties.deliveryWithResourceIdentity

DeliveryWithResourceIdentity

有关事件订阅必须传递事件的目标的信息。 使用父资源上的托管标识设置 (主题或域) 来获取在传递/死信期间使用的身份验证令牌。

properties.destination EventSubscriptionDestination:

有关事件订阅必须传递事件的目标的信息。 使用Azure 事件网格标识来获取传递/死信期间使用的身份验证令牌。

properties.eventDeliverySchema

EventDeliverySchema

EventGridSchema

事件订阅的事件传递架构。

properties.expirationTimeUtc

string

事件订阅的过期时间。

properties.filter

EventSubscriptionFilter

有关事件订阅的筛选器的信息。

properties.labels

string[]

用户定义的标签列表。

properties.provisioningState

EventSubscriptionProvisioningState

事件订阅的预配状态。

properties.retryPolicy

RetryPolicy

事件的重试策略。 这可用于配置事件的最大传递尝试次数和生存时间。

properties.topic

string

事件订阅的主题的名称。

systemData

systemData

与事件订阅资源相关的系统元数据。

type

string

资源的类型。

EventSubscriptionFilter

事件订阅的筛选器。

名称 类型 默认值 说明
advancedFilters AdvancedFilter[]:

用于筛选事件订阅的高级筛选器数组。

enableAdvancedFilteringOnArrays

boolean

允许根据值数组计算高级筛选器,而不是期望单数值。

includedEventTypes

string[]

需要属于事件订阅的适用事件类型的列表。 如果需要订阅所有默认事件类型,请将 IncludedEventTypes 设置为 null。

isSubjectCaseSensitive

boolean

False

指定是否应以区分大小写的方式比较筛选器的 SubjectBeginsWith 和 SubjectEndsWith 属性。

subjectBeginsWith

string

一个可选字符串,用于根据资源路径前缀筛选事件订阅的事件。 其格式取决于事件的发布者。 此路径不支持通配符。

subjectEndsWith

string

一个可选字符串,用于根据资源路径后缀筛选事件订阅的事件。 此路径不支持通配符。

EventSubscriptionIdentity

事件订阅的标识信息。

名称 类型 说明
type

EventSubscriptionIdentityType

使用的托管标识的类型。 类型“SystemAssigned,UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除任何标识。

userAssignedIdentity

string

与资源关联的用户标识。

EventSubscriptionIdentityType

使用的托管标识的类型。 类型“SystemAssigned,UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除任何标识。

名称 类型 说明
SystemAssigned

string

UserAssigned

string

EventSubscriptionProvisioningState

事件订阅的预配状态。

名称 类型 说明
AwaitingManualAction

string

Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

EventSubscriptionUpdateParameters

事件订阅更新的属性。

名称 类型 说明
deadLetterDestination DeadLetterDestination:

StorageBlobDeadLetterDestination

事件订阅的死信目标。 无法传递到其目标的任何事件都将发送到死信目标。 使用Azure 事件网格标识来获取传递/死信期间使用的身份验证令牌。

deadLetterWithResourceIdentity

DeadLetterWithResourceIdentity

事件订阅的死信目标。 无法传递到其目标的任何事件都将发送到死信目标。 使用父资源 (主题/域) 上的托管标识设置来获取在传递/死信期间使用的身份验证令牌。

deliveryWithResourceIdentity

DeliveryWithResourceIdentity

有关事件订阅必须传递事件的目标的信息。 使用父资源 (主题/域) 上的托管标识设置来获取在传递/死信期间使用的身份验证令牌。

destination EventSubscriptionDestination:

有关事件订阅必须传递事件的目标的信息。 使用Azure 事件网格标识来获取传递/死信期间使用的身份验证令牌。

eventDeliverySchema

EventDeliverySchema

事件订阅的事件传递架构。

expirationTimeUtc

string

有关事件订阅的过期时间的信息。

filter

EventSubscriptionFilter

有关事件订阅的筛选器的信息。

labels

string[]

用户定义的标签列表。

retryPolicy

RetryPolicy

事件的重试策略。 这可用于配置事件的最大传递尝试次数和生存时间。

HybridConnectionEventSubscriptionDestination

有关事件订阅的 HybridConnection 目标的信息。

名称 类型 说明
endpointType string:

HybridConnection

事件订阅目标的终结点的类型。

properties.deliveryAttributeMappings DeliveryAttributeMapping[]:

传递属性详细信息。

properties.resourceId

string

作为事件订阅目标的混合连接的 Azure 资源 ID。

IsNotNullAdvancedFilter

IsNotNull 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

IsNotNull

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

IsNullOrUndefinedAdvancedFilter

IsNullOrUndefined 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

IsNullOrUndefined

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

NumberGreaterThanAdvancedFilter

NumberGreaterThan 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberGreaterThan

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

value

number

筛选器值。

NumberGreaterThanOrEqualsAdvancedFilter

NumberGreaterThanOrEquals 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberGreaterThanOrEquals

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

value

number

筛选器值。

NumberInAdvancedFilter

NumberIn 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberIn

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

number[]

筛选器值集。

NumberInRangeAdvancedFilter

NumberInRange 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberInRange

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

number[]

筛选器值集。

NumberLessThanAdvancedFilter

NumberLessThan 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberLessThan

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

value

number

筛选器值。

NumberLessThanOrEqualsAdvancedFilter

NumberLessThanOrEquals 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberLessThanOrEquals

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

value

number

筛选器值。

NumberNotInAdvancedFilter

NumberNotIn 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberNotIn

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

number[]

筛选器值集。

NumberNotInRangeAdvancedFilter

NumberNotInRange 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

NumberNotInRange

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

number[]

筛选器值集。

RetryPolicy

有关事件订阅的重试策略的信息。

名称 类型 默认值 说明
eventTimeToLiveInMinutes

integer

1440

活动) 的生存时间 (以分钟为单位。

maxDeliveryAttempts

integer

30

事件的最大传递重试次数。

ServiceBusQueueEventSubscriptionDestination

有关事件订阅的服务总线目标的信息。

名称 类型 说明
endpointType string:

ServiceBusQueue

事件订阅目标的终结点的类型。

properties.deliveryAttributeMappings DeliveryAttributeMapping[]:

传递属性详细信息。

properties.resourceId

string

Azure 资源 ID,表示事件订阅的服务总线目标的终结点。

ServiceBusTopicEventSubscriptionDestination

有关事件订阅的服务总线主题目标的信息。

名称 类型 说明
endpointType string:

ServiceBusTopic

事件订阅目标的终结点的类型。

properties.deliveryAttributeMappings DeliveryAttributeMapping[]:

传递属性详细信息。

properties.resourceId

string

表示事件订阅的服务总线主题目标的终结点的 Azure 资源 ID。

StaticDeliveryAttributeMapping

静态传递属性映射详细信息。

名称 类型 默认值 说明
name

string

传递属性或标头的名称。

properties.isSecret

boolean

False

用于指示属性是否包含敏感信息 的布尔标志。

properties.value

string

传递属性的值。

type string:

Static

传递属性或标头名称的类型。

StorageBlobDeadLetterDestination

有关基于存储 Blob 的死信目标的信息。

名称 类型 说明
endpointType string:

StorageBlob

死信目标的终结点的类型

properties.blobContainerName

string

存储 Blob 容器的名称,该容器是死信事件的目标

properties.resourceId

string

死信事件目标的存储帐户的 Azure 资源 ID

StorageQueueEventSubscriptionDestination

有关事件订阅的存储队列目标的信息。

名称 类型 说明
endpointType string:

StorageQueue

事件订阅目标的终结点的类型。

properties.queueMessageTimeToLiveInSeconds

integer

存储队列消息生存时间(以秒为单位)。

properties.queueName

string

作为事件订阅目标的存储帐户下的存储队列的名称。

properties.resourceId

string

存储帐户的 Azure 资源 ID,其中包含事件订阅的目标队列。

StringBeginsWithAdvancedFilter

StringBeginsWith 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringBeginsWith

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

StringContainsAdvancedFilter

StringContains 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringContains

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

StringEndsWithAdvancedFilter

StringEndsWith 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringEndsWith

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

StringInAdvancedFilter

StringIn 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringIn

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

StringNotBeginsWithAdvancedFilter

StringNotBegins 使用高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringNotBeginsWith

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

StringNotContainsAdvancedFilter

StringNotContains 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringNotContains

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

StringNotEndsWithAdvancedFilter

StringNotEnds 使用高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringNotEndsWith

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

StringNotInAdvancedFilter

StringNotIn 高级筛选器。

名称 类型 说明
key

string

要基于其进行筛选的事件中的字段/属性。

operatorType string:

StringNotIn

用于筛选的运算符类型,例如 NumberIn、StringContains、BoolEquals 等。

values

string[]

筛选器值集。

systemData

与资源的创建和上次修改相关的元数据。

名称 类型 说明
createdAt

string

资源的创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源上次修改的时间戳 (UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识类型。

WebHookEventSubscriptionDestination

有关事件订阅的 Webhook 目标的信息。

名称 类型 默认值 说明
endpointType string:

WebHook

事件订阅目标的终结点的类型。

properties.azureActiveDirectoryApplicationIdOrUri

string

Azure Active Directory 应用程序 ID 或 URI,用于获取访问令牌,该令牌将作为持有者令牌包含在传递请求中。

properties.azureActiveDirectoryTenantId

string

用于获取访问令牌的 Azure Active Directory 租户 ID,该令牌将作为持有者令牌包含在传递请求中。

properties.deliveryAttributeMappings DeliveryAttributeMapping[]:

传递属性详细信息。

properties.endpointBaseUrl

string

表示事件订阅目标的终结点的基 URL。

properties.endpointUrl

string

表示事件订阅目标终结点的 URL。

properties.maxEventsPerBatch

integer

1

每个批处理的最大事件数。

properties.preferredBatchSizeInKilobytes

integer

64

首选批大小(以千字节为单位)。