Jump to

• Request
• Response

Update a Folder's Permissions

put

{protocol}//{host}:{port}{basePath}/ic/api/fileserver/v1/filesystem/directories/{guid}/permissions

Update a specified folder's permissions

Request

Path Parameters

• guid(required): string
  PathId of the folder

Supported Media Types

• application/json

Request Body - application/json ()

directoryPermissionDO

Root Schema : schema

Type: object

Describes configured permissions for given directory

Show Source

• doNotInherit: boolean
  Default Value: false

  Boolean indicating that current folder and child folders will not inherit any permission from its parent folders.
• links: array links
• path(required): string
• permissions: array permissions
  A list of permissions assigned for given directory to different users/groups.

{
    "required":[
        "path"
    ],
    "type":"object",
    "properties":{
        "path":{
            "type":"string",
            "xml":{
                "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
            }
        },
        "doNotInherit":{
            "type":"boolean",
            "description":"Boolean indicating that current folder and child folders will not inherit any permission from its parent folders.",
            "xml":{
                "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
            },
            "default":false
        },
        "permissions":{
            "type":"array",
            "description":"A list of permissions assigned for given directory to different users/groups.",
            "items":{
                "$ref":"#/components/schemas/Permission"
            }
        },
        "links":{
            "type":"array",
            "xml":{
                "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
            },
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"Describes configured permissions for given directory",
    "xml":{
        "name":"directory",
        "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "xml":{
        "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
    },
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : permissions

Type: array

A list of permissions assigned for given directory to different users/groups.

Show Source

• Array of: object permissions
  Configured permission for given directory for given user/group.

{
    "type":"array",
    "description":"A list of permissions assigned for given directory to different users/groups.",
    "items":{
        "$ref":"#/components/schemas/Permission"
    }
}

Nested Schema : Link

Type: object

Show Source

• href(required): string
• rel(required): string

{
    "required":[
        "href",
        "rel"
    ],
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    }
}

Nested Schema : permissions

Type: object

Configured permission for given directory for given user/group.

Show Source

• id(required): string
  Read Only: true
• lastModified: string
• lastUpdatedBy: string
• principle(required): string
  Name of user/group
• principleEnabled: boolean
  Boolean to indicate if user/group is enabled or not
• principleType(required): string
  Allowed Values: [ "user", "group" ]

  Principle Type
• propagateRightsToSubfolders: boolean
  Boolean to indicate if this permission will be applied to all subfolders
• rights(required): array rights
  Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.

{
    "required":[
        "id",
        "principle",
        "principleType",
        "rights"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "readOnly":true
        },
        "principle":{
            "type":"string",
            "description":"Name of user/group"
        },
        "principleType":{
            "type":"string",
            "description":"Principle Type",
            "enum":[
                "user",
                "group"
            ]
        },
        "principleEnabled":{
            "type":"boolean",
            "description":"Boolean to indicate if user/group is enabled or not"
        },
        "propagateRightsToSubfolders":{
            "type":"boolean",
            "description":"Boolean to indicate if this permission will be applied to all subfolders"
        },
        "rights":{
            "type":"array",
            "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
            "items":{
                "type":"string",
                "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
                "enum":[
                    "read",
                    "write",
                    "list",
                    "delete",
                    "createDir",
                    "deleteDir",
                    "renameDir",
                    "propagateRightsToSubfolders",
                    "all"
                ]
            },
            "enum":[
                "read",
                "write",
                "list",
                "delete",
                "createDir",
                "deleteDir",
                "renameDir",
                "propagateRightsToSubfolders",
                "all"
            ]
        },
        "lastUpdatedBy":{
            "type":"string"
        },
        "lastModified":{
            "type":"string"
        }
    },
    "description":"Configured permission for given directory for given user/group.",
    "xml":{
        "name":"permissions"
    }
}

Nested Schema : rights

Type: array

Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.

Allowed Values: [ "read", "write", "list", "delete", "createDir", "deleteDir", "renameDir", "propagateRightsToSubfolders", "all" ]

Show Source

• Array of: string
  Allowed Values: [ "read", "write", "list", "delete", "createDir", "deleteDir", "renameDir", "propagateRightsToSubfolders", "all" ]

  Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.

{
    "type":"array",
    "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
    "items":{
        "type":"string",
        "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
        "enum":[
            "read",
            "write",
            "list",
            "delete",
            "createDir",
            "deleteDir",
            "renameDir",
            "propagateRightsToSubfolders",
            "all"
        ]
    },
    "enum":[
        "read",
        "write",
        "list",
        "delete",
        "createDir",
        "deleteDir",
        "renameDir",
        "propagateRightsToSubfolders",
        "all"
    ]
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success

Body ()

Root Schema : schema

Type: object

Describes configured permissions for given directory

Show Source

• doNotInherit: boolean
  Default Value: false

  Boolean indicating that current folder and child folders will not inherit any permission from its parent folders.
• links: array links
• path(required): string
• permissions: array permissions
  A list of permissions assigned for given directory to different users/groups.

{
    "required":[
        "path"
    ],
    "type":"object",
    "properties":{
        "path":{
            "type":"string",
            "xml":{
                "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
            }
        },
        "doNotInherit":{
            "type":"boolean",
            "description":"Boolean indicating that current folder and child folders will not inherit any permission from its parent folders.",
            "xml":{
                "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
            },
            "default":false
        },
        "permissions":{
            "type":"array",
            "description":"A list of permissions assigned for given directory to different users/groups.",
            "items":{
                "$ref":"#/components/schemas/Permission"
            }
        },
        "links":{
            "type":"array",
            "xml":{
                "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
            },
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"Describes configured permissions for given directory",
    "xml":{
        "name":"directory",
        "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "xml":{
        "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/directorypermission"
    },
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : permissions

Type: array

A list of permissions assigned for given directory to different users/groups.

Show Source

• Array of: object permissions
  Configured permission for given directory for given user/group.

{
    "type":"array",
    "description":"A list of permissions assigned for given directory to different users/groups.",
    "items":{
        "$ref":"#/components/schemas/Permission"
    }
}

Nested Schema : Link

Type: object

Show Source

• href(required): string
• rel(required): string

{
    "required":[
        "href",
        "rel"
    ],
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    }
}

Nested Schema : permissions

Type: object

Configured permission for given directory for given user/group.

Show Source

• id(required): string
  Read Only: true
• lastModified: string
• lastUpdatedBy: string
• principle(required): string
  Name of user/group
• principleEnabled: boolean
  Boolean to indicate if user/group is enabled or not
• principleType(required): string
  Allowed Values: [ "user", "group" ]

  Principle Type
• propagateRightsToSubfolders: boolean
  Boolean to indicate if this permission will be applied to all subfolders
• rights(required): array rights
  Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.

{
    "required":[
        "id",
        "principle",
        "principleType",
        "rights"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "readOnly":true
        },
        "principle":{
            "type":"string",
            "description":"Name of user/group"
        },
        "principleType":{
            "type":"string",
            "description":"Principle Type",
            "enum":[
                "user",
                "group"
            ]
        },
        "principleEnabled":{
            "type":"boolean",
            "description":"Boolean to indicate if user/group is enabled or not"
        },
        "propagateRightsToSubfolders":{
            "type":"boolean",
            "description":"Boolean to indicate if this permission will be applied to all subfolders"
        },
        "rights":{
            "type":"array",
            "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
            "items":{
                "type":"string",
                "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
                "enum":[
                    "read",
                    "write",
                    "list",
                    "delete",
                    "createDir",
                    "deleteDir",
                    "renameDir",
                    "propagateRightsToSubfolders",
                    "all"
                ]
            },
            "enum":[
                "read",
                "write",
                "list",
                "delete",
                "createDir",
                "deleteDir",
                "renameDir",
                "propagateRightsToSubfolders",
                "all"
            ]
        },
        "lastUpdatedBy":{
            "type":"string"
        },
        "lastModified":{
            "type":"string"
        }
    },
    "description":"Configured permission for given directory for given user/group.",
    "xml":{
        "name":"permissions"
    }
}

Nested Schema : rights

Type: array

Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.

Allowed Values: [ "read", "write", "list", "delete", "createDir", "deleteDir", "renameDir", "propagateRightsToSubfolders", "all" ]

Show Source

• Array of: string
  Allowed Values: [ "read", "write", "list", "delete", "createDir", "deleteDir", "renameDir", "propagateRightsToSubfolders", "all" ]

  Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.

{
    "type":"array",
    "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
    "items":{
        "type":"string",
        "description":"Assigned rights list. 'propagateRightsToSubfolders' indicates if this permission will be applied to all subfolders. 'all' includes all other rights except 'propagateRightsToSubfolders' which is specified separately.",
        "enum":[
            "read",
            "write",
            "list",
            "delete",
            "createDir",
            "deleteDir",
            "renameDir",
            "propagateRightsToSubfolders",
            "all"
        ]
    },
    "enum":[
        "read",
        "write",
        "list",
        "delete",
        "createDir",
        "deleteDir",
        "renameDir",
        "propagateRightsToSubfolders",
        "all"
    ]
}

401 Response

Unauthorized

404 Response

Service not found

500 Response

Internal Server Error

Back to Top