跳到主要内容

快速开始

请查看 Github 链接获取详细信息:uspeedo-sdk-php

1.安装

使用 composer 安装(推荐):

$ composer require uspeedo-sdks/uspeedo-sdk-php

2.首次使用

当前,SDK 仅支持使用公钥/私钥作为认证方法。公钥和私钥可从以下渠道获取:

以下是一个简单的示例:

use USpeedo\UHost\UHostClient;
use USpeedo\Core\Exception\USpeedoException;
use USpeedo\UHost\Apis\CreateUHostInstanceRequest;
use USpeedo\UHost\Params\CreateUHostInstanceParamDisks;

$client = new UHostClient([
"publicKey" => getenv("USPEEDO_PUBLIC_KEY"),
"privateKey" => getenv("USPEEDO_PRIVATE_KEY"),
]);

// 创建实例
try {
$req = new CreateUHostInstanceRequest();
$req->setName("sdk-php-example");
$req->setImageId("...");
$req->setLoginMode("Password");
$req->setPassword(base64_encode("USpeedo1234!"));
$req->setCPU(1);
$req->setMemory(1024);

$disk = new CreateUHostInstanceParamDisks();
$disk->setSize(40);
$disk->setType("CLOUD_SSD");
$disk->setIsBoot("True");

$req->setDisks([$disk]);

$resp = $client->createUHostInstance($req);
} catch (USpeedoException $e) {
throw $e;
}
$id = $resp->getUHostIds()[0];

SDK 中的每个 API 调用都有详细的注释文档。 您可以通过编辑器/IDE 跳转到特定方法来查看它(您还可以查看接口文档), 并根据 IDE 的自动完成和错误消息继续探索 SDK 的使用方法。

如果您需要了解本代码未完全覆盖的使用技巧,请参阅:

  • 常见配置,了解如何配置 SDK,例如日志、重试、服务访问 端点(公共云、私有云)等。
  • 错误处理,了解如何处理不同类型的 SDK 异常,包括参数错误、业务异常等,其中 RetCode 不为 0。
  • 请求中间件,了解如何拦截 SDK 发起的请求并统一添加其他逻辑。
  • 通用调用,如何调用 SDK 尚未支持的 API(不建议使用此类 API,因为无兼容性保证)。