You need to enable JavaScript to run this app.
导航

资源管理

最近更新时间2023.12.13 14:01:28

首次发布时间2021.02.23 10:42:26

阅读本文,您可以快速了解资源管理 PHP SDK 的使用方法。

说明

以下 SDK 示例中仅展示了部分参数,您可以在 veImageX 的接口文档中查看该接口支持的全部参数及取值。

初始化

初始化代码并设置 AK/SK 和地域,具体可参考初始化

文件上传

普通上传

以下内容用于通过指定服务 ID 和上传文件,来获取上传成功的资源 URI。

UploadImages 接口内部依次调用了 ApplyImageUpload 和 CommitImageUpload 两个 OpenAPI 来实现完整文件上传能力。我们同时在 GitHub 上提供了参考示例

具体示例如下所示:

<?php
include_once(__DIR__ . '/../../vendor/autoload.php');

use Volc\Service\ImageX;

$client = ImageX::getInstance();

// call below method if you dont set ak and sk in ~/.volc/config
$client->setAccessKey("ak");
$client->setSecretKey("sk");

$params = array();
$params["ServiceId"] = "imagex service id";
$filePaths = array("image path 1");

$response = $client->uploadImages($params, $filePaths);
print_r($response);

分片上传

对大于 20MB 的文件,您可以通过将文件数据分成多个分片(part)来同时分片上传,最后将所有上传的分片合并为一个文件并获取存储地址。分片上传最大能够上传 48.8TB 文件,其中除了最后一个分片,其他分片大小需大于等于 5MB 且小于 5GB。分片数量默认从 1 开始,最大为 10000。

说明

上传顺序不影响最终的合并分片操作。如果其中任意分片上传失败,可以重新进行上传且不影响其他分片。

删除服务下多个文件

以下内容用于通过指定服务 ID 以及需要删除的文件 URI 列表,来删除指定的文件。

具体接口参数和返回字段请参考 DeleteImageUploadFiles。我们同时在 GitHub 上提供了参考示例

具体示例如下所示:

<?php
include_once(__DIR__ . '/../../vendor/autoload.php');

use Volc\Service\ImageX;

$client = ImageX::getInstance();

// call below method if you dont set ak and sk in ~/.volc/config
$client->setAccessKey("ak");
$client->setSecretKey("sk");

$serviceID = "imagex service id";
$uris = ["image uri 1", "image uri 2"];

$response = $client->deleteImages($serviceID, $uris);
print_r($response);

创建刷新/预热/禁用/解禁任务

本接口支持在指定服务 ID 、待更改操作的文件和文件操作类型(刷新 URL、刷新目录、预热 URL、禁用 URL 和解禁 URL)后创建相关文件务。

具体接口参数和返回字段请参考 CreateImageContentTask。我们同时在 GitHub 上提供了参考示例

具体示例如下所示:

<?php
include_once(__DIR__ . '/../../vendor/autoload.php');

use Volc\Service\ImageX;

$client = ImageX::getInstance();

// call below method if you dont set ak and sk in ~/.volc/config
$client->setAccessKey("ak");
$client->setSecretKey("sk");

$args = ['ServiceId' => "",
    'TaskType' => 'block_url',
    'Urls' => ['1'],
];

$resp = $client->createImageContentTask($args);
print_r($resp);

获取任务详情

本接口支持查询近 30 天内刷新/预热/禁用/解禁任务详情列表。

具体接口参数和返回字段请参考 GetImageContentTaskDetail。我们同时在 GitHub 上提供了参考示例

具体示例如下所示:

<?php
include_once(__DIR__ . '/../../vendor/autoload.php');

use Volc\Service\ImageX;

$client = ImageX::getInstance();

// call below method if you dont set ak and sk in ~/.volc/config
$client->setAccessKey("ak");
$client->setSecretKey("sk");

$args = ['ServiceId' => "",
    'TaskType' => 'block_url',
    'StartTime' => 0,
    'EndTime' => 2147483647,
];

$resp = $client->getImageContentTaskDetail($args);
print_r($resp);

获取禁用 URL 列表详情

本接口支持获取近 30 天内的已被禁用的 URL 列表详情,若 URL 解禁成功,则无法被查询。

具体接口参数和返回字段请参考 GetImageContentBlockList。我们同时在 GitHub 上提供了参考示例

具体示例如下所示:

<?php
include_once(__DIR__ . '/../../vendor/autoload.php');

use Volc\Service\ImageX;

$client = ImageX::getInstance();

// call below method if you dont set ak and sk in ~/.volc/config
$client->setAccessKey("ak");
$client->setSecretKey("sk");

$args = ['ServiceId' => "",
    'StartTime' => 0,
    'EndTime' => 2147483647,
];

$resp = $client->getImageContentBlockList($args);
print_r($resp);

数据抓取(Fetch)

以下内容用于指定公网可访问的待迁移资源 URL 以及迁移目标服务 ID,来对资源进行迁移,并得到迁移后的资源 URI 等信息,并获取异步抓取任务详情。

具体接口参数和返回字段请参考 FetchImageUrlGetUrlFetchTask。我们同时在 GitHub 上提供了参考示例

具体示例如下所示:

<?php
include_once(__DIR__ . '/../../vendor/autoload.php');

use Volc\Service\ImageX;

$client = ImageX::getInstance();

// call below method if you dont set ak and sk in ~/.volc/config
$client->setAccessKey("ak");
$client->setSecretKey("sk");

$req = [
    'Url' => 'image url',
    'ServiceId' => 'imagex service id',
//    'Async' => true,
];

$response = $client->fetchImageUrl($req);
print_r($response);

if (is_string($response) || !isset($response['TaskId'])) {
    exit();
}

$req2 = [
    'ServiceId' => $req['ServiceId'],
    'Id' => $response['TaskId'],
];

$response2 = $client->getUrlFetchTask($req2);
print_r($response2);