Modifica

Condividi tramite

Business Central Admin Center API - Reschedule Updates

  • Articolo

Allows for the management of scheduled updates such as rescheduling the update to a run on or after a specific date within a provided range.

Get Scheduled Update

Get information about updates that have already been scheduled for a specific environment.

GET /admin/v2.21/applications/{applicationFamily}/environments/{environmentName}/upgrade

Route Parameters

applicationFamily - Family of the environment's application (for example, "BusinessCentral")

environmentName - Name of the targeted environment

Response

Returns information about the scheduled update for that environment.

{
  "environmentName": string, // The name of the targeted environment.
  "applicationFamily": string, // Family of the environment (for example, "BusinessCentral")
  "sourceVersion": string, // The current version of the environment's application.
  "targetVersion": string, // The version of the application that the environment will update to.
  "canTenantSelectDate": boolean, // Indicates if a new update date can be selected.
  "didTenantSelectDate": boolean, // Indicates if the tenant has selected the current date for the update.
  "earliestSelectableUpgradeDate": datetime, // Specifies the earliest date that can be chosen for the update.
  "latestSelectableUpgradeDate": datetime, // Specifies the latest date that can be chosen for the update.
  "upgradeDate": datetime, // The currently selected scheduled date of the update.
  "updateStatus": string, // The current status of the environment's update. (enum | "Scheduled" or "Running")
  "ignoreUpgradeWindow": boolean, // Indicates if the environment's update window will be ignored
  "isActive": boolean, // Indicates if the update is activated and is scheduled to occur.
}

Expected Error Codes

applicationTypeDoesNotExist - the provided value for the application family wasn't found

environmentNotFound - the targeted environment couldn't be found

  • target: {applicationFamily}/{environmentName}

Reschedule Update

Reschedule an update, if able.

Content-Type: application/json
PUT /admin/v2.21/applications/{applicationFamily}/environments/{environmentName}/upgrade

Route Parameters

applicationFamily - Family of the environment's application (for example, "BusinessCentral")

environmentName - Name of the targeted environment

Body

{
  "runOn": datetime, // Sets the date that the upgrade should be run on.
  "ignoreUpgradeWindow": boolean // Specifies if the upgrade window for the environment should be respected.
}

Expected Error Codes

applicationTypeDoesNotExist - the provided value for the application family wasn't found

requestBodyRequired - the request body must be provided

resourceDoesNotExist - no upgrade is currently scheduled for the targeted environment

entityValidationFailed - some unhandled error occurred in the validation of the request

environmentNotFound - the targeted environment couldn't be found

  • target: {applicationFamily}/{environmentName}

The Business Central Administration Center API
Manage Apps
Microsoft Dynamics 365 Business Central Server Administration Tool