Esta página aborda os carregamentos multipartes da API XML no Cloud Storage. Este método de carregamento carrega ficheiros em partes e, em seguida, junta-os num único objeto através de um pedido final. Os carregamentos multipartes da API XML são compatíveis com os carregamentos multipartes do Amazon S3.
Vista geral
Um carregamento multipartes da API XML permite-lhe carregar dados em várias partes e, em seguida, juntá-los num objeto final. Este comportamento tem várias vantagens, especialmente para ficheiros grandes:
Pode carregar partes em simultâneo, o que reduz o tempo necessário para carregar os dados na sua totalidade.
Se uma das operações de carregamento falhar, só tem de voltar a carregar uma parte do objeto geral, em vez de reiniciar desde o início.
Uma vez que o tamanho total do ficheiro não é especificado antecipadamente, pode usar carregamentos multipartes da API XML para carregamentos de streaming ou para comprimir dados em tempo real durante o carregamento.
Um carregamento multipartes da API XML tem três passos obrigatórios:
Inicie o carregamento com um pedido
POST
, que inclui a especificação de quaisquer metadados que o objeto concluído deva ter. A resposta devolve umUploadId
que usa em todos os pedidos subsequentes associados ao carregamento.Carregue os dados através de um ou mais pedidos
PUT
.Conclua o carregamento através de um pedido
POST
. Este pedido substitui qualquer objeto existente no contentor com o mesmo nome.
Não existe limite para a duração em que um carregamento multipartes e as respetivas partes carregadas podem permanecer inacabados ou inativos num contentor.
Considerações
Aplicam-se as seguintes limitações à utilização de carregamentos multipartes da API XML:
- Existem limites para o tamanho mínimo de uma parte, o tamanho máximo de uma parte e o número de partes usadas para montar o carregamento concluído.
- As condições prévias não são suportadas nos pedidos.
- Os hashes MD5 não existem para objetos carregados através deste método.
- Este método de carregamento não é suportado na Cloud de Confiance consola nem na CLI do Google Cloud.
Tenha em atenção o seguinte quando trabalhar com carregamentos multipartes da API XML:
Os carregamentos multipartes da API XML têm autorizações de IAM específicas. Se usar funções de IAM personalizadas, deve garantir que essas funções têm as autorizações de que precisa.
Embora possa iniciar um carregamento e carregar partes, o pedido para concluir o carregamento falha se substituir um objeto que tenha uma retenção ou um período de retenção não cumprido.
Pode listar os carregamentos em curso num contentor, mas apenas um carregamento concluído aparece na lista normal de objetos no contentor.
Como as bibliotecas cliente usam carregamentos multipartes da API XML
Esta secção fornece informações sobre a realização de carregamentos multipartes da API XML com bibliotecas cliente que a suportam.
Bibliotecas cliente
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
A biblioteca cliente Java não suporta carregamentos multipartes da API XML. Em alternativa, use carregamentos compostos paralelos.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Pode realizar carregamentos multipartes da API XML através do método
uploadFileInChunks
. Por exemplo:
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Pode realizar carregamentos multipartes da API XML através do método
upload_chunks_concurrently
. Por exemplo:
O que se segue?
- Explore métodos de carregamento adicionais para o Cloud Storage.
- Saiba mais sobre a retirada exponencial truncada e quando tentar novamente os pedidos.