Module Expr Str Import alias Import alias ImportFrom alias ImportFrom alias ImportFrom alias ImportFrom alias ImportFrom alias ImportFrom alias ImportFrom alias ImportFrom alias ClassDef bases NameLoad body Expr Str FunctionDef arguments args NameParam NameParam NameParam NameParam defaults NameLoad NameLoad body If CompareIs NameLoad NameLoad body Assign NameStore AttributeLoad NameLoad attr Assign AttributeStore NameLoad attr NameLoad Assign AttributeStore NameLoad attr Call NameLoad Assign AttributeStore NameLoad attr NameLoad Expr Call AttributeLoad Call NameLoad NameLoad NameLoad attr keyword NameLoad keyword BinOpAdd AttributeLoad NameLoad attr Str keyword NameLoad decorator_list FunctionDef arguments args NameParam NameParam defaults body Expr Str Assign AttributeStore NameLoad attr Call NameLoad Call AttributeLoad NameLoad attr Str TupleLoad Expr Call AttributeLoad AttributeLoad NameLoad attr attr AttributeLoad NameLoad attr For NameStore Call AttributeLoad NameLoad attr Str ListLoad body Assign NameStore Call AttributeLoad NameLoad attr Str Assign NameStore Call NameLoad NameLoad keyword AttributeLoad NameLoad attr Expr Call AttributeLoad NameLoad attr NameLoad Expr Yield NameLoad decorator_list decorator_list ClassDef bases NameLoad body Expr Str Assign NameStore NameLoad Assign NameStore Num Expr Str Assign NameStore TupleLoad Str Str Str FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad body Expr Call AttributeLoad Call NameLoad NameLoad NameLoad attr keyword NameLoad Assign AttributeStore NameLoad attr NameLoad Assign AttributeStore NameLoad attr Call NameLoad NameLoad Assign AttributeStore NameLoad attr Call NameLoad NameLoad decorator_list FunctionDef arguments args NameParam defaults body Return BinOpMod Str AttributeLoad NameLoad attr decorator_list FunctionDef arguments args NameParam defaults body Expr Str Return AttributeLoad NameLoad attr decorator_list NameLoad FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad body Expr Str Return Call NameLoad keyword NameLoad keyword NameLoad keyword NameLoad decorator_list FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str Assign NameStore Call AttributeLoad NameLoad attr NameLoad TryExcept body Assign NameStore Dict Str Str Expr Call AttributeLoad AttributeLoad NameLoad attr attr keyword Str keyword AttributeLoad NameLoad attr keyword NameLoad keyword NameLoad Return NameLoad handlers ExceptHandler type NameLoad body Return NameLoad decorator_list FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str Assign NameStore Call AttributeLoad NameLoad attr NameLoad Assign NameStore Dict Str AttributeLoad NameLoad attr Assign NameStore Call NameLoad GeneratorExp TupleLoad NameLoad SubscriptLoad AttributeLoad NameLoad attr Index NameLoad comprehension NameStore AttributeLoad NameLoad attr Assign SubscriptStore NameLoad Index Str AttributeLoad NameLoad attr Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr keyword Str keyword Str keyword NameLoad keyword NameLoad keyword NameLoad Expr Call AttributeLoad NameLoad attr NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Return AttributeLoad NameLoad attr decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Return AttributeLoad NameLoad attr decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Return BinOpAdd Str NameLoad decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str If UnaryOpNot AttributeLoad NameLoad attr body Raise Call NameLoad Str Return Call AttributeLoad NameLoad attr AttributeLoad NameLoad attr decorator_list NameLoad FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad body Expr Str Assign NameStore Call AttributeLoad NameLoad attr NameLoad Assign NameStore Call NameLoad keyword NameLoad keyword NameLoad TryExcept body Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr keyword Str keyword AttributeLoad NameLoad attr keyword NameLoad Expr Call AttributeLoad NameLoad attr NameLoad Return NameLoad handlers ExceptHandler type NameLoad body Return NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad NameLoad NameLoad NameLoad Str NameLoad NameLoad body Expr Str Assign NameStore Dict If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad Assign NameStore Call AttributeLoad NameLoad attr NameLoad keyword NameLoad keyword NameLoad If CompareIsNot NameLoad NameLoad body Assign AttributeStore NameLoad attr NameLoad Return NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad NameLoad body Expr Str Assign NameStore Call AttributeLoad NameLoad attr NameLoad If NameLoad body Assign NameStore Call NameLoad Call AttributeLoad NameLoad attr keyword BinOpAdd AttributeLoad NameLoad attr Num keyword NameLoad If CompareGt Call NameLoad NameLoad AttributeLoad NameLoad attr body Assign NameStore BinOpMod Str TupleLoad AttributeLoad NameLoad attr Raise Call NameLoad NameLoad Expr Call AttributeLoad NameLoad attr NameLoad keyword Lambda arguments args NameParam defaults NameLoad keyword NameLoad Expr Call AttributeLoad AttributeLoad NameLoad attr attr keyword Str keyword AttributeLoad NameLoad attr keyword NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad body Expr Str Assign NameStore Call AttributeLoad NameLoad attr NameLoad Assign NameStore Call AttributeLoad NameLoad attr AttributeLoad NameLoad attr NameLoad Expr Call AttributeLoad AttributeLoad NameLoad attr attr keyword Str keyword NameLoad keyword NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam defaults NameLoad NameLoad body Expr Str For NameStore NameLoad body TryExcept body Assign NameStore NameLoad If UnaryOpNot Call NameLoad NameLoad AttributeLoad NameLoad attr body Assign NameStore AttributeLoad NameLoad attr Expr Call AttributeLoad NameLoad attr NameLoad keyword NameLoad handlers ExceptHandler type NameLoad body If CompareIsNot NameLoad NameLoad body Expr Call NameLoad NameLoad orelse Raise decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad body Expr Str Assign NameStore Call AttributeLoad NameLoad attr NameLoad If CompareIs NameLoad NameLoad body Assign NameStore AttributeLoad NameLoad attr Assign NameStore Call NameLoad keyword NameLoad keyword NameLoad Assign NameStore BinOpAdd BinOpAdd AttributeLoad NameLoad attr Str AttributeLoad NameLoad attr Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr keyword Str keyword NameLoad keyword NameLoad Expr Call AttributeLoad NameLoad attr NameLoad Return NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam defaults NameLoad body Expr Str Assign NameStore Call AttributeLoad NameLoad attr NameLoad NameLoad NameLoad keyword NameLoad Expr Call AttributeLoad NameLoad attr keyword NameLoad Return NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Return ListComp Call AttributeLoad NameLoad attr NameLoad comprehension NameStore Call AttributeLoad AttributeLoad NameLoad attr attr Str TupleLoad decorator_list NameLoad FunctionDef arguments args NameParam NameParam defaults body Expr Str Expr Call AttributeLoad NameLoad attr Str NameLoad decorator_list AttributeLoad NameLoad attr FunctionDef arguments args NameParam defaults body Expr Str Return Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Return Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr Str Dict Return ListComp Call AttributeLoad NameLoad attr NameLoad comprehension NameStore Call AttributeLoad NameLoad attr Str TupleLoad decorator_list NameLoad FunctionDef arguments args NameParam NameParam defaults body Expr Str Expr Call AttributeLoad NameLoad attr Str Dict Str NameLoad decorator_list AttributeLoad NameLoad attr Assign NameStore Call NameLoad Str Expr Str FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr Str Return Call AttributeLoad NameLoad attr NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam defaults Str body Expr Str Assign NameStore Dict Str Str NameLoad NameLoad Expr Call AttributeLoad NameLoad attr Str NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Expr Call AttributeLoad NameLoad attr Str NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr Str If CompareIsNot NameLoad NameLoad body Return Call NameLoad NameLoad decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Return Call AttributeLoad NameLoad attr Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr Str If CompareIsNot NameLoad NameLoad body Return Call NameLoad NameLoad decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Return Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Return Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list NameLoad FunctionDef arguments args NameParam NameParam defaults body Expr Str If CompareNotIn NameLoad AttributeLoad NameLoad attr body Raise Call NameLoad BinOpMod Str TupleLoad NameLoad Expr Call AttributeLoad NameLoad attr Str NameLoad decorator_list AttributeLoad NameLoad attr FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr Str If CompareIsNot NameLoad NameLoad body Return Call NameLoad NameLoad decorator_list NameLoad FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Call AttributeLoad AttributeLoad NameLoad attr attr Str Dict Return Call AttributeLoad NameLoad attr Str NameLoad decorator_list NameLoad FunctionDef arguments args NameParam NameParam defaults body Expr Str Expr Call AttributeLoad NameLoad attr Str Dict Str Call NameLoad NameLoad decorator_list AttributeLoad NameLoad attr FunctionDef arguments args NameParam NameParam NameParam defaults NameLoad NameLoad body Expr Str Assign NameStore Dict Str Str NameLoad NameLoad Expr Call AttributeLoad NameLoad attr Str NameLoad decorator_list FunctionDef arguments args NameParam defaults body Expr Str Return Call AttributeLoad NameLoad attr NameLoad NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam defaults NameLoad NameLoad NameLoad body Expr Str Expr Call AttributeLoad Call AttributeLoad AttributeLoad NameLoad attr attr attr Expr Call AttributeLoad AttributeLoad NameLoad attr attr keyword NameLoad If NameLoad body Assign NameStore AttributeLoad NameLoad attr If UnaryOpNot AttributeLoad NameLoad attr body Expr Call AttributeLoad NameLoad attr keyword NameLoad Expr Call AttributeLoad Call AttributeLoad NameLoad attr attr Expr Call AttributeLoad NameLoad attr keyword NameLoad If NameLoad body Assign NameStore Call NameLoad Call AttributeLoad NameLoad attr keyword Str keyword BinOpAdd AttributeLoad NameLoad attr Num keyword NameLoad If CompareGt Call NameLoad NameLoad AttributeLoad NameLoad attr body Assign NameStore BinOpMod Str TupleLoad AttributeLoad NameLoad attr Raise Call NameLoad NameLoad For NameStore NameLoad body Expr Call AttributeLoad Call AttributeLoad AttributeLoad NameLoad attr attr attr Expr Call AttributeLoad AttributeLoad NameLoad attr attr keyword NameLoad decorator_list decorator_list
N/A N/A Create / interact with gcloud storage buckets. N/A copy N/A six gcloud._helpers _rfc3339_to_datetime gcloud.exceptions NotFound gcloud.iterator Iterator gcloud.storage._helpers _PropertyMixin gcloud.storage._helpers _scalar_property gcloud.storage.acl BucketACL gcloud.storage.acl DefaultObjectACL gcloud.storage.blob Blob _BlobIterator N/A Iterator N/A N/A An iterator listing blobs in a bucket

    You shouldn't have to use this directly, but instead should use the
    :class:`gcloud.storage.blob.Bucket.list_blobs` method.

    :type bucket: :class:`gcloud.storage.bucket.Bucket`
    :param bucket: The bucket from which to list blobs.

    :type extra_params: dict or None
    :param extra_params: Extra query string parameters for the API call.

    :type client: :class:`gcloud.storage.client.Client`
    :param client: Optional. The client to use for making connections.
                   Defaults to the bucket's client.
     __init__ N/A N/A self bucket extra_params client N/A None None N/A N/A N/A client None N/A N/A client N/A bucket client N/A N/A self bucket bucket N/A N/A self prefixes N/A set N/A N/A self _current_prefixes None N/A N/A N/A N/A super _BlobIterator self __init__ client client path N/A N/A bucket path /o extra_params extra_params N/A get_items_from_response N/A N/A self response N/A N/A N/A Yield :class:`.storage.blob.Blob` items from response.

        :type response: dict
        :param response: The JSON API response for a page of blobs.
         N/A N/A self _current_prefixes N/A tuple N/A N/A response get prefixes N/A N/A N/A N/A N/A self prefixes update N/A self _current_prefixes N/A item N/A N/A response get items N/A N/A N/A name N/A N/A item get name N/A blob N/A Blob name bucket N/A self bucket N/A N/A N/A blob _set_properties item N/A N/A blob N/A N/A Bucket N/A _PropertyMixin N/A N/A A class representing a Bucket on Cloud Storage.

    :type client: :class:`gcloud.storage.client.Client`
    :param client: A client which holds credentials and project configuration
                   for the bucket (which requires a project).

    :type name: string
    :param name: The name of the bucket.
     N/A _iterator_class _BlobIterator N/A _MAX_OBJECTS_FOR_ITERATION 256 N/A Maximum number of existing objects allowed in iteration.

    This is used in Bucket.delete() and Bucket.make_public().
     N/A _STORAGE_CLASSES N/A STANDARD NEARLINE DURABLE_REDUCED_AVAILABILITY __init__ N/A N/A self client name N/A None N/A N/A N/A N/A N/A super Bucket self __init__ name name N/A N/A self _client client N/A N/A self _acl N/A BucketACL self N/A N/A self _default_object_acl N/A DefaultObjectACL self N/A __repr__ N/A N/A self N/A N/A N/A N/A <Bucket: %s> N/A self name N/A client N/A N/A self N/A N/A N/A The client bound to this bucket. N/A N/A self _client N/A property blob N/A N/A self blob_name chunk_size N/A None N/A N/A Factory constructor for blob object.

        .. note::
          This will not make an HTTP request; it simply instantiates
          a blob object owned by this bucket.

        :type blob_name: string
        :param blob_name: The name of the blob to be instantiated.

        :type chunk_size: integer
        :param chunk_size: The size of a chunk of data whenever iterating
                           (1 MB). This must be a multiple of 256 KB per the
                           API specification.

        :rtype: :class:`gcloud.storage.blob.Blob`
        :returns: The blob object created.
         N/A N/A Blob name blob_name bucket self chunk_size chunk_size N/A exists N/A N/A self client N/A None N/A N/A Determines whether or not this bucket exists.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :rtype: boolean
        :returns: True if the bucket exists in Cloud Storage.
         N/A client N/A N/A self _require_client client N/A N/A N/A query_params N/A fields name N/A N/A N/A N/A client connection api_request method GET path N/A self path query_params query_params _target_object None N/A True N/A N/A N/A NotFound N/A N/A False N/A create N/A N/A self client N/A None N/A N/A Creates current bucket.

        If the bucket already exists, will raise
        :class:`gcloud.exceptions.Conflict`.

        This implements "storage.buckets.insert".

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :rtype: :class:`gcloud.storage.bucket.Bucket`
        :returns: The newly created bucket.
         N/A client N/A N/A self _require_client client N/A query_params N/A project N/A client project N/A properties N/A dict N/A N/A key N/A N/A self _properties N/A key N/A key N/A self _changes N/A N/A properties N/A name N/A self name N/A api_response N/A N/A N/A client connection api_request method POST path /b query_params query_params data properties _target_object self N/A N/A N/A self _set_properties api_response N/A acl N/A N/A self N/A N/A N/A Create our ACL on demand. N/A N/A self _acl N/A property default_object_acl N/A N/A self N/A N/A N/A Create our defaultObjectACL on demand. N/A N/A self _default_object_acl N/A property path_helper N/A N/A bucket_name N/A N/A N/A Relative URL path for a bucket.

        :type bucket_name: string
        :param bucket_name: The bucket name in the path.

        :rtype: string
        :returns: The relative URL path for ``bucket_name``.
         N/A N/A /b/ bucket_name N/A staticmethod path N/A N/A self N/A N/A N/A The URL path to this bucket. N/A N/A N/A self name N/A N/A N/A ValueError Cannot determine path without bucket name. N/A N/A N/A self path_helper N/A self name N/A property get_blob N/A N/A self blob_name client N/A None N/A N/A Get a blob object by name.

        This will return None if the blob doesn't exist::

          >>> from gcloud import storage
          >>> client = storage.Client()
          >>> bucket = client.get_bucket('my-bucket')
          >>> print bucket.get_blob('/path/to/blob.txt')
          <Blob: my-bucket, /path/to/blob.txt>
          >>> print bucket.get_blob('/does-not-exist.txt')
          None

        :type blob_name: string
        :param blob_name: The name of the blob to retrieve.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :rtype: :class:`gcloud.storage.blob.Blob` or None
        :returns: The blob object if it exists, otherwise None.
         N/A client N/A N/A self _require_client client N/A blob N/A Blob bucket self name blob_name N/A N/A N/A response N/A N/A N/A client connection api_request method GET path N/A blob path _target_object blob N/A N/A N/A blob _set_properties response N/A blob N/A N/A N/A NotFound N/A N/A None N/A list_blobs N/A N/A self max_results page_token prefix delimiter versions projection fields client N/A None None None None None noAcl None None N/A N/A Return an iterator used to find blobs in the bucket.

        :type max_results: integer or ``NoneType``
        :param max_results: maximum number of blobs to return.

        :type page_token: string
        :param page_token: opaque marker for the next "page" of blobs. If not
                           passed, will return the first page of blobs.

        :type prefix: string or ``NoneType``
        :param prefix: optional prefix used to filter blobs.

        :type delimiter: string or ``NoneType``
        :param delimiter: optional delimter, used with ``prefix`` to
                          emulate hierarchy.

        :type versions: boolean or ``NoneType``
        :param versions: whether object versions should be returned as
                         separate blobs.

        :type projection: string or ``NoneType``
        :param projection: If used, must be 'full' or 'noAcl'. Defaults to
                           'noAcl'. Specifies the set of properties to return.

        :type fields: string or ``NoneType``
        :param fields: Selector specifying which fields to include in a
                       partial response. Must be a list of fields. For example
                       to get a partial response with just the next page token
                       and the language of each blob returned:
                       'items/contentLanguage,nextPageToken'

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :rtype: :class:`_BlobIterator`.
        :returns: An iterator of blobs.
         N/A extra_params N/A N/A N/A max_results None N/A N/A N/A extra_params N/A maxResults max_results N/A N/A prefix None N/A N/A N/A extra_params N/A prefix prefix N/A N/A delimiter None N/A N/A N/A extra_params N/A delimiter delimiter N/A N/A versions None N/A N/A N/A extra_params N/A versions versions N/A N/A extra_params N/A projection projection N/A N/A fields None N/A N/A N/A extra_params N/A fields fields N/A result N/A N/A self _iterator_class self extra_params extra_params client client N/A N/A page_token None N/A N/A N/A result next_page_token page_token N/A result N/A delete N/A N/A self force client N/A False None N/A N/A Delete this bucket.

        The bucket **must** be empty in order to submit a delete request. If
        ``force=True`` is passed, this will first attempt to delete all the
        objects / blobs in the bucket (i.e. try to empty the bucket).

        If the bucket doesn't exist, this will raise
        :class:`gcloud.exceptions.NotFound`.  If the bucket is not empty
        (and ``force=False``), will raise :class:`gcloud.exceptions.Conflict`.

        If ``force=True`` and the bucket contains more than 256 objects / blobs
        this will cowardly refuse to delete the objects (or the bucket). This
        is to prevent accidental bucket deletion and to prevent extremely long
        runtime of this method.

        :type force: boolean
        :param force: If True, empties the bucket's objects then deletes it.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :raises: :class:`ValueError` if ``force`` is ``True`` and the bucket
                 contains more than 256 objects / blobs.
         N/A client N/A N/A self _require_client client N/A force N/A N/A blobs N/A list N/A N/A self list_blobs max_results N/A N/A self _MAX_OBJECTS_FOR_ITERATION 1 client client N/A N/A N/A len blobs N/A self _MAX_OBJECTS_FOR_ITERATION N/A N/A message N/A Refusing to delete bucket with more than %d objects. If you actually want to delete this bucket, please delete the objects yourself before calling Bucket.delete(). N/A N/A self _MAX_OBJECTS_FOR_ITERATION N/A N/A ValueError message N/A N/A N/A self delete_blobs blobs on_error N/A N/A N/A blob N/A None client client N/A N/A N/A N/A client connection api_request method DELETE path N/A self path _target_object None N/A delete_blob N/A N/A self blob_name client N/A None N/A N/A Deletes a blob from the current bucket.

        If the blob isn't found (backend 404), raises a
        :class:`gcloud.exceptions.NotFound`.

        For example::

          >>> from gcloud.exceptions import NotFound
          >>> from gcloud import storage
          >>> client = storage.Client()
          >>> bucket = client.get_bucket('my-bucket')
          >>> print bucket.list_blobs()
          [<Blob: my-bucket, my-file.txt>]
          >>> bucket.delete_blob('my-file.txt')
          >>> try:
          ...   bucket.delete_blob('doesnt-exist')
          ... except NotFound:
          ...   pass

        :type blob_name: string
        :param blob_name: A blob name to delete.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :raises: :class:`gcloud.exceptions.NotFound` (to suppress
                 the exception, call ``delete_blobs``, passing a no-op
                 ``on_error`` callback, e.g.::

                 >>> bucket.delete_blobs([blob], on_error=lambda blob: None)
         N/A client N/A N/A self _require_client client N/A blob_path N/A N/A Blob path_helper N/A self path blob_name N/A N/A N/A N/A client connection api_request method DELETE path blob_path _target_object None N/A delete_blobs N/A N/A self blobs on_error client N/A None None N/A N/A Deletes a list of blobs from the current bucket.

        Uses :func:`Bucket.delete_blob` to delete each individual blob.

        :type blobs: list of string or :class:`gcloud.storage.blob.Blob`
        :param blobs: A list of blob names or Blob objects to delete.

        :type on_error: a callable taking (blob)
        :param on_error: If not ``None``, called once for each blob raising
                         :class:`gcloud.exceptions.NotFound`;
                         otherwise, the exception is propagated.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :raises: :class:`gcloud.exceptions.NotFound` (if
                 `on_error` is not passed).
         N/A blob blobs N/A N/A N/A N/A blob_name blob N/A N/A N/A isinstance blob_name N/A six string_types N/A N/A blob_name N/A blob name N/A N/A N/A self delete_blob blob_name client client N/A N/A N/A NotFound N/A N/A N/A on_error None N/A N/A N/A on_error blob N/A N/A N/A copy_blob N/A N/A self blob destination_bucket new_name client N/A None None N/A N/A Copy the given blob to the given bucket, optionally with a new name.

        :type blob: :class:`gcloud.storage.blob.Blob`
        :param blob: The blob to be copied.

        :type destination_bucket: :class:`gcloud.storage.bucket.Bucket`
        :param destination_bucket: The bucket into which the blob should be
                                   copied.

        :type new_name: string
        :param new_name: (optional) the new name for the copied file.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :rtype: :class:`gcloud.storage.blob.Blob`
        :returns: The new Blob.
         N/A client N/A N/A self _require_client client N/A N/A new_name None N/A N/A new_name N/A blob name N/A new_blob N/A Blob bucket destination_bucket name new_name N/A api_path N/A N/A N/A blob path /copyTo N/A new_blob path N/A copy_result N/A N/A N/A client connection api_request method POST path api_path _target_object new_blob N/A N/A N/A new_blob _set_properties copy_result N/A new_blob N/A rename_blob N/A N/A self blob new_name client N/A None N/A N/A Rename the given blob using copy and delete operations.

        Effectively, copies blob to the same bucket with a new name, then
        deletes the blob.

        .. warning::

          This method will first duplicate the data and then delete the
          old blob.  This means that with very large objects renaming
          could be a very (temporarily) costly or a very slow operation.

        :type blob: :class:`gcloud.storage.blob.Blob`
        :param blob: The blob to be renamed.

        :type new_name: string
        :param new_name: The new name for this blob.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.

        :rtype: :class:`Blob`
        :returns: The newly-renamed blob.
         N/A new_blob N/A N/A self copy_blob blob self new_name client client N/A N/A N/A blob delete client client N/A new_blob N/A cors N/A N/A self N/A N/A N/A Retrieve CORS policies configured for this bucket.

        See: http://www.w3.org/TR/cors/ and
             https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: list of dictionaries
        :returns: A sequence of mappings describing each CORS policy.
         N/A N/A N/A N/A copy deepcopy policy N/A policy N/A N/A N/A self _properties get cors N/A N/A property cors N/A N/A self entries N/A N/A N/A Set CORS policies configured for this bucket.

        See: http://www.w3.org/TR/cors/ and
             https://cloud.google.com/storage/docs/json_api/v1/buckets

        :type entries: list of dictionaries
        :param entries: A sequence of mappings describing each CORS policy.
         N/A N/A N/A self _patch_property cors entries N/A N/A cors setter etag N/A N/A self N/A N/A N/A Retrieve the ETag for the bucket.

        See: http://tools.ietf.org/html/rfc2616#section-3.11 and
             https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: string or ``NoneType``
        :returns: The bucket etag or ``None`` if the property is not
                  set locally.
         N/A N/A N/A N/A self _properties get etag N/A property id N/A N/A self N/A N/A N/A Retrieve the ID for the bucket.

        See: https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: string or ``NoneType``
        :returns: The ID of the bucket or ``None`` if the property is not
                  set locally.
         N/A N/A N/A N/A self _properties get id N/A property lifecycle_rules N/A N/A self N/A N/A N/A Lifecycle rules configured for this bucket.

        See: https://cloud.google.com/storage/docs/lifecycle and
             https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: list(dict)
        :returns: A sequence of mappings describing each lifecycle rule.
         N/A info N/A N/A N/A self _properties get lifecycle N/A N/A N/A N/A N/A copy deepcopy rule N/A rule N/A N/A info get rule N/A N/A property lifecycle_rules N/A N/A self rules N/A N/A N/A Update the lifecycle rules configured for this bucket.

        See: https://cloud.google.com/storage/docs/lifecycle and
             https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: list(dict)
        :returns: A sequence of mappings describing each lifecycle rule.
         N/A N/A N/A self _patch_property lifecycle N/A rule rules N/A N/A lifecycle_rules setter N/A location N/A _scalar_property location N/A Retrieve location configured for this bucket.

    See: https://cloud.google.com/storage/docs/json_api/v1/buckets and
    https://cloud.google.com/storage/docs/concepts-techniques#specifyinglocations

    If the property is not set locally, returns ``None``.

    :rtype: string or ``NoneType``
     get_logging N/A N/A self N/A N/A N/A Return info about access logging for this bucket.

        See: https://cloud.google.com/storage/docs/accesslogs#status

        :rtype: dict or None
        :returns: a dict w/ keys, ``logBucket`` and ``logObjectPrefix``
                  (if logging is enabled), or None (if not).
         N/A info N/A N/A N/A self _properties get logging N/A N/A N/A copy deepcopy info N/A enable_logging N/A N/A self bucket_name object_prefix N/A N/A N/A Enable access logging for this bucket.

        See: https://cloud.google.com/storage/docs/accesslogs#delivery

        :type bucket_name: string
        :param bucket_name: name of bucket in which to store access logs

        :type object_prefix: string
        :param object_prefix: prefix for access log filenames
         N/A info N/A logBucket logObjectPrefix bucket_name object_prefix N/A N/A N/A self _patch_property logging info N/A disable_logging N/A N/A self N/A N/A N/A Disable access logging for this bucket.

        See: https://cloud.google.com/storage/docs/accesslogs#disabling
         N/A N/A N/A self _patch_property logging None N/A metageneration N/A N/A self N/A N/A N/A Retrieve the metageneration for the bucket.

        See: https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: integer or ``NoneType``
        :returns: The metageneration of the bucket or ``None`` if the property
                  is not set locally.
         N/A metageneration N/A N/A N/A self _properties get metageneration N/A N/A metageneration None N/A N/A N/A int metageneration N/A property owner N/A N/A self N/A N/A N/A Retrieve info about the owner of the bucket.

        See: https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: dict or ``NoneType``
        :returns: Mapping of owner's role/ID. If the property is not set
                  locally, returns ``None``.
         N/A N/A N/A copy deepcopy N/A N/A N/A self _properties get owner N/A property project_number N/A N/A self N/A N/A N/A Retrieve the number of the project to which the bucket is assigned.

        See: https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: integer or ``NoneType``
        :returns: The project number that owns the bucket or ``None`` if the
                  property is not set locally.
         N/A project_number N/A N/A N/A self _properties get projectNumber N/A N/A project_number None N/A N/A N/A int project_number N/A property self_link N/A N/A self N/A N/A N/A Retrieve the URI for the bucket.

        See: https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: string or ``NoneType``
        :returns: The self link for the bucket or ``None`` if the property is
                  not set locally.
         N/A N/A N/A N/A self _properties get selfLink N/A property storage_class N/A N/A self N/A N/A N/A Retrieve the storage class for the bucket.

        See: https://cloud.google.com/storage/docs/storage-classes
        https://cloud.google.com/storage/docs/nearline-storage
        https://cloud.google.com/storage/docs/durable-reduced-availability

        :rtype: string or ``NoneType``
        :returns: If set, one of "STANDARD", "NEARLINE", or
                  "DURABLE_REDUCED_AVAILABILITY", else ``None``.
         N/A N/A N/A N/A self _properties get storageClass N/A property storage_class N/A N/A self value N/A N/A N/A Set the storage class for the bucket.

        See: https://cloud.google.com/storage/docs/storage-classes
        https://cloud.google.com/storage/docs/nearline-storage
        https://cloud.google.com/storage/docs/durable-reduced-availability

        :type value: string
        :param value: one of "STANDARD", "NEARLINE", or
                      "DURABLE_REDUCED_AVAILABILITY"
         N/A N/A value N/A self _STORAGE_CLASSES N/A N/A N/A ValueError N/A Invalid storage class: %s N/A value N/A N/A N/A self _patch_property storageClass value N/A N/A storage_class setter time_created N/A N/A self N/A N/A N/A Retrieve the timestamp at which the bucket was created.

        See: https://cloud.google.com/storage/docs/json_api/v1/buckets

        :rtype: :class:`datetime.datetime` or ``NoneType``
        :returns: Datetime object parsed from RFC3339 valid timestamp, or
                  ``None`` if the property is not set locally.
         N/A value N/A N/A N/A self _properties get timeCreated N/A N/A value None N/A N/A N/A _rfc3339_to_datetime value N/A property versioning_enabled N/A N/A self N/A N/A N/A Is versioning enabled for this bucket?

        See:  https://cloud.google.com/storage/docs/object-versioning for
        details.

        :rtype: boolean
        :returns: True if enabled, else False.
         N/A versioning N/A N/A N/A self _properties get versioning N/A N/A N/A N/A versioning get enabled False N/A property versioning_enabled N/A N/A self value N/A N/A N/A Enable versioning for this bucket.

        See:  https://cloud.google.com/storage/docs/object-versioning for
        details.

        :type value: convertible to boolean
        :param value: should versioning be anabled for the bucket?
         N/A N/A N/A self _patch_property versioning N/A enabled N/A bool value N/A N/A versioning_enabled setter configure_website N/A N/A self main_page_suffix not_found_page N/A None None N/A N/A Configure website-related properties.

        See: https://developers.google.com/storage/docs/website-configuration

        .. note::
          This (apparently) only works
          if your bucket name is a domain name
          (and to do that, you need to get approved somehow...).

        If you want this bucket to host a website, just provide the name
        of an index page and a page to use when a blob isn't found::

          >>> from gcloud import storage
          >>> client = storage.Client()
          >>> bucket = client.get_bucket(bucket_name)
          >>> bucket.configure_website('index.html', '404.html')

        You probably should also make the whole bucket public::

          >>> bucket.make_public(recursive=True, future=True)

        This says: "Make the bucket public, and all the stuff already in
        the bucket, and anything else I add to the bucket.  Just make it
        all public."

        :type main_page_suffix: string
        :param main_page_suffix: The page to use as the main page
                                 of a directory.
                                 Typically something like index.html.

        :type not_found_page: string
        :param not_found_page: The file to use when a page isn't found.
         N/A data N/A mainPageSuffix notFoundPage main_page_suffix not_found_page N/A N/A N/A self _patch_property website data N/A disable_website N/A N/A self N/A N/A N/A Disable the website configuration for this bucket.

        This is really just a shortcut for setting the website-related
        attributes to ``None``.
         N/A N/A N/A self configure_website None None N/A make_public N/A N/A self recursive future client N/A False False None N/A N/A Make a bucket public.

        If ``recursive=True`` and the bucket contains more than 256
        objects / blobs this will cowardly refuse to make the objects public.
        This is to prevent extremely long runtime of this method.

        :type recursive: boolean
        :param recursive: If True, this will make all blobs inside the bucket
                          public as well.

        :type future: boolean
        :param future: If True, this will make all objects created in the
                       future public as well.

        :type client: :class:`gcloud.storage.client.Client` or ``NoneType``
        :param client: Optional. The client to use.  If not passed, falls back
                       to the ``client`` stored on the current bucket.
         N/A N/A N/A N/A N/A N/A self acl all grant_read N/A N/A N/A N/A self acl save client client N/A future N/A N/A doa N/A self default_object_acl N/A N/A N/A doa loaded N/A N/A N/A N/A doa reload client client N/A N/A N/A N/A N/A doa all grant_read N/A N/A N/A doa save client client N/A recursive N/A N/A blobs N/A list N/A N/A self list_blobs projection full max_results N/A N/A self _MAX_OBJECTS_FOR_ITERATION 1 client client N/A N/A N/A len blobs N/A self _MAX_OBJECTS_FOR_ITERATION N/A N/A message N/A Refusing to make public recursively with more than %d objects. If you actually want to make every object in this bucket public, please do it on the objects yourself. N/A N/A self _MAX_OBJECTS_FOR_ITERATION N/A N/A ValueError message N/A blob blobs N/A N/A N/A N/A N/A N/A N/A blob acl all grant_read N/A N/A N/A N/A blob acl save client client N/A N/A