Прочитать символическую ссылку

Операция Read Symbolic Link считывает символическую ссылку из системы. Эта операция поддерживается в версии 2025-07-05 и более поздних только для общих папок с включенным протоколом NFS.

Доступность протокола

Протокол общей папки с включенным доступом	В наличии
Малый и средний бизнес (SMB)
Сетевая файловая система (NFS)

Просьба

Запрос Read Symbolic Link создается следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS.

Метод	Запрос URI	Версия HTTP
ПОЛУЧАЙ	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/mysymboliclink?restype=symboliclink`	HTTP/1.1
ПОЛУЧАЙ	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/mysymboliclink?restype=symboliclink&sharesnapshot=<DateTime>`	HTTP/1.1

Замените компоненты пути, отображаемые в URI запроса собственным, как описано в следующей таблице:

Компонент path	Описание
`myaccount`	Имя учетной записи хранения.
`myshare`	Имя общей папки.
`mydirectorypath`	Необязательно. Путь к директории, в которой присутствует символическая ссылка.
`mysymboliclink`	Имя символической ссылки.

Сведения об ограничениях именования путей см. в разделе Имя и справочные ресурсы, каталоги, файлы и метаданные.

Параметры URI

Можно указать следующие дополнительные параметры в URI запроса:

Параметр	Описание
`timeout`	Необязательно. Параметр `timeout` выражается в секундах. Дополнительные сведения см. в разделе Установка времени ожидания для операций службы файлов.
`sharesnapshot`	Необязательно. Этот `sharesnapshot` параметр представляет собой непрозрачное значение DateTime, которое при наличии указывает общий снимок для запроса символической ссылки.

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

Обязательные и необязательные заголовки запросов описаны в следующей таблице:

Заголовок запроса	Описание
`Authorization`	Обязательное. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
`Date` или `x-ms-date`	Обязательное. Указывает время универсального времени (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
`x-ms-version`	Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS. Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure.
`x-ms-client-request-id`	Необязательно. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), записанным в журналах при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Monitor Azure Files.
`x-ms-file-request-intent`	Требуется, если заголовок `Authorization` указывает токен OAuth. Допустимое значение равно `backup`. Этот заголовок указывает, что `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` или `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` следует предоставить, если они включены в политику RBAC, назначенную удостоверению, авторизованному с помощью заголовка `Authorization`. Доступно для версии 2022-11-02 и более поздних версий.
`x-ms-allow-trailing-dot: { <Boolean> }`	Необязательно. Версия 2022-11-02 и более поздних версий. Логическое значение указывает, следует ли обрезать конечную точку в URL-адресе запроса. Этот заголовок игнорируется, если целевой объект находится в общей папке с включенным протоколом NFS, который поддерживает конечную точку по умолчанию. Дополнительные сведения см. в разделе Именование и ссылки на общие папки, каталоги, файлы и метаданные.

Основное содержание запроса

Нет.

Пример запроса

Request Syntax:
GET https://myaccount.file.core.windows.net/myshare/mysymboliclink?restype=symboliclink HTTP/1.1
Request Headers:
x-ms-version: 2025-07-05
x-ms-date: Thu, 13 Mar 2025 06:58:30 GMT
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Код состояния

Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в коды состояния и коды ошибок.

Заголовки ответа

Ответ для этой операции содержит заголовки в следующей таблице:

Заголовок ответа	Описание
`Date`	Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ.
`ETag`	ETag содержит значение, представляющее версию файла. Значение заключено в кавычки.
`Last-Modified`	Возвращает дату и время последнего изменения файла. Формат даты следует RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Любая операция, которая изменяет каталог или его свойства, обновляет время последнего изменения. Операции с файлами не влияют на время последнего изменения каталога.
`x-ms-request-id`	Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API
`x-ms-version`	Указывает версию файлов Azure, используемую для выполнения запроса.
`x-ms-link-text`	Путь к целевому файлу, хранящийся в символьной ссылке в виде текста ссылки. Путь закодирован в процентах.
`x-ms-client-request-id`	Используется для устранения неполадок запросов и их соответствующих ответов. Значение этого заголовка равно значению заголовка `x-ms-client-request-id`, если оно присутствует в запросе, а значение содержит не более 1024 видимых символов ASCII. Если в запросе отсутствует заголовок `x-ms-client-request-id`, он отсутствует в ответе.

Основная часть ответа

Нет.

Пример ответа

Response Status:
HTTP/1.1 200 OK
Response Headers:
Date: Thu, 13 Mar 2025 06:58:31 GMT
ETag: "0x8DD61FC7700E64D"
Last-Modified: Thu, 13 Mar 2025 06:58:31 GMT
x-ms-version: 2025-07-05
x-ms-link-text: myfile
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Авторизация

Только владелец учетной записи может вызвать эту операцию.

Замечания

Если общая папка не существует, операция завершается ошибкой с кодом состояния 404/'Not Found' (ShareNotFound).

Если родительский каталог символьной ссылки не существует, то операция завершается ошибкой с кодом состояния 404/'Not Found' (ParentNotFound).

См. также

операции с файлами

Last updated on 2025-05-11