Documentação do Oracle Cloud Infrastructure

Executando um Upload Multiparte

No Compute Cloud@Customer, você pode fazer upload de objetos em várias partes.

Com uploads em várias partes, é possível fazer o upload de partes individuais de um objeto em paralelo para reduzir a quantidade de tempo que você gasta em upload.

Os uploads multiparte acomodam objetos que são muito grandes para uma única operação de upload. As partes do objeto não devem ser maiores que 50 GiB.

Você pode pausar entre os uploads de partes individuais e retomar o upload quando a programação e os recursos permitirem.

Peças do Objeto

Com o upload multiparte, você divide em partes individuais o objeto do qual deseja fazer upload. As partes individuais podem ter no máximo 50 GiB. O tamanho máximo para o upload de um objeto é 10 TiB.

Decida que número você deseja usar para cada parte. Os números de parte podem variar de 1 a 10.000. Não é necessário designar números contíguos, mas o Object Storage constrói o objeto ordenando números de peça em ordem crescente.

API Upload Multiparte

Antes de usar a API de upload multiparte, você é responsável por criar as partes para upload. O Object Storage fornece as operações da API para as etapas restantes.

Um upload multiparte executado usando a API consiste nas seguintes etapas:

  1. Inicie um upload.

  2. Fazer upload de partes do objeto.

  3. Confirme o upload.

O serviço também fornece operações de API para listar uploads multiparte em andamento, listando as partes dos objetos em um upload multiparte em andamento e abortando uploads multiparte em andamento iniciados por meio da API.

CLI de Upload Multiparte

Quando você executa um upload em várias partes usando a CLI, não é necessário dividir o objeto em partes, conforme é necessário pela API. Em vez disso, você especifica o tamanho da peça de sua escolha, e o Object Storage divide o objeto em partes e executa o upload de todas as partes automaticamente. Você pode optar por definir o número máximo de partes que podem ser carregadas em paralelo. Por padrão, a CLI limita a três o número de partes que podem ser submetidas a upload em paralelo. Ao usar a CLI, não será necessário executar um commit quando o upload estiver concluído.

Você também pode usar a CLI para listar upload de várias partes em andamento e cancelar uploads de várias partes iniciados por meio da API.

  • Esta tarefa não está disponível na Console.

  • Use o comando oci os object put e os parâmetros necessários para fazer upload de um objeto em várias partes.

    Sintaxe:

    oci os object put --namespace-name <object_storage_namespace> --bucket-name <bucket_name> --file <file_location> --parallel-upload-count <maximum_number_parallel_uploads> --part-size <upload_part_size_in_MB> --force [OPTIONS]

    Exemplo:

    oci os object put   \
--namespace-name examplenamespace  \
--file /boot/initramfs-0-rescue-e542c19f0fbf4e41a41428d933a7357f.img   \
--parallel-upload-count 5   \
--part-size 15   \
--force

Upload ID: a21bba2c-8922-4b9c-a98a-9ef3569c0138
Split file into 6 parts for upload.
Uploading object [####################################] 100%
{
  "etag": "0964effc8dc4394fd317f03a025ae5d0",
  "last-modified": "2021-05-11T21:35:19",
  "opc-multipart-md5": "UIVRhiwSHY6o0E4pi/yfGg==-6"
}

    Para obter uma lista completa de comandos, flags e opções da CLI, consulte a Referência da Linha de Comandos.

  • Um upload multiparte executado usando a API consiste nas seguintes etapas:

    1. Iniciando um upload.
    2. Fazendo upload de partes do objeto.
    3. Fazendo commit do upload.

    Antes de usar a API para upload em várias partes, você será responsável por criar as partes para upload. O Object Storage fornece as operações da API para as etapas restantes. O serviço também fornece operações de API para listar uploads multiparte em andamento, listando as partes dos objetos em um upload multiparte em andamento e abortando uploads multiparte em andamento iniciados por meio da API.

    Observação

    Esses requisitos de API de upload em várias partes não se aplicam à CLI.

    Para obter mais informações sobre como usar a API para Upload em várias partes, consulte Usando essa API.

    Use a operação PutObject para fazer upload de um objeto em várias partes.

    Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.