feat: add support for Archive storage class (#908)

* feat: add support for Archive storage class

* classify and sort storage classes appropriately

Co-authored-by: Justin Beckwith <justin.beckwith@gmail.com>
Co-authored-by: Benjamin E. Coe <bencoe@google.com>
Co-authored-by: Jonathan Lui <jonathanlui@google.com>

src/bucket.ts

@@ -2902,9 +2902,10 @@ class Bucket extends ServiceObject {
    * @see [Storage Classes]{@link https://cloud.google.com/storage/docs/storage-classes}
    *
    * @param {string} storageClass The new storage class. (`standard`,
-   *     `nearline`, `coldline`, or `durable_reduced_availability`).
-   *     **Note:** The storage classes `multi_regional` and `regional`
-   *     are now legacy and will be deprecated in the future.
+   *     `nearline`, `coldline`, or `archive`).
+   *     **Note:** The storage classes `multi_regional`, `regional`, and
+   *     `durable_reduced_availability` are now legacy and will be deprecated in
+   *     the future.
    * @param {object} [options] Configuration options.
    * @param {string} [options.userProject] - The ID of the project which will be
    *     billed for the request.

src/file.ts

@@ -3245,7 +3245,7 @@ class File extends ServiceObject<File> {
    * @see [Storage Classes]{@link https://cloud.google.com/storage/docs/storage-classes}
    *
    * @param {string} storageClass The new storage class. (`standard`,
-   *     `nearline`, or `coldline`)
+   *     `nearline`, `coldline`, or `archive`)
    *     **Note:** The storage classes `multi_regional` and `regional`
    *     are now legacy and will be deprecated in the future.
    * @param {SetStorageClassOptions} [options] Configuration options.

src/storage.ts

@@ -62,6 +62,7 @@ export interface BucketOptions {
 }
 
 export interface CreateBucketRequest {
+  archive?: boolean;
   coldline?: boolean;
   dra?: boolean;
   multiRegional?: boolean;
@@ -474,6 +475,7 @@ export class Storage extends Service {
    * Metadata to set for the bucket.
    *
    * @typedef {object} CreateBucketRequest
+   * @property {boolean} [archive=false] Specify the storage class as Archive.
    * @property {boolean} [coldline=false] Specify the storage class as Coldline.
    * @property {boolean} [dra=false] Specify the storage class as Durable Reduced
    *     Availability.
@@ -585,6 +587,7 @@ export class Storage extends Service {
     };
 
     const storageClasses = {
+      archive: 'ARCHIVE',
       coldline: 'COLDLINE',
       dra: 'DURABLE_REDUCED_AVAILABILITY',
       multiRegional: 'MULTI_REGIONAL',

test/index.ts

@@ -495,6 +495,15 @@ describe('Storage', () => {
     });
 
     describe('storage classes', () => {
+      it('should expand metadata.archive', done => {
+        storage.request = (reqOpts: DecorateRequestOptions) => {
+          assert.strictEqual(reqOpts.json.storageClass, 'ARCHIVE');
+          done();
+        };
+
+        storage.createBucket(BUCKET_NAME, {archive: true}, assert.ifError);
+      });
+
       it('should expand metadata.coldline', done => {
         storage.request = (reqOpts: DecorateRequestOptions) => {
           assert.strictEqual(reqOpts.json.storageClass, 'COLDLINE');