如何通过Swift SDK获取受版本控制bucket中的文件元数据

本文介绍如何在受版本控制的存储空间（Bucket）中获取文件（Object）元数据。

注意事项

本文示例代码以华东1（杭州）的地域IDcn-hangzhou为例，默认使用外网Endpoint，如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见OSS地域和访问域名。
要获取文件元数据，您必须有oss:GetObject权限。具体操作，请参见为RAM用户授予自定义的权限策略。

示例代码

使用HeadObject方法获取对象的所有元数据

您可以通过以下代码使用HeadObject方法获取指定对象版本的所有元数据。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {

        do {

            // 填写Bucket所在地域（示例：华东1为cn-hangzhou）
            let region = "cn-hangzhou"
            // 填写Bucket名称
            let bucket = "yourBucketName"
            // 可选项，指定访问OSS服务的域名。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com
            let endpoint: String? = nil
            // 填写要设置标签的对象名称（如：document.txt）
            let key = "yourObjectName" // 替换为实际对象名称
            // 版本id
            let versionId = "versionId"

            // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
            let credentialsProvider = EnvironmentCredentialsProvider()

            // 配置OSS客户端参数
            let config = Configuration.default()
                .withRegion(region)        // 设置Bucket所在地域
                .withCredentialsProvider(credentialsProvider)  // 设置访问凭证
                
            // 设置自定义Endpoint
            if let endpoint = endpoint {
                config.withEndpoint(endpoint)
            }
            
            // 创建OSS客户端实例
            let client = Client(config)

            // 获取元数据
            let result = try await client.headObject(
                HeadObjectRequest(
                    bucket: bucket,
                    key: key,
                    versionId: versionId
                )
            )
            print("result:\n\(result)")

        } catch {
            // 错误输出
            print("error：\(error)")
        }
    }
}

使用GetObjectMeta方法获取对象的部分元数据

说明

使用GetObjectMeta方法仅可以获取部分的对象元数据，包括：返回内容的长度（ContentLength）、实体标签（ETag）、返回的对象最后一次被修改的时间（LastModified）、对象最后一次被访问的时间（LastAccessTime）、对象的版本ID（VersionId）、对象的 64 位 CRC 值（HashCRC64）。

您可以通过以下代码使用GetObjectMeta方法获取指定对象版本的部分元数据。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {

        do {
            // 填写Bucket所在地域（示例：华东1为cn-hangzhou）
            let region = "cn-hangzhou"
            // 填写Bucket名称
            let bucket = "yourBucketName"
            // 可选项，指定访问OSS服务的域名。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com
            let endpoint: String? = nil
            // 填写要设置标签的对象名称（如：document.txt）
            let key = "yourObjectName" // 替换为实际对象名称
            // 版本id
            let versionId = "versionId"

            // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
            let credentialsProvider = EnvironmentCredentialsProvider()

            // 配置OSS客户端参数
            let config = Configuration.default()
                .withRegion(region)        // 设置Bucket所在地域
                .withCredentialsProvider(credentialsProvider)  // 设置访问凭证
                
            // 设置自定义Endpoint
            if let endpoint = endpoint {
                config.withEndpoint(endpoint)
            }
            
            // 创建OSS客户端实例
            let client = Client(config)

            // 获取指定对象版本的部分元数据
            let result = try await client.getObjectMeta(
                GetObjectMetaRequest(
                    bucket: bucket,
                    key: key,
                    versionId: versionId
                )
            )
            print("result:\n\(result)")

        } catch {
            // 错误输出
            print("error：\(error)")
        }
    }
}

Swift获取文件元数据

注意事项

示例代码

使用HeadObject方法获取对象的所有元数据

使用GetObjectMeta方法获取对象的部分元数据

相关文档