Application Command Execution Controller Resource

The API allows you to list, view, create and edit application command executions.

GET /applications/configs

Returns list of application command executions.

Request Parameters
name type description
direction query
filter query
nameLike query
orderBy query
page query
size query
Response Body
media type data type description
application/json array of AppCmdExecConfigListRecord (JSON) list of application command executions

Example

Request
GET /applications/configs
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "cmdExecMethod" : "NODE",
  "exportData" : true,
  "removeFilesAfterExport" : true,
  "sourceType" : "STREAM",
  "sourcePath" : "...",
  "appCmdExecConfigParams" : [ {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
      "name" : "Entity name"
    },
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
  }, {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "...",
      "name" : "..."
    },
    "guid" : "..."
  } ],
  "userModifiable" : true,
  "useNetcat" : true,
  "possibleActions" : [ "READ", "WRITE" ],
  "instanceCount" : 12345,
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
} ]
                
              

POST /applications/configs

Create a application command execution.

Request Body
media type data type description
application/json AppCmdExecConfigRequest (JSON) specify details for new application command execution
Response Body
media type data type description
application/json AppCmdExecConfigDetails (JSON) details of newly created application command execution

Example

Request
POST /applications/configs
Content-Type: application/json
Accept: application/json

                
{
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "applications" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "cmdExecMethod" : "NODE",
  "exportData" : true,
  "removeFilesAfterExport" : true,
  "sourceType" : "STREAM",
  "appCmdExecConfigParams" : [ {
    "guid" : "...",
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "..."
  }, {
    "guid" : "...",
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "..."
  } ],
  "ignoredExitCodes" : "...",
  "stdErrorHandling" : "DONT_IGNORE",
  "sourcePath" : "...",
  "timeout" : 12345,
  "useNetcat" : true
}
                
              
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{
  "applications" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "timeout" : 12345,
  "ignoredExitCodes" : "...",
  "cmdExecMethod" : "REMOTE_POWERSHELL",
  "stdErrorHandling" : "DONT_IGNORE",
  "exportData" : true,
  "buildInType" : "DB2_BACKUP",
  "removeFilesAfterExport" : true,
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "sourceType" : "STREAM",
  "sourcePath" : "...",
  "appCmdExecConfigParams" : [ {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
      "name" : "Entity name"
    },
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
  }, {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "...",
      "name" : "..."
    },
    "guid" : "..."
  } ],
  "userModifiable" : true,
  "useNetcat" : true,
  "possibleActions" : [ "WRITE", "READ" ],
  "instanceCount" : 12345
}
                
              

GET /applications/configs/detailed

Returns detailed list of application command executions.

Response Body
media type data type description
application/json array of AppCmdExecConfigDetails (JSON) detailed list of application command executions

Example

Request
GET /applications/configs/detailed
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "applications" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "timeout" : 12345,
  "ignoredExitCodes" : "...",
  "cmdExecMethod" : "NODE",
  "stdErrorHandling" : "IGNORE_WITH_WARNING",
  "exportData" : true,
  "buildInType" : "MSSQL_DB_BACKUP",
  "removeFilesAfterExport" : true,
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "sourceType" : "STREAM",
  "sourcePath" : "...",
  "appCmdExecConfigParams" : [ {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
      "name" : "Entity name"
    },
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
  }, {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "...",
      "name" : "..."
    },
    "guid" : "..."
  } ],
  "userModifiable" : true,
  "useNetcat" : true,
  "possibleActions" : [ "HV_READ", "INVENTORY_SYNC" ],
  "instanceCount" : 12345
} ]
                
              

GET /applications/configs/preview

Response Body
media type data type description
application/json array of NameAndGuid (JSON)

Example

Request
GET /applications/configs/preview
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "name" : "Entity name"
} ]
                
              

GET /applications/configs/rbac-contexts

Returns list of application command executions.

Response Body
media type data type description
application/json array of RbacContextListRecord (JSON) list of application command executions

Example

Request
GET /applications/configs/rbac-contexts
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
[ {
  "nameAndGuid" : {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  },
  "uuid" : "...",
  "type" : "DATA_CENTER",
  "checked" : true,
  "lastLevel" : true,
  "present" : true,
  "entityType" : "...",
  "childrenQueryType" : "..."
} ]
                
              

DELETE /applications/configs/{guid}

Remove application command execution.

Request Parameters
name type description
guid path specify local unique identifier for application command execution (use by vProtect)

Example

Request
DELETE /applications/configs/{guid}
Content-Type: */*

                
...
                
              
Response
HTTP/1.1 204 No Content

              

GET /applications/configs/{guid}

Get a single application command execution.

Request Parameters
name type description
guid path specify local unique identifier for application command execution (use by vProtect)
Response Body
media type data type description
application/json AppCmdExecConfigDetails (JSON) a single application command execution details

Example

Request
GET /applications/configs/{guid}
Content-Type: */*
Accept: application/json

                
...
                
              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "applications" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "timeout" : 12345,
  "ignoredExitCodes" : "...",
  "cmdExecMethod" : "NODE",
  "stdErrorHandling" : "IGNORE_WITHOUT_WARNING",
  "exportData" : true,
  "buildInType" : "OVIRT_RHV_DB_BACKUP",
  "removeFilesAfterExport" : true,
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "sourceType" : "FILE",
  "sourcePath" : "...",
  "appCmdExecConfigParams" : [ {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
      "name" : "Entity name"
    },
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
  }, {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "...",
      "name" : "..."
    },
    "guid" : "..."
  } ],
  "userModifiable" : true,
  "useNetcat" : true,
  "possibleActions" : [ "READ", "READ" ],
  "instanceCount" : 12345
}
                
              

PUT /applications/configs/{guid}

Change application command execution details.

Request Parameters
name type description
guid path specify local unique identifier for application command execution (use by vProtect)
Request Body
media type data type description
application/json AppCmdExecConfigRequest (JSON) specify application command execution details to update
Response Body
media type data type description
application/json AppCmdExecConfigDetails (JSON) updated details of application command execution

Example

Request
PUT /applications/configs/{guid}
Content-Type: application/json
Accept: application/json

                
{
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "applications" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "cmdExecMethod" : "NODE",
  "exportData" : true,
  "removeFilesAfterExport" : true,
  "sourceType" : "STREAM",
  "appCmdExecConfigParams" : [ {
    "guid" : "...",
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "..."
  }, {
    "guid" : "...",
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "..."
  } ],
  "ignoredExitCodes" : "...",
  "stdErrorHandling" : "DONT_IGNORE",
  "sourcePath" : "...",
  "timeout" : 12345,
  "useNetcat" : true
}
                
              
Response
HTTP/1.1 204 No Content
Content-Type: application/json

                
{
  "applications" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "timeout" : 12345,
  "ignoredExitCodes" : "...",
  "cmdExecMethod" : "REMOTE_POWERSHELL",
  "stdErrorHandling" : "DONT_IGNORE",
  "exportData" : true,
  "buildInType" : "INTERNAL_DB_BACKUP",
  "removeFilesAfterExport" : true,
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "sourceType" : "FILE",
  "sourcePath" : "...",
  "appCmdExecConfigParams" : [ {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
      "name" : "Entity name"
    },
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
  }, {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "...",
      "name" : "..."
    },
    "guid" : "..."
  } ],
  "userModifiable" : true,
  "useNetcat" : true,
  "possibleActions" : [ "READ", "HV_READ" ],
  "instanceCount" : 12345
}
                
              

POST /applications/configs/{guid}/clone

Clone application command execution.

Request Parameters
name type description
guid path local unique identifier of application command execution that will be cloned
Request Body
media type data type description
application/json CloneDTO (JSON) specify details for new application command execution
Response Body
media type data type description
application/json AppCmdExecConfigDetails (JSON) details of newly created application command execution

Example

Request
POST /applications/configs/{guid}/clone
Content-Type: application/json
Accept: application/json

                
{
  "name" : "..."
}
                
              
Response
HTTP/1.1 201 Created
Content-Type: application/json

                
{
  "applications" : [ {
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
    "name" : "Entity name"
  }, {
    "guid" : "...",
    "name" : "..."
  } ],
  "name" : "...",
  "cmdArg" : [ "...", "..." ],
  "timeout" : 12345,
  "ignoredExitCodes" : "...",
  "cmdExecMethod" : "REMOTE_POWERSHELL",
  "stdErrorHandling" : "IGNORE_WITHOUT_WARNING",
  "exportData" : true,
  "buildInType" : "REAR_BACKUP",
  "removeFilesAfterExport" : true,
  "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
  "sourceType" : "FILE",
  "sourcePath" : "...",
  "appCmdExecConfigParams" : [ {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67",
      "name" : "Entity name"
    },
    "guid" : "f8f73bf9-2445-4bce-a7dd-753be3b40a67"
  }, {
    "name" : "...",
    "showInUi" : true,
    "obligatory" : true,
    "defaultValue" : "...",
    "userFriendlyHint" : "...",
    "envVariables" : [ {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    }, {
      "name" : "...",
      "value" : "...",
      "hiddenInUI" : true,
      "application" : { },
      "appCmdExecConfigParam" : { },
      "guid" : "..."
    } ],
    "appCmdExecConfig" : {
      "guid" : "...",
      "name" : "..."
    },
    "guid" : "..."
  } ],
  "userModifiable" : true,
  "useNetcat" : true,
  "possibleActions" : [ "WRITE", "WRITE" ],
  "instanceCount" : 12345
}