Reject Cloud Events - Reject Cloud Events

Referencia

Szolgáltatás:: Event Grid

API-verzió:: 2023-11-01

A felhőesemények kötegének elvetése. A válasz tartalmazza a sikeresen elutasított zárolási jogkivonatok készletét, valamint a többi sikertelen zárolási jogkivonatot a hozzájuk tartozó hibainformációkkal együtt. A sikeresen elutasított események kézbesítetlenek lesznek, és a továbbiakban nem fogadhatók a fogyasztók.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A névtér gazdagépneve, például namespaceName1.westus-1.eventgrid.azure.net
eventSubscriptionName	path	True	string	Esemény-előfizetés neve.
topicName	path	True	string	Témakör neve.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
lockTokens	True	string[]	Zárolási jogkivonatok tömbje.

Válaszok

Name

Típus

Description

200 OK

A kérés sikeres volt.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

Reject Cloud Event

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 200

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

Definíciók

Name	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Microsoft One API irányelvei szerint – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
FailedLockToken	Sikertelen LockToken-információk.
RejectResult	Az Elutasítás művelet eredménye.

Azure.Core.Foundations.Error

Objektum

A hibaobjektum.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Objektum

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Objektum

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. A Microsoft One API irányelvei szerint – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

FailedLockToken

Objektum

Sikertelen LockToken-információk.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A kérelemben szereplő zárolási jogkivonat sikertelen művelet eredményének hibainformációi.
lockToken	string	A kérelemben szereplő bejegyzés zárolási jogkivonata.

RejectResult

Objektum

Az Elutasítás művelet eredménye.

Name	Típus	Description
failedLockTokens	FailedLockToken[]	A FailedLockToken tömbje sikertelen felhőeseményekhez. Minden FailedLockToken tartalmazza a zárolási jogkivonatot, valamint a kapcsolódó hibainformációkat (azaz a hibakódot és a leírást).
succeededLockTokens	string[]	A sikeresen elutasított felhőesemények zárolási jogkivonatainak tömbje.