---
title: "Obtener objeto"
url: https://docs.catalyst.zoho.com/es/sdk/ios/v2/cloud-scale/stratus/get-object/
description: "Esta página lista el método del iOS SDK para obtener un objeto u objetos del bucket."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /es/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /es/sdk/java/v1/cloud-scale/stratus/get-objects/
  - name: "Node.js SDK"
    url: /es/sdk/nodejs/v2/cloud-scale/stratus/get-objects/
  - name: "Python SDK"
    url: /es/sdk/python/v1/cloud-scale/stratus/get-objects/
  - name: "Web SDK"
    url: /es/sdk/web/v4/cloud-scale/stratus/get-object/
  - name: "Android SDK"
    url: /es/sdk/android/v2/cloud-scale/stratus/get-object/
  - name: "Flutter SDK"
    url: /es/sdk/flutter/v1/cloud-scale/stratus/get-object/
  - name: "REST API"
    url: /es/api/code-reference/cloud-scale/stratus/get-all-objects/#GetAllObjects
---

# Obtener objeto

Este método del SDK se puede utilizar para obtener un objeto del bucket. La respuesta estará en formato **blob**. 

Cuando [Versioning](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) está habilitado para el bucket:

* Si no pasas el `versionId`, solo se devolverá el **objeto más reciente**.
* Para recuperar una versión específica, utiliza el parámetro de consulta `versionId` con una versión válida como valor.

**Parámetros utilizados**

<table class="content-table">
	<thead>
		<tr>
			<th class="w30p">Nombre del parámetro</th>
      <th class="w70p">Definición</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`objectKey`</td>
			<td>Un parámetro **obligatorio**. Contendrá el nombre del objeto.</td>
		</tr>
		<tr>
			<td>`versionId`</td>
			<td>Un parámetro **opcional**. Contendrá el ID de versión único de la versión requerida del objeto.</td>
		</tr>
	</tbody>
</table>

```bash
bucketInstance.getObject( objectKey : "{object_name}", versionId : "{version_id}" ) { result in
	switch result {
		case .success( let object ) :
			print( "File Name : \( object.fileName )" )
		case .error(let error) :
			print("Error : \( error )")
	}
}
```

Se devolverá el objeto requerido.

**Excepción posible**

* **404**: Objeto o Bucket no encontrado

### Obtener todos los objetos

Este método del SDK se puede utilizar para obtener todos los objetos presentes en el bucket utilizando la técnica de paginación.

**Parámetros utilizados**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Nombre del parámetro</th>
			<th class="w20p">Tipo de dato</th>
      <th class="w60p">Definición</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`prefix`</td>
			<td>**String**</td>
			<td>Un parámetro **opcional**. Obtendrá los objetos que coincidan con el valor del prefijo.</td>
		</tr>
		<tr>
			<td>`maxKeys`</td>
			<td>**Number**</td>
			<td>Un parámetro **opcional**. Contendrá el límite máximo de objetos que pueden listarse por paginación.</td>
		</tr>
		<tr>
			<td>`continuation_token`</td>
			<td>**String**</td>
			<td>Un parámetro **opcional**. Si la respuesta fue truncada, el valor de esta clave debe pasarse como `continuation_token` al mismo método para recuperar el siguiente conjunto de objetos.</td>
		</tr>
	</tbody>
</table>

```bash
var params = ZCatalystQuery.ObjectParams()
params.maxKeys = 10
params.continuationToken = "{continuation_token}"
parmas.prefix = "{prefix}"
bucketInstance.getObjects( withParams : params ) { result in
	switch result {
		case .success( let objects, let response ) :
			for object in objects {
				print("File Name : \( object.fileName  )")
			}
		case .error( let error ) :
			print("Error : \( error )")
	}
}
```

El objeto requerido se devolverá como un arreglo en formato Blob.

**Excepción posible**

* **404**: Objeto o Bucket no encontrado