[Yandex Cloud documentation](../../index.md) > [Yandex Object Storage](../index.md) > [Concepts](index.md) > Partial object updates

# Partial object updates

Object Storage supports _partial updating and appending of objects data_ in a bucket.

{% note info %}

Basic [S3 API](../s3/index.md) operations do not include partial object update. This feature is supported for buckets with [versioning](versioning.md) disabled.

{% endnote %}

With partial updates, you can store data (e.g., logs) in a bucket as a single file and append data to it from time to time.

This also simplifies large file processing. For example, to change one byte of information in a large file, you can use:
* Standard [get](../s3/api-ref/object/get.md) and [upload](../s3/api-ref/object/upload.md) S3 API methods by fully downloading and uploading the object back to the storage.
* [Patch](../s3/api-ref/object/patch.md) method by uploading only the changed/new part of the file to the storage.

Such partial overwrite streamlines your Object Storage operations and reduces costs.

With partial updates, the following will be overwritten on the server side:
* Object as a whole, if initially uploaded using the [PUT](../s3/api-ref/object/upload.md) method.
* Object components being updated, if the object was initially [uploaded in parts](multipart.md).

This feature is implemented as a [patch](../s3/api-ref/object/patch.md) method and is supported in [GeeseFS](../tools/geesefs.md#patch).

GeeseFS is the recommended tool for partial updates of objects in a bucket.

You can also directly [send patch requests](../s3/index.md) to the Object Storage API, or extend the set of [AWS SDK](../tools/index.md) methods using the patch method [specification](#specification).

## Concurrent object updates {#concurrent-patch}

Object Storage supports concurrent partial object updates.

With a partial update, each parallel request runs on a dedicated object snapshot. Therefore, different update requests for the same object are processed independently.

All changes during parallel requests are applied atomically.

## Conflict resolution {#conflicts}

A conflict resolution feature is available for concurrent partial updates.

In case fo success, the more recent update is applied. 

The number of overwrite retries on the server side is limited. If the server fails to resolve conflicts, the user gets the `ConcurrentUpdatesPatchConflict` error. 

## Specification {#specification}

```json
"PatchObject":{
  "name":"PatchObject",
  "http":{
    "method":"PATCH",
    "requestUri":"/{Bucket}/{Key+}"
  },
  "input":{"shape":"PatchObjectRequest"},
  "output":{"shape":"PatchObjectOutput"},
  "httpChecksum":{
    "requestAlgorithmMember":"ChecksumAlgorithm",
    "requestChecksumRequired":false
  }
},
"PatchAppendPartSize":{"type": "integer"},
"PatchedObjectInfo":{
  "type":"structure",
  "members":{
    "ETag":{"shape":"ETag"},
    "LastModified":{"shape":"LastModified"}
  }
},
"PatchObjectOutput":{
  "type":"structure",
  "members":{
    "Object":{"shape":"PatchedObjectInfo"}
  }
},
"PatchObjectRequest":{
  "type":"structure",
  "required":[
    "Bucket",
    "Key",
    "ContentRange"
  ],
  "members":{
    "Body":{
      "shape":"Body",
      "streaming":true
    },
    "Bucket":{
      "shape":"BucketName",
      "location":"uri",
      "locationName":"Bucket"
    },
    "ContentLength":{
      "shape":"ContentLength",
      "location":"header",
      "locationName":"Content-Length"
    },
    "ContentMD5":{
      "shape":"ContentMD5",
      "location":"header",
      "locationName":"Content-MD5"
    },
    "ContentRange":{
      "shape":"ContentRange",
      "location":"header",
      "locationName":"Content-Range"
    },
    "IfMatch":{
      "shape":"IfMatch",
      "location":"header",
      "locationName":"If-Match"
    },
    "IfUnmodifiedSince":{
      "shape":"IfUnmodifiedSince",
      "location":"header",
      "locationName":"If-Unmodified-Since"
    },
    "Key":{
      "shape":"ObjectKey",
      "location":"uri",
      "locationName":"Key"
    },
    "PatchAppendPartSize":{
      "shape":"PatchAppendPartSize",
      "location":"header",
      "locationName":"X-Yc-S3-Patch-Append-Part-Size"
    }
  },
  "payload":"Body"
},
```