FIRStorageReference


@interface FIRStorageReference : NSObject

FIRStorageReference represents a reference to a Google Cloud Storage object. Developers can upload and download objects, as well as get/set object metadata, and delete an object at the path.

  • The FIRStorage service object which created this reference.

    Declaration

    Objective-C

    @property (readonly, nonatomic) FIRStorage *_Nonnull storage;
  • The name of the Google Cloud Storage bucket associated with this reference, in gs://bucket/path/to/object.txt, the bucket would be: ‘bucket’

    Declaration

    Objective-C

    @property (readonly, nonatomic) NSString *_Nonnull bucket;
  • The full path to this object, not including the Google Cloud Storage bucket. In gs://bucket/path/to/object.txt, the full path would be: ‘path/to/object.txt’

    Declaration

    Objective-C

    @property (readonly, nonatomic) NSString *_Nonnull fullPath;
  • The short name of the object associated with this reference, in gs://bucket/path/to/object.txt, the name of the object would be: ‘object.txt’

    Declaration

    Objective-C

    @property (readonly, nonatomic) NSString *_Nonnull name;
  • Creates a new FIRStorageReference pointing to the root object.

    Declaration

    Objective-C

    - (nonnull FIRStorageReference *)root;

    Return Value

    A new FIRStorageReference pointing to the root object.

  • Creates a new FIRStorageReference pointing to the parent of the current reference or nil if this instance references the root location. For example: path = foo/bar/baz parent = foo/bar path = foo parent = (root) path = (root) parent = nil

    Declaration

    Objective-C

    - (nullable FIRStorageReference *)parent;

    Return Value

    A new FIRStorageReference pointing to the parent of the current reference.

  • Creates a new FIRStorageReference pointing to a child object of the current reference. path = foo child = bar newPath = foo/bar path = foo/bar child = baz newPath = foo/bar/baz All leading and trailing slashes will be removed, and consecutive slashes will be compressed to single slashes. For example: child = /foo/bar newPath = foo/bar child = foo/bar/ newPath = foo/bar child = foo///bar newPath = foo/bar

    Declaration

    Objective-C

    - (nonnull FIRStorageReference *)child:(nonnull NSString *)path;

    Parameters

    path

    Path to append to the current path.

    Return Value

    A new FIRStorageReference pointing to a child location of the current reference.

  • Asynchronously uploads data to the currently specified FIRStorageReference, without additional metadata. This is not recommended for large files, and one should instead upload a file from disk.

    Declaration

    Objective-C

    - (nonnull FIRStorageUploadTask *)putData:(nonnull NSData *)uploadData;

    Parameters

    uploadData

    The NSData to upload.

    Return Value

    An instance of FIRStorageUploadTask, which can be used to monitor or manage the upload.

  • Asynchronously uploads data to the currently specified FIRStorageReference. This is not recommended for large files, and one should instead upload a file from disk.

    Declaration

    Objective-C

    - (nonnull FIRStorageUploadTask *)putData:(nonnull NSData *)uploadData
                                     metadata:
                                         (nullable FIRStorageMetadata *)metadata;

    Parameters

    uploadData

    The NSData to upload.

    metadata

    FIRStorageMetadata containing additional information (MIME type, etc.) about the object being uploaded.

    Return Value

    An instance of FIRStorageUploadTask, which can be used to monitor or manage the upload.

  • Asynchronously uploads data to the currently specified FIRStorageReference. This is not recommended for large files, and one should instead upload a file from disk.

    Declaration

    Objective-C

    - (nonnull FIRStorageUploadTask *)
           putData:(nonnull NSData *)uploadData
          metadata:(nullable FIRStorageMetadata *)metadata
        completion:(nullable void (^)(FIRStorageMetadata *_Nullable,
                                      NSError *_Nullable))completion;

    Parameters

    uploadData

    The NSData to upload.

    metadata

    FIRStorageMetadata containing additional information (MIME type, etc.) about the object being uploaded.

    completion

    A completion block that either returns the object metadata on success, or an error on failure.

    Return Value

    An instance of FIRStorageUploadTask, which can be used to monitor or manage the upload.