POST /gui_app_framework/applications/{application_id}

Updates an application.

Updates an application.

Supply status=RUNNING to start a stopped application.

Supply status=STOPPED to stop a running application.

Supply oauth_user_id to change the OAuth user associated with the application.

Supply security_profile_id to change the security profile associated with the application.

Note only one of these can be updated at a time, please supply only one query parameter below.

Table 1. POST /gui_app_framework/applications/{application_id} resource details
MIME Type

application/json

Table 2. POST /gui_app_framework/applications/{application_id} request parameter details
Parameter Type Optionality Data Type MIME Type Description

application_id

path

Required

Number (Integer)

text/plain

Required - The application identifier.

status

query

Optional

String

text/plain

- The status to set: RUNNING or STOPPED.

oauth_user_id

query

Optional

Number (Integer)

text/plain

- The OAuth user ID to set. This parameter is ignored when status is supplied.

security_profile_id

query

Optional

Long

text/plain

- The security profile ID to associate with the Application instance

fields

query

Optional

String

text/plain

Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.

Table 3. POST /gui_app_framework/applications/{application_id} response codes
HTTP Response Code Unique Code Description

200

The application has been successfully updated.

404

1002

The application identifier could not be found.

409

33000

The current state of the application does not allow the requested action.

409

33006

The current state of the application instance does not allow the requested action.

409

33402

The application image does not exist in the docker registry

409

33600

The application does not have an associated OAuth user.

409

33602

The supplied OAuth user does not have the capabilities required by the application.

409

33700

The application framework is currently disabled.

409

33703

The current state of the system hosts file does not allow the requested action.

409

1008

The application is in a state that does not allow the requested update.

422

33302

The application requested more memory than is currently available.

422

33500

A valid query parameter must be supplied to this API request.

422

33501

An invalid value was supplied for the status parameter.

422

33502

Only one query parameter can be supplied at a time to this API request.

422

33601

The supplied OAuth user does not exist.

422

33650

The supplied security profile does not exist.

422

33651

The supplied security profile is invalid as you can only change from the admin security profile id to null or vice versa.

422

33652

There is already an instance with the supplied security profile with the same app definition

422

33704

The application is not supported on this QRadar release.

422

1005

A supplied parameter is invalid.

500

33203

An error occurred while loading resource bundle properties from the application zip file.

500

33306

An error occurred while parsing the copy of the app manifest stored in the database.

500

1020

The request could not be completed.

Response Description

Application details, see GET /applications/{application_id}.

Response Sample


{
    "application_definition_id": 42,
    "application_state": {
        "application_id": "String",
        "error_messages": "String",
        "error_messages_json": [
            {
                "code": "String",
                "message": "String",
                "source": "String"
            }
        ],
        "memory": 42,
        "status": "String <one of: CREATING, UPGRADING, STARTING, RUNNING, STOPPING, STOPPED, DELETING, ERROR, UNKNOWN>"
    },
    "auth_client_user_id": 42,
    "image": "String",
    "installed_by": "String",
    "installed_on": 42,
    "managed_host_id": 42,
    "manifest": {
        "app_id": 42,
        "areas": [
            {
                "description": "String",
                "id": "String",
                "named_service": "String",
                "required_capabilities": [
                    "String"
                ],
                "text": "String",
                "url": "String"
            }
        ],
        "authentication": {
            "oauth2": {
                "authorization_flow": "String",
                "requested_capabilities": [
                    "String"
                ]
            }
        },
        "configuration_pages": [
            {
                "description": "String",
                "icon": "String",
                "named_service": "String",
                "required_capabilities": [
                    "String"
                ],
                "text": "String",
                "url": "String"
            }
        ],
        "console_ip": "String",
        "custom_columns": [
            {
                "label": "String",
                "named_service": "String",
                "page_id": "String",
                "required_capabilities": [
                    "String"
                ],
                "rest_endpoint": "String"
            }
        ],
        "dashboard_items": [
            {
                "description": "String",
                "required_capabilities": [
                    "String"
                ],
                "rest_method": "String",
                "text": "String"
            }
        ],
        "dependencies": {
            "pip_directory": "String",
            "rpms_directory": "String"
        },
        "description": "String",
        "environment_variables": [
            {
                "name": "String",
                "value": "String"
            }
        ],
        "fragments": [
            {
                "app_name": "String",
                "location": "String",
                "named_service": "String",
                "page_id": "String",
                "required_capabilities": [
                    "String"
                ],
                "rest_endpoint": "String"
            }
        ],
        "gui_actions": [
            {
                "description": "String",
                "groups": [
                    "String"
                ],
                "icon": "String",
                "id": "String",
                "javascript": "String",
                "named_service": "String",
                "required_capabilities": [
                    "String"
                ],
                "rest_method": "String",
                "text": "String"
            }
        ],
        "image": "String",
        "load_flask": "String",
        "log_level": "String",
        "metadata_providers": [
            {
                "metadata_type": "String",
                "rest_method": "String"
            }
        ],
        "multitenancy_safe": "String",
        "name": "String",
        "page_scripts": [
            {
                "app_name": "String",
                "named_service": "String",
                "page_id": "String",
                "scripts": [
                    "String"
                ]
            }
        ],
        "resource_bundles": [
            {
                "bundle": "String",
                "locale": "String"
            }
        ],
        "resources": {
            "memory": 42
        },
        "rest_methods": [
            {
                "argument_names": [
                    "String"
                ],
                "method": "String <one of: GET, HEAD, POST, PUT, DELETE, TRACE, OPTIONS, CONNECT, PATCH>",
                "name": "String",
                "named_service": "String",
                "required_capabilities": [
                    "String"
                ],
                "url": "String"
            }
        ],
        "services": [
            {
                "autorestart": "String",
                "autostart": "String",
                "command": "String",
                "directory": "String",
                "endpoints": [
                    {
                        "error_mime_type": "String",
                        "http_method": "String",
                        "name": "String",
                        "parameters": [
                            {
                                "definition": "String",
                                "location": "String",
                                "name": "String"
                            }
                        ],
                        "path": "String",
                        "request_mime_type": "String",
                        "response": {
                            "mime_type": "String"
                        }
                    }
                ],
                "environment": "String",
                "exitcodes": "String",
                "name": "String",
                "numprocs": 42,
                "port": 42,
                "priority": 42,
                "process_name": "String",
                "redirect_stderr": "String",
                "serverurl": "String",
                "startretries": 42,
                "startsecs": 42,
                "stderr_capture_maxbytes": "String",
                "stderr_events_enabled": "String",
                "stderr_logfile": "String",
                "stderr_logfile_backups": 42,
                "stderr_logfile_maxbytes": "String",
                "stdout_capture_maxbytes": "String",
                "stdout_events_enabled": "String",
                "stdout_logfile": "String",
                "stdout_logfile_backups": 42,
                "stdout_logfile_maxbyte": "String",
                "stopsignal": "String",
                "stopwaitsecs": 42,
                "umask": "String",
                "user": "String",
                "uuid": "String",
                "version": "String"
            }
        ],
        "single_instance_only": "String",
        "uninstall_hooks": [
            {
                "description": "String",
                "documentation_url": "String",
                "last_instance_only": "String",
                "rest_method": "String"
            }
        ],
        "uuid": "String",
        "version": "String"
    },
    "security_profile_id": 42
}