Verwenden des Application Discovery Service API zum Abfragen erkannter Konfigurationselemente - AWS Application Discovery Service
Verwenden der DescribeConfigurations AktionDie ListConfigurations Aktion verwendenLetztendliche Datenkonsistenz

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden des Application Discovery Service API zum Abfragen erkannter Konfigurationselemente

Ein Konfigurationselement ist ein IT-Asset, das in Ihrem Rechenzentrum von einem Agenten oder durch einen Import erkannt wurde. Wenn Sie AWS Application Discovery Service (Application Discovery Service) verwenden, verwenden Sie den, API um Filter anzugeben und spezifische Konfigurationselemente für Server-, Anwendungs-, Prozess- und Verbindungsressourcen abzufragen. Weitere Informationen zu finden Sie API unter Application Discovery Service API Reference.

In den Tabellen in den folgenden Abschnitten sind die verfügbaren Eingabefilter und Ausgabesortieroptionen für zwei Application Discovery Service Service-Aktionen aufgeführt:

  • DescribeConfigurations

  • ListConfigurations

Die Filter- und Sortieroptionen sind nach dem Asset-Typ (Server, Anwendung, Prozess oder Verbindung) organisiert.

Wichtig

Die vonDescribeConfigurations,ListConfigurations, zurückgegebenen Ergebnisse enthalten StartExportTask möglicherweise keine aktuellen Aktualisierungen. Weitere Informationen finden Sie unter Eventuelle Konsistenz in der AWS Application Discovery Service API.

Verwenden der DescribeConfigurations Aktion

Die DescribeConfigurations Aktion ruft Attribute für eine IDs Konfigurationsliste ab. Alle angegebenen Daten IDs müssen für denselben Asset-Typ (Server, Anwendung, Prozess oder Verbindung) verwendet werden. Ausgabefelder sind für den gewählten Komponententyp spezifisch. Beispiel: Die Ausgabe für ein Server-Konfigurationselement enthält eine Liste von Attributen zum Server, z. B. den Host-Namen, das Betriebssystem und die Anzahl der Netzwerkkarten. Weitere Hinweise zur Befehlssyntax finden Sie unter DescribeConfigurations.

Die DescribeConfigurations-Aktion unterstützt keine Filterung.

Ausgabefelder für DescribeConfigurations

In den folgenden nach Asset-Typ geordneten Tabellen sind die unterstützten Ausgabefelder der DescribeConfigurations-Aktion aufgeführt. Zwingend erforderliche Felder sind immer in der Ausgabe vorhanden.

Serverressourcen

Feld zwingend erforderlich
server.agentId
server.applications
server.applications.hasMoreValues
server.configurationId x
server.cpuType
server.hostName
server.hypervisor
server.networkInterfaceInfo
server.networkInterfaceInfo.hasMoreValues
server.osName
server.osVersion
server.tags
server.tags.hasMoreValues
server.timeOfCreation x
server.type
server.performance.avgCpuUsagePct
server.performance.avgDiskReadIOPS
server.performance.avgDiskReadsPerSecondInKB
server.performance.avgDiskWriteIOPS
server.performance.avgDiskWritesPerSecondInKB
server.performance.avgFreeRAMInKB
server.performance.avgNetworkReadsPerSecondInKB
server.performance.avgNetworkWritesPerSecondInKB
server.performance.maxCpuUsagePct
server.performance.maxDiskReadIOPS
server.performance.maxDiskReadsPerSecondInKB
server.performance.maxDiskWriteIOPS
server.performance.maxDiskWritesPerSecondInKB
server.performance.maxNetworkReadsPerSecondInKB
server.performance.maxNetworkWritesPerSecondInKB
server.performance.minFreeRAMInKB
server.performance.numCores
server.performance.numCpus
server.performance.numDisks
server.performance.numNetworkCards
server.performance.totalRAMInKB

Verarbeitungs-Assets

Feld zwingend erforderlich
process.commandLine
process.configurationId x
process.name
process.path
process.timeOfCreation x

Anwendungs-Assets

Feld zwingend erforderlich
application.configurationId x
application.description
application.lastModifiedTime x
application.name x
application.serverCount x
application.timeOfCreation x

Die ListConfigurations Aktion verwenden

Die ListConfigurations-Aktion ruft eine Liste von Konfigurationselementen nach den Kriterien ab, die Sie in einem Filter angeben. Weitere Hinweise zur Befehlssyntax finden Sie unter ListConfigurations.

Ausgabefelder für ListConfigurations

In den folgenden nach Asset-Typ geordneten Tabellen sind die unterstützten Ausgabefelder der ListConfigurations-Aktion aufgeführt. Zwingend erforderliche Felder sind immer in der Ausgabe vorhanden.

Serverressourcen

Feld zwingend erforderlich
server.configurationId x
server.agentId
server.hostName
server.osName
server.osVersion
server.timeOfCreation x
server.type

Verarbeitungs-Assets

Feld zwingend erforderlich
process.commandLine
process.configurationId x
process.name
process.path
process.timeOfCreation x
server.agentId
server.configurationId x

Anwendungs-Assets

Feld zwingend erforderlich
application.configurationId x
application.description
application.name x
application.serverCount x
application.timeOfCreation x
application.lastModifiedTime x

Verbindungs-Assets

Feld zwingend erforderlich
connection.destinationIp x
connection.destinationPort x
connection.ipVersion x
connection.latestTimestamp x
connection.occurrence x
connection.sourceIp x
connection.transportProtocol
destinationProcess.configurationId
destinationProcess.name
destinationServer.configurationId
destinationServer.hostName
sourceProcess.configurationId
sourceProcess.name
sourceServer.configurationId
sourceServer.hostName
Unterstützte Filter für ListConfigurations

In den folgenden nach Asset-Typ geordneten Tabellen sind die unterstützten Filter für die ListConfigurations-Aktion aufgeführt. Filter und Werte befinden sich in einer Schlüssel-Wert-Beziehung, die durch eine der unterstützten logischen Bedingungen definiert ist. Sie können die Ausgabe der angegebenen Filter sortieren.

Serverressourcen

Filter

Unterstützte Bedingungen

Unterstützte Werte

Unterstützte Sortierung
server.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • Jede gültige Serverkonfigurations-ID

 None
server.hostName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
server.osName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
server.osVersion

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
server.agentId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • String

 None
server.connectorId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • String

 None
server.type

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

 String mit einem der folgenden Werte:

  • EC2

  • OTHER

  • VMWARE_VM

  • VMWARE_HOST

  • VMWARE_VM_ TEMPLATE

 None
server.vmWareInfo.morefId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.vmWareInfo.vcenterId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.vmWareInfo.hostId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.networkInterfaceInfo.portGroupId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.networkInterfaceInfo.portGroupName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.networkInterfaceInfo.virtualSwitchName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.networkInterfaceInfo.ipAddress

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.networkInterfaceInfo.macAddress

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.performance.avgCpuUsagePct

  • GE

  • LE

  • GT

  • LT

  • Prozentsatz

 None
server.performance.totalDiskFreeSizeInKB

  • GE

  • LE

  • GT

  • LT

  • Double

 None
server.performance.avgFreeRAMInKB

  • GE

  • LE

  • GT

  • LT

  • Double

 None
server.tag.value

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.tag.key

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.application.name

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.application.description

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None
server.application.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • Jede gültige Anwendungskonfigurations-ID

None
server.process.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ProcessId

None

server.process.name

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

None
server.process.commandLine

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

 None

Anwendungs-Assets

Filter

Unterstützte Bedingungen

Unterstützte Werte

Unterstützte Sortierung
application.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ApplicationId

 None
application.name

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
application.description

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
application.serverCount Filtern wird nicht unterstützt. Filtern wird nicht unterstützt.

  • ASC

  • DESC
application.timeOfCreation Filtern wird nicht unterstützt. Filtern wird nicht unterstützt.

  • ASC

  • DESC
application.lastModifiedTime Filtern wird nicht unterstützt. Filtern wird nicht unterstützt.

  • ASC

  • DESC
server.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ServerId

 None

Verarbeitungs-Assets

Filter

Unterstützte Bedingungen

Unterstützte Werte

Unterstützte Sortierung
process.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ProcessId

process.name

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
process.commandLine

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
server.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ServerId
server.hostName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
server.osName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
server.osVersion

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
server.agentId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

Verbindungs-Assets

Filter

Unterstützte Bedingungen

Unterstützte Werte

Unterstützte Sortierung
connection.sourceIp

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • IP

  • ASC

  • DESC
connection.destinationIp

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • IP

  • ASC

  • DESC
connection.destinationPort

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • Ganzzahl

  • ASC

  • DESC
sourceServer.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ServerId
sourceServer.hostName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
destinationServer.osName

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
destinationServer.osVersion

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
destinationServer.agentId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String
sourceProcess.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ProcessId
sourceProcess.name

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
sourceProcess.commandLine

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
destinationProcess.configurationId

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • ProcessId
destinationProcess.name

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC
destinationprocess.commandLine

  • EQUALS

  • NOT_EQUALS

  • EQ

  • NE

  • CONTAINS

  • NOT_CONTAINS

  • String

  • ASC

  • DESC

Eventuelle Konsistenz in der AWS Application Discovery Service API

Die folgenden Aktualisierungsvorgänge sind letztendlich konsistent. Aktualisierungen sind für die Lesevorgänge StartExportTaskDescribeConfigurations, und möglicherweise nicht sofort sichtbar ListConfigurations.

Vorschläge für die Verwaltung der eventuellen Konsistenz:

  • Wenn Sie die Lesevorgänge oder ListConfigurations(oder die entsprechenden AWS CLI Befehle) aufrufen StartExportTaskDescribeConfigurations, verwenden Sie einen exponentiellen Backoff-Algorithmus, damit alle vorherigen Aktualisierungsvorgänge genügend Zeit haben, um sich im System auszubreiten. Führen Sie dazu den Lesevorgang wiederholt aus, wobei Sie mit einer Wartezeit von zwei Sekunden beginnen und die Wartezeit schrittweise auf bis zu fünf Minuten erhöhen.

  • Verlängert die Wartezeit zwischen aufeinanderfolgenden Vorgängen, auch wenn ein Aktualisierungsvorgang die Antwort 200 — OK zurückgibt. Wenden Sie einen exponentiellen Backoff-Algorithmus an, der mit einer Wartezeit von einigen Sekunden beginnt, und erhöhen Sie die Wartezeit schrittweise auf etwa fünf Minuten.