Reject Cloud Events - Reject Cloud Events

Service:: Event Grid

API-versie:: 2024-06-01

Weiger een batch Cloud Events. Het antwoord bevat de set met geweigerde vergrendelingstokens, samen met andere mislukte vergrendelingstokens met de bijbehorende foutinformatie. Succesvol afgewezen evenementen worden als dode letter verzonden en kunnen niet meer worden ontvangen door een consument.

POST {endpoint}/topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:reject?api-version=2024-06-01

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string (uri)	De hostnaam van de naamruimte, bijvoorbeeld namespaceName1.westus-1.eventgrid.azure.net
eventSubscriptionName	path	True	string	Naam van gebeurtenisabonnement.
topicName	path	True	string	Naam onderwerp.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
lockTokens	True	string[]	Array van lock tokens.

Antwoorden

Name

Type

Description

200 OK

De aanvraag is voltooid.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Een onverwachte foutreactie.

Kopteksten

x-ms-error-code: string

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
https://eventgrid.azure.net/.default

Voorbeelden

Reject Cloud Event

Voorbeeldaanvraag

HTTP

POST myNamespaceName.westus-1.eventgrid.azure.net/topics/myTopic/eventsubscriptions/myEventSubscription:reject?api-version=2024-06-01

Voorbeeldrespons

Statuscode:: 200

{
  "failedLockTokens": [],
  "succeededLockTokens": [
    "CgMKATESCQoHdG9rZW4tMQ=="
  ]
}

Definities

Name	Description
Azure.Core.Foundations.Error	Het foutobject.
Azure.Core.Foundations.ErrorResponse	Een antwoord met foutdetails.
Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie over de fout. Volgens de Azure REST API-richtlijnen - . https://aka.ms/AzureRestApiGuidelines#handling-errors
FailedLockToken	Mislukte LockToken-informatie.
RejectResult	Het resultaat van de bewerking Afwijzen.

Azure.Core.Foundations.Error

Object

Het foutobject.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	Azure.Core.Foundations.Error[]	Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout.
innererror	Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie dan het huidige object over de fout.
message	string	Een leesbare weergave van de fout.
target	string	Het doel van de fout.

Azure.Core.Foundations.ErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	Azure.Core.Foundations.Error	Het foutobject.

Azure.Core.Foundations.InnerError

Object

Een object met meer specifieke informatie over de fout. Volgens de Azure REST API-richtlijnen - . https://aka.ms/AzureRestApiGuidelines#handling-errors

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
innererror	Azure.Core.Foundations.InnerError	Interne fout.

FailedLockToken

Object

Mislukte LockToken-informatie.

Name	Type	Description
error	Azure.Core.Foundations.Error	Foutinformatie van het resultaat van de mislukte bewerking voor het vergrendelingstoken in de aanvraag.
lockToken	string	Het slottoken van een vermelding in de aanvraag.

RejectResult

Object

Het resultaat van de bewerking Afwijzen.

Name	Type	Description
failedLockTokens	FailedLockToken[]	Array van FailedLockToken voor mislukte cloudgebeurtenissen. Elke FailedLockToken bevat het vergrendelingstoken samen met de gerelateerde foutinformatie (namelijk de foutcode en beschrijving).
succeededLockTokens	string[]	Matrix met vergrendelingstokens voor de met succes afgewezen cloudgebeurtenissen.