---
title: "POST /list-applicationcomponents"
method: POST
path: "/list-applicationcomponents"
---

# POST /list-applicationcomponents

`POST /list-applicationcomponents`

Retrieves a list of all the application components (processes).

## Request body

- object
  - `applicationComponentCriteria` 'NOT_DEFINED' | 'APP_NAME' | 'SERVER_ID' | 'APP_TYPE' | 'STRATEGY' | 'DESTINATION' | 'ANALYSIS_STATUS' | 'ERROR_CATEGORY' — Criteria for filtering the list of application components.
  - `filterValue` string — Specify the value based on the application component criteria type. For example, if <code>applicationComponentCriteria</code> is set to <code>SERVER_ID</code> and <code>filterValue</code> is set to <code>server1</code>, then <a>ListApplicationComponents</a> returns all the application components running on server1.
  - `groupIdFilter` Group[] — The group ID specified in to filter on.
    - `name` 'ExternalId' | 'ExternalSourceType' — The key of the specific import group.
    - `value` string — The value of the specific import group.
  - `maxResults` integer — The maximum number of items to include in the response. The maximum value is 100.
  - `nextToken` string — The token from a previous call that you use to retrieve the next set of results. For example, if a previous call to this action returned 100 items, but you set <code>maxResults</code> to 10. You'll receive a set of 10 results along with a token. You then use the returned token to retrieve the next set of 10.
  - `sort` 'ASC' | 'DESC' — Specifies whether to sort by ascending (<code>ASC</code>) or descending (<code>DESC</code>) order.

## Response `200`

Success

- ListApplicationComponentsResponse
  - `applicationComponentInfos` ApplicationComponentDetail[] — The list of application components with detailed information about each component.
    - `analysisStatus` 'ANALYSIS_TO_BE_SCHEDULED' | 'ANALYSIS_STARTED' | 'ANALYSIS_SUCCESS' | 'ANALYSIS_FAILED' | 'ANALYSIS_PARTIAL_SUCCESS' | 'UNCONFIGURED' | 'CONFIGURED' — The status of analysis, if the application component has source code or an associated database.
    - `antipatternReportS3Object` object — The S3 bucket name and the Amazon S3 key name for the anti-pattern report.
      - `s3Bucket` string — The S3 bucket name.
      - `s3key` string — The Amazon S3 key name.
    - `antipatternReportStatus` 'FAILED' | 'IN_PROGRESS' | 'SUCCESS' — The status of the anti-pattern report generation.
    - `antipatternReportStatusMessage` string — The status message for the anti-pattern.
    - `appType` 'DotNetFramework' | 'Java' | 'SQLServer' | 'IIS' | 'Oracle' | 'Other' | 'Tomcat' | 'JBoss' | 'Spring' | 'Mongo DB' | 'DB2' | 'Maria DB' | 'MySQL' | 'Sybase' | 'PostgreSQLServer' | 'Cassandra' | 'IBM WebSphere' | 'Oracle WebLogic' | 'Visual Basic' | 'Unknown' | 'DotnetCore' | 'Dotnet' — The type of application component.
    - `appUnitError` object — The error in the analysis of the source code or database.
      - `appUnitErrorCategory` 'CREDENTIAL_ERROR' | 'CONNECTIVITY_ERROR' | 'PERMISSION_ERROR' | 'UNSUPPORTED_ERROR' | 'OTHER_ERROR' — The category of the error.
    - `associatedServerId` string — The ID of the server that the application component is running on.
    - `databaseConfigDetail` object — Configuration details for the database associated with the application component.
      - `secretName` string — AWS Secrets Manager key that holds the credentials that you use to connect to a database.
    - `id` string — The ID of the application component.
    - `inclusionStatus` 'excludeFromAssessment' | 'includeInAssessment' — Indicates whether the application component has been included for server recommendation or not.
    - `lastAnalyzedTimestamp` string, date-time — The timestamp of when the application component was assessed.
    - `listAntipatternSeveritySummary` AntipatternSeveritySummary[] — A list of anti-pattern severity summaries.
      - `count` integer — Contains the count of anti-patterns.
      - `severity` 'HIGH' | 'MEDIUM' | 'LOW' — Contains the severity of anti-patterns.
    - `moreServerAssociationExists` boolean — Set to true if the application component is running on multiple servers.
    - `name` string — The name of application component.
    - `osDriver` string — OS driver.
    - `osVersion` string — OS version.
    - `recommendationSet` object — The top recommendation set for the application component.
      - `strategy` 'Rehost' | 'Retirement' | 'Refactor' | 'Replatform' | 'Retain' | 'Relocate' | 'Repurchase' — The recommended strategy.
      - `targetDestination` 'None specified' | 'AWS Elastic BeanStalk' | 'AWS Fargate' | 'Amazon Elastic Cloud Compute (EC2)' | 'Amazon Elastic Container Service (ECS)' | 'Amazon Elastic Kubernetes Service (EKS)' | 'Aurora MySQL' | 'Aurora PostgreSQL' | 'Amazon Relational Database Service on MySQL' | 'Amazon Relational Database Service on PostgreSQL' | 'Amazon DocumentDB' | 'Amazon DynamoDB' | 'Amazon Relational Database Service' | 'Babelfish for Aurora PostgreSQL' — The recommended target destination.
      - `transformationTool` object — The target destination for the recommendation set.
        - `description` string — Description of the tool.
        - `name` 'App2Container' | 'Porting Assistant For .NET' | 'End of Support Migration' | 'Windows Web Application Migration Assistant' | 'Application Migration Service' | 'Strategy Recommendation Support' | 'In Place Operating System Upgrade' | 'Schema Conversion Tool' | 'Database Migration Service' | 'Native SQL Server Backup/Restore' — Name of the tool.
        - `tranformationToolInstallationLink` string — URL for installing the tool.
    - `resourceSubType` 'Database' | 'Process' | 'DatabaseProcess' — The application component subtype.
    - `resultList` Result[] — A list of the analysis results.
      - `analysisStatus` object — The error in server analysis.
        - `runtimeAnalysisStatus` 'ANALYSIS_TO_BE_SCHEDULED' | 'ANALYSIS_STARTED' | 'ANALYSIS_SUCCESS' | 'ANALYSIS_FAILED' — The status of the analysis.
        - `srcCodeOrDbAnalysisStatus` 'ANALYSIS_TO_BE_SCHEDULED' | 'ANALYSIS_STARTED' | 'ANALYSIS_SUCCESS' | 'ANALYSIS_FAILED' | 'ANALYSIS_PARTIAL_SUCCESS' | 'UNCONFIGURED' | 'CONFIGURED' — The status of the source code or database analysis.
      - `analysisType` 'SOURCE_CODE_ANALYSIS' | 'DATABASE_ANALYSIS' | 'RUNTIME_ANALYSIS' | 'BINARY_ANALYSIS' — The error in server analysis.
      - `antipatternReportResultList` AntipatternReportResult[] — The error in server analysis.
        - `analyzerName` object — The analyzer name.
          - `binaryAnalyzerName` 'DLL_ANALYZER' | 'BYTECODE_ANALYZER' — The binary analyzer names.
          - `runTimeAnalyzerName` 'A2C_ANALYZER' | 'REHOST_ANALYZER' | 'EMP_PA_ANALYZER' | 'DATABASE_ANALYZER' | 'SCT_ANALYZER' — The assessment analyzer names.
          - `sourceCodeAnalyzerName` 'CSHARP_ANALYZER' | 'JAVA_ANALYZER' | 'BYTECODE_ANALYZER' | 'PORTING_ASSISTANT' — The source code analyzer names.
        - `antiPatternReportS3Object` S3Object — Contains the S3 bucket name and the Amazon S3 key name.
          - `s3Bucket` string — The S3 bucket name.
          - `s3key` string — The Amazon S3 key name.
        - `antipatternReportStatus` 'FAILED' | 'IN_PROGRESS' | 'SUCCESS' — The status of the anti-pattern report generation.
        - `antipatternReportStatusMessage` string — The status message for the anti-pattern.
      - `statusMessage` string — The error in server analysis.
    - `runtimeStatus` 'ANALYSIS_TO_BE_SCHEDULED' | 'ANALYSIS_STARTED' | 'ANALYSIS_SUCCESS' | 'ANALYSIS_FAILED' — The status of the application unit.
    - `runtimeStatusMessage` string — The status message for the application unit.
    - `sourceCodeRepositories` SourceCodeRepository[] — Details about the source code repository associated with the application component.
      - `branch` string — The branch of the source code.
      - `projectName` string — The name of the project.
      - `repository` string — The repository name for the source code.
      - `versionControlType` string — The type of repository to use for the source code.
    - `statusMessage` string — A detailed description of the analysis status and any failure message.
  - `nextToken` string — The token you use to retrieve the next set of results, or null if there are no more results.

## Other responses

- `480` — AccessDeniedException
- `481` — ServiceLinkedRoleLockClientException
- `482` — ValidationException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/migrationhubstrategy.md) · [All operations](https://skmtc.net/aws/apis/migrationhubstrategy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/migrationhubstrategy/versions/5fde79aed042/schema)