AMC Application Manager API

2.1.3

Overview

Statistics
23 Operations
0 Skills
Management Category
Manage alerts, deployments, diagnostics, logs, and schedulers for Runtime Fabric and CloudHub 2.0 applications.

Servers

  • https://anypoint.mulesoft.com/amc/application-manager/api/v2 AMC Application Manager API
  • https://{region}.anypoint.mulesoft.com/amc/application-manager/api/v2 Regional AMC Application Manager API
  • https://{region}.platform.mulesoft.com/amc/application-manager/api/v2 Regional AMC Application Manager API

Authentication & Security

  • bearerAuth http

    Bearer token authentication. Login endpoint: https://anypoint.mulesoft.com/accounts/api/login

  • clientAuth oauth2

    OAuth2 client credentials. Token endpoint: https://anypoint.mulesoft.com/accounts/api/v2/oauth2/token

Update Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Schedulers By Flowname updateOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSchedulersByFlowname

PUT

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Schedulers
Updates the scheduler configuration for the specified flow name.

Path Parameters

environmentId *: string
deploymentId *: string
flowName *: string
The flowName to identify the target resource.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Request Body *

json
timeUnit: string
frequency: string
Only for FixedFrequencyScheduler or null otherwise.<br/>The frequency at which the Scheduler triggers the flow.
startDelay: string
expression: string
Only for CronScheduler or null otherwise.<br/>A date-time expression.
timeZone: string
Only for CronScheduler or null otherwise.<br/>Java timeZone values are supported.
enabled: boolean
True to enable the scheduler or false otherwise.
fixedFrequencyScehduler: boolean

Response

json
Success
total: integer(int64)
The items list size.
items: array
Examples
application/json
{ "total": 1, "items": [ { "id": "string", "type": "string" } ] }

Delete Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Schedulers By Flowname deleteOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSchedulersByFlowname

DELETE

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Schedulers
Removes the custom scheduler configuration for the given flow name in the deployment and restores the default configuration.

Path Parameters

environmentId *: string
deploymentId *: string
flowName *: string
The flowName to identify the target resource.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
total: integer(int64)
The items list size.
items: array
Examples
application/json
{ "total": 1, "items": [ { "id": "string", "type": "string" } ] }

Get Organizations By Organizationid Environments By Environmentid Deployments getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeployments

GET

Try it out

Path Parameters
Query Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Deployments
Retrieves a list of deployments for the specified query. If the query returns no results, then an empty list is returned.

Path Parameters

environmentId *: string

Query Parameters

deploymentQuery: any
The deploymentQuery query parameter.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
total: integer(int64)
The items list size.
items: array
Examples
application/json
{ "total": 1, "items": [ { "id": "string", "type": "string" } ] }

Create Organizations By Organizationid Environments By Environmentid Deployments createOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeployments

POST

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Deployments
Deploys a new application with the provided data.

Path Parameters

environmentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Request Body *

json
name: string
The name of the application.
target: object
application: object
The details of the application to deploy.
desiredVersion: string
The desired spec version to deploy
upgradeData: object

Response

json
Accepted
id: string
The id of the deployment.
name: string
The name of the deployment.
creationDate: string(date-time)
The date when the deployment was created.
lastModifiedDate: string(date-time)
The date when the deployment was last modified.
target: object
The target of the deployment.
status: string
The status of the deployment.
application: object
The application of the deployment.
desiredVersion: string
The desired version of the deployment.
replicas: array
The list of replicas for the specified deployment.
lastSuccessfulVersion: string
The last version of the deployment that applied correctly.
Examples
application/json
{ "id": "e4899eda-22c9-4546-8ad2-ffde5a3d466d", "name": "app-name", "creationDate": "2024-01-15T10:30:00Z", "lastModifiedDate": "2024-01-15T10:30:00Z", "target": { "id": "string", "type": "string" }, "status": "FAILED", "application": { "id": "string", "type": "string" }, "desiredVersion": "0ef171b6-aad1-459b-8720-10c405b05ed1", "replicas": [ { "id": "string", "type": "string" } ], "lastSuccessfulVersion": "0ef171b6-aad1-459b-8720-10c405b05ed1" }

Create Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Schedulers By Flowname Run createOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSchedulersByFlownameRun

POST

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Schedulers
Triggers a request to executes immediately the scheduler for the given flow name.

Path Parameters

environmentId *: string
deploymentId *: string
flowName *: string
The flowName to identify the target resource.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

Success

Get Organizations By Organizationid Environments By Environmentid Alerts getOrganizationsByOrganizationidEnvironmentsByEnvironmentidAlerts

GET

Try it out

Path Parameters
Query Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Alerts
Retrieves Cloudhub 2.0 alerts

Path Parameters

environmentId *: string

Query Parameters

offset: integer(int32)
Pagination offset or page number for results.
limit: integer(int32)
Maximum number of results to return per page.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
data: array
Examples
application/json
{ "data": [ { "id": "string", "type": "string" } ] }

Create Organizations By Organizationid Environments By Environmentid Alerts createOrganizationsByOrganizationidEnvironmentsByEnvironmentidAlerts

POST

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Alerts
Creates a Cloudhub 2.0 alert

Path Parameters

environmentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Request Body *

json
name *: string
severity *: string
condition *: object
actions *: array

Response

json
Success
id: string
name: string
severity: string
enabled: boolean
organizationId: string
environmentId: string
lastModified: integer(int64)
createdAt: integer(int64)
isSystem: boolean
productName: string
condition: object
actions: array
conditionType: string
Examples
application/json
{ "id": "string", "name": "string", "severity": "INFO", "enabled": true, "organizationId": "string", "environmentId": "string", "lastModified": 0, "createdAt": 0, "isSystem": true, "productName": "string" }

Get Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentid

GET

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Deployments
Retrieves a single deployment with the provided id.

Path Parameters

environmentId *: string
deploymentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
id: string
The id of the deployment.
name: string
The name of the deployment.
creationDate: string(date-time)
The date when the deployment was created.
lastModifiedDate: string(date-time)
The date when the deployment was last modified.
target: object
The target of the deployment.
status: string
The status of the deployment.
application: object
The application of the deployment.
desiredVersion: string
The desired version of the deployment.
replicas: array
The list of replicas for the specified deployment.
lastSuccessfulVersion: string
The last version of the deployment that applied correctly.
Examples
application/json
{ "id": "e4899eda-22c9-4546-8ad2-ffde5a3d466d", "name": "app-name", "creationDate": "2024-01-15T10:30:00Z", "lastModifiedDate": "2024-01-15T10:30:00Z", "target": { "id": "string", "type": "string" }, "status": "FAILED", "application": { "id": "string", "type": "string" }, "desiredVersion": "0ef171b6-aad1-459b-8720-10c405b05ed1", "replicas": [ { "id": "string", "type": "string" } ], "lastSuccessfulVersion": "0ef171b6-aad1-459b-8720-10c405b05ed1" }

Patch Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid patchOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentid

PATCH

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Deployments
Updates an existing deployment with the provided details.

Path Parameters

environmentId *: string
deploymentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Request Body *

json
target: object
application: object
The details of the application to deploy.
desiredVersion: string
The desired spec version to deploy
name: string
The name of the application.
Examples
Update vCores
{ "application": { "vCores": "0.07" } }
Update replicas
{ "target": { "replicas": 3 } }
Update runtime version
{ "target": { "deploymentSettings": { "runtimeVersion": "4.3.0:20220523-3" } } }
Update application ref
{ "application": { "ref": { "groupId": "66310c16-bce5-43c4-b978-5945ed2f99c5", "artifactId": "app-with-44-schedulers", "version": "1.0.44", "packaging": "jar" } } }
Update JVM arguments
{ "target": { "deploymentSettings": { "jvm": { "args": "-XX:MaxRAMPercentage=60.0" } } } }
Start application
{ "application": { "desiredState": "STARTED" } }
Stop application
{ "application": { "desiredState": "STOPPED" } }

Response

json
Success
id: string
The id of the deployment.
name: string
The name of the deployment.
creationDate: string(date-time)
The date when the deployment was created.
lastModifiedDate: string(date-time)
The date when the deployment was last modified.
target: object
The target of the deployment.
status: string
The status of the deployment.
application: object
The application of the deployment.
desiredVersion: string
The desired version of the deployment.
replicas: array
The list of replicas for the specified deployment.
lastSuccessfulVersion: string
The last version of the deployment that applied correctly.
Examples
application/json
{ "id": "e4899eda-22c9-4546-8ad2-ffde5a3d466d", "name": "app-name", "creationDate": "2024-01-15T10:30:00Z", "lastModifiedDate": "2024-01-15T10:30:00Z", "target": { "id": "string", "type": "string" }, "status": "FAILED", "application": { "id": "string", "type": "string" }, "desiredVersion": "0ef171b6-aad1-459b-8720-10c405b05ed1", "replicas": [ { "id": "string", "type": "string" } ], "lastSuccessfulVersion": "0ef171b6-aad1-459b-8720-10c405b05ed1" }

Delete Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid deleteOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentid

DELETE

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Deployments
Deletes the specified deploymentId.

Path Parameters

environmentId *: string
deploymentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

Success

Get Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Schedulers getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSchedulers

GET

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Schedulers
Retrieves a list of schedulers for the specified deployment. If this path contains no data, then an empty list is returned.

Path Parameters

environmentId *: string
deploymentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
total: integer(int64)
The items list size.
items: array
Examples
application/json
{ "total": 1, "items": [ { "id": "string", "type": "string" } ] }

Patch Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Schedulers patchOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSchedulers

PATCH

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Schedulers
Disables or enables a list of schedulers in a deployment.

Path Parameters

environmentId *: string
deploymentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Request Body *

json
items: array
Array items

Response

json
Success
total: integer(int64)
The items list size.
items: array
Examples
application/json
{ "total": 1, "items": [ { "id": "string", "type": "string" } ] }

Get Organizations By Organizationid Environments By Environmentid Alerts By Alertid getOrganizationsByOrganizationidEnvironmentsByEnvironmentidAlertsByAlertid

GET

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Alerts
Retrieves a single Cloudhub 2.0 alert

Path Parameters

environmentId *: string
alertId *: string
The alert ID to identify the target resource.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
id: string
name: string
severity: string
enabled: boolean
organizationId: string
environmentId: string
lastModified: integer(int64)
createdAt: integer(int64)
isSystem: boolean
productName: string
condition: object
actions: array
conditionType: string
Examples
application/json
{ "id": "string", "name": "string", "severity": "INFO", "enabled": true, "organizationId": "string", "environmentId": "string", "lastModified": 0, "createdAt": 0, "isSystem": true, "productName": "string" }

Patch Organizations By Organizationid Environments By Environmentid Alerts By Alertid patchOrganizationsByOrganizationidEnvironmentsByEnvironmentidAlertsByAlertid

PATCH

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
Alerts
Updates a Cloudhub 2.0 alert

Path Parameters

environmentId *: string
alertId *: string
The alert ID to identify the target resource.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Request Body *

json
id: string
name *: string
enabled: boolean
productName: string
severity *: string
condition *: object
actions *: array
organizationId: string
environmentId: string
lastModified: integer(int64)
isSystem: boolean
createdAt: integer(int64)
system: boolean

Response

json
Success
id: string
name: string
severity: string
enabled: boolean
organizationId: string
environmentId: string
lastModified: integer(int64)
createdAt: integer(int64)
isSystem: boolean
productName: string
condition: object
actions: array
conditionType: string
Examples
application/json
{ "id": "string", "name": "string", "severity": "INFO", "enabled": true, "organizationId": "string", "environmentId": "string", "lastModified": 0, "createdAt": 0, "isSystem": true, "productName": "string" }

Delete Organizations By Organizationid Environments By Environmentid Alerts By Alertid deleteOrganizationsByOrganizationidEnvironmentsByEnvironmentidAlertsByAlertid

DELETE

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Alerts
Deletes a Cloudhub 2.0 alert

Path Parameters

environmentId *: string
alertId *: string
The alert ID to identify the target resource.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

Success

Get Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Specs getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSpecs

GET

Try it out

Path Parameters
Query Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Deployments
Retrieves a list of deployment version specs for the specified deploymentId.

Path Parameters

environmentId *: string
deploymentId *: string

Query Parameters

limit: integer(int32)

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
items: array
Array items
Examples
application/json
[ { "id": "string", "type": "string" } ]

Get Organizations By Organizationid Environments By Environmentid Alerts By Alertid History getOrganizationsByOrganizationidEnvironmentsByEnvironmentidAlertsByAlertidHistory

GET

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Alerts
Retrieves a Cloudhub 2.0 alert history record

Path Parameters

environmentId *: string
alertId *: string
The alert ID to identify the target resource.

Header Parameters

Authorization *: string
Bearer token for API authentication.

Response

json
Success
data: array
total: integer(int32)
Examples
application/json
{ "data": [ { "id": "string", "type": "string" } ], "total": 0 }

Create Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Replicas By Replicaid Diagnostics createOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidReplicasByReplicaidDiagnostics

POST

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Diagnostics
Trigger a thread dump diagnosis for a specific replica of a deployment

Path Parameters

environmentId *: string
replicaId *: string
The replica ID to identify the target resource.
deploymentId *: string

Response

No Content

Get Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Specs By Specificationid Logs getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSpecsBySpecificationidLogs

GET

Try it out

Path Parameters
Query Parameters
Custom Query Parameters
Custom Headers
Logs
Fetch logs from the Log Aggregator V2 API.

Path Parameters

environmentId *: string
specificationId *: string
Specification Id

Query Parameters

search *: any
Search or filter expression to narrow results.

Response

OK

Get Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Specs By Specificationid Logs File getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidSpecsBySpecificationidLogsFile

GET

Try it out

Path Parameters
Query Parameters
Custom Query Parameters
Custom Headers
Logs
Download log entries matching the search as text attachment, without pagination.

Path Parameters

environmentId *: string
specificationId *: string
Specification Id

Query Parameters

search *: any
Search or filter expression to narrow results.

Response

OK
Examples
application/json
{}

Get Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Diagnostics getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidDiagnostics

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Diagnostics
Retrieve a list of all executed actions related to the specified organization id, environment id and deployment id.

Path Parameters

environmentId *: string
deploymentId *: string

Response

json
OK
items: array
Array items
Examples
application/json
[ { "id": "string", "type": "string" } ]

Get Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Diagnostics By Actionid File getOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidDiagnosticsByActionidFile

GET

Try it out

Path Parameters
Custom Query Parameters
Custom Headers
Diagnostics
Fetch the thread dump report of a specific diagnosis action.

Path Parameters

environmentId *: string
deploymentId *: string
actionId *: string
The action ID to identify the target resource.

Response

OK
Examples
application/json
{}

Update Organizations By Organizationid Environments By Environmentid Deployments By Deploymentid Upgradedata Trafficswitching updateOrganizationsByOrganizationidEnvironmentsByEnvironmentidDeploymentsByDeploymentidUpgradedataTrafficswitching

PUT

Try it out

Path Parameters
Header Parameters
Custom Query Parameters
Custom Headers
Request Body application/json
TrafficSwitching
upsert the percentage in which the traffic is switched to the CH2 deployment.

Path Parameters

environmentId *: string
deploymentId *: string

Header Parameters

Authorization *: string
Bearer token for API authentication.

Request Body *

json
switchedTraffic: integer(int32)
number mapped to an integer between 0 and 100

Response

json
Success
isSwitched: boolean
is the app traffic switched from CloudHub to CH2
switchedTrafficPercent: integer(int32)
number mapped to an integer between 0 and 100
ch1AppName: string
cloudhub app name
ch2AppName: string
CH2 app name
deploymentId: string
CH2 deployment id
Examples
application/json
{ "isSwitched": true, "switchedTrafficPercent": 50, "ch1AppName": "cloudhub app", "ch2AppName": "ch2 app", "deploymentId": "deployment id" }