Object Storage Service：配置用戶端（Swift SDK）

內網網域名稱配置樣本

當您的應用部署在阿里雲的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-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所在地區。以華北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)
    }
}