35.2. Method: createOrUpdatePath


Description

Create a new text or binary file or directory with the given path, or update an existing path on a server.

Parameters

The following parameters are available for this method:

  • string sessionKey
  • int serverId
  • string path - The configuration file/directory path
  • boolean isDir
    • true if the path is a directory
    • false if the path is a file
  • struct - path info
    • string contents - Contents of the file (text or base64 encoded if binary) (only for non-directories)
    • boolean contents_enc64 - Identifies base64 encoded content (default: disabled, only for non-directories)
    • string owner - Owner of the file or directory
    • string group - Group name of the file or directory
    • string permissions - Octal file or directory permissions e.g. 644
    • string macro-start-delimiter - Config file macro end delimiter. Use null or empty string to accept the default (only for non-directories)
    • string macro-end-delimiter - Config file macro end delimiter. Use null or empty string to accept the default (only for non-directories)
    • string selinux_ctx - SELinux context (optional)
    • int revision - Next revision number, auto increment for null
    • boolean binary - Mark the binary content, if true, base64 encoded content is expected (only for non-directories)
  • int commitToLocal
    • 1 to commit configuration files to the system's local override configuration channel
    • 0 to commit configuration files to the system's sandbox configuration channel
Returns

The following return values are available for this method:

  • struct - Configuration Revision information
    • string type
      • file
      • directory
      • symlink
    • string path - File path
    • string target_path - Symbolic link target file path; present for symbolic links only
    • string channel - Channel name
    • string contents - File contents (base64 encoded according to the contents_enc64 attribute)
    • boolean contents_enc64 - Identifies base64 encoded content
    • int revision - File revision
    • dateTime.iso8601 creation - Creation date
    • dateTime.iso8601 modified - Last modified date
    • string owner - File Owner; present for files or directories only
    • string group - File Group; present for files or directories only
    • int permissions - File Permissions; present for files or directories only (deprecated)
    • string permissions_mode - File Permissions; present for files or directories only
    • string selinux_ctx - SELinux context (optional)
    • boolean binary - true or false; present for files only
    • string md5 - File's MD5 signature; present for files only
    • string macro-start-delimiter - Macro start delimiter for a config file; present for text files only
    • string macro-end-delimiter - Macro end delimiter for a config file; present for text files only
Available since: 10.2
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat