In diesem Artikel werden die spezifischen Event Grid-Ereignisse erläutert, die die Anforderung/Antwort-Sequenz für verschiedene Gridwich-Vorgänge bilden.
Gridwich-Ereignisse
Die Gridwich-Bestätigung und der Gridwich-Fehler unterscheiden sich von anderen Gridwich-Ereignissen. Dies gilt insbesondere in folgenden Fällen:
- Die Gridwich-Bestätigung gibt an, dass Gridwich die Anforderung aus einer Anforderung/Bestätigung/Antwort-Sequenz empfangen, aber noch nicht unbedingt verarbeitet hat.
- Jeder Vorgang verfügt über mindestens ein eindeutiges Erfolgsereignis. Fast alle Vorgänge verwenden hingegen dasselbe Gridwich-Fehlerereignis, um einen Fehler zu kommunizieren.
Codierungsereignisse
Initiieren eines neuen Codierauftrags
Beim unmittelbaren Antwortereignis der jeweiligen Encoder handelt es sich, abgesehen von einer Bestätigung, um das Ereignis Fehler oder Encoding dispatched (Codierung gesendet), das eine erfolgreiche Einreihung des Auftrags in die Warteschlange anzeigt. Die Benachrichtigungsereignisse zum Codierungsfortschritt geben den weiteren Fortschritt an.
Benachrichtigungen zum Codierungsfortschritt
Alle Encoder verwenden dieselben Fortschrittsbenachrichtigungen zum Ereignisstatus.
Blob- und Containerspeicherereignisse
Container
Blobs
Blobbenachrichtigungen
Speicherschlüssel
Vorgangskontext
Gridwich akzeptiert ein JSON-operationContext
-Objekt als Teil der Anforderungsnachrichten. Im Allgemeinen gibt Gridwich ein entsprechendes Objekt in Antwortnachrichten zurück und befasst sich nicht mit der genauen internen Struktur oder dem Inhalt des Kontextobjekts.
Die Ausnahme ist, dass das Antwortkontextobjekt im Vergleich zum Anforderungsgegenstück zusätzliche JSON-Eigenschaften aufweisen kann. Diese zusätzlichen Eigenschaften sind intern in Gridwich verfügbar, und ihre Namen beginnen immer mit einer Tilde ~. Die Anforderungseigenschaften sind immer im Antwortkontextobjekt vorhanden.
Wie im normalen JSON-Code können die Eigenschaften des Antwortobjekts in einer anderen Reihenfolge als im Anforderungsobjekt aufweisen.
Weitere Informationen zum Vorgangskontext finden Sie im Artikel zur Gridwich-Architektur unter Vorgangskontext.
Event Grid-Nachrichten
Weitere Informationen zum Anforderung/Antwort-Nachrichtenflow finden Sie unter Gridwich-Cloudmediensystem.
In den folgenden Ereignisbeschreibungen weisen die JSON-Eigenschaftswerte die üblichen Typen (Zeichenfolge, numerisch oder boolesch) auf. In den Beschreibungen werden die folgenden spezifischen Zeichenfolgeninhaltstypen verwendet. Wenn die Beschreibung die Bezeichnung „opak“ enthält, sind der Inhalt und das Format des Werts willkürlich.
GUID-string
, z. B."b621f33d-d01e-0002-7ae5-4008f006664e"
, ist ein 16-Byte-ID-Wert, der 36 Zeichen (32 Hexadezimalziffern und 4 Bindestriche) umfasst. Beachten Sie das Fehlen von geschweiften Klammern. Bei diesem Wert wird die Groß-/Kleinschreibung nicht beachtet. Dieses Format entspricht dem Ergebnis von System.GUID.ToString("D").Topic-string
, z. B."/subscriptions/5edeadbe-ef64-4022-a3aa-133bfef1d7a2/resourceGroups/gws-shared-rg-sb/providers/Microsoft.EventGrid/topics/gws-gws-egt-sb"
, ist eine Zeichenfolge von opakem Inhalt.Subject-string
, z. B."/blobServices/default/containers/telestreamoutput/blobs/db08122195b66be71db9e54ae04c58df/503220533TAGHD23976fps16x990266772067587.mxf"
, ist eine Zeichenfolge von opakem Inhalt.EventType-string
, z. B."request.operation.requested"
, ist im Allgemeinen eine Zeichenfolge im Format{"request"|"response"}.operation[.qualifier]
.DataVersion-string
, z. B."1.0"
, ist ein Indikator für die Versionsverwaltung, anhand dessen Nachrichtenverarbeiter unterschiedliche Entwicklungen desselben Vorgangs unterscheiden. Für Gridwich ist dies ein Pflichtfeld. Die MethodeHandlesEvent
bestimmt, welche Versionen ein einzelner Event Grid-Handler verarbeiten kann.URL-string
ist eine absolute URL, die häufig auf Application Insights-Protokolle verweist. Diese Zeichenfolgen stellen aufgrund von Zielautorisierungsanforderungen in der Regel eine SAS-URL dar.StorageURL-string
ist eine absolute URL, die häufig auf eine Azure Storage Blob-Instanz oder einen Container verweist. Bei dieser Zeichenfolge handelt es sich normalerweise nicht um eine SAS-URL.StorageURL-SAS-string
ist eine absolute SAS-URL, die häufig auf eine Azure Storage Blob-Instanz oder einen Container verweist.OperationContextObject
, z. B.{ "prodID": 10, "dc": "abc" }
, ist ein beliebiges JSON-Objekt, das bei eingehenden Anforderungen akzeptiert und als Teil von Gridwich-Antwortereignissen zurückgegeben wird.Metadata-Dictionary
ist ein String-to-String-JSON-Objektwörterbuch, wobei die Name/Wert-Paare die Metadaten für Azure Storage Blob darstellen.Encoder-Context
ist ein opakes JSON-Objekt von Eigenschaften, die für einen bestimmten Encoder spezifisch sind.
Allgemeine Bestätigungsantwort von Gridwich
Für Nachrichten von Gridwich an den Anforderer wird ResponseAcknowledgeDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"eventType": "request.blob.metadata.create"
},
"eventType": "response.acknowledge"
}
Beim Zeichenfolgenwert von data.eventType
handelt es sich um die eventType
-Eigenschaft der obersten Ebene des Anforderungsereignisses. Für eine Blobanalyseanforderung lautet der Zeichenfolgenwert von data.eventType
beispielsweise request.blob.analysis.create
.
Allgemeine Fehlerantwort in Gridwich
Für Nachrichten von Gridwich an den Anforderer wird ResponseFailureDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"logEventId": 30001,
"logEventMessage": "the message text for eventId 30001",
"logRecordId": "GUID-string",
"logRecordUrl": "URL-string", // AppInsight URL to the logRecordId
"eventHandlerClassName": "string",
"handlerId": "GUID-string"
},
"eventType": "response.failure"
}
Das Fehlerereignis enthält nicht den ursprünglichen eventType
-Wert der Anforderung, sondern den Vorgangskontext und den Namen des Handlers, der die Anforderung verarbeitet hat. Die log*
-Eigenschaften beziehen sich auf die Probleminformationen, die von der konfigurierten Application Insights-Instanz erfasst wurden.
Bei einer begrenzten Anzahl von Vorgängen unterscheidet sich das Fehlerereignisobjekt erheblich von der vorangehenden Nachricht. Weitere Informationen finden Sie unter Rotieren von Speicherschlüsseln.
Der Anforderer fordert Gridwich zum Platzieren einiger Metadaten in einem Blob auf
Für Nachrichten vom Anforderer an Gridwich wird RequestBlobMetadataCreateDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"blobMetadata": <Metadata-Dictionary>
},
"eventType": "request.blob.metadata.create"
}
blobMetadata
ist ein Objekt von Eigenschaften mit Zeichenfolgenwerten, die alle Name/Wert-Paare der Metadaten des gewünschten Blobs darstellen.
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobMetadataSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"blobMetadata": <Metadata-Dictionary>
},
"eventType": "response.blob.metadata.success"
}
Wenn Sie später die aktuellen Metadaten für ein Blob abrufen möchten, finden Sie weitere Informationen unter der Anforderung Analysieren von Blobs.
Der Anforderer fordert Gridwich zum Analysieren eines Blobs mithilfe von MediaInfo auf
Für Nachrichten vom Anforderer an Gridwich wird RequestBlobAnalysisCreateDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"analyzerSpecificData": {
"mediaInfo": {
"commandLineOptions": {
"Complete": "1",
"Output": "JSON"
}
}
}
},
"eventType": "request.blob.analysis.create"
}
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobAnalysisSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"blobMetadata": <Metadata-Dictionary>,
"analysisResults": <Analysis-Result-Object>
},
"eventType": "response.blob.analysis.success"
}
Der Inhalt des analysisResults
-Objekts ist nicht angegeben. Im aktuellen Projekt handelt es sich um die MediaInfo-Ausgabe.
Der blobMetadata
-Wert ist ein String-to-String-Dictionary-Objekt für Eigenschaften mit Zeichenfolgenwerten, die alle Name/Wert-Paare der Metadaten des angegebenen Blobs darstellen.
Wie üblich bei Azure Storage müssen die Namen von Metadatenelementen die Benennungsregeln für C#-Bezeichner erfüllen. Weitere Informationen finden Sie im Artikel zur REST-API „SetBlobMetadata“ von Azure sowie in den Benennungsregeln für C#.
Der Anforderer fordert Gridwich zum Kopieren eines Blobs in ein neues Ziel auf
Für Nachrichten vom Anforderer an Gridwich wird RequestBlobCopyDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"sourceUri": "StorageURL-string",
"destinationUri": "StorageURL-string"
},
"eventType": "request.blob.copy"
}
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobCopyScheduledDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"sourceUri": "URL-string",
"blobMetadata": <Metadata-Dictionary>,
"destinationUri": "StorageURL-string"
},
"eventType": "response.blob.copy.scheduled"
}
Gridwich benachrichtigt den Anforderer über die Bloberstellung
Gridwich hätte den Blob aus einer beliebigen Quelle erstellen können, z. B. aus einem Kopierergebnis, einem Eingang ins Postfach oder einem Codierungsergebnis.
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobCreatedSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"blobMetadata": <Metadata-Dictionary>
},
"eventType": "response.blob.created.success"
}
Der Anforderer fordert Gridwich zur Löschung eines Blobs auf
Für Nachrichten vom Anforderer an Gridwich wird RequestBlobDeleteDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
},
"eventType": "request.blob.delete"
}
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobDeleteScheduledDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"blobMetadata": <Metadata-Dictionary>
},
"eventType": "response.blob.delete.scheduled"
}
Gridwich informiert den Anforderer über die Löschung des Blobs
Die Löschung des Blobs kann aus einer beliebigen Quelle erfolgen, z. B. einer expliziten Anforderung eines Anforderers oder einem Ergebnis interner Vorgänge.
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobDeleteSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string"
},
"eventType": "response.blob.delete.success"
}
Der Anforderer fordert Gridwich zur Rückgabe einer SAS-URL für Inhalte mit ablaufender Gültigkeit auf
Für Nachrichten vom Anforderer an Gridwich wird RequestBlobSasUrlCreateDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"secToLive": 1200
},
"eventType": "request.blob.sas-url.create"
}
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobSasUrlSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"sasUrl": "StorageURL-SAS-string"
},
"eventType": "response.blob.sas-url.success"
}
Der Anforderer fordert Gridwich zum Codieren über einen CloudPort-Workflow auf
Für Nachrichten vom Anforderer an Gridwich wird RequestCloudPortEncodeCreateDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"inputs": [
{"blobUri": "StorageURL-string" }
],
"outputContainer": "https://<storageaccountname>.blob.core.windows.net/<containername>/",
"workflowName": "TestWorkflow2",
"parameters": [ { "prop1": "value1" } ],
"secToLive": 18000
},
"eventType": "request.encode.cloudport.create",
}
Der Anforderer fordert Gridwich zum Codieren mit Flip auf
Für Nachrichten vom Anforderer an Gridwich wird RequestFlipEncodeCreateDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"inputs": [
{"blobUri": "StorageURL-string" }
],
"outputContainer": "StorageURL-string", // of the Storage container
"factoryName": "gws-dev-flip",
"profiles": "h264",
"parameters": [ { "prop1": "value1" } ],
"secToLive": 18000
},
"eventType": "request.encode.flip.create"
}
Beispiel für RequestFlipEncodeCreateDTO
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": { "progId": 1234 },
"inputs": [
{
"blobUri": "https://gws-sa1.blob.core.windows.net/Vid0001Container/input.mp4"
}
],
"outputContainer": "https://gws-sa22out.blob.core.windows.net/Out0004/",
"factoryName": "gws-dev-flip",
"profiles": "h264",
"parameters": [ { "someProperty1": "someValue1" } ],
"secToLive": 18000
},
"eventType": "request.encode.flip.create"
}
Allgemeine Anforderungsantwort der Gridwich-Encoder bei erfolgreichem Versand
Für Nachrichten von Gridwich an den Anforderer wird ResponseEncodeDispatchedDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"encoderContext": <EncoderContext>,
"workflowJobName": "CloudPort or Flip assigned job name for workflow instance."
},
"eventType": "response.encode.<encodername>.dispatched"
}
<encodername>
kann entweder cloudport
oder flip
sein.
Asynchrone Statusmeldungen der Gridwich-Encoder
Die Gridwich-Encoder generieren während der Codierung oder anschließend vier Arten von Ereignissen:
- Geplant
- Verarbeitung
- Erfolg
- Canceled
Tritt ein Fehler bei einer Codierungsanforderung auf, wird ein Gridwich-Fehlerereignis generiert.
Codierungsstatus: Geplant
Für Nachrichten von Gridwich an den Anforderer wird ResponseEncodeScheduledDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"encoderContext": <EncoderContext>,
"workflowJobName": "CloudPort or Flip assigned job name for workflow instance."
},
"eventType": "response.encode.<encodername>.scheduled"
}
Codierungsstatus: Verarbeitung
Für Nachrichten von Gridwich an den Anforderer wird ResponseEncodeProcessingDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"encoderContext": <EncoderContext>,
"workflowJobName": "CloudPort or Flip assigned job name for workflow instance.",
"currentStatus": "string",
"percentComplete": 50,
},
"eventType": "response.encode.<encodername>.processing"
}
Codierungsstatus: Erfolgreich
Für Nachrichten von Gridwich an den Anforderer wird ResponseEncodeSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,,
"encoderContext": <EncoderContext>,
"workflowJobName": "CloudPort or Flip assigned job name for workflow instance.",
"outputs":[
{ "blobUri": "StorageURL-string" }
]
},
"eventType": "response.encode.<encodername>.success"
}
Codierungsstatus: Abgebrochen
Für Nachrichten von Gridwich an den Anforderer wird ResponseEncodeCanceledDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"encoderContext": <EncoderContext>,
"workflowJobName": "CloudPort or Flip assigned job name for workflow instance."
},
"eventType": "response.encode.<encodername>.canceled"
}
Der Anforderer fordert Gridwich zum Ändern der Speicherebene eines Blobs auf
Für Nachrichten vom Anforderer an Gridwich wird RequestBlobTierChangeDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"accessTier": "string",
"rehydratePriority": "string"
},
"eventType": "request.blob.tier.change"
}
- Die Eigenschaft
accessTier
kannHot
,Cool
oderArchive
entsprechen. - Die Eigenschaft
rehydratePriority
kannStandard
oderHigh
entsprechen.
Für Nachrichten von Gridwich an den Anforderer wird ResponseBlobTierChangeSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"blobUri": "StorageURL-string",
"accessTier": "string",
"rehydratePriority": "string"
},
"eventType":"response.blob.tier.success"
}
Der Anforderer fordert Gridwich zum Erstellen eines Blobcontainers auf
Die Anforderung enthält das Speicherkonto und den Containernamen.
Für Nachrichten vom Anforderer an Gridwich wird RequestContainerCreateDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"storageAccountName": "string", // e.g. mySA1
"containerName": "string" // e.g. mycontainer
},
"eventType": "request.blob.container.create"
}
Für Nachrichten von Gridwich an den Anforderer wird ResponseContainerCreatedSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"storageAccountName": "string",
"containerName": "string"
},
"eventType": "response.blob.container.create.success"
}
Der Anforderer fordert Gridwich zum Löschen eines Blobcontainers auf
Die Anforderung enthält das Speicherkonto und den Containernamen.
Für Nachrichten vom Anforderer an Gridwich wird RequestContainerDeleteDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"storageAccountName": "string",
"containerName": "string"
},
"eventType": "request.blob.container.delete"
}
Für Nachrichten von Gridwich an den Anforderer wird ResponseContainerDeleteSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"storageAccountName": "string",
"containerName": "string"
},
"eventType": "response.blob.container.delete.success"
}
Der Anforderer fordert Gridwich zum Ändern des öffentlichen Zugriffs eines Containers auf
Die Anforderung enthält den Containernamen und einen Wert für accessType
, der Blob
, BlobContainer
oder None
entsprechen kann.
Für Nachrichten vom Anforderer an Gridwich wird RequestContainerAccessChangeDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"storageAccountName": "string",
"containerName": "string",
"accessType": "string"
},
"eventType": "request.blob.container.access.change"
}
Für Nachrichten von Gridwich an den Anforderer wird ResponseContainerAccessChangeSuccessDTO verwendet.
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"storageAccountName": "string",
"containerName": "string",
"accessType": "string"
},
"eventType": "response.blob.container.access.change.success"
}
Der Anforderer fordert Gridwich zum Rotieren zu einem neuen Speicherschlüssel auf
Die Rollkey
-Ereignisfamilie unterscheidet sich insofern von anderen Ereignissen in Gridwich, als dass die Anforderung zwar einen operationContext
-Wert akzeptiert, dieser aber in keinem der Antwortereignisse enthalten ist.
Fehlerereignisse weisen nicht den normalen Ereignistyp response.failure, sondern den Typwert response.rollkey.storage.failure
auf.
Die response.rollkey.storage.failure
-Fehlerereignisse:
- enthalten keine der normalen
log
-Dateneigenschaften von Fehlerereignisprotokollinformationen - enthalten eine zusätzliche Dateneigenschaft namens
error
, die einen Fehlermeldungstext enthält Andere Gridwich-Fehler enthalten diesen Text in derlogEventMessage
-Dateneigenschaft.
Diese Punkte geben den aktuellen Zustand der Azure-Logik-App wieder, die den RollKey-Vorgang ausführt. Die Definition der Logik-App befindet sich in der Terraform-Datei infrastructure/terraform/keyroller/main.tf.
keyName
entspricht hier dem Namen des Schlüssels, der von Azure Storage im keyName
definiert wird.
Nachricht vom Anforderer an Gridwich
{
"id": "GUID-string",
"topic": "Topic-string",
"subject": "Subject-string",
"dataVersion": "DataVersion-string",
"data": {
"operationContext": <OperationContextObject>,
"account": "storageAccountName",
"keyName": "key1"
},
"eventType": "request.rollkey.storage"
}
Nachricht von Gridwich an den Anforderer
Erfolg:
{ "id": "GUID-string", "topic": "Topic-string", "subject": "Subject-string", "dataVersion": "DataVersion-string", "data": { "account": "storageAccountName", "keyName": "key1" }, "eventType": "response.rollkey.storage.success" }
Fehler:
{ "id": "GUID-string", "topic": "Topic-string", "subject": "Subject-string", "dataVersion": "1.0", "data": { "account": "storageAccountName1", "keyName": "key1", "error": "error message text" }, "eventType": "response.rollkey.storage.failure" }
Fehlerergebnisse für diesen Vorgang sind nicht so vollständig wie normale Gridwich-Fehler.
Nächste Schritte
Produktdokumentation:
Microsoft Learn-Module: