---
title: "Obtener un bucket específico"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/stratus/get-bucket/
description: "Esta API te permite recuperar los detalles de un bucket específico en Stratus junto con los detalles de todos los objetos en él"
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Obtener bucket

### Descripción

Esta API te permite obtener todos los detalles disponibles de un bucket presente en Stratus. El bucket se referencia por su [nombre único de bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket).

### Detalles de la solicitud

#### URL de solicitud

`GET` {api-domain}/baas/v1/project/{project_id}/bucket/{bucket_name}

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

- **bucket_name** (Alphanumerical): El [nombre del bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Alcance

ZohoCatalyst.buckets.READ

### Detalles de la respuesta

La respuesta devolverá los metadatos y detalles del bucket particular incluyendo su `bucket_name`, y los detalles del usuario que creó y modificó por última vez el bucket.

**Sample Request**

```bash

curl -X GET https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket?bucket_name=mybucketname/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**Sample Response**

```json

    {
    "status": "success",
    "data": [
        {
        "bucket_name": "fsbucket17",
        "bucket_url": "https://fsbucket17-development.stratus.com",
        "objects_count": 21,
        "size_in_bytes": 145578,
        "project_details": {
            "project_name": "Project-Rainfall-4",
            "id": 2000000000075,
            "project_type": "Live"
        },
        "created_by": {
            "zuid": 18599686,
            "is_confirmed": false,
            "email_id": "emmy@zylker.com",
            "first_name": "Amelia B",
            "last_name": "Fstest",
            "user_type": "Admin",
            "user_id": 2000000000055
        },
        "created_time": "Sep 27, 2023 05:01 PM",
        "modified_by": {
            "zuid": 18599686,
            "is_confirmed": false,
            "email_id": "emmy@zylker.com",
            "first_name": "Amelia B",
            "last_name": "Fstest",
            "user_type": "Admin",
            "user_id": 2000000000055
        },
        "modified_time": "Sep 27, 2023 05:01 PM",
        "bucket_meta": {
            "versioning": true,
            "caching": {
            "status": "Enabled"
            },
            "encryption": true,
            "audit_consent": false
        }
        }
    ]
    }

```

### SDK Documentation

* [Get a Particular Bucket - Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/list-buckets/#get-a-particular-bucket)
* [Get a Particular Bucket - Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/list-buckets/#get-a-particular-bucket)
* [Get a Particular Bucket - Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/list-buckets/#get-a-particular-bucket)
* [Stratus - Web SDK](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/stratus/overview/)
* [Stratus - iOS SDK](https://docs.catalyst.zoho.com/es/sdk/ios/v2/cloud-scale/stratus/overview/)
* [Stratus - Android SDK](https://docs.catalyst.zoho.com/es/sdk/android/v2/cloud-scale/stratus/overview/)
* [Stratus - Flutter SDK](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/stratus/overview/)