Red Hat Training

A Red Hat training course is available for Red Hat Satellite

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