Cloud Storage JSON API (storage:v1)

2024-12-10

1 new method

Additions

    Methods
  • storage.objects.move

      Path : b/{bucket}/o/{sourceObject}/moveTo/o/{destinationObject}

      HTTP Method : POST

      Description : Moves the source object to the destination object in the same bucket.

      Parameters :

        bucket

          Type : string

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

          Required : Yes

          Location : path

        sourceObject

          Type : string

          Description : Name of the source object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).

          Required : Yes

          Location : path

        destinationObject

          Type : string

          Description : Name of the destination object. For information about how to URL encode object names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/request-endpoints#encoding).

          Required : Yes

          Location : path

        ifSourceGenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the source object's current generation matches the given value. `ifSourceGenerationMatch` and `ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        ifSourceGenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether the source object's current generation does not match the given value. `ifSourceGenerationMatch` and `ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        ifSourceMetagenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the source object's current metageneration matches the given value. `ifSourceMetagenerationMatch` and `ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        ifSourceMetagenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether the source object's current metageneration does not match the given value. `ifSourceMetagenerationMatch` and `ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        ifGenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the destination object's current generation matches the given value. Setting to 0 makes the operation succeed only if there are no live versions of the object. `ifGenerationMatch` and `ifGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        ifGenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether the destination object's current generation does not 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.`ifGenerationMatch` and `ifGenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        ifMetagenerationMatch

          Type : string

          Description : Makes the operation conditional on whether the destination object's current metageneration matches the given value. `ifMetagenerationMatch` and `ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        ifMetagenerationNotMatch

          Type : string

          Description : Makes the operation conditional on whether the destination object's current metageneration does not match the given value. `ifMetagenerationMatch` and `ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for both of them to be set in the request.

          Format : int64

          Location : query

        userProject

          Type : string

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

          Location : query

      Parameter Order :

    • bucket
    • sourceObject
    • destinationObject
    • Scopes :

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/devstorage.full_control
    • https://www.googleapis.com/auth/devstorage.read_write