Carregamento de multiparte

Inicialização de uma tarefa de carregamento de multiparte

Quando você envia uma solicitação para iniciar o carregamento de multiparte, o OBS retorna uma resposta com o ID de carregamento, que é o identificador exclusivo do carregamento de multiparte. Esse ID deve ser incluído na solicitação para fazer carregamento de partes, listar partes carregadas, concluir um carregamento de multiparte ou cancelar um carregamento de multiparte.

Carregamento de uma parte

Ao carregar partes, você deve especificar o ID de carregamento e os números de parte. Você pode selecionar qualquer número de parte entre 1 e 10.000. Um número de parte identifica exclusivamente uma parte e sua localização no objeto que você está carregando. Se o número de uma parte carregada for usado para carregar uma nova parte, a parte carregada será sobrescrita. Sempre que você carrega uma parte, o OBS retorna o cabeçalho ETag na resposta. Para cada tarefa de carregamento de parte, é necessário registrar os números de parte e os valores de ETag. Esses números de parte e valores de ETag são necessários nas operações subseqüentes de conclusão da tarefa de carregamento de multiparte.

Depois que a tarefa de carregamento de multiparte é inicializada e uma ou mais partes são carregadas, você deve mesclar as partes ou cancelar a tarefa de carregamento de multiparte. Caso contrário, você tem que pagar pela taxa de armazenamento das partes carregadas. O OBS libera o armazenamento e pára de cobrar a taxa de armazenamento somente depois que as partes carregadas são mescladas ou a tarefa de carregamento de multiparte é cancelada.

Quando várias operações de carregamento simultâneas são executadas para a mesma parte de um objeto, o servidor está em conformidade com a política Last Write Win, mas a hora referida em Last Write é a hora em que os metadados da parte são criados. Para garantir a precisão dos dados, o cliente deve ser bloqueado durante o carregamento simultâneo para a mesma parte de um objeto. O carregamento simultâneo de diferentes partes de um objeto não requer que o cliente seja bloqueado.

Cópia de uma parte

Depois de criar um trabalho de carregamento de multiparte, você pode especificar os ID de carregamento e partes de carregamento para a tarefa de carregamento especificada. Você também pode chamar a API para cópia de partes para adicionar partes. Uma parte de um objeto ou todo o objeto pode ser copiado como uma parte.

Não é possível determinar se uma solicitação foi executada com sucesso usando apenas status_code no cabeçalho retornado pelo HTTP. Se 200 em status_code for retornado, o servidor recebeu a solicitação e começa a processar a solicitação. O corpo na resposta mostra se a solicitação foi executada com sucesso. A solicitação é executada com sucesso somente quando o corpo contém Etag. Caso contrário, o pedido não será executado.

Se você copiar o objeto de origem como uma parte chamada part1 e outra parte1 já existir antes da operação de cópia, a parte1 original será substituída pela nova após a operação de cópia. Depois que a cópia for bem-sucedida, somente a nova parte1 será exibida. Os dados da antiga parte 1 serão apagados. Portanto, assegure-se de que a parte de destino não exista ou não tenha valor ao copiar uma parte. Caso contrário, os dados podem ser apagados por engano. O objeto de origem não muda durante a cópia.

Mescla de componentes e cancelamento de uma tarefa de carregamento de multiparte

Ao mesclar partes, o OBS cria um objeto ao padronizar múltiplas partes em ordem crescente. Se algum metadado de objeto for fornecido na inicialização de uma tarefa de carregamento de parte, o OBS associará os metadados ao objeto. Depois que o carregamento de multiparte for concluído, as partes não existirão mais. Uma solicitação de mescla de partes deve conter o ID de carregamento, números de parte e uma lista de valores ETag correspondentes. As respostas do OBS incluem o ETag que identifica exclusivamente os dados do objeto composto. O ETag não é o valor de hash MD5 dos dados do objeto. Você pode cancelar uma tarefa de carregamento de multiparte. Depois que uma tarefa de carregamento de multiparte é cancelada, o ID de carregamento não pode ser usado para carregar qualquer parte. Em seguida, o OBS libera o armazenamento de todas as partes carregadas. Se você parar um carregamento de multiparte em andamento, o carregamento ainda será concluído (o resultado pode ser bem-sucedido ou fracassado). Para liberar a capacidade de armazenamento ocupada por todos os componentes carregados, cancele o carregamento de multiparte após a conclusão de toda a tarefa.

Se 10 partes forem carregadas, mas apenas nove forem selecionadas para mescla, as partes que não forem mescladas serão automaticamente excluídas pelo sistema. As partes que não são mescladas não podem ser restauradas após serem excluídas. Antes de mesclar as partes, adote a API usada para listar as partes que foram carregadas para verificar todas as partes para garantir que nenhuma parte seja perdida.

Listagem de partes carregadas

Você pode listar as partes de uma tarefa de carregamento de multiparte especificada ou as partes de todas as tarefas de carregamento de multiparte em andamento. As informações sobre as partes carregadas em um carregamento de multiparte específico serão retornadas para uma solicitação de lista de partes carregadas. Para cada solicitação para listar partes carregadas, o OBS retorna informações sobre partes carregadas no carregamento de multiparte específico. Informações sobre um máximo de 1000 partes podem ser devolvidas. Se mais de 1000 partes forem carregadas em um carregamento de multiparte, você precisará enviar várias solicitações para listar todas as partes carregadas. A lista de partes carregadas não inclui partes mescladas.

Uma lista devolvida só pode ser usada para verificação. Após a conclusão de um carregamento de multiparte, o resultado na lista não é mais válido. No entanto, quando os números de parte e os valores de ETag retornados pelo OBS são carregados, a lista de números de parte especificados pelo usuário será reservada.

Listagem de tarefas de carregamento de multiparte

Você pode obter a lista de tarefas de carregamento de multiparte inicializadas listando as tarefas de carregamento de multiparte no bucket. Tarefas de carregamento de multiparte inicializadas referem-se às tarefas de carregamento de multiparte que não são mescladas ou canceladas após a inicialização. Um máximo de 1000 tarefas de carregamento de multiparte podem ser retornadas para cada solicitação. Se o número de tarefas de carregamento de multiparte em andamento exceder 1000, você precisará enviar mais solicitações para consultar as tarefas restantes.

Tabela 1 lista as restrições na listagem de carregamentos de multiparte

Operações e permissões de carregamento de multiparte

Você pode realizar o carregamento de multiparte somente após receber a permissão. Você pode usar ACL, políticas de bucket ou políticas de usuário para conceder aos usuários a permissão. A tabela a seguir lista as operações de carregamento de multiparte e as permissões necessárias que podem ser concedidas por ACL, políticas de bucket ou políticas de usuário.

As API REST aplicáveis ao carregamento de multiparte

As seções a seguir na Referência de API de Object Storage Service descrevem as API REST relevantes para o carregamento de multiparte.

• ListBucketMultipartUpload
• InitiateMultipartUpload
• UploadPart
• UploadPart-Copy
• ListParts
• CompleteMultipartUpload
• AbortMultipartUpload