Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo dell'Application Discovery Service API per interrogare gli elementi di configurazione rilevati
Un elemento di configurazione è una risorsa IT scoperta nel data center da un agente o tramite un'importazione. Quando si utilizza AWS Application Discovery Service (Application Discovery Service), si utilizza API per specificare filtri e interrogare elementi di configurazione specifici per server, applicazioni, processi e risorse di connessione. Per informazioni suAPI, vedere Application Discovery Service API Reference.
Le tabelle nelle seguenti sezioni elencano i filtri di input e le opzioni di ordinamento dell'output disponibili per due azioni di Application Discovery Service:
-
DescribeConfigurations -
ListConfigurations
Le opzioni di filtraggio e ordinamento sono organizzate in base al tipo di asset a cui si applica (server, applicazione, processo o connessione).
Importante
I risultati DescribeConfigurations restituiti ListConfigurations da e StartExportTask potrebbero non contenere aggiornamenti recenti. Per ulteriori informazioni, consulta Eventuale coerenza nel AWS Application Discovery Service API.
Utilizzo dell'DescribeConfigurationsazione
L'DescribeConfigurationsazione recupera gli attributi per un elenco di configurazioniIDs. Tutti i dati forniti IDs devono riguardare lo stesso tipo di risorsa (server, applicazione, processo o connessione). I campi di output sono specifici per il tipo di risorsa selezionato. Ad esempio, l'output per un elemento di configurazione di un server include un elenco di attributi relativi al server, come nome host, sistema operativo e numero di schede di rete. Per ulteriori informazioni sulla sintassi dei comandi, vedere DescribeConfigurations.
L'operazione DescribeConfigurations non supporta il filtraggio.
Campi di output per DescribeConfigurations
Nelle tabelle seguenti, organizzate per tipo di asset, sono elencati i campi di output supportati dell'operazione DescribeConfigurations. Quelli contrassegnati come obbligatori sono sempre presenti nell'output.
Asset del server
| Campo | Obbligatorio |
|---|---|
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 |
Asset di elaborazione
| Campo | Obbligatorio |
|---|---|
process.commandLine |
|
process.configurationId |
x |
process.name |
|
process.path |
|
process.timeOfCreation |
x |
Asset delle applicazioni
| Campo | Obbligatorio |
|---|---|
application.configurationId |
x |
application.description |
|
application.lastModifiedTime |
x |
application.name |
x |
application.serverCount |
x |
application.timeOfCreation |
x |
Utilizzo dell'azione ListConfigurations
L'operazione ListConfigurations recupera un elenco di elementi di configurazione in base ai criteri specificati in un filtro. Per ulteriori informazioni sulla sintassi dei comandi, vedere ListConfigurations.
Campi di output per ListConfigurations
Nelle tabelle seguenti, organizzate per tipo di asset, sono elencati i campi di output supportati dell'operazione ListConfigurations. Quelli contrassegnati come obbligatori sono sempre presenti nell'output.
Asset del server
| Campo | Obbligatorio |
|---|---|
server.configurationId |
x |
server.agentId |
|
server.hostName |
|
server.osName |
|
server.osVersion |
|
server.timeOfCreation |
x |
server.type |
Asset di elaborazione
| Campo | Obbligatorio |
|---|---|
process.commandLine |
|
process.configurationId |
x |
process.name |
|
process.path |
|
process.timeOfCreation |
x |
server.agentId |
|
server.configurationId |
x |
Asset delle applicazioni
| Campo | Obbligatorio |
|---|---|
application.configurationId |
x |
application.description |
|
application.name |
x |
application.serverCount |
x |
application.timeOfCreation |
x |
application.lastModifiedTime |
x |
Asset di connessione
| Campo | Obbligatorio |
|---|---|
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 |
Filtri supportati per ListConfigurations
Nelle tabelle seguenti, organizzate per tipo di asset, sono elencati i filtri supportati per l'operazione ListConfigurations. I filtri e i valori sono in una relazione chiave/valore definita da una delle condizioni logiche supportate. È possibile ordinare l'output dei filtri indicati.
Asset del server
|
Filtro |
Condizioni supportate |
Valori supportati |
Ordinamento supportato |
|---|---|---|---|
server.configurationId |
|
|
Nessuno |
server.hostName |
|
|
|
server.osName |
|
|
|
server.osVersion |
|
|
|
server.agentId |
|
|
Nessuno |
server.connectorId |
|
|
Nessuno |
server.type |
|
Stringa con uno dei seguenti valori:
|
Nessuno |
server.vmWareInfo.morefId |
|
|
Nessuno |
server.vmWareInfo.vcenterId |
|
|
Nessuno |
server.vmWareInfo.hostId |
|
|
Nessuno |
server.networkInterfaceInfo.portGroupId |
|
|
Nessuno |
server.networkInterfaceInfo.portGroupName |
|
|
Nessuno |
server.networkInterfaceInfo.virtualSwitchName |
|
|
Nessuno |
server.networkInterfaceInfo.ipAddress |
|
|
Nessuno |
server.networkInterfaceInfo.macAddress |
|
|
Nessuno |
server.performance.avgCpuUsagePct |
|
|
Nessuno |
server.performance.totalDiskFreeSizeInKB |
|
|
Nessuno |
server.performance.avgFreeRAMInKB |
|
|
Nessuno |
server.tag.value |
|
|
Nessuno |
server.tag.key |
|
|
Nessuno |
server.application.name |
|
|
Nessuno |
server.application.description |
|
|
Nessuno |
server.application.configurationId |
|
|
Nessuno |
server.process.configurationId |
|
|
Nessuno |
|
|
|
Nessuno |
server.process.commandLine |
|
|
Nessuno |
Asset delle applicazioni
|
Filtro |
Condizioni supportate |
Valori supportati |
Ordinamento supportato |
|---|---|---|---|
application.configurationId |
|
|
Nessuno |
application.name |
|
|
|
application.description |
|
|
|
application.serverCount |
Filtraggio non supportato. | Filtraggio non supportato. |
|
application.timeOfCreation |
Filtraggio non supportato. | Filtraggio non supportato. |
|
application.lastModifiedTime |
Filtraggio non supportato. | Filtraggio non supportato. |
|
server.configurationId |
|
|
Nessuno |
Asset di elaborazione
|
Filtro |
Condizioni supportate |
Valori supportati |
Ordinamento supportato |
|---|---|---|---|
process.configurationId |
|
|
|
process.name |
|
|
|
process.commandLine |
|
|
|
server.configurationId |
|
|
|
server.hostName |
|
|
|
server.osName |
|
|
|
server.osVersion |
|
|
|
server.agentId |
|
|
Asset di connessione
|
Filtro |
Condizioni supportate |
Valori supportati |
Ordinamento supportato |
|---|---|---|---|
connection.sourceIp |
|
|
|
connection.destinationIp |
|
|
|
connection.destinationPort |
|
|
|
sourceServer.configurationId |
|
|
|
sourceServer.hostName |
|
|
|
destinationServer.osName |
|
|
|
destinationServer.osVersion |
|
|
|
destinationServer.agentId |
|
|
|
sourceProcess.configurationId |
|
|
|
sourceProcess.name |
|
|
|
sourceProcess.commandLine |
|
|
|
destinationProcess.configurationId |
|
|
|
destinationProcess.name |
|
|
|
destinationprocess.commandLine |
|
|
|
Eventuale coerenza nel AWS Application Discovery Service API
Le seguenti operazioni di aggiornamento sono alla fine coerenti. Gli aggiornamenti potrebbero non essere immediatamente visibili alle operazioni di lettura StartExportTaskDescribeConfigurations, e ListConfigurations.
Suggerimenti per gestire l'eventuale coerenza:
-
Quando richiamate le operazioni di lettura o ListConfigurations(o i AWS CLI comandi corrispondenti) StartExportTaskDescribeConfigurations, utilizzate un algoritmo di backoff esponenziale per concedere tempo sufficiente per consentire a qualsiasi operazione di aggiornamento precedente di propagarsi nel sistema. A tale scopo, eseguite l'operazione di lettura ripetutamente, iniziando con un tempo di attesa di due secondi e aumentando gradualmente fino a cinque minuti di attesa.
-
Aggiunge il tempo di attesa tra le operazioni successive, anche se un'operazione di aggiornamento restituisce una risposta di 200 - OK. Applica un algoritmo di backoff esponenziale a partire da un paio di secondi di attesa e aumenta gradualmente fino a circa cinque minuti di attesa.
