Ce contenu n'est pas disponible dans la langue sélectionnée.

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
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat