Jump to

• Request
• Response

Get user permission

get

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

Get folder permissions for a user

Request

Path Parameters

• guid(required): string
  folder guid
• user(required): string
  user name

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success

Body ()

Root Schema : principleDirectoryPermission

Type: object

Read Only: true

Configured permission for given user/group for given directory.

Show Source

• doNotInherit: boolean
  Boolean indicating that current folder and child folders will not inherit any permission from its parent folders.
• id: string
• links: array links
• path: string
  Directory for which permission is assigned.
• pathId: string
• permission: object permissions
  Configured permission for given directory for given user/group.

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string"
        },
        "path":{
            "type":"string",
            "description":"Directory for which permission is assigned."
        },
        "pathId":{
            "type":"string"
        },
        "doNotInherit":{
            "type":"boolean",
            "description":"Boolean indicating that current folder and child folders will not inherit any permission from its parent folders."
        },
        "permission":{
            "$ref":"#/components/schemas/Permission"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"Configured permission for given user/group for given directory.",
    "nullable":true,
    "readOnly":true,
    "xml":{
        "name":"principleDirectoryPermission",
        "namespace":"http://xmlns.oracle.com/cloud/fileserver/filesystem/principleDirectoryPermission"
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object Link

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

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 : 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 : 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