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 para as definições de política e os outros produtos, ou o Manifesto de comportamento das operações legível por máquina.
| Operação | Política de repetição | Idempotência | Conclusão / recuperação |
|---|---|---|---|
GET /api/cloudstorage/infoqueryCloudStorageInfoLocal | 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/pagepageCloudStorageFilesLocal | 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/initbatchRequestCloudStoragePresignedUploadUrlsLocal | 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/completeconfirmCloudStorageUploadCompleteLocal | 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/batchbatchDeleteCloudStorageFilesLocal | 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/setsetCloudStorageFileTagsLocal | 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/addaddCloudStorageFileTagsLocal | 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/queryqueryCloudStorageFileTagsLocal | 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/allqueryAllCloudStorageFileTagsLocal | 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/createcreateCloudStorageFileTagLocal | 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/editeditCloudStorageFileTagLocal | 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/batchdeleteCloudStorageFileTagsLocal | 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. |
| Operação | Política de repetição | Idempotência | Conclusão / recuperação |
|---|---|---|---|
GET /cloudstorage/infoqueryCloudStorageInfo | 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/pagepageCloudStorageFiles | 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/initbatchRequestCloudStoragePresignedUploadUrls | 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/completeconfirmCloudStorageUploadComplete | 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/batchbatchDeleteCloudStorageFiles | 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/setsetCloudStorageFileTags | 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/addaddCloudStorageFileTags | 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/queryqueryCloudStorageFileTags | 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/allqueryAllCloudStorageFileTags | 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/createcreateCloudStorageFileTag | 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/editeditCloudStorageFileTag | 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/batchdeleteCloudStorageFileTags | 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. |