读取符号链接

项目
2025-05-11

该 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 中显示的路径组件替换为自己的路径组件，如下表所述：

路径组件	DESCRIPTION
`myaccount`	存储帐户的名称。
`myshare`	文件共享的名称。
`mydirectorypath`	可选。符号链接所在的目录的路径。
`mysymboliclink`	符号链接的名称。

有关路径命名限制的信息，请参阅名称和引用共享、目录、文件和元数据。

URI 参数

可以在请求 URI 上指定以下附加参数：

参数	DESCRIPTION
`timeout`	可选。 `timeout` 参数以秒为单位表示。有关详细信息，请参阅设置文件服务作的超时。
`sharesnapshot`	可选。该 `sharesnapshot` 参数是一个不透明的 DateTime 值，如果存在，则指定要查询符号链接的共享快照。

请求标头

下表描述了必需和可选的请求标头：

请求标头	DESCRIPTION
`Authorization`	必填。指定授权方案、帐户名称和签名。有关详细信息，请参阅授权对 Azure 存储的请求。
`Date` 或 `x-ms-date`	必填。指定请求的协调世界时（UTC）时间。有关详细信息，请参阅授权对 Azure 存储的请求。
`x-ms-version`	所有授权请求都是必需的。指定要用于此请求的操作的版本。在版本 2025-05-05 及更高版本中支持此作，以启用 NFS 协议的文件共享。有关详细信息，请参阅 azure 存储服务版本控制。
`x-ms-client-request-id`	可选。提供客户端生成的不透明值，该值具有配置日志记录时日志中记录的 1-kibibyte （KiB）字符限制。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息，请参阅监视 Azure 文件。
`x-ms-file-request-intent`	如果需要 `Authorization` 标头指定 OAuth 令牌。可接受的值为 `backup`。此标头指定，如果 `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` 或 `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` 包含在分配给使用 `Authorization` 标头授权的标识的 RBAC 策略中，则应授予 `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action`。适用于版本 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（正常）。有关状态代码的信息，请参阅状态和错误代码。

响应标头

此作的响应包括下表中的标头：

响应头	DESCRIPTION
`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` 标头的值，并且该值包含不超过 1,024 个可见 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/“未找到”（ShareNotFound）。

如果符号链接的父目录不存在，则作将失败，状态代码为 404/'Not Found' （ParentNotFound）。

另请参阅

对文件作

通过