Filesystem - Set Properties

  • Ссылка
Service:
Storage Services
API Version:
2021-10-04

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

PATCH https://{accountName}.{dnsSuffix}/{filesystem}?resource=filesystem
With optional parameters: 
PATCH https://{accountName}.{dnsSuffix}/{filesystem}?resource=filesystem&timeout={timeout}

Параметры URI

Name In Required Type Description
accountName
 path True
  • string

Имя учетной записи служба хранилища Azure.
dnsSuffix
 path True
  • string

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

Идентификатор файловой системы. Значение должно начинаться и заканчиваться буквой или цифрой и содержать только буквы, цифры и дефис (-). Последовательные дефисы запрещены. Все буквы должны быть строчными. Значение должно содержать от 3 до 63 символов.

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

Значение должно быть "файловой системой" для всех операций файловой системы.
timeout
 query
  • integer
int32

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

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

Name Required Type Description
x-ms-properties
  • string

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

Необязательный элемент. Значение даты и времени. Укажите этот заголовок для выполнения операции, только если ресурс был изменен с указанной даты и времени.
If-Unmodified-Since
  • string

Необязательный элемент. Значение даты и времени. Укажите этот заголовок для выполнения операции, только если ресурс не был изменен с указанной даты и времени.
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, используемого для обработки запроса. Это необходимо при использовании авторизации общего ключа.

Ответы

Name Type Description
200 OK

ОК

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
Other Status Codes

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

  • 400 Недопустимый запрос, ContentLengthMustBeZero, "Заголовок запроса Content-Length должен быть равен нулю".
  • 400 Недопустимый запрос, InvalidAuthenticationInfo, "Сведения о проверке подлинности не указаны в правильном формате. Проверьте значение заголовка авторизации".
  • 400 Недопустимый запрос, InvalidFlushPosition, "Отправленные данные не являются смежными или значение параметра запроса позиции не равно длине файла после добавления переданных данных".
  • 400 Bad Request, InvalidHeaderValue, "Значение одного из заголовков HTTP не имеет правильного формата".
  • 400 Недопустимый запрос, InvalidHttpVerb, "Указана недопустимая http-команда — она не распознается сервером".
  • 400 Недопустимый запрос, InvalidInput, "Один из входных данных запроса недопустим".
  • 400 Bad Request, InvalidPropertyName, "Имя свойства не может быть пустым".
  • 400 Bad Request, InvalidPropertyName, "Имя свойства содержит недопустимые символы".
  • 400 Недопустимый запрос, InvalidQueryParameterValue, "Значение для одного из параметров запроса, указанных в URI запроса, недопустимо".
  • 400 Bad Request, InvalidResourceName, "Указанное имя ресурса содержит недопустимые символы".
  • 400 Недопустимый запрос, InvalidSourceUri, "Недопустимый URI источника".
  • 400 Недопустимый запрос, 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 Запрещено, InsufficientAccountPermissions: "Доступ к учетной записи не имеет достаточных разрешений для выполнения этой операции".
  • 404 Not Found, FilesystemNotFound, "Указанная файловая система не существует".
  • 404 Not Found, PathNotFound, "Указанный путь не существует".
  • 404 Не найдено, RenameDestinationParentPathNotFound, "Родительский каталог пути назначения не существует".
  • 404 Not Found, ResourceNotFound, "Указанный ресурс не существует".
  • 404 Не найдено, SourcePathNotFound, "Исходный путь для операции переименования не существует".
  • Метод 405 Не разрешен, unsupportedHttpVerb, "Ресурс не поддерживает указанную HTTP-команду".
  • 409 Conflict, DestinationPathIsBeingDeleted, "Указанный путь назначения помечен для удаления".
  • 409 Conflict, DirectoryNotEmpty, "Значение параметра рекурсивного запроса должно иметь значение true, чтобы удалить непустый каталог".
  • 409 Conflict, FilesystemAlreadyExists, "Указанная файловая система уже существует".
  • 409 Conflict, FilesystemBeingDeleted, "Указанная файловая система удаляется".
  • 409 Conflict, InvalidDestinationPath, "Указанный путь или элемент пути существует, и его тип ресурса недопустим для этой операции". * Конфликт 409, InvalidFlushOperation, "Ресурс был создан или изменен API службы BLOB-объектов и не может быть записан в API службы Data Lake Storage".
  • 409 Conflict, InvalidRenameSourcePath, "Исходный каталог не может совпадать с конечным каталогом, а также не может быть подкаталогом исходного каталога".
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Тип исходного и целевого ресурсов должен быть идентичным".
  • 409 Conflict, LeaseAlreadyPresent, "Есть уже арендная презентация".
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Указанный идентификатор аренды не соответствует идентификатору аренды ресурса с указанной операцией аренды".
  • 409 Конфликт, 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. Слишком большая сущность запроса, RequestBodyTooLarge, "Текст запроса слишком велик и превышает максимально допустимое ограничение".
  • 416 Запрошенный диапазон не удовлетворяется, InvalidRange, "Указанный диапазон недопустим для текущего размера ресурса".
  • 500 Внутренняя ошибка сервера, InternalError, "Сервер столкнулся с внутренней ошибкой. Пожалуйста, повторите запрос".
  • 500 Внутренняя ошибка сервера, OperationTimedOut, "Не удалось завершить операцию в течение разрешенного времени".
  • 503 Служба недоступна, ServerBusy, "Egress превышает предел учетной записи".
  • 503 Служба недоступна, ServerBusy, "Входящий трафик превышает предел учетной записи".
  • 503 Служба недоступна, ServerBusy, "Операции в секунду превышает предел учетной записи".
  • 503 Service Unavailable, ServerBusy, "Сервер в настоящее время не может получать запросы. Please retry your request." (Программе установки кластера не удалось установить компоненты в одном или нескольких узлах. Повторите запрос.)

Headers

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

Определения

DataLakeStorageError
Error

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

Значение должно быть "файловой системой" для всех операций с файловой системой.

DataLakeStorageError

Name Type Description
error

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

Error

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

Name Type Description
code
  • string

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

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

FilesystemResourceType

Значение должно быть "файловой системой" для всех операций с файловой системой.

Name Type Description
filesystem
  • string