查询Endpoint信息(C# SDK V2)

本文介绍如何使用C# SDK V2查询所有支持地域或者指定地域对应的Endpoint信息,包括外网访问(IPv4)Endpoint、内网访问(经典网络或VPC网络)Endpoint和传输加速域名(全地域上传下载加速)Endpoint。

注意事项

  • 查询所有支持地域或者指定地域对应的Endpoint信息与OSS的地域支持情况相关,与您在该地域是否创建Bucket无关。

  • 本文示例代码以华东1(杭州)的地域IDcn-hangzhou为例,默认使用外网Endpoint,如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的RegionEndpoint的对应关系,请参见OSS地域和访问域名

查询所有支持地域对应的Endpoint信息

以下代码用于查询所有支持地域对应的Endpoint信息。

using OSS = AlibabaCloud.OSS.V2; // 为阿里云OSS SDK创建别名,简化后续使用
using AlibabaCloud.OSS.V2.Models;

var region = "cn-hangzhou"; // 必须项,区域(Region)。以华东1(杭州)为例,Region填写为cn-hangzhou
var endpoint = null as string;  // 可选项,指定访问OSS服务的域名。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com

// 加载OSS SDK的默认配置,此配置会自动从环境变量中读取凭证信息(如AccessKey)
var cfg = OSS.Configuration.LoadDefault();
// 显式设置使用环境变量获取凭证,用于身份验证(格式:OSS_ACCESS_KEY_ID、OSS_ACCESS_KEY_SECRET)
cfg.CredentialsProvider = new OSS.Credentials.EnvironmentVariableCredentialsProvider();
// 设置配置的Bucket区域
cfg.Region = region;
// 若已指定了endpoint,则覆盖默认的endpoint
if(endpoint != null)
{
    cfg.Endpoint = endpoint;
}

// 使用配置信息创建OSS客户端实例
using var client = new OSS.Client(cfg);

// 创建请求对象
var request = new DescribeRegionsRequest();

// 调用DescribeRegionsAsync方法
var result = await client.DescribeRegionsAsync(request);

Console.WriteLine("阿里云OSS区域信息列表:");
foreach (var regionInfo in result.RegionInfoList.RegionInfos)
{
    Console.WriteLine($"===== 区域:{regionInfo.Region} =====");
            
    // 打印Endpoint
    Console.WriteLine($"  - 公网 Endpoint: {regionInfo.InternetEndpoint}");
    Console.WriteLine($"  - 内网 Endpoint: {regionInfo.InternalEndpoint}");
    Console.WriteLine($"  - 加速 Endpoint: {regionInfo.AccelerateEndpoint}");
    Console.WriteLine("-------------------------");
}