Merge pull request #150 from XiaoningLiu/blobtier

Blob Tier

Author: vinjiang

ISSUE_TEMPLATE.md

@@ -0,0 +1,16 @@
+### Which service(blob, file, queue, table) does this issue concern?
+
+
+### Which version of the SDK was used?
+
+
+### What's the PHP/OS version?
+
+
+### What problem was encountered?
+
+
+### Steps to reproduce the issue?
+
+
+### Have you found a mitigation/solution?

azure-storage-blob/ChangeLog.md

@@ -1,3 +1,10 @@
+2018.08 - version 1.2.0
+
+* Updated Azure Storage API version from 2016-05-31 to 2017-04-17.
+* Added method `setBlobTier` method in `BlobRestProxy` to set blob tiers.
+* Added support setting or getting blob tiers related properties when creating blobs, listing blobs, getting blob properties and copying blobs.
+* Set the `getBlobUrl()` method in `BlobRestProxy` visibility to public.
+
 2018.04 - version 1.1.0
 
 * Private method BlobRestProxy::getBlobUrl now preserves primary URI path when exists.
@@ -12,7 +19,7 @@
 
 * Created `BlobSharedAccessSignatureHelper` and moved method `SharedAccessSignatureHelper::generateBlobServiceSharedAccessSignatureToken()` into `BlobSharedAccessSignatureHelper`.
 * Added static builder methods `createBlobService` and `createContainerAnonymousAccess` into `BlobRestProxy`.
-* Removed `dataSerializer` parameter from `BlobRextProxy` constructor.
+* Removed `dataSerializer` parameter from `BlobRestProxy` constructor.
 * Added `setUseTransactionalMD5` method for options of `BlobRestProxy::CreateBlockBlob` and `BlobRestProxy::CreatePageBlobFromContent`. Default false, enabling transactional MD5 validation will take more cpu and memory resources.
 * Fixed a bug that CopyBlobFromURLOptions not found.
 * Deprecated PHP 5.5 support.

azure-storage-blob/composer.json

@@ -1,6 +1,6 @@
 {
     "name": "microsoft/azure-storage-blob",
-    "version": "1.1.0",
+    "version": "1.2.0",
     "description": "This project provides a set of PHP client libraries that make it easy to access Microsoft Azure Storage Blob APIs.",
     "keywords": [ "php", "azure", "storage", "sdk", "blob" ],
     "license": "MIT",
@@ -12,7 +12,7 @@
     ],
     "require": {
         "php": ">=5.6.0",
-		"microsoft/azure-storage-common": "~1.1"
+        "microsoft/azure-storage-common": "~1.2.0"
     },
     "autoload": {
         "psr-4": {

azure-storage-blob/src/Blob/BlobRestProxy.php

@@ -45,6 +45,7 @@
 use MicrosoftAzure\Storage\Blob\Models\CreateBlobSnapshotOptions;
 use MicrosoftAzure\Storage\Blob\Models\CreateBlobSnapshotResult;
 use MicrosoftAzure\Storage\Blob\Models\CreateContainerOptions;
+use MicrosoftAzure\Storage\Blob\Models\CreatePageBlobOptions;
 use MicrosoftAzure\Storage\Blob\Models\DeleteBlobOptions;
 use MicrosoftAzure\Storage\Blob\Models\GetBlobMetadataOptions;
 use MicrosoftAzure\Storage\Blob\Models\GetBlobMetadataResult;
@@ -71,6 +72,7 @@
 use MicrosoftAzure\Storage\Blob\Models\SetBlobMetadataResult;
 use MicrosoftAzure\Storage\Blob\Models\SetBlobPropertiesOptions;
 use MicrosoftAzure\Storage\Blob\Models\SetBlobPropertiesResult;
+use MicrosoftAzure\Storage\Blob\Models\SetBlobTierOptions;
 use MicrosoftAzure\Storage\Common\Internal\Authentication\SharedAccessSignatureAuthScheme;
 use MicrosoftAzure\Storage\Common\Internal\Authentication\SharedKeyAuthScheme;
 use MicrosoftAzure\Storage\Common\Internal\Http\HttpFormatter;
@@ -376,7 +378,7 @@ private function createPath($container, $blob = '')
      *
      * @return string
      */
-    private function getBlobUrl($container, $blob)
+    public function getBlobUrl($container, $blob)
     {
         $encodedBlob = $this->createPath($container, $blob);
         $uri = $this->getPsrPrimaryUri();
@@ -1337,6 +1339,82 @@ public function setContainerMetadataAsync(
         );
     }
 
+    /**
+     * Sets blob tier on the blob.
+     *
+     * @param string                    $container name
+     * @param string                    $blob      name of the blob
+     * @param Models\SetBlobTierOptions $options   optional parameters
+     *
+     * @return void
+     *
+     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier
+     */
+    public function setBlobTier(
+        $container,
+        $blob,
+        Models\SetBlobTierOptions $options = null
+    ) {
+        $this->setBlobTierAsync($container, $blob, $options)->wait();
+    }
+
+    /**
+     * Sets blob tier on the blob.
+     *
+     * @param string                    $container name
+     * @param string                    $blob      name of the blob
+     * @param Models\SetBlobTierOptions $options   optional parameters
+     *
+     * @return \GuzzleHttp\Promise\PromiseInterface
+     *
+     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier
+     */
+    public function setBlobTierAsync(
+        $container,
+        $blob,
+        Models\SetBlobTierOptions $options = null
+    )
+    {
+        Validate::canCastAsString($container, 'container');
+        Validate::canCastAsString($blob, 'blob');
+        Validate::notNullOrEmpty($blob, 'blob');
+
+        $method      = Resources::HTTP_PUT;
+        $headers     = array();
+        $postParams  = array();
+        $queryParams = array();
+        $path        = $this->createPath($container, $blob);
+
+        if (is_null($options)) {
+            $options = new SetBlobTierOptions();
+        }
+
+        $this->addOptionalQueryParam(
+            $queryParams,
+            Resources::QP_COMP,
+            'tier'
+        );
+
+        $this->addOptionalHeader(
+            $headers,
+            Resources::X_MS_ACCESS_TIER,
+            $options->getAccessTier()
+        );
+
+        $options->setLocationMode(LocationMode::PRIMARY_ONLY);
+
+        return $this->sendAsync(
+            $method,
+            $headers,
+            $queryParams,
+            $postParams,
+            $path,
+            array(Resources::STATUS_OK, Resources::STATUS_ACCEPTED),
+            Resources::EMPTY_STRING,
+            $options
+        );
+    }
+
     /**
      * Lists all of the blobs in the given container.
      *
@@ -1462,7 +1540,7 @@ public function listBlobsAsync(
      *                                            The page blob size must be
      *                                            aligned to a 512-byte
      *                                            boundary.
-     * @param Models\CreateBlobOptions $options   The optional parameters.
+     * @param Models\CreatePageBlobOptions $options   The optional parameters.
      *
      * @return Models\PutBlobResult
      *
@@ -1472,7 +1550,7 @@ public function createPageBlob(
         $container,
         $blob,
         $length,
-        Models\CreateBlobOptions $options = null
+        Models\CreatePageBlobOptions $options = null
     ) {
         return $this->createPageBlobAsync(
             $container,
@@ -1494,7 +1572,7 @@ public function createPageBlob(
      *                                            The page blob size must be
      *                                            aligned to a 512-byte
      *                                            boundary.
-     * @param Models\CreateBlobOptions $options   The optional parameters.
+     * @param Models\CreatePageBlobOptions $options   The optional parameters.
      *
      * @return \GuzzleHttp\Promise\PromiseInterface
      *
@@ -1504,7 +1582,7 @@ public function createPageBlobAsync(
         $container,
         $blob,
         $length,
-        Models\CreateBlobOptions $options = null
+        Models\CreatePageBlobOptions $options = null
     ) {
         Validate::canCastAsString($container, 'container');
         Validate::canCastAsString($blob, 'blob');
@@ -1519,7 +1597,7 @@ public function createPageBlobAsync(
         $path        = $this->createPath($container, $blob);
 
         if (is_null($options)) {
-            $options = new CreateBlobOptions();
+            $options = new CreatePageBlobOptions();
         }
 
         $this->addOptionalHeader(
@@ -1537,6 +1615,11 @@ public function createPageBlobAsync(
             Resources::X_MS_BLOB_SEQUENCE_NUMBER,
             $options->getSequenceNumber()
         );
+        $this->addOptionalHeader(
+            $headers,
+            Resources::X_MS_ACCESS_TIER,
+            $options->getAccessTier()
+        );
         $headers = $this->addCreateBlobOptionalHeaders($options, $headers);
 
         $options->setLocationMode(LocationMode::PRIMARY_ONLY);
@@ -3521,7 +3604,7 @@ public function saveBlobToFile(
      * @param Models\GetBlobOptions $options   optional parameters
      *
      * @return \GuzzleHttp\Promise\PromiseInterface
-     *
+     * @throws \Exception
      * @see http://msdn.microsoft.com/en-us/library/windowsazure/dd179440.aspx
      */
     public function saveBlobToFileAsync(
@@ -4024,6 +4107,12 @@ public function copyBlobFromURLAsync(
             $options->getSourceLeaseId()
         );
 
+        $this->addOptionalHeader(
+            $headers,
+            Resources::X_MS_ACCESS_TIER,
+            $options->getAccessTier()
+        );
+
         $options->setLocationMode(LocationMode::PRIMARY_ONLY);
 
         return $this->sendAsync(

azure-storage-blob/src/Blob/Internal/BlobResources.php

@@ -41,8 +41,8 @@ class BlobResources extends Resources
 {
     // @codingStandardsIgnoreStart
 
-    const BLOB_SDK_VERSION = '1.1.0';
-    const STORAGE_API_LATEST_VERSION = '2016-05-31';
+    const BLOB_SDK_VERSION = '1.2.0';
+    const STORAGE_API_LATEST_VERSION = '2017-04-17';
 
     // Error messages
     const INVALID_BTE_MSG = "The blob block type must exist in %s";
@@ -83,6 +83,10 @@ class BlobResources extends Resources
     const X_MS_SERVER_ENCRYPTED = 'x-ms-server-encrypted';
     const X_MS_INCREMENTAL_COPY = 'x-ms-incremental-copy';
     const X_MS_COPY_DESTINATION_SNAPSHOT = 'x-ms-copy-destination-snapshot';
+    const X_MS_ACCESS_TIER = 'x-ms-access-tier';
+    const X_MS_ACCESS_TIER_INFERRED = 'x-ms-access-tier-inferred';
+    const X_MS_ACCESS_TIER_CHANGE_TIME = 'x-ms-access-tier-change-time';
+    const X_MS_ARCHIVE_STATUS = 'x-ms-archive-status';
     const MAX_BLOB_SIZE = 'x-ms-blob-condition-maxsize';
     const MAX_APPEND_POSITION = 'x-ms-blob-condition-appendpos';
     const SEQUENCE_NUMBER_LESS_THAN_OR_EQUAL = 'x-ms-if-sequence-number-le';