> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/global/scids/{scid}/data/{pathAndFileName},{type})

> GET (/global/scids/{scid}/data/{pathAndFileName},{type})

# GET (/global/scids/{scid}/data/{pathAndFileName},{type})

Descarga un archivo.
El dominio de estos URI es `titlestorage.xboxlive.com`.

* [Parámetros de URI](#ID4EX)
* [Autorización](#ID4ECB)
* [Parámetros de cadena de consulta opcionales](#ID4EPB)
* [Encabezados de solicitud obligatorios](#ID4EZC)
* [Encabezados de solicitud opcionales](#ID4ECE)
* [Cuerpo de la solicitud](#ID4EMF)
* [Códigos de estado HTTP](#ID4EZF)
* [Encabezados de respuesta](#ID4EMDAC)
* [Cuerpo de la respuesta](#ID4EPEAC)

## Parámetros de URI

| Parámetro | Tipo | Descripción |
| - | - | - |
| scid | guid | Id. de la configuración de servicio que se va a buscar. |
| pathAndFileName | string | Ruta de acceso y nombre de archivo del elemento al que se va a acceder. Los caracteres válidos para la parte de la ruta de acceso (hasta la última barra diagonal, incluida) incluyen letras mayúsculas (A-Z), letras minúsculas (a-z), números (0-9), guion bajo (*) y barra diagonal (/). La parte de la ruta de acceso puede estar vacía. Los caracteres válidos para la parte del nombre de archivo (todo lo que sigue a la última barra diagonal) incluyen letras mayúsculas (A-Z), letras minúsculas (a-z), números (0-9), guion bajo (*), punto (.) y guion (-). El nombre de archivo no puede estar vacío, terminar en un punto ni contener dos puntos consecutivos. |
| type | string | Formato de los datos. Los valores posibles son: binary, config o json. |

## Autorización

La solicitud debe incluir un encabezado de autorización de XBOX LIVE válido. Si el autor de la llamada no tiene permiso para acceder a este recurso, el servicio devolverá una respuesta 403 Prohibido. Si el encabezado no es válido o falta, el servicio devolverá una respuesta 401 No autorizado.

## Parámetros de cadena de consulta opcionales

Varía según el tipo de blob. Los blobs binarios no admiten parámetros de consulta.

\| Parámetro| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- |
\| select| string| Solo se puede usar cuando el tipo es json. Especifica que la respuesta solo debe contener una determinada propiedad o valor del JSON, según lo determinado por este parámetro. Use un punto (.) para especificar subpropiedades y corchetes ('\[' y ']') para especificar índices de matriz. Por ejemplo, "array1\[4].prop2" especifica la propiedad "prop2" del índice 4 de la matriz "array1".|
\| customSelector| string| Para archivos de tipo config. Indica qué nodos virtuales personalizados se van a incluir. Consulte Title Storage para obtener más información sobre los archivos de tipo config.|

## Encabezados de solicitud obligatorios

\| Encabezado| Valor| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 1| Versión del contrato de la API.|
\| Authorization| XBL3.0 x=\[hash];\[token]| Token de autenticación de STS. STSTokenString se reemplaza por el token devuelto por la solicitud de autenticación. Consulte Authenticating and Authorizing XBOX LIVE Services Requests para obtener información adicional sobre cómo recuperar un token de STS y crear un encabezado de autorización.|

## Encabezados de solicitud opcionales

\| Encabezado| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| If-Match| Especifica una ETag que debe coincidir con un elemento existente para completar la operación.|
\| If-None-Match| Especifica una ETag que no debe coincidir con ningún elemento existente para completar la operación.|
\| Range| Especifica el intervalo de bytes que se va a descargar. Sigue el formato estándar del encabezado Range de HTTP.|

## Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta solicitud.

## Códigos de estado HTTP

El servicio devuelve uno de los códigos de estado de esta sección en respuesta a una solicitud realizada con este método en este recurso. Para obtener una lista completa de los códigos de estado HTTP estándar que se usan con los servicios de XBOX Live, consulte [Códigos de estado HTTP estándar](https://devdocs.xbox.com/es/reference/live/rest/additional/httpstatuscodes).

\| Código| Frase de motivo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK | La solicitud se completó correctamente.|
\| 201| Created | Se creó la entidad.|
\| 400| Bad Request | El servicio no pudo entender una solicitud con formato incorrecto. Normalmente, un parámetro no válido.|
\| 401| Unauthorized | La solicitud requiere autenticación del usuario.|
\| 403| Forbidden | La solicitud no está permitida para el usuario o el servicio.|
\| 404| Not Found | No se encontró el recurso especificado.|
\| 406| Not Acceptable | No se admite la versión del recurso.|
\| 408| Request Timeout | La solicitud tardó demasiado en completarse.|
\| 500| Internal Server Error | El servidor encontró una condición inesperada que le impidió completar la solicitud.|
\| 503| Service Unavailable | La solicitud se ha limitado; reintente la solicitud después del valor de client-retry en segundos (por ejemplo, 5 segundos después).|

## Encabezados de respuesta

\| Encabezado| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| ETag| Una ETag es un identificador opaco que un servidor web asigna a una versión específica de un recurso que se encuentra en una dirección URL. Si el contenido del recurso en esa dirección URL cambia en algún momento, se asigna una ETag nueva y diferente.|
\| Content-Range| Si se trató de una descarga parcial, este encabezado especifica el intervalo de bytes descargados.|

## Cuerpo de la respuesta

Si la llamada se realiza correctamente, el servicio devolverá el contenido del archivo.

## Consulte también

##### Elemento primario

[/global/scids/{scid}/data/{pathAndFileName},{type}](https://devdocs.xbox.com/es/reference/live/rest/uri/storage/uri-globalscidssciddatapathandfilenametype)

##### Referencia  [TitleBlob (JSON)](https://devdocs.xbox.com/es/reference/live/rest/json/json-titleblob)


## Related topics

- [XblTitleStorageDownloadBlobAsync](https://devdocs.xbox.com/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [XblTitleStorageGetBlobMetadataAsync](https://devdocs.xbox.com/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync.md)
