全部产品
Search
文档中心

阿里云SDK:重试机制

更新时间:Jun 13, 2024

本文为您介绍V2.0 Node.js SDK的重试机制配置方式。

说明

在V2.0 SDK中,OpenAPI请求的处理逻辑内置了网络异常重试逻辑,即当遇到网络异常问题时,系统会自动尝试重新发起请求,以确保服务的稳定性和可靠性。若请求因业务逻辑错误而报错,例如参数错误、资源不存在等情况,SDK将不会执行重试操作,这是因为业务层面的错误通常需要应用程序根据具体的错误信息做出相应的处理或调整,而非简单地重复尝试。

重试机制配置方式

说明

重试机制配置优先级为:RuntimeOption配置->默认,优先级依次降低。

  • 使用默认配置。默认情况下不会进行重试,如果打开重试配置且未配置重试次数,则默认最多重试3次。

  • 通过运行时参数(RuntimeOptions)配置重试机制。

    JavaScript示例

    const { default: Ecs20140526, ModifySecurityGroupRuleRequest, DescribeRegionsRequest } = require('@alicloud/ecs20140526');
    const { Config } = require('@alicloud/openapi-client');
    const { RuntimeOptions } = require('@alicloud/tea-util');
    
    async function main() {
        const config = new Config({
            // 从环境变量中获取RAM用户的AccessKey ID
            accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,
            // 从环境变量中获取RAM用户的AccessKey Secret
            accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET,
            // 访问的区域
            regionId: 'cn-beijing',
        });
        const client = new Ecs20140526(config);
        const request = new DescribeRegionsRequest();
        // 创建RuntimeObject实例并设置运行参数。
        const runtime = new RuntimeOptions({
            // 设置打开重试
            autoretry: true,
            // 设置重试次数
            maxAttempts: 3,
        });
        const resp = await client.describeRegionsWithOptions(request, runtime);
        console.log(resp.headers);
        console.log(resp.body);
    }
    
    main();

    TypeScript示例

    import Ecs20140526, * as $Ecs20140526 from '@alicloud/ecs20140526';
    import * as $OpenApi from '@alicloud/openapi-client';
    import * as $Util from '@alicloud/tea-util';
    
    export default class Client {
        static async main(): Promise<void> {
            const config = new $OpenApi.Config({
                // 从环境变量中获取RAM用户的AccessKey ID
                accessKeyId: process.env.ALIBABA_CLOUD_ACCESS_KEY_ID,
                // 从环境变量中获取RAM用户的AccessKey Secret
                accessKeySecret: process.env.ALIBABA_CLOUD_ACCESS_KEY_SECRET,
                // 访问的区域
                regionId: 'cn-beijing',
            });
            const client = new Ecs20140526(config);
            const request = new $Ecs20140526.DescribeRegionsRequest();
            // 创建RuntimeObject实例并设置运行参数。
            const runtime = new $Util.RuntimeOptions({
                // 设置打开重试
                autoretry: true,
                // 设置重试次数
                maxAttempts: 3,
            });
            const resp = await client.describeRegionsWithOptions(request, runtime);
            console.log(resp.headers);
            console.log(resp.body);
        }
    }