11.3. Method: createOrUpdatePath

Description

Create a new file or directory with the given path, or update an existing path.

Parameters

The following parameters are available for this method:

  • string sessionKey
  • string configChannelLabel
  • string path
  • boolean isDir - true if the path is a directory, false if it is a file.
  • struct - path info
    • string contents - Contents of the file in text or base64 encoded if binary (only for non-directories)
    • boolean contents_enc64 - Identifies base64 encoded content (disabled by default, 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 selinux_ctx - SELinux security context (optional)
    • string macro-start-delimiter - Config file macro start 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)
    • 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)
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