# Objetos -------------------------------------------------------------------------------- title: "Objetos y sus elementos asociados" description: "Stratus es una solución robusta de almacenamiento en la nube impulsada por Catalyst. Puedes almacenar datos de cualquier tipo de formato en forma de buckets y objetos." last_updated: "2026-07-02T09:34:15.860Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/introduction/" service: "Cloud Scale" related: - Create a Bucket (/es/cloud-scale/help/stratus/buckets/create-bucket/) - Upload an Object (/es/cloud-scale/help/stratus/objects/upload-object/) - Object Versioning (/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) - Java SDK (/es/sdk/java/v1/cloud-scale/stratus/overview/) - Node.js SDK (/es/sdk/nodejs/v2/cloud-scale/stratus/overview/) - Python SDK (/es/sdk/python/v1/cloud-scale/stratus/overview/) - Web SDK (/es/sdk/web/v4/cloud-scale/stratus/overview/) - iOS SDK (/es/sdk/ios/v2/cloud-scale/stratus/overview/) - Android SDK (/es/sdk/android/v2/cloud-scale/stratus/overview/) - Flutter SDK (/es/sdk/flutter/v2/cloud-scale/stratus/overview/) - REST API (/es/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets) -------------------------------------------------------------------------------- # Objects Los objetos son los datos que almacenas en los buckets. Los objetos pueden ser de cualquier tipo de formato, y cada uno de ellos se puede acceder usando una **URL de Object** generada por Stratus. <br /> <!--Once Caching is enabled, a **Caching URL** will be generated when objects are uploaded to the bucket. Objects that are accessed using this URL will be cached.--> ### URL de Object Esta es una URL única generada por Stratus para identificar de forma única y acceder de manera segura al objeto que cargas a un bucket. <br /> Si has habilitado el versionado para tu bucket, puedes acceder a cada versión del objeto usando parámetros de consulta en la **URL de Object** en formato clave-valor. versionId es la clave y el valor es el valor de cadena generado por Stratus cuando cargas una versión del objeto. La URL de Object tendrá los siguientes formatos: * En el entorno de desarrollo:<br /> **https://&lt;bucket-name&gt;-development.zohostratus.com/&lt;object-name&gt;** Por ejemplo: **https<span></span>://mappedsample-development.zohostratus.com/Archive.zip** * En el entorno de producción:<br /> **https://&lt;bucket-name&gt;.zohostratus.com/&lt;object-name&gt;** Por ejemplo: **https<span></span>://mappedsample.zohostratus.com/Archive.zip** * Con el **versionado** habilitado:<br /> **https://&lt;bucket-name&gt;-development.zohostratus.com/&lt;object-name&gt;?versionid={versionid}** Por ejemplo: **https<span></span>://mappedsample-development.zohostratus.com/Archive.zip?versionid=1233487326** Nota: Las estructuras de las URLs de Object están sujetas a cambios según los DC en los que se crean, de manera similar a las URLs de Bucket. ### Ruta La ruta es la ubicación de un objeto en el bucket. Cuando creas un bucket y cargas objetos en él, su ruta se crea en el formato estándar de directorio. <br /> Por ejemplo, imagina que creas un bucket llamado "**MyPictures**". Puedes crear subrutas en el bucket y almacenar los objetos en ellas, o almacenar los objetos directamente. En este ejemplo, hay una subruta con el nombre "**puppies**", y esta ruta tiene un objeto llamado "**border_collie.jpeg**". El objeto se almacena en la siguiente ruta:<br /> **MyPictures/puppies/border_collie.jpeg** Nota: * Una ruta nunca puede estar vacía. Contendrá más rutas para almacenar objetos, u objetos en sí. * Los siguientes caracteres, incluido el espacio, no son compatibles cuando creas una ruta o un objeto: comillas dobles, ambos corchetes angulares, almohadilla, barra invertida y símbolo de pipe. * El nombre de la ruta y el nombre del objeto no deben comenzar con un carácter de espacio o un carácter especial. ### Metadatos <br /> * Puedes proporcionar información personalizada sobre el objeto en formato de par clave-valor usando la opción de metadatos. * Puedes usar caracteres alfanuméricos, guiones bajos o caracteres de espacio en blanco, así como guiones, para escribir tus metadatos. No se permite ningún otro carácter especial aparte de los mencionados. * Puedes obtener los metadatos de un objeto usando el método de solicitud **HEAD**. En la respuesta, los metadatos se listarán en la clave 'x-user-meta'. * El límite máximo de tamaño de caracteres permitidos para los metadatos en general es de **2047** caracteres. El conteo de caracteres usado para determinar el límite de tamaño también incluye el carácter especial dos puntos ":" usado para definir el par clave-valor. -------------------------------------------------------------------------------- title: "Cargar un objeto a un bucket" description: "Stratus es una solución robusta de almacenamiento en la nube impulsada por Catalyst. Puedes almacenar datos de cualquier tipo de formato en forma de buckets y objetos." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/upload-object/" service: "Cloud Scale" related: - Create a Bucket (/es/cloud-scale/help/stratus/buckets/create-bucket/) - Object Versioning (/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) - Java SDK (/es/sdk/java/v1/cloud-scale/stratus/upload-object/) - Node.js SDK (/es/sdk/nodejs/v2/cloud-scale/stratus/upload-object/) - Python SDK (/es/sdk/python/v1/cloud-scale/stratus/upload-object/) - Web SDK (/es/sdk/web/v4/cloud-scale/stratus/upload-object/) - iOS SDK (/es/sdk/ios/v2/cloud-scale/stratus/upload-object/) - Android SDK (/es/sdk/android/v2/cloud-scale/stratus/upload-object/) - Flutter SDK (/es/sdk/flutter/v1/cloud-scale/stratus/upload-object/) - REST API (/es/api/code-reference/cloud-scale/stratus/upload-object/#UploadObject) -------------------------------------------------------------------------------- # Cargar un objeto a un bucket Un objeto puede ser datos en cualquier formato. Puedes cargarlo directamente desde tu sistema local usando una estructura de directorios personalizable según tus necesidades. Nota: Cuando cargas un objeto, asegúrate de que su nombre sea único en su ruta actual. Para cargar un objeto o un grupo de objetos: 1. Haz clic en el botón **Upload** y elige **Upload Folder** si deseas cargar una carpeta completa con todos sus objetos, o **Upload File** si deseas cargar un grupo selecto de objetos o solo uno. <br /> 2. Si eliges cargar: Selecciona la carpeta requerida de tu sistema local y haz clic en **Upload**. <br /> La carpeta se cargará con todo su contenido. <br /> Haz clic en el directorio cargado para confirmar que contiene todos los objetos que contenía en el sistema local. <br /> Selecciona el archivo o archivos de tu sistema local para cargar, y haz clic en **Open**. <br /> Los archivos se cargarán. <br /> ### Cargar objeto usando ruta También puedes cargar objetos al bucket usando la opción **Create Path**. <br /> Nota: La opción de ruta se usa mejor cuando deseas almacenar uno o más objetos en una ruta particular del bucket. Puedes obtener más información sobre la ruta en esta documentación de ayuda. 1. Haz clic en el botón **Create Path**. <br /> 2. Proporciona la ruta requerida usando el carácter especial de barra diagonal '**/**' como separador de directorios. <br /> 3. Haz clic en el **ícono de carga** y selecciona el objeto requerido en tu sistema local y haz clic en **Open** para cargar. <br /> La ruta ingresada se creará y se podrá navegar de la misma manera que un directorio convencional. <br /> El siguiente método de SDK te permite cargar un objeto al bucket: Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. **Asegúrate de que se importen los siguientes paquetes:** import com.zc.component.stratus.beans.ZCPutObjectOptions; import java.nio.file.Path; import java.nio.file.Files; import java.nio.file.StandardCopyOption; import java.io.*; InputStream file =new FileInputStream("filePath"); Boolean res = bucket.putObject("objectName", file); System.out.println(res); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. // crea un read stream para cargar el objeto const file = fs.createReadStream("file_path"); // llama al método de carga const res = await bucket.putObject("object_name", file); console.log(res); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. file = open('file_path','rb') res = bucket.put_object('object_name',file) print(res) Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. const putObject = stratus.putObject("{object_name}","{File}", "{options}", "{processCallback}"); const putObjectStart = putObject.start(); // para iniciar la solicitud const putObjectAbort = putObject.abort(); // para cancelar la solicitud Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. bucketInstance.upload( filePath : "{file_path}", fileName : "{file_name}", shouldCompress : true ) { error in if let error = error { print("Error : \( error )") return } print("Uploaded Successfully") } Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. bucketIntance.uploadObject("/Desktop", "Helplinecard.jpeg", true, { println(" >> Object Upload Success -$it") }, { println(" >> Object Upload Failed -$it") }, progress = { bytesWritten, contentLength, percentage -> println("Percentage: $percentage") } ) Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. try{ XFile? imageFile = await pickImage(ImageSource.gallery); var bucket = stratus.bucket("testing"); var response = await bucket.uploadObject(imageFile!.path); print("Upload Status: ${response.statusCode}"); } on ZCatalystException catch (ex) { print(ex.toString()); } Nota: Stratus escanea constantemente en busca de malware en segundo plano. Cuando los escaneos encuentran malware, el usuario, administrador, superadministrador y propietario del proyecto serán notificados sobre el malware, y el objeto cargado se elimina inmediata y permanentemente del bucket. ## Gestionar objetos almacenados -------------------------------------------------------------------------------- title: "Gestionar un objeto almacenado" description: "Stratus es una solución robusta de almacenamiento en la nube impulsada por Catalyst. Puedes almacenar datos de cualquier tipo de formato en forma de buckets y objetos." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/manage-object/manage-stored-object/" service: "Cloud Scale" related: - Create a Bucket (/es/cloud-scale/help/stratus/buckets/create-bucket/) - Upload an Object (/es/cloud-scale/help/stratus/objects/upload-object/) - Object Versioning (/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) - Java SDK (/es/sdk/java/v1/cloud-scale/stratus/overview/) - Node.js SDK (/es/sdk/nodejs/v2/cloud-scale/stratus/overview/) - Python SDK (/es/sdk/python/v1/cloud-scale/stratus/overview/) - Web SDK (/es/sdk/web/v4/cloud-scale/stratus/overview/) - iOS SDK (/es/sdk/ios/v2/cloud-scale/stratus/overview/) - Android SDK (/es/sdk/android/v2/cloud-scale/stratus/overview/) - Flutter SDK (/es/sdk/flutter/v2/cloud-scale/stratus/overview/) - REST API (/es/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets) -------------------------------------------------------------------------------- # Gestionar un objeto almacenado Haz clic en cualquiera de los objetos almacenados en tu bucket. <br /> Podrás realizar las siguientes operaciones en el objeto: * Ver detalles generales, como el *nombre*, *tamaño*, *hora de modificación* y *formato* del objeto. * Puedes acceder al objeto directamente usando la URL de Object segura. Esta URL se puede copiar y usar en tu código para satisfacer tus necesidades. <!--* You can enable Caching for the bucket; a **Caching URL** will be generated by Stratus. This URL can also be copied. When you access objects using this URL, they will be cached. * You can click the **Purge Cache** button to purge the stored cache of the object.--> * Si has habilitado el versionado, puedes ver todas las versiones del objeto presentes en el bucket. * Proporcionar metadatos personalizados para el objeto. * Descargar el objeto * Eliminar el objeto ### Proporcionar metadatos personalizados para un objeto Para proporcionar metadatos para tu objeto: Nota: El límite máximo de tamaño de caracteres permitidos para los metadatos en general es de 2047 caracteres. El conteo de caracteres usado para determinar el límite de tamaño también incluye el carácter especial dos puntos ":" usado para definir el par clave-valor. 1. Haz clic en el objeto requerido. <br /> 2. Haz clic en el botón **Add Meta**. <br /> 3. Los metadatos que proporciones se renderizarán y aplicarán al objeto en **formato de par clave-valor JSON**. Haz clic en **Save** una vez que hayas completado la adición de los datos requeridos. <br /> Tus metadatos personalizados se agregarán al objeto. <br /> Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. **Asegúrate de que se importen los siguientes paquetes:** import org.json.simple.JSONObject; HashMap&lt;String, String&gt; objectMeta = new HashMap&lt;&gt;(); objectMeta.put("key1", "value1"); objectMeta.put("key2", "value2"); JSONObject res = object.putMeta(objectMeta); System.out.println(res); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. const objectMeta = { "key1": "value1" , "key2": "value2" }; const objMeta = await objectIns.putMeta(objectMeta); console.log(objMeta); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. res = object_ins.put_meta({'author': 'Amelia Burrows'}) print(res) ### Editar metadatos personalizados Para editar los metadatos personalizados: 1. Haz clic en **Modify Meta**. <br /> 2. Realiza los cambios necesarios y haz clic en **Save**. <br /> Los cambios se aplicarán. <br /> -------------------------------------------------------------------------------- title: "Descargar un objeto de un bucket" description: "Stratus es una solución robusta de almacenamiento en la nube impulsada por Catalyst. Puedes almacenar datos de cualquier tipo de formato en forma de buckets y objetos." last_updated: "2026-07-02T09:34:15.861Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/manage-object/download-object/" service: "Cloud Scale" related: - Create a Bucket (/es/cloud-scale/help/stratus/buckets/create-bucket/) - Upload an Object (/es/cloud-scale/help/stratus/objects/upload-object/) - Object Caching (/es/cloud-scale/help/stratus/stratus-config/general-settings/#caching) - Object Versioning (/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) - Java SDK (/es/sdk/java/v1/cloud-scale/stratus/download-object/) - Node.js SDK (/es/sdk/nodejs/v2/cloud-scale/stratus/download-object/) - Python SDK (/es/sdk/python/v1/cloud-scale/stratus/download-object/) - Web SDK (/es/sdk/web/v4/cloud-scale/stratus/download-object/) - iOS SDK (/es/sdk/ios/v2/cloud-scale/stratus/download-object/) - Android SDK (/es/sdk/android/v2/cloud-scale/stratus/download-object/) - Flutter SDK (/es/sdk/flutter/v2/cloud-scale/stratus/download-object/) - REST API (/es/api/code-reference/cloud-scale/stratus/download-object/#DownloadObject) -------------------------------------------------------------------------------- # Descargar un objeto de un bucket Para descargar un objeto del bucket: 1. Haz clic o selecciona el objeto requerido. <br /> 2. Haz clic en **Download**. <br /> 3. Haz clic en **Save** en el diálogo de tu sistema. <br /> El objeto se descargará a tu sistema local. También puedes descargar el objeto usando el botón **Download** presente en la vista de detalles del objeto. <br /> Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. **Asegúrate de que se importen los siguientes paquetes** import com.zc.component.stratus.beans.ZCGetObjectOptions; import java.nio.file.Path; import java.nio.file.Files; import java.nio.file.StandardCopyOption; import java.io.*; InputStream dataStream = bucket.getObject("objectName"); // descarga el objeto a tu máquina local Path path = Path.of("file_path"); // especifica una ruta para almacenar el objeto descargado Files.copy(dataStream, path, StandardCopyOption.REPLACE_EXISTING); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. const res = await bucket.getObject("objectName"); // descarga el objeto a la máquina local const files = fs.createWriteStream('filePath'); res.on('data', (data) => { files.write(data) }); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. res = bucket.get_object('object_name') # descarga el objeto a la máquina local file = open('file_path','wb') file.write(res) Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. objectInstance.download(fromCache : true) { result in switch result { case.success(let url): do { let data = Data(contentsOf : url) DispatchQueue.main.sync { self.imageView.image = UIImage(date : data) } } catch { print("Error : \( error )") } case.error(let error): print("Error : \( error )") } } Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. bucketInstance.getObject("SunSet.jpeg", "2823000000044005", //Reemplaza esto con tu Folder ID y File ID { object->object.download({println("File download success ${it.available()}")}, {println("File download failed $it")}) Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. try { ZCatalystBucket bucket = stratus.bucket("testing"); var(response, object) = await bucket.getObject("SunSet.jpeg"); final downloadsDir = await getExternalStorageDirectory(); final filePath = downloadsDir !.absolute.path; var fileResponse = await object.download( pathToDownload : filePath, onProgress : (bytesWritten, contentLength, percentage) { print("Downloaded Percentage: $percentage"); }, ); print("Download Status: ${fileResponse.statusCode}"); OpenFile.open(filePath + '/SunSet.jpeg'); } on ZCatalystException catch (ex) { print(ex.toString()); } -------------------------------------------------------------------------------- title: "Eliminar un objeto de un bucket" description: "Stratus es una solución robusta de almacenamiento en la nube impulsada por Catalyst. Puedes almacenar datos de cualquier tipo de formato en forma de buckets y objetos." last_updated: "2026-07-02T09:34:15.862Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/objects/manage-object/delete-object/" service: "Cloud Scale" related: - Create a Bucket (/es/cloud-scale/help/stratus/buckets/create-bucket/) - Upload an Object (/es/cloud-scale/help/stratus/objects/upload-object/) - Object Caching (/es/cloud-scale/help/stratus/stratus-config/general-settings/#caching) - Object Versioning (/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) - Java SDK (/es/sdk/java/v1/cloud-scale/stratus/delete-objects/) - Node.js SDK (/es/sdk/nodejs/v2/cloud-scale/stratus/delete-objects/) - Python SDK (/es/sdk/python/v1/cloud-scale/stratus/delete-objects/) - Web SDK (/es/sdk/web/v4/cloud-scale/stratus/delete-object/) - iOS SDK (/es/sdk/ios/v2/cloud-scale/stratus/delete-object/) - Android SDK (/es/sdk/android/v2/cloud-scale/stratus/delete-object/) - Flutter SDK (/es/sdk/flutter/v2/cloud-scale/stratus/delete-object/) - REST API (/es/api/code-reference/cloud-scale/stratus/delete-objects/#DeleteObject) -------------------------------------------------------------------------------- # Eliminar un objeto de un bucket Para eliminar un objeto del bucket: 1. Selecciona el objeto requerido. <br /> 2. Haz clic en **Delete**. <br /> 3. Haz clic en **Delete** en el diálogo de confirmación también. <br /> La acción de eliminación se programará, y tomará un breve momento antes de que la operación se refleje en la consola. Las operaciones de eliminación se pueden realizar en múltiples objetos y en múltiples rutas de la misma manera. También puedes usar el botón **Delete** presente en la vista de detalles del objeto para eliminarlo. <br /> Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. **Asegúrate de que se importen los siguientes paquetes:** import org.json.simple.JSONObject; int ttl = 200; JSONObject deleteRes = bucket.deleteObject("objectName", "versionId", ttl); System.out.println(deleteRes); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. const res = await bucket.deleteObject("objectName"); console.log(res); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. delete_res = bucket.delete_object('object_name') print(delete_res) Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. // Eliminar un objeto const deleteObject = await bucket.deleteObject("objectName"); Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. objectInstance.delete() { error in if let error = error { print("Error : \\( error )") return } print("Deleted Successfully") } Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. bucketInstance.getObject("SunSet.jpeg", "2823000000044005", //Reemplaza esto con tu Object Name y Object ID { object -> object.delete( { println("Object Deletion Success.") }, { println("Failed to delete the object. $it") } ) Nota: Visita este documento de ayuda para obtener más información sobre este método de SDK. try { ZCatalystBucket bucket = stratus.bucket("testing"); var (response, objects, _) = await bucket.getObjects(maxKeys: 5, prefix: 'trip'); var response = await bucket.deleteObjects(objects); print("Delete Objects: ${response.statusCode}"); } on ZCatalystException catch (ex) { print(ex.toString()); } Nota: Cuando realizas una operación de eliminación en un objeto, y si es el único objeto presente en la ruta particular, entonces la ruta completa se eliminará. Una ruta vacía no puede existir en un bucket.