此内容没有您所选择的语言版本。

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
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat