全部產品
Search

搜尋本產品

    Object Storage Service：管理儲存空間

    文件中心

    Object Storage Service：管理儲存空間

    更新時間：Aug 30, 2018

    儲存空間（Bucket）是對象（Object）的容器，對象必須隸屬於某個儲存空間。

    以下場景的完整代碼請參見GitHub。

    建立儲存空間

    以下代碼用於建立儲存空間：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱。
    18. $bucket= "<yourBucketName>";
    19. try {
    20.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    21.     // 設定儲存空間的儲存類型為低頻訪問類型，預設是標準類型。
    22.     $options = array(
    23.         OssClient::OSS_STORAGE => OssClient::OSS_STORAGE_IA
    24.     );
    25.     // 設定儲存空間的許可權為公共讀，預設是私有讀寫。
    26.     $ossClient->createBucket($bucket, OssClient::OSS_ACL_TYPE_PUBLIC_READ, $options);
    27. } catch (OssException $e) {
    28.     printf(__FUNCTION__ . ": FAILED\n");
    29.     printf($e->getMessage() . "\n");
    30.     return;
    31. }
    32. print(__FUNCTION__ . ": OK" . "\n");

    儲存空間的命名規範，請參見基本概念中的命名規範。

    判斷儲存空間是否存在

    以下代碼用於判斷指定的儲存空間是否存在：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱。
    18. $bucket= "<yourBucketName>";
    19. try {
    20.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    22.     $res = $ossClient->doesBucketExist($bucket);
    23. } catch (OssException $e) {
    24.     printf(__FUNCTION__ . ": FAILED\n");
    25.     printf($e->getMessage() . "\n");
    26.     return;
    27. }
    28. if ($res === true) {
    29.     print(__FUNCTION__ . ": OK" . "\n");
    30. } else {
    31.     print(__FUNCTION__ . ": FAILED" . "\n");
    32. }

    列舉儲存空間

    以下代碼用於列舉儲存空間：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. try{
    18.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    20.     $bucketListInfo = $ossClient->listBuckets();
    21. } catch(OssException $e) {
    22.     printf(__FUNCTION__ . ": FAILED\n");
    23.     printf($e->getMessage() . "\n");
    24.     return;
    25. }
    26. $bucketList = $bucketListInfo->getBucketList();
    27. foreach($bucketList as $bucket) {
    28.     print($bucket->getLocation() . "\t" . $bucket->getName() . "\t" . $bucket->getCreatedate() . "\n");
    29. }

    設定儲存空間的存取權限

    儲存空間的存取權限（ACL）有以下三類：

    存取權限 描述 存取權限值
    私有 儲存空間的擁有者和授權使用者有該儲存空間內的檔案的讀寫權限，其他使用者沒有許可權操作該儲存空間內的檔案。 OssClient::OSS_ACL_TYPE_PRIVATE
    公共讀 儲存空間的擁有者和授權使用者有該儲存空間內的檔案的讀寫權限，其他使用者只有該儲存空間內的檔案的讀許可權。請謹慎使用該許可權。 OssClient::OSS_ACL_TYPE_PUBLIC_READ
    公共讀寫 所有使用者都有該儲存空間內的檔案的讀寫權限。請謹慎使用該許可權。 OssClient::OSS_ACL_TYPE_PUBLIC_READ_WRITE

    以下代碼用於設定儲存空間的存取權限：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱。
    18. $bucket= "<yourBucketName>";
    19. // 設定儲存空間的許可權為私有。
    20. $acl = OssClient::OSS_ACL_TYPE_PRIVATE;
    21. try {
    22.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    24.     $ossClient->putBucketAcl($bucket, $acl);
    25. } catch (OssException $e) {
    26.     printf(__FUNCTION__ . ": FAILED\n");
    27.     printf($e->getMessage() . "\n");
    28.     return;
    29. }
    30. print(__FUNCTION__ . ": OK" . "\n");

    獲取儲存空間的存取權限

    以下代碼用於獲取儲存空間的存取權限：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱。
    18. $bucket= "<yourBucketName>";
    20. try {
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $res = $ossClient->getBucketAcl($bucket);
    24. } catch (OssException $e) {
    25.     printf(__FUNCTION__ . ": FAILED\n");
    26.     printf($e->getMessage() . "\n");
    27.     return;
    28. }
    29. print(__FUNCTION__ . ": OK" . "\n");
    30. print('acl: ' . $res);

    獲取儲存空間的地域

    以下代碼用於獲取儲存空間的地域（稱為Region或Location）：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱。
    18. $bucket= "<yourBucketName>";
    20. try {
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $Regions = $ossClient->getBucketLocation($bucket);
    24. } catch (OssException $e) {
    25.     printf(__FUNCTION__ . ": FAILED\n");
    26.     printf($e->getMessage() . "\n");
    27.     return;
    28. }
    29. print(__FUNCTION__ . ": OK" . "\n");
    30. var_dump($Regions);

    關於地域的詳細資料請參見基本概念中的地域。

    獲取儲存空間元資訊

    以下代碼用於獲取儲存空間元資訊：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱。
    18. $bucket= "<yourBucketName>";
    20. try {
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $Metas = $ossClient->getBucketMeta($bucket);
    24. } catch (OssException $e) {
    25.     printf(__FUNCTION__ . ": FAILED\n");
    26.     printf($e->getMessage() . "\n");
    27.     return;
    28. }
    29. print(__FUNCTION__ . ": OK" . "\n");
    30. var_dump($Metas);

    刪除儲存空間

    刪除儲存空間之前，必須先刪除儲存空間下的所有檔案、LiveChannel和分區上傳產生的碎片。

    說明：要刪除分區上傳產生的碎片，首先使用Bucket.ListMultipartUploads列舉出所有碎片，然後使用Bucket.AbortMultipartUpload刪除這些碎片。

    以下代碼用於刪除儲存空間：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱。
    18. $bucket= "<yourBucketName>";
    20. try{
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $ossClient->deleteBucket($bucket);
    24. } catch(OssException $e) {
    25.     printf(__FUNCTION__ . ": FAILED\n");
    26.     printf($e->getMessage() . "\n");
    27.     return;
    28. }
    29. print(__FUNCTION__ . ": OK" . "\n");