filesystem.chown ================ Change owner or group of file at ``path``. ``uid`` and ``gid`` specify new owner of the file. If either key is absent or None, then existing value on the file is not changed. ``user`` and ``group`` alternatively allow specifying a uid gid by user name or group name. ``recursive`` performs action recursively, but does not traverse filesystem mount points. If ``traverse`` and ``recursive`` are specified, then the chown operation will traverse filesystem mount points. A recursive change may not target the mountpoint of a dataset consumed by an S3 bucket, nor traverse into one; apply it to the bucket's ``s3data`` directory instead. This method is a job. .. raw:: html
Type: object

Type: array
No Additional Items

Tuple Validation

Parameter 1: filesystem_chown

filesystem_chown

Type: object

FilesystemChownArgs parameters.

 No Additional Properties

Path

Type: string

Filesystem path to modify.

Must be at least 1 characters long

Uid

Default: null

Numeric user ID to set as owner. null to leave unchanged.

Type: integer

Value must be greater or equal to -1 and lesser or equal to 2147483647

Type: null

User

Default: null

Username to set as owner. null to leave unchanged.

Type: string

Must be at least 1 characters long

Type: null

Gid

Default: null

Numeric group ID to set as group owner. null to leave unchanged.

Type: integer

Value must be greater or equal to -1 and lesser or equal to 2147483647

Type: null

Group

Default: null

Group name to set as group owner. null to leave unchanged.

Type: string

Must be at least 1 characters long

Type: null

FilesystemChownOptions

Type: object Default: {"recursive": false, "traverse": false}

Additional options for the ownership change operation.

 No Additional Properties

Recursive

Type: boolean Default: false

Whether to apply the operation recursively to subdirectories.

Traverse

Type: boolean Default: false

If set do not limit to single dataset / filesystem.

Result

Type: null

Returns null when the ownership change is successfully completed.


*Required roles:* FILESYSTEM_ATTRS_WRITE