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 o uploads multiparte, é possível fazer upload de partes individuais de um objeto em paralelo para reduzir o tempo que você gasta no 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 sua programação e recursos permitirem.

Partes do Objeto

Com o upload multiparte, você divide em partes individuais o objeto do qual deseja fazer upload. Partes individuais podem ser tão grandes quanto 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. Você não precisa designar números contínuos, mas o serviço Object Storage constrói o objeto ordenando os números de partes em ordem crescente.

API de Upload em Várias Partes

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

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

  1. Iniciar um upload.

  2. Faça upload de partes do objeto.

  3. Faça commit do upload.

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

CLI de Upload em Várias Partes

Quando você executa um upload multiparte usando a CLI, não é necessário dividir o objeto em partes, pois você precisa fazer pela API. Em vez disso, você especifica o tamanho de parte à sua escolha e o serviç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, você não precisará executar um commit quando o upload estiver concluído.

Você também pode usar a CLI para listar uploads várias partes em andamento e para cancelar uploads 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]

    Por 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 de Linha de Comando.

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

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

    Antes de usar a API de upload multiparte, você é responsável por criar as partes para upload. O serviço Object Storage fornece operações de API para as etapas restantes. O serviço também fornece operações de API para listar uploads várias partes em andamento, listando as partes dos objetos em um upload várias partes em andamento e abortando uploads várias partes 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 de Upload em várias partes, consulte Usando a API de Upload em Várias Partes.

    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.