# Matriz de novas tentativas e conclusão do Cloud Storage

Política de repetição, idempotência e conclusão das 24 operações do Cloud Storage. 12 delas documentam códigos de erro de negócio específicos do endpoint.

> Em operações que alteram estado, um tempo limite HTTP é um resultado desconhecido, não uma prova de que a operação falhou. Consulte o estado atual antes de repetir.


Veja a [Matriz de novas tentativas de endpoints](/pt/api-reference/getting-started/endpoint-behavior) para as definições de política e os outros produtos, ou o [Manifesto de comportamento das operações](/assets/operation-behavior.c7be57979902d535863b8d6a0eef0e3fb4768f96d388fa815ab123af6ce6038f.ec0bf2e0.yaml) legível por máquina.

## Cloud Storage Local API

| Operação | Política de repetição | Idempotência | Conclusão / recuperação |
|  --- | --- | --- | --- |
| `GET /api/cloudstorage/info``queryCloudStorageInfoLocal` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39001`. |
| `POST /api/cloudstorage/file/page``pageCloudStorageFilesLocal` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /api/cloudstorage/upload/init``batchRequestCloudStoragePresignedUploadUrlsLocal` | Não repita automaticamente a menos que a documentação específica do endpoint diga que é seguro. | Nenhuma garantia pública de idempotência está documentada. | Envie cada objeto para sua URL pré-assinada e depois chame POST /cloudstorage/upload/complete. Erros de negócio documentados: `39001`, `39037`, `39044`, `39045`, `39047`, `39050`, `39051`. |
| `POST /api/cloudstorage/upload/complete``confirmCloudStorageUploadCompleteLocal` | Não repita automaticamente; consulte primeiro se o recurso, o upload ou a tarefa foi criado. | Nenhum contrato público de chave de idempotência está documentado. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39001`, `39011`, `39014`, `39041`, `39046`, `39047`. |
| `POST /api/cloudstorage/file/delete/batch``batchDeleteCloudStorageFilesLocal` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39011`. |
| `POST /api/cloudstorage/file/tag/set``setCloudStorageFileTagsLocal` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39011`, `39048`, `39049`. |
| `POST /api/cloudstorage/file/tag/add``addCloudStorageFileTagsLocal` | Não repita automaticamente; consulte primeiro se o recurso, o upload ou a tarefa foi criado. | Nenhum contrato público de chave de idempotência está documentado. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39011`, `39048`, `39049`. |
| `POST /api/cloudstorage/file/tag/query``queryCloudStorageFileTagsLocal` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `GET /api/cloudstorage/tag/all``queryAllCloudStorageFileTagsLocal` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /api/cloudstorage/tag/create``createCloudStorageFileTagLocal` | Não repita automaticamente; consulte primeiro se o recurso, o upload ou a tarefa foi criado. | Nenhum contrato público de chave de idempotência está documentado. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /api/cloudstorage/tag/edit``editCloudStorageFileTagLocal` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /api/cloudstorage/tag/delete/batch``deleteCloudStorageFileTagsLocal` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |


## Cloud Storage Open API

| Operação | Política de repetição | Idempotência | Conclusão / recuperação |
|  --- | --- | --- | --- |
| `GET /cloudstorage/info``queryCloudStorageInfo` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39001`. |
| `POST /cloudstorage/file/page``pageCloudStorageFiles` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /cloudstorage/upload/init``batchRequestCloudStoragePresignedUploadUrls` | Não repita automaticamente a menos que a documentação específica do endpoint diga que é seguro. | Nenhuma garantia pública de idempotência está documentada. | Envie cada objeto para sua URL pré-assinada e depois chame POST /cloudstorage/upload/complete. Erros de negócio documentados: `39001`, `39037`, `39044`, `39045`, `39047`, `39050`, `39051`. |
| `POST /cloudstorage/upload/complete``confirmCloudStorageUploadComplete` | Não repita automaticamente; consulte primeiro se o recurso, o upload ou a tarefa foi criado. | Nenhum contrato público de chave de idempotência está documentado. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39001`, `39011`, `39014`, `39041`, `39046`, `39047`. |
| `POST /cloudstorage/file/delete/batch``batchDeleteCloudStorageFiles` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39011`. |
| `POST /cloudstorage/file/tag/set``setCloudStorageFileTags` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39011`, `39048`, `39049`. |
| `POST /cloudstorage/file/tag/add``addCloudStorageFileTags` | Não repita automaticamente; consulte primeiro se o recurso, o upload ou a tarefa foi criado. | Nenhum contrato público de chave de idempotência está documentado. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Erros de negócio documentados: `39011`, `39048`, `39049`. |
| `POST /cloudstorage/file/tag/query``queryCloudStorageFileTags` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `GET /cloudstorage/tag/all``queryAllCloudStorageFileTags` | Seguro com recuo exponencial limitado e jitter. | Somente leitura; repetir a requisição não deve alterar o estado do recurso. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /cloudstorage/tag/create``createCloudStorageFileTag` | Não repita automaticamente; consulte primeiro se o recurso, o upload ou a tarefa foi criado. | Nenhum contrato público de chave de idempotência está documentado. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /cloudstorage/tag/edit``editCloudStorageFileTag` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |
| `POST /cloudstorage/tag/delete/batch``deleteCloudStorageFileTags` | Consulte o estado atual antes de repetir após um tempo limite ou falha de transporte. | O resultado pode já ter sido aplicado; a execução repetida não é idempotente por contrato. | A resposta é o único sinal de conclusão documentado; nenhum contrato assíncrono é especificado. Não há erros de negócio específicos do endpoint documentados; use o contrato de erros comuns. |