title | description | author | ms.author | ms.topic | ms.date | ms.reviewer | audience | ms.search.region | ms.search.validFrom | ms.search.form | ms.dyn365.ops.version |
---|---|---|---|---|---|---|---|---|---|---|---|
Database movement API - Reference - v1 - Create a database refresh |
Learn about a reference for version 1 (v1) of the Database Movement application programming interface (API) for creating a database refresh. |
laneswenka |
laswenka |
reference |
09/30/2019 |
johnmichalak |
Developer, IT Pro |
Global |
2019-09-30 |
10.0.0 |
[!include banner]
You can create a database refresh between two environments. Note that the same validation rules from the details page in Microsoft Dynamics Lifecycle Services (LCS) apply to the application programming interface (API).
One of the following permissions is required to call this API. For more information about permissions and how to select them, see Authentication.
Permission type | Permissions (from least privileged to most privileged) |
---|---|
Delegated (work or school account) | user_impersonation |
POST /databasemovement/v1/refresh/project/{projectId}/source/{sourceEnvironmentId}/target/{targetEnvironmentId}
Header | Value |
---|---|
Authorization | Bearer {token} (required) |
'x-ms-version' | '2017-09-15' (required) |
Content-Type | application/json |
Don't supply a request body for this method.
The response is always a 200 OK response, unless you aren't correctly authenticated. Be sure to use the IsSuccess property to evaluate the success or failure of the action.
POST /databasemovement/v1/refresh/project/12345/source/5362377c-bc37-4f92-b30e-fe0c1e664cc0/target/6a90b45f-1764-4077-b924-3f4671540237
{
"IsSuccess": true,
"OperationActivityId": "55eb4327-9346-4c7b-82bd-fe8ef15112c6",
"ErrorMessage": null,
"VersionEOL": "9999-12-31T23:59:59.9999999"
}
[!INCLUDEfooter-include]