Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added FileSystem Get/SetAccessControl and SetPermissions #8081

Merged
merged 1 commit into from
Jan 8, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -482,6 +482,301 @@
}
]
},
"/{filesystem}/?action=setAccessControl": {
"patch": {
"tags": [
"FileSystem Operations"
],
"operationId": "FileSystem_SetAccessControl",
"description": "Set the owner, group, permissions, or access control list for a file system.",
"parameters": [
{
"$ref": "#/parameters/Timeout"
},
{
"$ref": "#/parameters/LeaseIdOptional"
},
{
"$ref": "#/parameters/Owner"
},
{
"$ref": "#/parameters/Group"
},
{
"$ref": "#/parameters/Permissions"
},
{
"$ref": "#/parameters/Acl"
},
{
"$ref": "#/parameters/IfMatch"
},
{
"$ref": "#/parameters/IfNoneMatch"
},
{
"$ref": "#/parameters/IfModifiedSince"
},
{
"$ref": "#/parameters/IfUnmodifiedSince"
},
{
"$ref": "#/parameters/ClientRequestId"
},
{
"$ref": "#/parameters/ApiVersionParameter"
}
],
"responses": {
"200": {
"description": "Set file system access control response.",
"headers": {
"Date": {
"type": "string",
"format": "date-time-rfc1123",
"description": "A UTC date/time value generated by the service that indicates the time at which the response was initiated."
},
"ETag": {
"type": "string",
"format": "etag",
"description": "An HTTP entity tag associated with the file or directory."
},
"Last-Modified": {
"type": "string",
"format": "date-time-rfc1123",
"description": "The data and time the file or directory was last modified. Write operations on the file system update the last modified time."
},
"x-ms-client-request-id": {
"x-ms-client-name": "ClientRequestId",
"type": "string",
"description": "If a client request id header is sent in the request, this header will be present in the response with the same value."
},
"x-ms-request-id": {
"x-ms-client-name": "RequestId",
"type": "string",
"description": "A server-generated UUID recorded in the analytics logs for troubleshooting and correlation."
},
"x-ms-version": {
"x-ms-client-name": "Version",
"type": "string",
"description": "The version of the REST protocol used to process the request."
}
}
},
"default": {
"description": "Failure",
"headers": {
"x-ms-client-request-id": {
"x-ms-client-name": "ClientRequestId",
"type": "string",
"description": "If a client request id header is sent in the request, this header will be present in the response with the same value."
},
"x-ms-request-id": {
"x-ms-client-name": "RequestId",
"type": "string",
"description": "A server-generated UUID recorded in the analytics logs for troubleshooting and correlation."
},
"x-ms-version": {
"x-ms-client-name": "Version",
"type": "string",
"description": "The version of the REST protocol used to process the request."
}
},
"schema": {
"$ref": "#/definitions/StorageError"
}
}
}
},
"parameters": [
{
"name": "action",
"in": "query",
"required": true,
"type": "string",
"enum": [
"setAccessControl"
]
}
]
},
"/{filesystem}/?action=getAccessControl": {
"head": {
"operationId": "FileSystem_GetAccessControl",
"summary": "Get Access Control List",
"description": "Get Access Control List returns the access control list for a file system. This operation supports conditional HTTP requests. For more information, see [Specifying Conditional Headers for Blob Service Operations](https://docs.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations).",
"tags": [
"File System Operations"
],
"parameters": [
{
"$ref": "#/parameters/Upn"
},
{
"$ref": "#/parameters/LeaseIdOptional"
},
{
"$ref": "#/parameters/IfMatch"
},
{
"$ref": "#/parameters/IfNoneMatch"
},
{
"$ref": "#/parameters/IfModifiedSince"
},
{
"$ref": "#/parameters/IfUnmodifiedSince"
}
],
"responses": {
"200": {
"description": "Returns all properties for the file or directory.",
"headers": {
"Accept-Ranges": {
"description": "Indicates that the service supports requests for partial file content.",
"type": "string"
},
"Cache-Control": {
"description": "If the Cache-Control request header has previously been set for the resource, that value is returned in this header.",
"type": "string"
},
"Content-Disposition": {
"description": "If the Content-Disposition request header has previously been set for the resource, that value is returned in this header.",
"type": "string"
},
"Content-Encoding": {
"description": "If the Content-Encoding request header has previously been set for the resource, that value is returned in this header.",
"type": "string"
},
"Content-Language": {
"description": "If the Content-Language request header has previously been set for the resource, that value is returned in this header.",
"type": "string"
},
"Content-Length": {
"description": "The size of the resource in bytes.",
"type": "integer",
"format": "int64"
},
"Content-Range": {
"description": "Indicates the range of bytes returned in the event that the client requested a subset of the file by setting the Range request header.",
"type": "string"
},
"Content-Type": {
"description": "The content type specified for the resource. If no content type was specified, the default content type is application/octet-stream.",
"type": "string"
},
"Content-MD5": {
"description": "The MD5 hash of complete file stored in storage. This header is returned only for \"GetProperties\" operation. If the Content-MD5 header has been set for the file, this response header is returned for GetProperties call so that the client can check for message content integrity.",
"type": "string"
},
"Date": {
"description": "A UTC date/time value generated by the service that indicates the time at which the response was initiated.",
"type": "string",
"format": "date-time-rfc1123"
},
"ETag": {
"description": "An HTTP entity tag associated with the file or directory.",
"format": "etag",
"type": "string"
},
"Last-Modified": {
"description": "The data and time the file or directory was last modified. Write operations on the file or directory update the last modified time.",
"format": "date-time-rfc1123",
"type": "string"
},
"x-ms-request-id": {
"x-ms-client-name": "RequestId",
"description": "A server-generated UUID recorded in the analytics logs for troubleshooting and correlation.",
"pattern": "^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$",
"type": "string"
},
"x-ms-version": {
"x-ms-client-name": "Version",
"description": "The version of the REST protocol used to process the request.",
"type": "string"
},
"x-ms-resource-type": {
"x-ms-client-name": "ResourceType",
"description": "The type of the resource. The value may be \"file\" or \"directory\". If not set, the value is \"file\".",
"type": "string"
},
"x-ms-properties": {
"x-ms-client-name": "Properties",
"description": "The user-defined properties associated with the file or directory, in the format of a comma-separated list of name and value pairs \"n1=v1, n2=v2, ...\", where each value is a base64 encoded string. Note that the string may only contain ASCII characters in the ISO-8859-1 character set.",
"type": "string"
},
"x-ms-owner": {
"x-ms-client-name": "Owner",
"description": "The owner of the file or directory. Included in the response if Hierarchical Namespace is enabled for the account.",
"type": "string"
},
"x-ms-group": {
"x-ms-client-name": "Group",
"description": "The owning group of the file or directory. Included in the response if Hierarchical Namespace is enabled for the account.",
"type": "string"
},
"x-ms-permissions": {
"x-ms-client-name": "Permissions",
"description": "The POSIX access permissions for the file owner, the file owning group, and others. Included in the response if Hierarchical Namespace is enabled for the account.",
"type": "string"
},
"x-ms-acl": {
"x-ms-client-name": "ACL",
"description": "The POSIX access control list for the file or directory. Included in the response only if the action is \"getAccessControl\" and Hierarchical Namespace is enabled for the account.",
"type": "string"
},
"x-ms-lease-duration": {
"x-ms-client-name": "LeaseDuration",
"description": "When a resource is leased, specifies whether the lease is of infinite or fixed duration.",
"type": "string"
},
"x-ms-lease-state": {
"x-ms-client-name": "LeaseState",
"description": "Lease state of the resource.",
"type": "string"
},
"x-ms-lease-status": {
"x-ms-client-name": "LeaseStatus",
"description": "The lease status of the resource.",
"type": "string"
}
}
},
"default": {
"description": "Failure",
"headers": {
"x-ms-error-code": {
"x-ms-client-name": "ErrorCode",
"type": "string"
}
},
"schema": {
"$ref": "#/definitions/StorageError"
}
}
}
},
"parameters": [
{
"name": "action",
"in": "query",
"required": true,
"type": "string",
"enum": [
"getAccessControl"
]
},
{
"$ref": "#/parameters/ClientRequestId"
},
{
"$ref": "#/parameters/Timeout"
},
{
"$ref": "#/parameters/ApiVersionParameter"
}
]
},
"/{filesystem}/{path}": {
"put": {
"operationId": "Path_Create",
Expand Down