Swift配置客户端

内网域名配置示例

当您的应用部署在阿里云的ECS实例上，并且需要频繁访问同地域的OSS资源时，使用内网域名可以降低流量成本并提高访问速度。

以下是使用OSS内网域名配置OSSClient的示例代码。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        // 填写Bucket所在地域（示例：华东1为cn-hangzhou）
        let region = "cn-hangzhou"
        let endpoint: String? = "https://oss-cn-hangzhou-internal.aliyuncs.com" // 可选项，指定访问OSS服务的内网域名。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou-internal.aliyuncs.com

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

        // 配置OSS客户端参数
        let config = Configuration.default()
            .withRegion(region)        // 设置Bucket所在地域
            .withCredentialsProvider(credentialsProvider)  // 设置访问凭证
        // 您也可以无需指定内网endpoint，直接设置useInternalEndpoint = true配置内网域名
        //    .withUseInternalEndpoint(true)
            
        // 设置自定义Endpoint
        if let endpoint = endpoint {
            config.withEndpoint(endpoint)
        }
        
        // 创建OSS客户端实例
        let client = Client(config)
    }
}

自定义域名配置示例

当您有多个不同的OSS Bucket用于不同的目的时，可以通过为每个Bucket设置不同的子域名来更好地管理和组织资源。

以下是使用自定义域名配置OSSClient的示例代码。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        // 填写Bucket所在地域（示例：华东1为cn-hangzhou）
        let region = "cn-hangzhou"
        let endpoint: String? = "https://www.example-***.com"  // 必须项，请填写您的自定义域名。例如www.example-***.com

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

        // 配置OSS客户端参数
        let config = Configuration.default()
            .withRegion(region)        // 设置Bucket所在地域
            .withCredentialsProvider(credentialsProvider)  // 设置访问凭证
            .withUseCname(true)		// 请注意，设置true开启CNAME选项，否则无法使用自定义域名
            
        // 设置自定义Endpoint
        if let endpoint = endpoint {
            config.withEndpoint(endpoint)
        }
        
        // 创建OSS客户端实例
        let client = Client(config)
    }
}

传输加速域名配置示例

以下是使用传输加速域名配置OSSClient的示例代码。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        // 填写Bucket所在地域（示例：华东1为cn-hangzhou）
        let region = "cn-hangzhou"
        let endpoint: String? = "https://oss-cn-hangzhou-accelerate.aliyuncs.com" // 可选项，填写Bucket所在地域对应的传输加速Endpoint。以华东1（杭州）为例，Endpoint填写为'https://oss-accelerate.aliyuncs.com'

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

        // 配置OSS客户端参数
        let config = Configuration.default()
            .withRegion(region)        // 设置Bucket所在地域
            .withCredentialsProvider(credentialsProvider)  // 设置访问凭证
        // 您也可以无需指定传输加速endpoint，直接设置useAccelerateEndpoint = true配置传输加速域名
        //    .withUseAccelerateEndpoint(true)
            
        // 设置自定义Endpoint
        if let endpoint = endpoint {
            config.withEndpoint(endpoint)
        }
        
        // 创建OSS客户端实例
        let client = Client(config)
    }
}

专有域配置示例

以下是使用专有域配置OSSClient的示例代码。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        // 填写Bucket所在地域（示例：华东1为cn-hangzhou）
        let region = "cn-hangzhou"
        let endpoint: String? = "https://service.corp.example.com"  // 必须项，请填写您的专有域。例如：https://service.corp.example.com

        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量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)
    }
}

金融云配置示例

以下是使用金融云域名配置OSSClient的示例代码。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        // 填写Bucket所在地域。以华东1 金融云为例，Region填写为cn-hangzhou-finance
        let region = "cn-hangzhou-finance"
        let endpoint: String? = "https://oss-cn-hzjbp-a-internal.aliyuncs.com"  // 必须项， 填写Bucket所在地域对应的内网Endpoint。以华东1 金融云为例，Endpoint填写为'https://oss-cn-hzjbp-a-internal.aliyuncs.com'

        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量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)
    }
}

政务云配置示例

以下是使用政务云域名配置OSSClient的示例代码。

import AlibabaCloudOSS
import Foundation

@main
struct Main {
    static func main() async {
        // 填写Bucket所在地域。以华北2 阿里政务云1为例，Region填写为cn-north-2-gov-1
        let region = "cn-north-2-gov-1"
        // 必须项， 填写Bucket所在地域对应的内网Endpoint。以华北2 阿里政务云1为例，Endpoint填写为'https://oss-cn-north-2-gov-1-internal.aliyuncs.com'
        let endpoint: String? = "https://oss-cn-north-2-gov-1-internal.aliyuncs.com"  

        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量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)
    }
}