Cloud Storage JSON API
  1. buckets
Cloud Storage JSON API
  • buckets
    • /b
      GET
    • /b
      POST
    • /b/{bucket}
      DELETE
    • /b/{bucket}
      GET
    • /b/{bucket}
      PATCH
    • /b/{bucket}
      PUT
  • bucketAccessControls
    • /b/{bucket}/acl
      GET
    • /b/{bucket}/acl
      POST
    • /b/{bucket}/acl/{entity}
      DELETE
    • /b/{bucket}/acl/{entity}
      GET
    • /b/{bucket}/acl/{entity}
      PATCH
    • /b/{bucket}/acl/{entity}
      PUT
  • defaultObjectAccessControls
    • /b/{bucket}/defaultObjectAcl
      GET
    • /b/{bucket}/defaultObjectAcl
      POST
    • /b/{bucket}/defaultObjectAcl/{entity}
      DELETE
    • /b/{bucket}/defaultObjectAcl/{entity}
      GET
    • /b/{bucket}/defaultObjectAcl/{entity}
      PATCH
    • /b/{bucket}/defaultObjectAcl/{entity}
      PUT
  • objects
    • /b/{bucket}/o
      GET
    • /b/{bucket}/o
      POST
    • /b/{bucket}/o/watch
      POST
    • /b/{bucket}/o/{object}
      DELETE
    • /b/{bucket}/o/{object}
      GET
    • /b/{bucket}/o/{object}
      PATCH
    • /b/{bucket}/o/{object}
      PUT
    • /b/{destinationBucket}/o/{destinationObject}/compose
      POST
    • /b/{sourceBucket}/o/{sourceObject}/copyTo/b/{destinationBucket}/o/{destinationObject}
      POST
  • objectAccessControls
    • /b/{bucket}/o/{object}/acl
    • /b/{bucket}/o/{object}/acl
    • /b/{bucket}/o/{object}/acl/{entity}
    • /b/{bucket}/o/{object}/acl/{entity}
    • /b/{bucket}/o/{object}/acl/{entity}
    • /b/{bucket}/o/{object}/acl/{entity}
  • channels
    • /channels/stop
  1. buckets

/b/{bucket}

PATCH
/b/{bucket}
Updates a bucket. This method supports patch semantics.

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢200Successful response
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://storage.googleapis.com/storage/v1beta2/b/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "acl": [
        {
            "bucket": "string",
            "domain": "string",
            "email": "string",
            "entity": "string",
            "entityId": "string",
            "etag": "string",
            "id": "string",
            "kind": "storage#bucketAccessControl",
            "role": "string",
            "selfLink": "string"
        }
    ],
    "cors": [
        {
            "maxAgeSeconds": 0,
            "method": [
                "string"
            ],
            "origin": [
                "string"
            ],
            "responseHeader": [
                "string"
            ]
        }
    ],
    "defaultObjectAcl": [
        {
            "bucket": "string",
            "domain": "string",
            "email": "string",
            "entity": "string",
            "entityId": "string",
            "etag": "string",
            "generation": "string",
            "id": "string",
            "kind": "storage#objectAccessControl",
            "object": "string",
            "role": "string",
            "selfLink": "string"
        }
    ],
    "etag": "string",
    "id": "string",
    "kind": "storage#bucket",
    "lifecycle": {
        "rule": [
            {
                "action": {
                    "type": "string"
                },
                "condition": {
                    "age": 0,
                    "createdBefore": "2019-08-24",
                    "isLive": true,
                    "numNewerVersions": 0
                }
            }
        ]
    },
    "location": "string",
    "logging": {
        "logBucket": "string",
        "logObjectPrefix": "string"
    },
    "metageneration": "string",
    "name": "string",
    "owner": {
        "entity": "string",
        "entityId": "string"
    },
    "selfLink": "string",
    "storageClass": "string",
    "timeCreated": "2019-08-24T14:15:22Z",
    "versioning": {
        "enabled": true
    },
    "website": {
        "mainPageSuffix": "string",
        "notFoundPage": "string"
    }
}'
Response Response Example
{
    "acl": [
        {
            "bucket": "string",
            "domain": "string",
            "email": "string",
            "entity": "string",
            "entityId": "string",
            "etag": "string",
            "id": "string",
            "kind": "storage#bucketAccessControl",
            "role": "string",
            "selfLink": "string"
        }
    ],
    "cors": [
        {
            "maxAgeSeconds": 0,
            "method": [
                "string"
            ],
            "origin": [
                "string"
            ],
            "responseHeader": [
                "string"
            ]
        }
    ],
    "defaultObjectAcl": [
        {
            "bucket": "string",
            "domain": "string",
            "email": "string",
            "entity": "string",
            "entityId": "string",
            "etag": "string",
            "generation": "string",
            "id": "string",
            "kind": "storage#objectAccessControl",
            "object": "string",
            "role": "string",
            "selfLink": "string"
        }
    ],
    "etag": "string",
    "id": "string",
    "kind": "storage#bucket",
    "lifecycle": {
        "rule": [
            {
                "action": {
                    "type": "string"
                },
                "condition": {
                    "age": 0,
                    "createdBefore": "2019-08-24",
                    "isLive": true,
                    "numNewerVersions": 0
                }
            }
        ]
    },
    "location": "string",
    "logging": {
        "logBucket": "string",
        "logObjectPrefix": "string"
    },
    "metageneration": "string",
    "name": "string",
    "owner": {
        "entity": "string",
        "entityId": "string"
    },
    "selfLink": "string",
    "storageClass": "string",
    "timeCreated": "2019-08-24T14:15:22Z",
    "versioning": {
        "enabled": true
    },
    "website": {
        "mainPageSuffix": "string",
        "notFoundPage": "string"
    }
}
Modified at 2023-08-15 08:12:16
Previous
/b/{bucket}
Next
/b/{bucket}
Built with