Cloud Storage JSON API (storage:v1)

2023-09-10

2 updated methods | 5 removed methods

Updates

    Methods
  • storage.objects.get

      Parameters :

        softDeleted

          Type : boolean

          Description : If true, only soft-deleted object versions will be listed. The default is false. For more information, see Soft Delete.

          Location : query

  • storage.objects.list

      Parameters :

        softDeleted

          Type : boolean

          Description : If true, only soft-deleted object versions will be listed. The default is false. For more information, see Soft Delete.

          Location : query

Deletions

    Methods
  • storage.buckets.operations.cancel

  • storage.buckets.operations.get

  • storage.buckets.operations.list

  • storage.objects.restore

      Path : b/{bucket}/o/{object}/restore

      HTTP Method : POST

      Description : Restores a soft-deleted object.

      Parameters :

        bucket

          Type : string

          Description : Name of the bucket in which the object resides.

          Required : Yes

          Location : path

        generation

          Type : string

          Description : Selects a specific revision of this object.

          Required : Yes

          Format : int64

          Location : query

        object

          Type : string

          Description : Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

          Required : Yes

          Location : path

        ifGenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the object's one live generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.

          Format : int64

          Location : query

        ifGenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether none of the object's live generations match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.

          Format : int64

          Location : query

        ifMetagenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the object's one live metageneration matches the given value.

          Format : int64

          Location : query

        ifMetagenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether none of the object's live metagenerations match the given value.

          Format : int64

          Location : query

        projection

          Type : string

          Description : Set of properties to return. Defaults to full.

          Enum :

        • full
        • noAcl
        • Enum Descriptions :

        • Include all properties.
        • Omit the owner, acl property.
        • Location : query

        userProject

          Type : string

          Description : The project to be billed for this request. Required for Requester Pays buckets.

          Location : query

      Parameter Order :

    • bucket
    • object
    • Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/devstorage.full_control
  • storage.objects.bulkRestore

5 new methods | 2 updated methods

Additions

    Methods
  • storage.buckets.operations.cancel

  • storage.buckets.operations.get

  • storage.buckets.operations.list

  • storage.objects.restore

      Path : b/{bucket}/o/{object}/restore

      HTTP Method : POST

      Description : Restores a soft-deleted object.

      Parameters :

        bucket

          Type : string

          Description : Name of the bucket in which the object resides.

          Required : Yes

          Location : path

        generation

          Type : string

          Description : Selects a specific revision of this object.

          Required : Yes

          Format : int64

          Location : query

        object

          Type : string

          Description : Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

          Required : Yes

          Location : path

        ifGenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the object's one live generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object.

          Format : int64

          Location : query

        ifGenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether none of the object's live generations match the given value. If no live object exists, the precondition fails. Setting to 0 makes the operation succeed only if there is a live version of the object.

          Format : int64

          Location : query

        ifMetagenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the object's one live metageneration matches the given value.

          Format : int64

          Location : query

        ifMetagenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether none of the object's live metagenerations match the given value.

          Format : int64

          Location : query

        projection

          Type : string

          Description : Set of properties to return. Defaults to full.

          Enum :

        • full
        • noAcl
        • Enum Descriptions :

        • Include all properties.
        • Omit the owner, acl property.
        • Location : query

        userProject

          Type : string

          Description : The project to be billed for this request. Required for Requester Pays buckets.

          Location : query

      Parameter Order :

    • bucket
    • object
    • Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/devstorage.full_control
  • storage.objects.bulkRestore

Updates

    Methods
  • storage.objects.get

      Parameters :

        softDeleted

          Type : boolean

          Description : If true, only soft-deleted object versions will be listed. The default is false. For more information, see Soft Delete.

          Location : query

  • storage.objects.list

      Parameters :

        softDeleted

          Type : boolean

          Description : If true, only soft-deleted object versions will be listed. The default is false. For more information, see Soft Delete.

          Location : query