{"id":13848394,"url":"https://github.com/aliyun/aliyun-openapi-java-sdk","last_synced_at":"2025-05-16T01:03:09.464Z","repository":{"id":35294765,"uuid":"39555898","full_name":"aliyun/aliyun-openapi-java-sdk","owner":"aliyun","description":"The Alibaba Cloud V1.0 SDK will soon enter the Basic Security Maintenance phase and is no longer recommended for use.","archived":false,"fork":false,"pushed_at":"2025-05-06T09:47:39.000Z","size":79242,"stargazers_count":1411,"open_issues_count":23,"forks_count":1114,"subscribers_count":114,"default_branch":"master","last_synced_at":"2025-05-09T00:56:09.648Z","etag":null,"topics":["java","sdk","v1"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aliyun.png","metadata":{"files":{"readme":"README-CN.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"License","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-07-23T08:41:13.000Z","updated_at":"2025-05-06T09:47:45.000Z","dependencies_parsed_at":"2025-05-07T22:26:20.604Z","dependency_job_id":null,"html_url":"https://github.com/aliyun/aliyun-openapi-java-sdk","commit_stats":{"total_commits":6723,"total_committers":57,"mean_commits":"117.94736842105263","dds":"0.26312658039565673","last_synced_commit":"f8e6e7258b034708a953e9671b7716596a58c48c"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Faliyun-openapi-java-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Faliyun-openapi-java-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Faliyun-openapi-java-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aliyun%2Faliyun-openapi-java-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aliyun","download_url":"https://codeload.github.com/aliyun/aliyun-openapi-java-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254050966,"owners_count":22006391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","sdk","v1"],"created_at":"2024-08-04T19:00:48.202Z","updated_at":"2025-05-16T01:03:04.440Z","avatar_url":"https://github.com/aliyun.png","language":"Java","readme":"[English](./README.md) | 简体中文\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\" https://www.alibabacloud.com\"\u003e\u003cimg src=\"https://aliyunsdk-pages.alicdn.com/icons/Aliyun.svg\" alt=\"alibaba cloud logo\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eAlibaba Cloud SDK for Java\u003c/h1\u003e\n\n[![Maven Central Version](https://img.shields.io/maven-central/v/com.aliyun/aliyun-java-sdk-core)](https://search.maven.org/search?q=g:%22com.aliyun%22%20AND%20a:%22aliyun-java-sdk-core%22)\n[![Java CI with Maven](https://github.com/aliyun/aliyun-openapi-java-sdk/actions/workflows/maven.yml/badge.svg)](https://github.com/aliyun/aliyun-openapi-java-sdk/actions/workflows/maven.yml)\n[![codecov](https://codecov.io/gh/aliyun/aliyun-openapi-java-sdk/graph/badge.svg?token=4LHp6BfqKF)](https://codecov.io/gh/aliyun/aliyun-openapi-java-sdk)\n\n阿里云 V1.0 SDK 即将进入基础安全维护阶段，不再建议使用，建议使用 V2.0 SDK。\n\n如果您在使用 Alibaba Cloud SDK for Java 的过程中遇到任何问题，欢迎在当前 GitHub [提交 Issues](https://github.com/aliyun/aliyun-openapi-java-sdk/issues/new)。\n\n## 环境要求\n\n1. 要使用 Alibaba Cloud SDK for Java ，您需要一个云账号以及一对`Access Key ID`和`Access Key Secret`。 请在阿里云控制台中的[RAM管理页面](https://ram.console.aliyun.com)上创建和查看您的Access Key，或者联系您的系统管理员。\n2. 要使用 Alibaba Cloud SDK for Java 访问某个产品的API，您需要事先在[阿里云控制台](https://home.console.aliyun.com)中开通这个产品。\n3. Alibaba Cloud SDK for Java 需要 1.8 以上的 JDK。\n\n## 安装依赖\n\n无论您要使用哪个产品的开发工具包，都必须安装`aliyun-java-sdk-core`。比如，对云服务器SDK的调用，您需要安装`aliyun-java-sdk-core`和`aliyun-java-sdk-ecs`。\n\n### 通过Maven来管理项目依赖(推荐)\n\n如果您使用Apache Maven来管理Java项目，只需在项目的`pom.xml`文件加入相应的依赖项即可。您可以在[阿里云SDK中心](https://api.aliyun.com/api-tools/sdklang?language=java\u0026sdkStyle=old)中查看各云产品的Maven依赖。\n以使用Ecs SDK为例，您只需在`pom.xml`中声明以下两个依赖：\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.aliyun\u003c/groupId\u003e\n    \u003cartifactId\u003ealiyun-java-sdk-core\u003c/artifactId\u003e\n    \u003cversion\u003e[4.6.3,5.0.0)\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.aliyun\u003c/groupId\u003e\n    \u003cartifactId\u003ealiyun-java-sdk-ecs\u003c/artifactId\u003e\n    \u003cversion\u003e[4.16.0,5.0.0)\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n如果 maven 没有从中央存储库下载 jar 包，则需要将这些依赖项添加到`pom.xml`文件中，否则将报告 NoClassDefFoundError 异常\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.google.code.gson\u003c/groupId\u003e\n    \u003cartifactId\u003egson\u003c/artifactId\u003e\n    \u003cversion\u003e2.10.1\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.opentracing\u003c/groupId\u003e\n    \u003cartifactId\u003eopentracing-api\u003c/artifactId\u003e\n    \u003cversion\u003e0.33.0\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.opentracing\u003c/groupId\u003e\n    \u003cartifactId\u003eopentracing-util\u003c/artifactId\u003e\n    \u003cversion\u003e0.33.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## 使用诊断\n\n[Troubleshoot](https://troubleshoot.api.aliyun.com/?source=github_sdk) 提供 OpenAPI 使用诊断服务，通过 `RequestID` 或 `报错信息` ，帮助开发者快速定位，为开发者提供解决方案。\n\n## 快速使用\n\n以下这个代码示例向您展示了如何调用 Alibaba Cloud SDK for Java：\n\n```java\npackage com.testprogram;\n\nimport com.aliyuncs.profile.DefaultProfile;\nimport com.aliyuncs.DefaultAcsClient;\nimport com.aliyuncs.IAcsClient;\nimport com.aliyuncs.exceptions.ClientException;\nimport com.aliyuncs.exceptions.ServerException;\nimport com.aliyuncs.ecs.model.v20140526.*;\n\npublic class Main {\n    public static void main(String[] args) {\n        // 1. 创建DefaultAcsClient实例并初始化。\n        DefaultProfile profile = DefaultProfile.getProfile(\n            \"\u003cyour-region-id\u003e\",          // 地域ID\n            \"\u003cyour-access-key-id\u003e\",      // RAM账号的AccessKey ID\n            \"\u003cyour-access-key-secret\u003e\"); // RAM账号Access Key Secret\n        IAcsClient client = new DefaultAcsClient(profile);\n\n        // 2. 创建API请求并设置参数\n        DescribeInstancesRequest request = new DescribeInstancesRequest();\n        request.setPageSize(10);\n\n        // 3. 发起请求并处理应答或异常\n        DescribeInstancesResponse response;\n        try {\n            response = client.getAcsResponse(request);\n            for (DescribeInstancesResponse.Instance instance:response.getInstances()) {\n                System.out.println(instance.getPublicIpAddress());\n            }\n        } catch (ServerException e) {\n            e.printStackTrace();\n         } catch (ClientException e) {\n            e.printStackTrace();\n        }\n    }\n}\n```\n\n\u003e 因为安全的原因，我们不推荐在源代码中硬编码凭证信息。你应该通过外部配置或者环境变量的方式来访问凭证信息。\n\n## 文档\n\n* [环境要求](./docs/0-Requirements-CN.md)\n* [安装](./docs/1-Installation-CN.md)\n* [客户端与凭证](./docs/2-Client-CN.md)\n* [连接池](./docs/3-Pool-CN.md)\n* [超时机制](./docs/4-Timeout-CN.md)\n* [HTTPS配置](./docs/5-HTTPS-CN.md)\n* [代理配置](./docs/6-Proxy-CN.md)\n* [调试](./docs/7-Debug-CN.md)\n* [日志](./docs/8-Log-CN.md)\n* [异常](./docs/9-Exception-CN.md)\n* [域名](./docs/10-Endpoint-CN.md)\n\n## 问题\n\n[提交 Issue](https://github.com/aliyun/aliyun-openapi-java-sdk/issues/new)，不符合指南的问题可能会立即关闭。\n\n## 发行说明\n\n每个版本的详细更改记录在[发行说明](./aliyun-java-sdk-core/ChangeLog.txt)中。\n\n## 贡献\n\n提交 Pull Request 之前请阅读[贡献指南](CONTRIBUTING.md)。\n\n## 相关\n\n* [阿里云服务 Regions \u0026 Endpoints](https://developer.aliyun.com/endpoints)\n* [OpenAPI 开发者门户](https://api.aliyun.com/)\n* [最新源码](https://github.com/aliyun/aliyun-openapi-java-sdk)\n\n## 许可证\n\n[Apache-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nCopyright (c) 2009-present, Alibaba Cloud All rights reserved.\n","funding_links":[],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliyun%2Faliyun-openapi-java-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliyun%2Faliyun-openapi-java-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliyun%2Faliyun-openapi-java-sdk/lists"}