Documentation

    PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.19

    Documentation for other releases can be found by using the version selector in the top right of any doc page.

    json_file

    Manage settings in JSON files.

    Attributes

    check_mode:
      support: full
    

    Parameters

    Parameter Required Type Values Description
    backup   boolean   Create a backup of the file before modifying. [default: false]
    key true string   The JSON key path using dot notation (e.g., server.port).
    path true string   The absolute path to the JSON file to modify.
    state   string present
    absent
    Whether the key should exist or not. [default: "present"]
    value       The value to set for the key. Required if state=present.

    Examples

    - json_file:
        path: /etc/app/config.json
        key: server.port
        value: 8080
    
    - json_file:
        path: /etc/app/config.json
        key: database.connection.timeout
        value: 30
    
    - json_file:
        path: /etc/app/config.json
        key: debug.enabled
        state: absent
    
    - json_file:
        path: /etc/app/config.json
        key: server.host
        value: "0.0.0.0"
        backup: true