Skip to main content

PUT (/json/users/xuid()/scids//data/,json)

Carga un archivo. La carga de varios bloques no se admite para datos de tipo json. El dominio de estos URI es titlestorage.xboxlive.com.

Parámetros de URI

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 Forbidden. Si el encabezado no es válido o falta, el servicio devolverá una respuesta 401 Unauthorized.

Parámetros de cadena de consulta opcionales

| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | clientFileTime| DateTime| Fecha y hora del archivo en el cliente que cargó el archivo por última vez.| | displayName| string| Nombre del archivo que se debe mostrar al usuario.|

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 Autenticación y autorización de solicitudes de los servicios de XBOX LIVE para obtener más información 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.|

Cuerpo de la solicitud

El cuerpo de la solicitud contiene el contenido completo del archivo que se está cargando.

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. | Código| Frase de motivo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK | La solicitud se realizó correctamente.| | 201| Created | Se creó la entidad.| | 400| Bad Request | El servicio no pudo interpretar 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 | La versión del recurso no es compatible.| | 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; vuelva a intentar la solicitud después del valor de client-retry en segundos (por ejemplo, 5 segundos después).|

Cuerpo de la respuesta

Si la carga se realiza correctamente, se devuelve un 201 con una respuesta .

Consulte también

Elemento primario
/json/users/xuid()/scids//data/,json
Last modified on October 19, 2026