Dynatrace
Dynatrace bietet eine erstklassige Observability über eine offene, KI-gestützte Plattform. Dieser Connector enthält die Endpunkte für die Dynatrace Problems-Schnittstelle.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Dynatrace-Unterstützung |
| URL | https://www.dynatrace.com/services-support/ |
| microsoftalliances@dynatrace.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Dynatrace |
| Webseite | https://www.dynatrace.com/ |
| Datenschutzrichtlinie | https://www.dynatrace.com/company/trust-center/privacy/ |
| Kategorien | Künstliche Intelligenz; Business Intelligence |
Dynatrace ist führend in der Cloud observability, mit KI und Automatisierung, um die Anwendungsleistung, Entwicklung, Sicherheit, Benutzererfahrung und vieles mehr zu überwachen und zu optimieren. Die Davis AI von Dynatrace liefert präzise Ursachenanalysen der komplexesten Probleme Ihrer Umgebung. Mithilfe des Dynatrace-Connectors können Sie die Erkenntnisse aus der Dynatrace-API "Probleme", "Sicherheitsprobleme", "Ereignisse" und "Metriken" nutzen, um Ihre Umgebungsdaten zu analysieren, um eine beliebige Anzahl von Aktionen mit den verfügbaren Connectors in der Microsoft-Bibliothek auszuführen. Erfahren Sie mehr über die APIs von Dynatrace hier.
Voraussetzungen
Sie benötigen folgendes, um den Connector zu verwenden:
Eine Dynatrace Software Intelligence Platform. Klicken Sie hier, um zu beginnen
Generieren Sie ein API-Zugriffstoken für die Dynatrace-Plattform mit den folgenden Bereichen:
- Lesen von Problemen
- Schreibprobleme
- Lesen von Ereignissen
- Erfassungsereignisse
- Lesezugriffe
- Lesen von Sicherheitsproblemen
Stellen Sie OneAgent mindestens für die Anwendung bereit. Hier gibt es Beispielanwendungen und Workshops zum Starten von Anwendungen mit Azure auf Ihrem Mandanten .
So erhalten Sie Anmeldeinformationen
- Sie benötigen einen Dynatrace-Mandanten und einen API-Schlüssel. Befolgen Sie die Anweisungen im Abschnitt "Voraussetzungen", um beide zu generieren.
Erste Schritte mit Ihrem Connector
- Erstellen einer PowerApps- oder PowerAutomate-Fluss- oder Logik-App
- Fügen Sie im Designerabschnitt dieser Objekte den Dynatrace Connector hinzu.
- Sie müssen Ihre Mandanten-URL und den API-Schlüssel eingeben, um mit der Verwendung des Connectors zu beginnen. Folgen Sie den obigen Anweisungen, um beide Elemente abzurufen.
- Die eingegebene Mandanten-URL sollte im Format vorliegen: abc123.dynatrace.com
- Der API-Schlüssel sollte in das Format eingegeben werden: Api-Token dt1234. ABCDEFGH
Bekannte Probleme und Einschränkungen
Ein Benutzer muss über einen Dynatrace-Mandanten verfügen, um diesen Connector verwenden zu können.
Häufige Fehler und Abhilfemaßnahmen
- Stellen Sie sicher, dass sich Ihr eingegebener Mandant im Format "abc123.dynatrace.com" befindet.
- Wenn Sie Auth-Fehler erhalten, stellen Sie sicher, dass Sie Ihren API-Schlüssel mit den oben aufgeführten richtigen Bereichen generiert haben.
Häufig gestellte Fragen
Wird aktualisiert, wenn Fragen gestellt werden.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| API-Schlüssel | securestring | Der API-Schlüssel für diese API (Api-Token dt1234. ABCDEFGH) | Richtig |
| Dynatrace-Mandant | Schnur | Die URL für Ihren Mandanten. (abc123.dynatrace.com) | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Ereignissen |
Listet Ereignisse innerhalb des angegebenen Zeitrahmens auf |
| Entität nach ID abrufen |
Ruft die Eigenschaften der angegebenen überwachten Entität ab. |
| Entitäten abrufen |
Ruft die Informationen zu überwachten Entites ab. |
| Post Event Ingest |
Nimmt ein benutzerdefiniertes Ereignis ein |
| Problem nach ID abrufen |
Ruft die Eigenschaften des angegebenen Problems ab. |
| Probleme abrufen |
Listet Probleme auf, die innerhalb des angegebenen Zeitrahmens beobachtet wurden. |
| Problemkommentar nach Problem-ID abrufen |
Ruft alle Kommentare zum angegebenen Problem ab. |
| Problemkommentar nach Problem-ID und Kommentar-ID abrufen |
Ruft den angegebenen Kommentar zu einem Problem ab. |
| Problemkommentar posten |
Fügt einen neuen Kommentar zum angegebenen Problem hinzu. |
| Sicherheitsprobleme erhalten |
Listet alle Sicherheitsprobleme auf |
| Sicherheitsprobleme nach ID abrufen |
Abrufen von Parametern für Sicherheitsprobleme |
Abrufen von Ereignissen
Listet Ereignisse innerhalb des angegebenen Zeitrahmens auf
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zeitfenster
|
from | string |
Der Anfang des angeforderten Zeitrahmens. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Warnungen
|
warnings | array of string |
Warnungen |
|
events
|
events | array of object |
Ereignisse |
|
underMaintenance
|
events.underMaintenance | boolean |
Unter Wartung |
|
suppressAlert
|
events.suppressAlert | boolean |
Benachrichtigung unterdrücken |
|
suppressProblem
|
events.suppressProblem | boolean |
Problem unterdrücken |
|
frequentEvent
|
events.frequentEvent | boolean |
Häufiges Ereignis |
|
Eigenschaften
|
events.properties | array of object |
Eigenschaften |
|
value
|
events.properties.value | string |
Eigenschaftswert |
|
key
|
events.properties.key | string |
Eigenschaftsschlüssel |
|
correlationId
|
events.correlationId | string |
Korrelations-ID |
|
status
|
events.status | string |
Der Status |
|
startTime
|
events.startTime | integer |
Startzeit |
|
endTime
|
events.endTime | integer |
Endzeit |
|
title
|
events.title | string |
Title |
|
eventType
|
events.eventType | string |
Ereignistyp |
|
managementZones
|
events.managementZones | array of object |
Verwaltungszonen |
|
name
|
events.managementZones.name | string |
Verwaltungszonenname |
|
id
|
events.managementZones.id | string |
Verwaltungszonen-ID |
|
eventId
|
events.eventId | string |
Ereignis-ID |
|
entityTags
|
events.entityTags | array of object |
Entitätstags |
|
stringRepresentation
|
events.entityTags.stringRepresentation | string |
Entitätstag-Zeichenfolgendarstellung |
|
value
|
events.entityTags.value | string |
Entitätstag-Wert |
|
key
|
events.entityTags.key | string |
Entity Tag Key |
|
context
|
events.entityTags.context | string |
Entity Tag Context |
|
id
|
events.entityId.entityId.id | string |
Entitäts-ID |
|
type
|
events.entityId.entityId.type | string |
Entitätstyp |
|
name
|
events.entityId.name | string |
Entitätsname |
|
nextPageKey
|
nextPageKey | string |
Nächster Seitenschlüssel |
|
totalCount
|
totalCount | integer |
Gesamtanzahl |
|
pageSize
|
pageSize | integer |
Seitenformat |
Entität nach ID abrufen
Ruft die Eigenschaften der angegebenen überwachten Entität ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Entitäts-ID
|
entityId | True | string |
Die ID der angegebenen überwachten Entität |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
entityId
|
entityId | string |
Entitäts-ID |
|
type
|
type | string |
Entitätstyp |
|
Anzeigename
|
displayName | string |
Anzeigename der Entität |
|
primaryIconType
|
icon.primaryIconType | string |
Primärer Symboltyp |
|
secondaryIconType
|
icon.secondaryIconType | string |
Sekundärer Symboltyp |
|
customIconPath
|
icon.customIconPath | string |
Benutzerdefinierter Symbolpfad |
|
firstSeenTms
|
firstSeenTms | integer |
Erste gesehene Zeiten |
|
lastSeenTms
|
lastSeenTms | integer |
Zuletzt gesehene Zeiten |
|
|
properties.bitness | string |
Bitanzahl |
|
monitoringMode
|
properties.monitoringMode | string |
Überwachungsmodus |
|
osType
|
properties.osType | string |
Betriebssystemtyp |
|
osArchitecture
|
properties.osArchitecture | string |
Betriebssystemarchitektur |
|
networkZoneId
|
properties.networkZoneId | string |
Netzwerkzonen-ID |
|
cpuCores
|
properties.cpuCores | integer |
CPU-Kerne |
|
ipAddress
|
properties.ipAddress | array of string |
IP-Adresse |
|
tags
|
tags | array of object |
Stichwörter |
|
context
|
tags.context | string |
Tagkontext |
|
key
|
tags.key | string |
Tag-Taste |
|
value
|
tags.value | string |
Tagwert |
|
stringRepresentation
|
tags.stringRepresentation | string |
Tagzeichenfolgendarstellung |
|
managementZones
|
managementZones | array of object |
Verwaltungszonen |
|
id
|
managementZones.id | string |
Verwaltungszonen-ID |
|
name
|
managementZones.name | string |
Verwaltungszonenname |
|
isInstanceOf
|
fromRelationships.isInstanceOf | array of object |
Ist Instanz von |
|
id
|
fromRelationships.isInstanceOf.id | string |
Ist Instanz der ID |
|
type
|
fromRelationships.isInstanceOf.type | string |
Ist Instanz des Typs |
|
isDiskOf
|
toRelationships.isDiskOf | array of object |
Ist Datenträger von |
|
id
|
toRelationships.isDiskOf.id | string |
Ist Datenträger der ID |
|
type
|
toRelationships.isDiskOf.type | string |
Ist Datenträger vom Typ |
Entitäten abrufen
Ruft die Informationen zu überwachten Entites ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Entitätsauswahl
|
entitySelector | True | string |
Definiert den Bereich der Abfrage. Nur Entitäten, die den angegebenen Kriterien entsprechen, werden in die Antwort einbezogen. |
|
Zeitbereich
|
from | string |
Der Anfang des angeforderten Zeitrahmens. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Gesamtanzahl |
|
pageSize
|
pageSize | integer |
Seitenformat |
|
nextPageKey
|
nextPageKey | string |
Nächster Seitenschlüssel |
|
Entitäten
|
entities | array of object |
Entitäten |
|
entityId
|
entities.entityId | string |
Entitäts-ID |
|
type
|
entities.type | string |
Entitätstyp |
|
Anzeigename
|
entities.displayName | string |
Anzeigename der Entität |
|
primaryIconType
|
entities.icon.primaryIconType | string |
Primärer Symboltyp |
|
secondaryIconType
|
entities.icon.secondaryIconType | string |
Sekundärer Symboltyp |
|
customIconPath
|
entities.icon.customIconPath | string |
Benutzerdefinierter Symbolpfad |
|
firstSeenTms
|
entities.firstSeenTms | integer |
Erste gesehene Zeiten |
|
lastSeenTms
|
entities.lastSeenTms | integer |
Zuletzt gesehene Zeiten |
|
Bitanzahl
|
entities.properties.bitness | integer |
Bitanzahl |
|
monitoringMode
|
entities.properties.monitoringMode | string |
Überwachungsmodus |
|
osType
|
entities.properties.osType | string |
Betriebssystemtyp |
|
osArchitecture
|
entities.properties.osArchitecture | string |
Betriebssystemarchitektur |
|
networkZoneId
|
entities.properties.networkZoneId | string |
Netzwerkzonen-ID |
|
cpuCores
|
entities.properties.cpuCores | integer |
CPU-Kerne |
|
tags
|
entities.tags | array of object |
Stichwörter |
|
context
|
entities.tags.context | string |
Tagkontext |
|
key
|
entities.tags.key | string |
Tag-Taste |
|
value
|
entities.tags.value | string |
Tagwert |
|
stringRepresentation
|
entities.tags.stringRepresentation | string |
Tagzeichenfolgendarstellung |
|
managementZones
|
entities.managementZones | array of object |
Verwaltungszonen |
|
id
|
entities.managementZones.id | string |
Verwaltungszonen-ID |
|
name
|
entities.managementZones.name | string |
Verwaltungszonenname |
|
isInstanceOf
|
entities.fromRelationships.isInstanceOf | array of object |
Ist Instanz von |
|
id
|
entities.fromRelationships.isInstanceOf.id | string |
Ist Instanz der ID |
|
type
|
entities.fromRelationships.isInstanceOf.type | string |
Ist Instanz des Typs |
|
isDiskOf
|
entities.toRelationships.isDiskOf | array of object |
Ist Datenträger von |
|
id
|
entities.toRelationships.isDiskOf.id | string |
Ist Datenträger der ID |
|
type
|
entities.toRelationships.isDiskOf.type | string |
Ist Datenträger vom Typ |
Post Event Ingest
Nimmt ein benutzerdefiniertes Ereignis ein
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
eventType
|
eventType | True | string |
Ereignistyp |
|
title
|
title | True | string |
Title |
|
startTime
|
startTime | string |
Startzeit |
|
|
endTime
|
endTime | string |
Endzeit |
|
|
timeout
|
timeout | integer |
Zeitlimit |
|
|
entitySelector
|
entitySelector | string |
Entitätsauswahl |
|
|
Eigenschaften
|
properties | object |
Eigenschaften |
Problem nach ID abrufen
Ruft die Eigenschaften des angegebenen Problems ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Problem-ID
|
problem_id | True | string |
Die ID des erforderlichen Problems |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
details
|
evidenceDetails.details | array of object |
Einzelheiten |
|
evidenceType (Beweis)
|
evidenceDetails.details.evidenceType | string |
Nachweistyp |
|
Anzeigename
|
evidenceDetails.details.displayName | string |
Anzeigename |
|
id
|
evidenceDetails.details.entity.entityId.id | string |
Nachweisentitäts-ID |
|
type
|
evidenceDetails.details.entity.entityId.type | string |
Beweisentitätstyp |
|
name
|
evidenceDetails.details.entity.name | string |
Name der Nachweisentität |
|
id
|
evidenceDetails.details.groupingEntity.entityId.id | string |
Gruppieren der Entitäts-ID |
|
type
|
evidenceDetails.details.groupingEntity.entityId.type | string |
Gruppieren des Entitätstyps |
|
name
|
evidenceDetails.details.groupingEntity.name | string |
Gruppierungsentitätsname |
|
rootCauseRelevant
|
evidenceDetails.details.rootCauseRelevant | boolean |
Ursache relevant |
|
startTime
|
evidenceDetails.details.startTime | integer |
Startzeit der Nachweisdetails |
|
totalCount
|
evidenceDetails.totalCount | integer |
Gesamtanzahl der Nachweisdetails |
|
comments
|
recentComments.comments | array of object |
Kommentare |
|
authorName
|
recentComments.comments.authorName | string |
Name des zuletzt verwendeten Kommentarautors |
|
createdAtTimestamp
|
recentComments.comments.createdAtTimestamp | integer |
Zuletzt erstellte Kommentare zum Zeitstempel |
|
context
|
recentComments.comments.context | string |
Kontext der zuletzt verwendeten Kommentare |
|
id
|
recentComments.comments.id | string |
Letzte Kommentar-ID |
|
Inhalt
|
recentComments.comments.content | string |
Aktueller Kommentarinhalt |
|
pageSize
|
recentComments.pageSize | integer |
Zuletzt verwendete Seitengröße für Kommentare |
|
nextPageKey
|
recentComments.nextPageKey | string |
Zuletzt verwendete Kommentare – Schlüssel der nächsten Seite |
|
totalCount
|
recentComments.totalCount | integer |
Gesamtzahl der zuletzt verwendeten Kommentare |
|
displayId
|
linkedProblemInfo.displayId | string |
Anzeige-ID des verknüpften Problems |
|
problemId
|
linkedProblemInfo.problemId | string |
Verknüpfte Problem-ID |
|
id
|
rootCauseEntity.entityId.id | string |
Entitäts-ID der Stammursache |
|
type
|
rootCauseEntity.entityId.type | string |
Entitätstyp der Stammursache |
|
name
|
rootCauseEntity.name | string |
Name der Stammursachenenentität |
|
impactedEntities
|
impactedEntities | array of object |
Betroffene Entitäten |
|
id
|
impactedEntities.entityId.id | string |
Betroffene Entitäts-ID |
|
type
|
impactedEntities.entityId.type | string |
Betroffener Entitätstyp |
|
name
|
impactedEntities.name | string |
Betroffener Entitätsname |
|
Aufschläge
|
impactAnalysis.impacts | array of object |
Aufschläge |
|
impactType
|
impactAnalysis.impacts.impactType | string |
Auswirkungstyp |
|
id
|
impactAnalysis.impacts.impactedEntity.entityId.id | string |
Betroffene Entitäts-ID |
|
type
|
impactAnalysis.impacts.impactedEntity.entityId.type | string |
Betroffener Entitätstyp |
|
name
|
impactAnalysis.impacts.impactedEntity.name | string |
Betroffener Entitätsname |
|
geschätzteAffectedUsers
|
impactAnalysis.impacts.estimatedAffectedUsers | integer |
Geschätzte betroffene Benutzer |
|
problemFilters
|
problemFilters | array of object |
Problemfilter |
|
name
|
problemFilters.name | string |
Problemfiltername |
|
id
|
problemFilters.id | string |
Problemfilter-ID |
|
impactLevel
|
impactLevel | string |
Auswirkungsebene |
|
displayId
|
displayId | string |
Anzeige-ID |
|
Betroffene Entities
|
affectedEntities | array of object |
Betroffene Entitäten |
|
id
|
affectedEntities.entityId.id | string |
Betroffene Entitäts-ID |
|
type
|
affectedEntities.entityId.type | string |
Betroffener Entitätstyp |
|
name
|
affectedEntities.name | string |
Betroffener Entitätsname |
|
managementZones
|
managementZones | array of object |
Verwaltungszonen |
|
name
|
managementZones.name | string |
Verwaltungszonenname |
|
id
|
managementZones.id | string |
Verwaltungszonen-ID |
|
severityLevel
|
severityLevel | string |
Schweregrad |
|
entityTags
|
entityTags | array of object |
Entitätstags |
|
stringRepresentation
|
entityTags.stringRepresentation | string |
Entitätstag-Zeichenfolgendarstellung |
|
value
|
entityTags.value | string |
Entitätstag-Wert |
|
key
|
entityTags.key | string |
Entity Tag Key |
|
context
|
entityTags.context | string |
Entity Tag Context |
|
problemId
|
problemId | string |
Problem-ID |
|
status
|
status | string |
Der Status |
|
startTime
|
startTime | integer |
Startzeit |
|
endTime
|
endTime | integer |
Endzeit |
|
title
|
title | string |
Title |
Probleme abrufen
Listet Probleme auf, die innerhalb des angegebenen Zeitrahmens beobachtet wurden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zeitbereich
|
from | string |
Bereich der Abfrage. Beispiel: 'now-1d' |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Gesamtanzahl |
|
pageSize
|
pageSize | integer |
Seitenformat |
|
nextPageKey
|
nextPageKey | string |
Nächster Seitenschlüssel |
|
Probleme
|
problems | array of object |
Probleme |
|
Betroffene Entities
|
problems.affectedEntities | array of object |
Betroffene Entitäten |
|
id
|
problems.affectedEntities.entityId.id | string |
Betroffene Entitäts-ID |
|
type
|
problems.affectedEntities.entityId.type | string |
Betroffener Entitätstyp |
|
name
|
problems.affectedEntities.name | string |
Betroffener Entitätsname |
|
displayId
|
problems.displayId | string |
Anzeige-ID |
|
impactedEntities
|
problems.impactedEntities | array of object |
Betroffene Entitäten |
|
id
|
problems.impactedEntities.entityId.id | string |
Betroffene Entitäts-ID |
|
type
|
problems.impactedEntities.entityId.type | string |
Betroffener Entitätstyp |
|
name
|
problems.impactedEntities.name | string |
Betroffener Entitätsname |
|
displayId
|
problems.linkedProblemInfo.displayId | string |
Anzeige-ID des verknüpften Problems |
|
problemId
|
problems.linkedProblemInfo.problemId | string |
Verknüpfte Problem-ID |
|
problemFilters
|
problems.problemFilters | array of object |
Problemfilter |
|
name
|
problems.problemFilters.name | string |
Problemfiltername |
|
id
|
problems.problemFilters.id | string |
Problemfilter-ID |
|
totalCount
|
problems.evidenceDetails.totalCount | integer |
Gesamtanzahl |
|
details
|
problems.evidenceDetails.details | array of object |
Einzelheiten |
|
evidenceType (Beweis)
|
problems.evidenceDetails.details.evidenceType | string |
Nachweistyp |
|
Anzeigename
|
problems.evidenceDetails.details.displayName | string |
Anzeigename |
|
id
|
problems.evidenceDetails.details.entity.entityId.id | string |
Nachweisdetails Entitäts-ID |
|
type
|
problems.evidenceDetails.details.entity.entityId.type | string |
Entitätstyp "Nachweisdetails" |
|
name
|
problems.evidenceDetails.details.entity.name | string |
Name der Entität "Nachweisdetails" |
|
id
|
problems.evidenceDetails.details.groupingEntity.entityId.id | string |
Gruppieren der Entitäts-ID |
|
type
|
problems.evidenceDetails.details.groupingEntity.entityId.type | string |
Gruppieren des Entitätstyps |
|
name
|
problems.evidenceDetails.details.groupingEntity.name | string |
Gruppierungsentitätsname |
|
rootCauseRelevant
|
problems.evidenceDetails.details.rootCauseRelevant | boolean |
Ursache relevant |
|
startTime
|
problems.evidenceDetails.details.startTime | integer |
Nachweisdetails StartTime |
|
comments
|
problems.recentComments.comments | array of object |
Kommentare |
|
createdAtTimestamp
|
problems.recentComments.comments.createdAtTimestamp | integer |
Kommentar zur Zeitstempel erstellt |
|
authorName
|
problems.recentComments.comments.authorName | string |
Name des Kommentarautors |
|
context
|
problems.recentComments.comments.context | string |
Kommentarkontext |
|
id
|
problems.recentComments.comments.id | string |
Kommentar-ID |
|
Inhalt
|
problems.recentComments.comments.content | string |
Kommentarinhalt |
|
pageSize
|
problems.recentComments.pageSize | integer |
PageSize |
|
nextPageKey
|
problems.recentComments.nextPageKey | string |
Nächster Seitenschlüssel |
|
totalCount
|
problems.recentComments.totalCount | integer |
Gesamtanzahl |
|
Aufschläge
|
problems.impactAnalysis.impacts | array of object |
Aufschläge |
|
impactType
|
problems.impactAnalysis.impacts.impactType | string |
Auswirkungstyp |
|
id
|
problems.impactAnalysis.impacts.impactedEntity.entityId.id | string |
Betroffene Entitäts-ID |
|
type
|
problems.impactAnalysis.impacts.impactedEntity.entityId.type | string |
Betroffener Entitätstyp |
|
name
|
problems.impactAnalysis.impacts.impactedEntity.name | string |
Betroffener Entitätsname |
|
geschätzteAffectedUsers
|
problems.impactAnalysis.impacts.estimatedAffectedUsers | integer |
Geschätzte betroffene Benutzer |
|
id
|
problems.rootCauseEntity.entityId.id | string |
Entitäts-ID der Stammursache |
|
type
|
problems.rootCauseEntity.entityId.type | string |
Ursachetyp der Stammursache |
|
name
|
problems.rootCauseEntity.name | string |
Name der Stammursachenenentität |
|
managementZones
|
problems.managementZones | array of object |
Verwaltungszonen |
|
name
|
problems.managementZones.name | string |
Verwaltungszonenname |
|
id
|
problems.managementZones.id | string |
Verwaltungszonen-ID |
|
severityLevel
|
problems.severityLevel | string |
Schweregrad |
|
entityTags
|
problems.entityTags | array of object |
Entitätstags |
|
stringRepresentation
|
problems.entityTags.stringRepresentation | string |
Entitätstag-Zeichenfolgendarstellung |
|
value
|
problems.entityTags.value | string |
Entitätstag-Wert |
|
key
|
problems.entityTags.key | string |
Entity Tag Key |
|
context
|
problems.entityTags.context | string |
Entity Tag Context |
|
problemId
|
problems.problemId | string |
Problem-ID |
|
impactLevel
|
problems.impactLevel | string |
Auswirkungsebene |
|
status
|
problems.status | string |
Der Status |
|
startTime
|
problems.startTime | integer |
Startzeit |
|
endTime
|
problems.endTime | integer |
Endzeit |
|
title
|
problems.title | string |
Title |
|
Warnungen
|
warnings | array of string |
Warnungen |
Problemkommentar nach Problem-ID abrufen
Ruft alle Kommentare zum angegebenen Problem ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Problem-ID
|
problemId | True | string |
Problem-ID |
Problemkommentar nach Problem-ID und Kommentar-ID abrufen
Ruft den angegebenen Kommentar zu einem Problem ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Problem-ID
|
problemId | True | string |
Die ID des erforderlichen Problems |
|
Kommentar-ID
|
commentId | True | string |
Die ID des erforderlichen Kommentars |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
id
|
id | string |
Kommentar-ID |
|
createdAtTimestamp
|
createdAtTimestamp | integer |
Beim Zeitstempel erstellt |
|
Inhalt
|
content | string |
Kommentarinhalt |
|
authorName
|
authorName | string |
Name des Kommentarautors |
Problemkommentar posten
Fügt einen neuen Kommentar zum angegebenen Problem hinzu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Problem-ID
|
problemId | True | string |
Problem-ID |
|
message
|
message | string |
Nachricht |
|
|
context
|
context | string |
Kontext |
Sicherheitsprobleme erhalten
Listet alle Sicherheitsprobleme auf
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Sicherheitsproblemauswahl
|
securityProblemSelector | string |
Definiert den Bereich der Abfrage. Nur Sicherheitsprobleme, die den angegebenen Kriterien entsprechen, sind in der Antwort enthalten. |
|
|
Zeitbereich
|
from | string |
Der Anfang des angeforderten Zeitrahmens |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Gesamtanzahl |
|
pageSize
|
pageSize | integer |
Seitenformat |
|
nextPageKey
|
nextPageKey | string |
Nächster Seitenschlüssel |
|
SecurityProblems
|
securityProblems | array of object |
Sicherheitsprobleme |
|
securityProblemId
|
securityProblems.securityProblemId | string |
Sicherheitsproblem-ID |
|
displayId
|
securityProblems.displayId | string |
Anzeige-ID |
|
status
|
securityProblems.status | string |
Der Status |
|
gedämpft
|
securityProblems.muted | boolean |
Gedämpft |
|
externalVulnerabilityId
|
securityProblems.externalVulnerabilityId | string |
ID für externe Sicherheitsrisiken |
|
vulnerabilityType
|
securityProblems.vulnerabilityType | string |
Sicherheitsrisikotyp |
|
title
|
securityProblems.title | string |
Title |
|
packageName
|
securityProblems.packageName | string |
Paketname |
|
URL
|
securityProblems.url | string |
URL |
|
Technologie
|
securityProblems.technology | string |
Technologie |
|
firstSeenTimestamp
|
securityProblems.firstSeenTimestamp | integer |
Erster Gesehener Zeitstempel |
|
lastUpdatedTimestamp
|
securityProblems.lastUpdatedTimestamp | integer |
Zeitstempel der letzten Aktualisierung |
|
riskLevel
|
securityProblems.riskAssessment.riskLevel | string |
Risikostufe |
|
riskScore
|
securityProblems.riskAssessment.riskScore | integer |
Risikobewertung |
|
riskVector
|
securityProblems.riskAssessment.riskVector | string |
Risikovektor |
|
baseRiskLevel
|
securityProblems.riskAssessment.baseRiskLevel | string |
Basisrisikostufe |
|
baseRiskScore
|
securityProblems.riskAssessment.baseRiskScore | integer |
Basisrisikobewertung |
|
baseRiskVector
|
securityProblems.riskAssessment.baseRiskVector | string |
Basisrisikovektor |
|
Belichtung
|
securityProblems.riskAssessment.exposure | string |
Exposition |
|
dataAssets
|
securityProblems.riskAssessment.dataAssets | string |
Datenressourcen |
|
publicExploit
|
securityProblems.riskAssessment.publicExploit | string |
Öffentlicher Exploit |
|
vulnerableFunctionUsage
|
securityProblems.riskAssessment.vulnerableFunctionUsage | string |
Verwendung anfälliger Funktionen |
|
managementZones
|
securityProblems.managementZones | array of object |
Verwaltungszonen |
|
name
|
securityProblems.managementZones.name | string |
Verwaltungszonenname |
|
id
|
securityProblems.managementZones.id | string |
Verwaltungszonen-ID |
|
cveIds
|
securityProblems.cveIds | array of string |
CVE-IDs |
Sicherheitsprobleme nach ID abrufen
Abrufen von Parametern für Sicherheitsprobleme
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Secuirty Problem-ID
|
id | True | string |
Die ID des angegebenen Sicherheitsproblems |
|
Felder
|
fields | string |
Eine Liste zusätzlicher Sicherheitsproblemeigenschaften, die Sie der Antwort hinzufügen können. Wenn Sie Eigenschaften hinzufügen möchten, geben Sie sie in einer durch Trennzeichen getrennten Liste an, und präfixieren Sie jede Eigenschaft mit einem Pluszeichen (z. B. +riskAssessment,+managementZones). |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
securityProblemId
|
securityProblemId | string |
Sicherheitsproblem-ID |
|
displayId
|
displayId | string |
Anzeige-ID |
|
status
|
status | string |
Der Status |
|
gedämpft
|
muted | boolean |
Gedämpft |
|
externalVulnerabilityId
|
externalVulnerabilityId | string |
ID für externe Sicherheitsrisiken |
|
vulnerabilityType
|
vulnerabilityType | string |
Sicherheitsrisikotyp |
|
title
|
title | string |
Title |
|
packageName
|
packageName | string |
Paketname |
|
URL
|
url | string |
URL |
|
Beschreibung
|
description | string |
Description |
|
Technologie
|
technology | string |
Technologie |
|
firstSeenTimestamp
|
firstSeenTimestamp | integer |
Erster Gesehener Zeitstempel |
|
lastUpdatedTimestamp
|
lastUpdatedTimestamp | integer |
Zeitstempel der letzten Aktualisierung |
|
riskLevel
|
riskAssessment.riskLevel | string |
Risikostufe |
|
|
riskAssessment.riskScore | float |
Risikobewertung |
|
riskVector
|
riskAssessment.riskVector | string |
Risikovektor |
|
baseRiskLevel
|
riskAssessment.baseRiskLevel | string |
Basisrisikostufe |
|
|
riskAssessment.baseRiskScore | float |
Basisrisikobewertung |
|
baseRiskVector
|
riskAssessment.baseRiskVector | string |
Basisrisikovektor |
|
Belichtung
|
riskAssessment.exposure | string |
Exposition |
|
dataAssets
|
riskAssessment.dataAssets | string |
Datenressourcen |
|
publicExploit
|
riskAssessment.publicExploit | string |
Öffentlicher Exploit |
|
vulnerableFunctionUsage
|
riskAssessment.vulnerableFunctionUsage | string |
Verwendung anfälliger Funktionen |
|
managementZones
|
managementZones | array of object |
Verwaltungszonen |
|
name
|
managementZones.name | string |
Verwaltungszonenname |
|
id
|
managementZones.id | string |
Zonen-ID für die Verwaltung |
|
cveIds
|
cveIds | array of string |
CVE-IDs |
|
events
|
events | array of object |
Ereignisse |
|
Zeitstempel
|
events.timestamp | integer |
Ereigniszeitstempel |
|
Grund
|
events.reason | string |
Ereignisgrund |
|
numberOfAffectedEntities
|
events.riskAssessmentSnapshot.numberOfAffectedEntities | integer |
Anzahl der betroffenen Entitäten |
|
numberOfReachableDataAssets
|
events.riskAssessmentSnapshot.numberOfReachableDataAssets | integer |
Anzahl der erreichbaren Datenressourcen |
|
publicExploit
|
events.riskAssessmentSnapshot.publicExploit | string |
Öffentlicher Exploit |
|
Belichtung
|
events.riskAssessmentSnapshot.exposure | string |
Exposition |
|
vulnerableFunctionUsage
|
events.riskAssessmentSnapshot.vulnerableFunctionUsage | string |
Verwendung anfälliger Funktionen |
|
user
|
events.muteState.user | string |
Statusbenutzer stummschalten |
|
Grund
|
events.muteState.reason | string |
Zustandsgrund stummschalten |
|
Kommentar
|
events.muteState.comment | string |
Statuskommentar stummschalten |
|
anfälligeComponents
|
vulnerableComponents | array of object |
Anfällige Komponenten |
|
id
|
vulnerableComponents.id | string |
ID anfälliger Komponenten |
|
Anzeigename
|
vulnerableComponents.displayName | string |
Anzeigename für anfällige Componenets |
|
fileName
|
vulnerableComponents.fileName | string |
Dateiname anfälliger Komponenten |
|
numberOfAffectedEntities
|
vulnerableComponents.numberOfAffectedEntities | integer |
Anfällige Komponenten Anzahl betroffener Entitäten |
|
Betroffene Entities
|
vulnerableComponents.affectedEntities | array of string |
Betroffene Entitäten |
|
Betroffene Entities
|
affectedEntities | array of string |
Betroffene Entitäten |
|
exposedEntities
|
exposedEntities | array of string |
Verfügbar gemachte Entitäten |
|
reachableDataAssets
|
reachableDataAssets | array of string |
Erreichbare Datenressourcen |
|
applications
|
relatedEntities.applications | array of object |
Anträge |
|
id
|
relatedEntities.applications.id | string |
Anwendungs-ID |
|
numberOfAffectedEntities
|
relatedEntities.applications.numberOfAffectedEntities | integer |
Anwendungsanzahl betroffener Entitäten |
|
Betroffene Entities
|
relatedEntities.applications.affectedEntities | array of string |
Betroffene Entitäten der Anwendung |
|
services
|
relatedEntities.services | array of object |
Dienste |
|
id
|
relatedEntities.services.id | string |
Dienst-ID |
|
numberOfAffectedEntities
|
relatedEntities.services.numberOfAffectedEntities | integer |
Dienstnummer der betroffenen Entitäten |
|
Betroffene Entities
|
relatedEntities.services.affectedEntities | array of string |
Betroffene Entitäten des Diensts |
|
Belichtung
|
relatedEntities.services.exposure | string |
Exposition |
|
hosts
|
relatedEntities.hosts | array of object |
Hosts |
|
id
|
relatedEntities.hosts.id | string |
Host-ID |
|
numberOfAffectedEntities
|
relatedEntities.hosts.numberOfAffectedEntities | integer |
Hostanzahl betroffener Entitäten |
|
Betroffene Entities
|
relatedEntities.hosts.affectedEntities | array of string |
Betroffene Entitäten hosten |
|
databases
|
relatedEntities.databases | array of string |
Datenbanken |
|
kubernetesWorkloads
|
relatedEntities.kubernetesWorkloads | array of object |
Kubernetes-Workloads |
|
id
|
relatedEntities.kubernetesWorkloads.id | string |
Kubernetes Workload-ID |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesWorkloads.numberOfAffectedEntities | integer |
Kubernetes-Workload Anzahl betroffener Entitäten |
|
Betroffene Entities
|
relatedEntities.kubernetesWorkloads.affectedEntities | array of string |
Kubernetes-Workload Betroffene Entitäten |
|
kubernetesClusters
|
relatedEntities.kubernetesClusters | array of object |
Kubernetes-Cluster |
|
id
|
relatedEntities.kubernetesClusters.id | string |
Kubernetes-Cluster-ID |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesClusters.numberOfAffectedEntities | integer |
Kubernetes Cluder Anzahl betroffener Entitäten |
|
Betroffene Entities
|
relatedEntities.kubernetesClusters.affectedEntities | array of string |
Kubernetes Cluster Betroffene Entitäten |
|
containerImages
|
relatedContainerImages.containerImages | array of object |
Containerimages |
|
imageId
|
relatedContainerImages.containerImages.imageId | string |
Zugehörige Containerimage-ID |
|
imageName
|
relatedContainerImages.containerImages.imageName | string |
Name des zugehörigen Containerimages |
|
numberOfAffectedEntities
|
relatedContainerImages.containerImages.numberOfAffectedEntities | integer |
Verknüpfte Containeranzahl betroffener Entitäten |
|
Betroffene Entities
|
relatedContainerImages.containerImages.affectedEntities | array of string |
Verwandte Container betroffene Entitäten |
|
muteStateChangeInProgress
|
muteStateChangeInProgress | boolean |
Statusänderung stummschalten |