> ## 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. # PUT (/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type}) > PUT (/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type}) # PUT (/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type}) Carrega um arquivo. Os dados podem ser carregados em um carregamento completo, no qual os dados e os metadados são enviados em uma única mensagem, ou como um carregamento de vários blocos, no qual os dados e os metadados são enviados em uma série de blocos menores. Somente arquivos menores que quatro megabytes podem ser enviados como uma única mensagem. Não há suporte para carregamento de vários blocos para dados do tipo json. O domínio desses URIs é `titlestorage.xboxlive.com`. * [Parâmetros de URI](#ID4EX) * [Autorização](#ID4EEB) * [Parâmetros opcionais da cadeia de caracteres de consulta](#ID4ERB) * [Cabeçalhos de solicitação obrigatórios](#ID4ENE) * [Cabeçalhos de solicitação opcionais](#ID4EWF) * [Corpo da solicitação](#ID4EZG) * [Códigos de status HTTP](#ID4EEH) * [Corpo da resposta](#ID4EXEAC) ## Parâmetros de URI | Parâmetro | Tipo | Descrição | | - | - | - | | sessionId | string | o ID da sessão a ser consultada. | | scid | guid | o ID da configuração de serviço a ser consultada. | | pathAndFileName | string | Caminho e nome de arquivo do item a ser acessado. Os caracteres válidos para a parte do caminho (até a barra final, inclusive) incluem letras maiúsculas (A-Z), letras minúsculas (a-z), números (0-9), sublinhado (*) e barra (/). A parte do caminho pode estar vazia. Os caracteres válidos para a parte do nome do arquivo (tudo após a barra final) incluem letras maiúsculas (A-Z), letras minúsculas (a-z), números (0-9), sublinhado (*), ponto (.) e hífen (-). O nome do arquivo não pode estar vazio, terminar com ponto ou conter dois pontos consecutivos. | | type | string | O formato dos dados. Os valores possíveis são binary ou json. | ## Autorização A solicitação deve incluir um cabeçalho de autorização do XBOX LIVE válido. Se o chamador não tiver permissão para acessar este recurso, o serviço retornará uma resposta 403 Forbidden. Se o cabeçalho for inválido ou estiver ausente, o serviço retornará uma resposta 401 Unauthorized. ## Parâmetros opcionais da cadeia de caracteres de consulta Para carregamentos de mensagem única, os parâmetros da cadeia de caracteres de consulta são: \| Parâmetro| Tipo| Descrição| \| --- | --- | --- | --- | --- | --- | \| clientFileTime| DateTime| Data/hora do arquivo no cliente que carregou o arquivo pela última vez.| \| displayName| string| Nome do arquivo que deve ser mostrado ao usuário.| Para carregamentos de vários blocos, os parâmetros da cadeia de caracteres de consulta são: \| Parâmetro| Tipo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | \| clientFileTime| DateTime| Data/hora do arquivo no cliente que carregou o arquivo pela última vez.| \| displayName| string| Nome do arquivo que deve ser mostrado ao usuário.| \| continuationToken| string| O token de continuação da resposta da solicitação de carregamento anterior. Se este for o primeiro bloco, ele não deve ser especificado. | \| finalBlock| bool| Defina como true para o último bloco do arquivo. Defina como false para todos os outros blocos.| ## Cabeçalhos de solicitação obrigatórios \| Cabeçalho| Valor| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| x-xbl-contract-version| 1| Versão do contrato de API.| \| Authorization| XBL3.0 x=\[hash];\[token]| Token de autenticação STS. STSTokenString é substituído pelo token retornado pela solicitação de autenticação. Consulte Autenticação e autorização de solicitações dos XBOX LIVE Services para obter informações adicionais sobre como recuperar um token STS e criar um cabeçalho de autorização.| ## Cabeçalhos de solicitação opcionais \| Cabeçalho| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| If-Match| Especifica uma ETag que deve corresponder a um item existente para concluir a operação.| \| If-None-Match| Especifica uma ETag que não deve corresponder a nenhum item existente para concluir a operação.| ## Corpo da solicitação O corpo da solicitação contém o conteúdo do arquivo que está sendo carregado. Para carregamentos de mensagem única, o corpo é o conteúdo completo do arquivo. Para carregamentos de vários blocos, o corpo é a parte do arquivo especificada nos parâmetros da cadeia de caracteres de consulta. ## Códigos de status HTTP O serviço retorna um dos códigos de status desta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os XBOX Live Services, consulte [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes). \| Código| Frase de motivo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| 200| OK | A solicitação foi bem-sucedida.| \| 201| Created | A entidade foi criada.| \| 400| Bad Request | O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.| \| 401| Unauthorized | A solicitação requer autenticação do usuário.| \| 403| Forbidden | A solicitação não é permitida para o usuário ou serviço.| \| 404| Not Found | O recurso especificado não foi encontrado.| \| 406| Not Acceptable | Não há suporte para a versão do recurso.| \| 408| Request Timeout | A solicitação demorou muito para ser concluída.| \| 500| Internal Server Error | O servidor encontrou uma condição inesperada que o impediu de atender à solicitação.| \| 503| Service Unavailable | A solicitação foi limitada; tente novamente após o valor de client-retry em segundos (por exemplo, 5 segundos depois).| ## Corpo da resposta Se a chamada for uma solicitação de vários blocos e for bem-sucedida, o serviço retornará um token de continuação a ser passado com o próximo bloco. ### Exemplo de resposta ```cpp theme={null} { "continuationToken":"abcd1234-1111-2222-3333-abcd12345678-1" } ``` ## Confira também ##### Pai [/sessions/{sessionId}/scids/{scid}/data/{pathAndFileName},{type}](/pt-BR/reference/live/rest/uri/storage/uri-sessionssessionidscidssciddatapathandfilenametype) ## Related topics - [XblMultiplayerSessionReferenceUri](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md) - [XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata.md) - [XblMultiplayerSessionReference](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference.md) - [XblTitleStorageUploadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestorageuploadblobasync.md)