Descargar objeto

# Descargar objeto

Este método del SDK te permitirá descargar el objeto. La operación devolverá un input stream.

**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>{{%badge%}}pathToDownload{{%/badge%}}</td>
      <td>{{%bold%}}String{{%/bold%}}</td>
      <td>Un parámetro {{%bold%}}obligatorio{{%/bold%}}. Contendrá la {{%link href="/es/cloud-scale/help/stratus/objects/introduction/#path" %}}ruta{{%/link%}} donde el objeto necesita ser descargado.</td>
    </tr>
    <tr>
      <td>{{%badge%}}newObjectName{{%/badge%}}</td>
      <td>{{%bold%}}String{{%/bold%}}</td>
      <td>Un parámetro {{%bold%}}opcional{{%/bold%}}. Contendrá el nombre del objeto que proporcionas al descargarlo. Si no proporcionas este valor, el objeto se descargará con su nombre original.</td>
    </tr>
		<tr>
			<td>{{%badge%}}versionId{{%/badge%}}</td>
      <td>{{%bold%}}String{{%/bold%}}</td>
			<td>Un parámetro {{%bold%}}opcional{{%/bold%}}. Si {{%link href="/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning" %}}Versioning{{%/link%}} está habilitado para el bucket, contendrá el ID de versión único de la versión del objeto requerido.</td>
		</tr>
    <tr>
			<td>{{%badge%}}fromCache{{%/badge%}}</td>
      <td>{{%bold%}}Boolean{{%/bold%}}</td>
			<td>
        <ul>
          <li>Un parámetro {{%bold%}}opcional{{%/bold%}}. Se usa para especificar si este archivo debe recuperarse de la caché o no.</li>
          <li>{{%bold%}}Valor predeterminado{{%/bold%}}: false.</li>
        </ul>
      </td>
		</tr>
    <tr>
			<td>{{%badge%}}progress{{%/badge%}}</td>
      <td>{{%bold%}}Function(int, int, Double)?{{%/bold%}}</td>
			<td>Una función de callback que puede proporcionar información del progreso sobre la descarga del objeto</td>
		</tr>
	</tbody>
</table>

{{%code class="language-javascript"%}}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());
}{{%/code%}}

Este método del SDK te permitirá descargar el objeto. La operación devolverá un input stream.

Parámetros utilizados

Nombre del parámetro	Tipo de dato	Definición
pathToDownload	String	Un parámetro obligatorio. Contendrá la ruta donde el objeto necesita ser descargado.
newObjectName	String	Un parámetro opcional. Contendrá el nombre del objeto que proporcionas al descargarlo. Si no proporcionas este valor, el objeto se descargará con su nombre original.
versionId	String	Un parámetro opcional. Si Versioning está habilitado para el bucket, contendrá el ID de versión único de la versión del objeto requerido.
fromCache	Boolean	Un parámetro opcional. Se usa para especificar si este archivo debe recuperarse de la caché o no. Valor predeterminado: false.
progress	Function(int, int, Double)?	Una función de callback que puede proporcionar información del progreso sobre la descarga del objeto

copy

         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());
}
    

Última actualización 2026-03-20 21:51:56 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Stratus Component Help Documentation Download an Object Java SDK Node.js SDK Python SDK Web SDK iOS SDK Android SDK REST API