Endpoint配置

更新时间:
复制 MD 格式

Endpoint是请求接口服务的网络域名,如 ecs.cn-hangzhou.aliyuncs.com。

Endpoint设置

V2.0 SDK提供了两种Endpoint设置方式,下面按优先级排列:

  1. 方式一:指定Endpoint(推荐)

    可以在初始化云产品客户端对象时指定Endpoint,支持公网Endpoint和VPC Endpoint。

    from alibabacloud_tea_openapi.models import Config
    
    config = Config(
        # 省略凭证配置
        endpoint='<endpoint>'  # endpoint
    )
    
  2. 方式二:指定RegionId

    在未指定Endpoint的情况下,可以在初始化云产品客户端对象时指定RegionId,SDK底层将通过自动寻址的方式获取相应的Endpoint。

    from alibabacloud_tea_openapi.models import Config
    
    config = Config(
        # 省略凭证配置
        region_id='cn-hangzhou',  # 通过 regionId 映射到 endpoint
    )
    

获取文件上传授权码的Endpoint

针对部分需要上传文件的OpenAPI,在初始化请求客户端时,支持配置文件上传授权码的VPC Endpoint,以确保网络更加稳定。如未设置,则将使用默认的公网服务地址(已开启全球加速)。

  • 上传文件鉴权服务Endpoint,您可以在VPC环境配置VPC Endpoint来请求上传文件的鉴权信息。

from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions

from alibabacloud_facebody20191230.models import DetectBodyCountAdvanceRequest
from alibabacloud_facebody20191230.client import Client

runtime = RuntimeOptions()
config = Config(
    # 省略凭证配置
    region_id='cn-hangzhou',
    # 文件上传鉴权服务Endpoint
    open_platform_endpoint='openplatform-vpc.cn-shanghai.aliyuncs.com'
)

client = Client(config)
with open('test.txt', 'rb') as f:
    request = DetectBodyCountAdvanceRequest(image_urlobject=f)
    response = client.detect_body_count_advance(request, runtime)
    # response 包含服务端响应的 body 和 headers
    print(response.body)
    print(response.headers)
  • 上传文件鉴权服务的Endpoint,您可以在VPC或者内网环境配置VPC Endpoint来请求上传文件的鉴权信息。

from alibabacloud_tea_openapi.models import Config
from alibabacloud_tea_util.models import RuntimeOptions

from alibabacloud_facebody20191230.models import DetectBodyCountAdvanceRequest
from alibabacloud_facebody20191230.client import Client

runtime = RuntimeOptions()
config = Config(
    # 省略凭证配置
    region_id='cn-hangzhou',
    open_platform_endpoint='openplatform-vpc.cn-shanghai.aliyuncs.com',
    endpoint_type='internal'  # 设置通过 OSS 内网地址上传文件
)

client = Client(config)
with open('test.txt', 'rb') as f:
    request = DetectBodyCountAdvanceRequest(image_urlobject=f)
    response = client.detect_body_count_advance(request, runtime)
    # response 包含服务端响应的 body 和 headers
    print(response.body)
    print(response.headers)

附:Endpoint查找方式

产品的Endpoint可以通过在OpenAPI门户上寻找:

  1. 在门户顶部菜单选择云产品,例如ECS。

  2. 在云产品主页找到服务区域列表。

  3. 选择相应RegionId所对应的Endpoint,进行复制粘贴即可。

还可以在API调试界面,在左侧栏单击服务区域,查看云产品支持的Endpoint。