Path - Update

Добавление данных | Очистка данных | Задание свойств | Настройка контроль доступа
Отправляет данные для добавления в файл, сбрасывает (записывает) ранее отправленные данные в файл, задает свойства файла или каталога или задает управление доступом к файлу или каталогу. Данные могут быть добавлены только в файл. Одновременная запись в один файл с использованием нескольких клиентов не поддерживается. Эта операция поддерживает условные HTTP-запросы. Дополнительные сведения см. в статье Указание условных заголовков для операций службы BLOB-объектов.

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}
PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&timeout={timeout}

Параметры URI

Имя В Обязательно Тип Описание
accountName
path True

string

Имя учетной записи хранения Azure.

dnsSuffix
path True

string

DNS-суффикс для конечной точки Azure Data Lake Storage.

filesystem
path True

string

Идентификатор файловой системы.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

path
path True

string

Путь к файлу или каталогу.

action
query True

PathUpdateAction

Действие должно быть "добавить" для отправки данных, которые должны быть добавлены в файл, "очистить" для очистки ранее отправленных данных в файл, "setProperties", чтобы задать свойства файла или каталога, или "setAccessControl", чтобы задать владельца, группу, разрешения или список управления доступом для файла или каталога, или setAccessControlRecursive, чтобы рекурсивно задать список управления доступом для каталога. Обратите внимание, что для учетной записи необходимо включить иерархическое пространство имен, чтобы использовать управление доступом. Также обратите внимание, что список контроль доступа (ACL) включает разрешения для владельца, группы владельцев и других пользователей, поэтому заголовки запросов x-ms-permissions и x-ms-acl являются взаимоисключающими.

close
query

boolean

События службы хранилища Azure позволяют приложениям получать уведомления при изменении файлов. При включении событий службы хранилища Azure возникает событие изменения файла. Это событие имеет свойство, указывающее, является ли это окончательным изменением, чтобы различать разницу между промежуточным сбросом в файловый поток и окончательным закрытием файлового потока. Параметр запроса close действителен только в том случае, если действием является "очистка" и включены уведомления об изменениях. Если значение close равно true и операция очистки завершается успешно, служба выдает уведомление об изменении файла со свойством , указывающим, что это окончательное обновление (файловый поток закрыт). Если значение false, подается уведомление об изменении, указывающее, что файл был изменен. Значение по умолчанию — false. Драйвер Hadoop ABFS задает этому параметру запроса значение true, чтобы указать, что файловый поток закрыт.

continuation
query

string

Необязательный и допустимый только для операции setAccessControlRecursive. Количество путей, обрабатываемых с каждым вызовом, ограничено. Если количество обрабатываемых путей превышает это ограничение, маркер продолжения возвращается в заголовке ответа x-ms-continuation. Когда маркер продолжения возвращается в ответе, он должен быть закодирован в процентах и указан при последующем вызове операции setAccessControlRecursive.

flush
query

boolean

Допустимо только для вызовов добавления. Этот параметр позволяет вызывающей объекту выполнять очистку во время вызова добавления. Значение по умолчанию — false, если значение true, данные будут сброшены с помощью вызова добавления. Обратите внимание, что при использовании flush=true следующие заголовки не поддерживаются: "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". Чтобы задать эти заголовки во время очистки, используйте action=flush.

forceFlag
query

boolean

Необязательный и допустимый только для операции setAccessControlRecursive. Если это значение false, операция быстро завершится при возникновении ошибок пользователя (4XX). Если значение равно true, API проигнорирует ошибки пользователя и продолжит операцию с другими вложенными сущностями каталога. Подробное состояние ошибок пользователя будет возвращено в ответе для любого сценария. Маркер продолжения возвращается только в том случае, если forceFlag имеет значение true в случае ошибок пользователя. Значение по умолчанию для forceFlag — false.

maxRecords
query

integer

int32

Необязательный и допустимый только для операции setAccessControlRecursive. Он указывает максимальное количество файлов или каталогов, к которым будет применено изменение списка acl. Если значение пропущено или больше 2000, запрос обработает до 2000 элементов.

mode
query

string

Необязательный элемент. Допустимые и обязательные для операции setAccessControlRecursive. Режим "set" устанавливает права управления доступом POSIX к файлам и каталогам, "modify" изменяет одно или несколько прав управления доступом POSIX, которые ранее существовали в файлах и каталогах, "remove" удаляет одно или несколько прав управления доступом POSIX, которые были ранее в файлах и каталогах

position
query

integer

int64

Этот параметр позволяет вызывающему объекту отправлять данные параллельно и управлять порядком их добавления в файл. Он необходим при отправке данных, добавляемых в файл, и при очистке ранее отправленных данных в файл. Значение должно быть позицией, в которой должны быть добавлены данные. Отправленные данные не сразу сбрасываются или не записываются в файл. Для очистки ранее отправленные данные должны быть смежными, параметр position должен быть указан и равен длине файла после записи всех данных, а также не должно быть тела сущности запроса, включаемой в запрос.

retainUncommittedData
query

boolean

Допустимо только для операций очистки. Если значение равно true, незафиксированные данные сохраняются после завершения операции очистки; В противном случае незафиксированные данные удаляются после операции очистки. Значение по умолчанию — false. Данные со смещением меньше указанной позиции записываются в файл при успешной очистке, но этот необязательный параметр позволяет сохранять данные после позиции очистки для будущей операции очистки.

timeout
query

integer

int32

Необязательное значение времени ожидания операции в секундах. Период начинается с момента получения запроса службой. Если время ожидания истекает до завершения операции, операция завершается сбоем.

Заголовок запроса

Media Types: "application/octet-stream", "text/plain"

Имя Обязательно Тип Описание
Content-Length

integer

int64

Требуется для добавления данных и очистки данных. Для параметра "Очистка данных" должно быть значение 0. Длина содержимого запроса в байтах для параметра "Добавление данных".

Content-MD5

string

Необязательный элемент. Хэш MD5 содержимого запроса. Этот заголовок действителен для операций Append и Flush. Этот хэш используется для проверки целостности содержимого запроса в ходе транспортировки. Если указан этот заголовок, то служба хранилища сравнивает хэш полученного содержимого со значением, полученным в этом заголовке. Если хэш не совпадает, операция завершится с ошибкой и кодом ошибки 400 (неправильный запрос). Обратите внимание, что этот хэш MD5 не хранится вместе с файлом. Этот заголовок связан с содержимым запроса, а не с хранимым содержимым самого файла.

x-ms-lease-id

string

При наличии активной аренды необходимо указать идентификатор аренды. Недопустимо для операций setAccessControlRecursive.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-cache-control

string

Необязательный и допустимый только для операций очистки и задания свойств. Служба сохраняет это значение и включает его в заголовок ответа Cache-Control для операций чтения файла.

x-ms-content-type

string

Необязательный и допустимый только для операций очистки и задания свойств. Служба сохраняет это значение и включает его в заголовок ответа Content-Type для операций чтения файла.

x-ms-content-disposition

string

Необязательный и допустимый только для операций очистки и задания свойств. Служба сохраняет это значение и включает его в заголовок ответа Content-Disposition для операций чтения файла.

x-ms-content-encoding

string

Необязательный и допустимый только для операций очистки и задания свойств. Служба сохраняет это значение и включает его в заголовок ответа Content-Encoding для операций чтения файла.

x-ms-content-language

string

Необязательный и допустимый только для операций очистки и задания свойств. Служба сохраняет это значение и включает его в заголовок ответа Content-Language для операций чтения файла.

x-ms-content-md5

string

Необязательный и допустимый только для операций очистки и задания свойств. Служба сохраняет это значение и включает его в заголовок ответа Content-Md5 для операций чтения и получения свойств. Если это свойство не задано в запросе, то это свойство файла будет очищено. Последующие вызовы свойств Read и Get не будут возвращать это свойство, если оно не будет явно задано для этого файла снова.

x-ms-properties

string

Необязательный элемент. Определяемые пользователем свойства, которые хранятся в файле или каталоге, в формате разделенного запятыми списка пар "n1=v1, n2=v2, ...", где каждое значение представляет собой строку в кодировке Base64. Обратите внимание, что строка может содержать только символы ASCII в наборе символов ISO-8859-1. Допустимо только для операции setProperties. Если файл или каталог существует, все свойства, не включенные в список, будут удалены. Все свойства удаляются, если заголовок опущен. Чтобы объединить новые и существующие свойства, сначала получите все существующие свойства и текущий E-Тег, а затем выполните условный запрос с E-Тегом и включите значения для всех свойств.

x-ms-owner

string

Необязательный и допустимый только для операции setAccessControl. Задает владельца файла или каталога.

x-ms-group

string

Необязательный и допустимый только для операции setAccessControl. Задает группу владельцев файла или каталога.

x-ms-permissions

string

Необязательный и допустимый, только если для учетной записи включено иерархическое пространство имен. Задает разрешения на доступ к POSIX для владельца файла, группы владельцев файлов и т. д. Каждому классу может быть предоставлено разрешение на чтение (4), запись (2) или на выполнение (1). Поддерживаются символьная (rwxrw-rw-) и 4-значная восьмеричная нотация (например, 0766). Прилипающий бит также поддерживается и в символьной нотации. Он представлен буквой t или T в окончательном месте символа в зависимости от того, задан или не задан бит выполнения для другой категории соответственно (например, rwxrw-rw- с липким битом представляется как rwxrw-rwT). Rwxrw-rwx с липким битом представлен как rwxrw-rwt), отсутствие t или T указывает на то, что липкий бит не задан. В четырехзначном восьмеричном нотации она представлена 1-й цифрой (например, 1766 представляет rwxrw-rw- с липким битом, а 0766 представляет rwxrw-rw- без липкой бит). Недопустимо в сочетании с x-ms-acl.

x-ms-acl

string

Необязательный и допустимый только для операций setAccessControl и setAccessControlRecursive. Требуется для операции setAccessControlRecursive. Задает права управления доступом POSIX к файлам и каталогам. Значение представляет собой разделенный запятыми список записей управления доступом, который полностью заменяет существующий список управления доступом (ACL) в случае setAccessControl и режим setAccessControlRecursive. Режим "modify" setAccessControlRecursive обновляет уже существующие ACLS. Каждая запись управления доступом (ACE) состоит из область, типа, идентификатора пользователя или группы и разрешений в формате "[область:][тип]:[id]:[permissions]". Область должно быть "по умолчанию", чтобы указать, что ACE принадлежит ACL по умолчанию для каталога; в противном случае область неявно, а ACE принадлежит к ACL доступа. Существует четыре типа ACE: "пользователь" предоставляет права владельцу или именованного пользователя, "группа" предоставляет права группе-владельцу или именованной группе, "маска" ограничивает права, предоставленные именованным пользователям и членам групп, а "другие" предоставляет права всем пользователям, которых нет ни в одной из других записей. Идентификатор пользователя или группы опущен для записей типа mask и other. Идентификатор пользователя или группы также опущен для владельца и группы-владельца. Поле разрешений представляет собой последовательность из 3 символов, где первый символ — "r" для предоставления доступа на чтение, второй — "w" для предоставления доступа на запись, а третий символ — "x" для предоставления разрешения на выполнение. Если доступ не предоставлен, символ "-" используется для обозначения отказа в разрешении. Например, следующий список управления доступом предоставляет права на чтение, запись и выполнение владельцу файла и john.doe@contoso, право на чтение группе-владельцу и ничего не предоставляет всем остальным: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Недопустимо в сочетании с x-ms-permissions. Режим "remove" setAccessControlRecursive удаляет уже существующие списки управления доступом и не должен содержать разрешения в указанном списке управления доступом : "user:john.doe@contoso:, mask:". Режим set (set) setAccessControlRecursive задает списки управления доступом, заменяющие уже существующие списки управления доступом указанного область, и должны содержать все три параметра : пользователь-владение, группа владельцев и другие сведения, если область доступа устанавливается или если в область по умолчанию устанавливается пользователь, группа владельцев или другая. Режимы set и modify setAccessControlRecursive должны содержать разрешения в составе списка управления доступом.

If-Match

string

Необязательный параметр для сброса данных, установка контроль доступа и задание свойств, но недопустимый для добавления данных и задания контроль доступа рекурсивного. Значение ETag. Укажите этот заголовок для выполнения операции только в том случае, если ETag ресурса соответствует указанному значению. ETag должен быть указан в кавычках.

If-None-Match

string

Необязательный параметр для сброса данных, установка контроль доступа и задание свойств, но недопустимый для добавления данных и задания контроль доступа рекурсивного. Значение ETag или специальное значение с подстановочным знаком ("*"). Укажите этот заголовок для выполнения операции только в том случае, если ETag ресурса не соответствует указанному значению. ETag должен быть указан в кавычках.

If-Modified-Since

string

Необязательный параметр для очистки данных и свойств set, но недопустимый для добавления данных и задания контроль доступа рекурсивного. Значение даты и времени. Укажите этот заголовок для выполнения операции, только если ресурс был изменен с указанной даты и времени.

If-Unmodified-Since

string

Необязательный параметр для очистки данных и свойств set, но недопустимый для добавления данных и задания контроль доступа рекурсивного. Значение даты и времени. Укажите этот заголовок для выполнения операции, только если ресурс не был изменен с указанной даты и времени.

x-ms-encryption-key

string

Необязательный элемент. Ключ шифрования AES-256 в кодировке Base64.

x-ms-encryption-key-sha256

string

Необязательный элемент. Хэш SHA256 в кодировке Base64 ключа шифрования.

x-ms-encryption-algorithm: AES256

string

Необязательный элемент. Указывает алгоритм, используемый для шифрования. Значение этого заголовка должно быть AES256.

x-ms-lease-action True

PathLeaseAction

Начиная с версии 2020-08-04 в операциях добавления и очистки. Добавление поддерживает действие "получение", "автоматическое продление" и "получение-выпуск". Если "приобрести", он получит аренду. При автоматическом продлении аренда будет продлена. При получении и выпуске он получит & завершить операцию & освободить аренду после завершения операции. Действие "Освободить" поддерживается только в операции очистки. Если задано значение true, будет освобождена аренда файла, используя сведения об идентификаторе аренды из заголовка x-ms-lease-id.

x-ms-lease-duration

integer

int32

Длительность аренды необходима для получения аренды и указывает длительность аренды в секундах. Продолжительность аренды должна составлять от 15 до 60 секунд или -1 для бесконечной аренды.

x-ms-proposed-lease-id

string

Требуется, если "x-ms-lease-action" имеет значение "acquire" или "change". При успешном выполнении операции будет получена аренда с этим идентификатором аренды.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-client-request-id

string

UUID, записанный в журналы аналитики для устранения неполадок и корреляции.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-date

string

Задает время запроса в формате UTC. Это необходимо при использовании авторизации с общим ключом.

x-ms-version

string

Указывает версию протокола REST, используемого для обработки запроса. Это необходимо при использовании авторизации с общим ключом.

Текст запроса

Media Types: "application/octet-stream", "text/plain"

Имя Тип Описание
requestBody

object

Допустимо только для операций добавления. Данные для отправки и добавления в файл.

Ответы

Имя Тип Описание
200 OK

SetAccessControlRecursiveResponse

Данные были сброшены (записаны) в файл или свойства были успешно заданы. Текст ответа необязателен и действителен только для SetAccessControlRecursive.

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • Accept-Ranges: string
  • Cache-Control: string
  • Content-Disposition: string
  • Content-Encoding: string
  • Content-Language: string
  • Content-Length: integer
  • Content-Range: string
  • Content-Type: string
  • Content-MD5: string
  • x-ms-properties: string
  • x-ms-continuation: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
  • x-ms-lease-renewed: boolean
202 Accepted

Отправленные данные были приняты.

Headers

  • Content-MD5: string
  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-renewed: boolean
Other Status Codes

DataLakeStorageError

Произошла ошибка. Ниже перечислены возможные строки состояния HTTP, кода и сообщений.

  • 400 Bad Request, ContentLengthMustBeZero, "Заголовок запроса Content-Length должен быть равен нулю".
  • 400 Bad Request, InvalidAuthenticationInfo, "Сведения о проверке подлинности не предоставлены в правильном формате. Проверьте значение заголовка авторизации".
  • 400 Bad Request, InvalidFlushPosition, "Отправленные данные не являются непрерывными или значение параметра запроса position не равно длине файла после добавления отправленных данных".
  • 400 Bad Request, InvalidHeaderValue, "Значение для одного из заголовков HTTP имеет неправильный формат".
  • 400 Bad Request, InvalidHttpVerb, "Указана недопустимая HTTP-команда , она не распознана сервером".
  • 400 Bad Request, InvalidInput, "Один из входных данных запроса недопустим".
  • 400 Bad Request, InvalidPropertyName, "Имя свойства не может быть пустым".
  • 400 Bad Request, InvalidPropertyName, "Имя свойства содержит недопустимые символы".
  • 400 Bad Request, InvalidQueryParameterValue, "Значение для одного из параметров запроса, указанных в URI запроса, недопустимо".
  • 400 Bad Request, InvalidResourceName, "Указанное имя ресурса содержит недопустимые символы".
  • 400 Bad Request, InvalidSourceUri, "Недопустимый URI источника".
  • 400 Bad Request, InvalidUri, "Недопустимый URI запроса".
  • 400 Bad Request, MissingRequiredHeader, "Http-заголовок, который является обязательным для этого запроса, не указан".
  • 400 Bad Request, MissingRequiredQueryParameter, "Параметр запроса, который является обязательным для этого запроса, не указан".
  • 400 Bad Request, MultipleConditionHeadersNotSupported, "Несколько заголовков условий не поддерживаются".
  • 400 Bad Request, OutOfRangeInput, "Один из входных данных запроса находится вне диапазона".
  • 400 Bad Request, OutOfRangeQueryParameterValue, "Один из параметров запроса, указанных в URI запроса, находится за пределами допустимого диапазона".
  • 400 Bad Request, UnsupportedHeader, "Один из заголовков, указанных в запросе, не поддерживается".
  • 400 Bad Request, UnsupportedQueryParameter, "Один из параметров запроса, указанных в URI запроса, не поддерживается".
  • 400 Bad Request, UnsupportedRestVersion, "Указанная версия rest не поддерживается".
  • 403 Запрещено, AccountIsDisabled, "Указанная учетная запись отключена".
  • 403 Запрещено, AuthorizationFailure, "Этот запрос не авторизован для выполнения этой операции".
  • 403 Forbidden, InsufficientAccountPermissions, "У учетной записи, к которой осуществляется доступ, нет достаточных разрешений для выполнения этой операции".
  • 404 Не найдено, FilesystemNotFound, "Указанная файловая система не существует".
  • 404 Не найдено, PathNotFound, "Указанный путь не существует".
  • 404 Not Found, RenameDestinationParentPathNotFound, "Родительский каталог пути назначения не существует".
  • 404 Не найдено, ResourceNotFound, "Указанный ресурс не существует".
  • 404 Not Found, SourcePathNotFound, "Исходный путь для операции переименования не существует".
  • 405 Method Not Allowed, UnsupportedHttpVerb, The resource't support the specified HTTP verb.
  • 409 Conflict, DestinationPathIsBeingDeleted, "Указанный путь назначения помечен для удаления".
  • 409 Conflict, DirectoryNotEmpty, "Значение параметра рекурсивного запроса должно быть true для удаления непустого каталога".
  • 409 Conflict, FilesystemAlreadyExists, "Указанная файловая система уже существует".
  • 409 Conflict, FilesystemBeingDeleted, "Указанная файловая система удаляется".
  • 409 Conflict, InvalidDestinationPath, "Указанный путь или элемент пути существует и его тип ресурса недопустим для этой операции". * 409 Conflict, InvalidFlushOperation, "Ресурс был создан или изменен API службы BLOB-объектов и не может быть записан с помощью API службы Data Lake Storage".
  • 409 Conflict, InvalidRenameSourcePath, "Исходный каталог не может совпадать с целевым каталогом, а назначение не может быть подкаталогом исходного каталога".
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Исходный и целевой типы ресурсов должны быть идентичными".
  • 409 Conflict, LeaseAlreadyPresent, "Есть уже арендный подарок".
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Указанный идентификатор аренды не соответствует идентификатору аренды для ресурса с указанной операцией аренды".
  • 409 Conflict, LeaseIsAlreadyBroken, "Аренда уже нарушена и не может быть нарушена снова".
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "Идентификатор аренды совпадает, но аренда в настоящее время находится в состоянии нарушения и не может быть получена, пока она не будет нарушена".
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Идентификатор аренды совпадает, но аренда в настоящее время находится в состоянии нарушения и не может быть изменена".
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "Идентификатор аренды совпадает, но аренда была явно нарушена и не может быть продлена".
  • 409 Conflict, LeaseNameMismatch, "Указанное имя аренды не соответствует существующему имени аренды".
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "Идентификатор аренды отсутствует в указанной операции аренды".
  • 409 Conflict, PathAlreadyExists, "Указанный путь уже существует".
  • 409 Conflict, PathConflict, "Указанный путь или элемент пути существует, и его тип ресурса недопустим для этой операции".
  • 409 Conflict, SourcePathIsBeingDeleted, "Указанный исходный путь помечен для удаления".
  • 409 Conflict, ResourceTypeMismatch, "Тип ресурса, указанный в запросе, не соответствует типу ресурса".
  • 412. Сбой предусловия, ConditionNotMet, "Условие, указанное с помощью условных заголовков HTTP, не выполнено".
  • 412. Сбой предварительного условия, LeaseIdMismatch, "Указанный идентификатор аренды не соответствует идентификатору аренды для ресурса".
  • 412 Сбой предварительного условия, LeaseIdMissing: "В настоящее время имеется аренда ресурса и идентификатор аренды не указан в запросе".
  • 412 Сбой предварительного условия, LeaseNotPresent, "В настоящее время нет аренды ресурса".
  • 412 Сбой предварительного условия, LeaseLost, "Указан идентификатор аренды, но срок аренды ресурса истек".
  • 412 Сбой предусловия, SourceConditionNotMet, "Исходное условие, указанное с помощью условных заголовков HTTP, не выполнено".
  • 413 Request Entity Too Large, RequestBodyTooLarge, "Текст запроса слишком велик и превышает максимально допустимое ограничение".
  • 416 Запрошенный диапазон не удовлетворяет, InvalidRange, "Указанный диапазон является недопустимым для текущего размера ресурса".
  • 500 Внутренняя ошибка сервера, Внутренняя ошибка, "Сервер обнаружил внутреннюю ошибку. Пожалуйста, повторите запрос".
  • 500 Внутренняя ошибка сервера OperationTimedOut: "Не удалось завершить операцию в течение разрешенного времени".
  • 503 Служба недоступна, ServerBusy, "Исходящий трафик превышает лимит учетной записи".
  • 503 Служба недоступна, ServerBusy, "Входящий трафик превышает лимит учетной записи".
  • 503 Служба недоступна, ServerBusy, "Количество операций в секунду превышает лимит учетной записи".
  • 503 Служба недоступна, ServerBusy, "Сервер в настоящее время не может получать запросы. Please retry your request." (Программе установки кластера не удалось установить компоненты в одном или нескольких узлах. Повторите запрос.)

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Определения

Имя Описание
AclFailedEntryList
DataLakeStorageError
Error

Объект ответа об ошибке службы.

PathLeaseAction

Начиная с версии 2020-08-04 в операциях добавления и очистки. Append поддерживает действия acquire, auto-renew и acquire-release. Если "приобрести", он получит аренду. При автоматическом продлении аренда будет продлена. Если "acquire-release" он получит & завершить операцию & освободить аренду после завершения операции. Действие "Освободить" поддерживается только в операции очистки. Если задано значение true, отпустит аренду файла, используя сведения об идентификаторе аренды из заголовка x-ms-lease-id.

PathUpdateAction

Действие должно быть "add" для отправки данных, которые должны быть добавлены в файл, "очистка" для очистки ранее отправленных данных в файл, "setProperties", чтобы задать свойства файла или каталога, или "setAccessControl", чтобы задать владельца, группу, разрешения или список управления доступом для файла или каталога, или "setAccessControlRecursive", чтобы задать список управления доступом для каталога рекурсивно. Обратите внимание, что для использования управления доступом для учетной записи необходимо включить иерархическое пространство имен. Кроме того, обратите внимание, что список контроль доступа (ACL) включает разрешения для владельца, группы владельцев и т. д., поэтому заголовки запросов x-ms-permissions и x-ms-acl являются взаимоисключающими.

SetAccessControlRecursiveResponse

AclFailedEntryList

Имя Тип Описание
errorMessage

string

name

string

type

string

DataLakeStorageError

Имя Тип Описание
error

Error

Объект ответа об ошибке службы.

Error

Объект ответа об ошибке службы.

Имя Тип Описание
code

string

Код ошибки службы.

message

string

Сообщение об ошибке службы.

PathLeaseAction

Начиная с версии 2020-08-04 в операциях добавления и очистки. Append поддерживает действия acquire, auto-renew и acquire-release. Если "приобрести", он получит аренду. При автоматическом продлении аренда будет продлена. Если "acquire-release" он получит & завершить операцию & освободить аренду после завершения операции. Действие "Освободить" поддерживается только в операции очистки. Если задано значение true, отпустит аренду файла, используя сведения об идентификаторе аренды из заголовка x-ms-lease-id.

Имя Тип Описание
acquire

string

acquire-release

string

auto-renew

string

release

string

PathUpdateAction

Действие должно быть "add" для отправки данных, которые должны быть добавлены в файл, "очистка" для очистки ранее отправленных данных в файл, "setProperties", чтобы задать свойства файла или каталога, или "setAccessControl", чтобы задать владельца, группу, разрешения или список управления доступом для файла или каталога, или "setAccessControlRecursive", чтобы задать список управления доступом для каталога рекурсивно. Обратите внимание, что для использования управления доступом для учетной записи необходимо включить иерархическое пространство имен. Кроме того, обратите внимание, что список контроль доступа (ACL) включает разрешения для владельца, группы владельцев и т. д., поэтому заголовки запросов x-ms-permissions и x-ms-acl являются взаимоисключающими.

Имя Тип Описание
append

string

flush

string

setAccessControl

string

setAccessControlRecursive

string

setProperties

string

SetAccessControlRecursiveResponse

Имя Тип Описание
directoriesSuccessful

integer

failedEntries

AclFailedEntryList[]

failureCount

integer

filesSuccessful

integer