Todos os produtos
Search
Central de documentação

:Pré-requisitos

Última atualização: Jun 27, 2026

Este tópico descreve os pré-requisitos para a migração de dados.

Etapa 1: Criar um bucket de destino

Crie um bucket de destino para armazenar os dados migrados. Para mais informações, consulte Criar um bucket.

Etapa 2: Criar um usuário RAM e conceder permissões

Importante

Faça login no console RAM com sua conta Alibaba Cloud. Na página Users, localize o usuário RAM criado e clique em Add Permissions na coluna Actions.

  1. Política do sistema: Permissions for managing Online Migration Service (AliyunOSSImportFullAccess).

  2. Política personalizada: esta política deve incluir as permissões ram:CreateRole, ram:CreatePolicy, ram:AttachPolicyToRole e ram:ListRoles.

    Para mais informações sobre gerenciamento de permissões, consulte Criar uma política personalizada. Veja abaixo um exemplo de política:

    {
        "Version":"1",
        "Statement":[
            {
                "Effect":"Allow",
                "Action":[
                    "ram:CreateRole",
                    "ram:CreatePolicy",
                    "ram:AttachPolicyToRole",
                    "ram:ListRoles"
                ],
                "Resource":"*"
            }
        ]
    }

Etapa 3: Autorizar o bucket de origem

Siga as etapas correspondentes à propriedade do seu bucket de origem.

Nota

Neste tópico, "sua conta" refere-se à conta Alibaba Cloud usada para acessar o console Data Online Migration. Um bucket é considerado "de propriedade da sua conta" se você utilizar a mesma conta Alibaba Cloud tanto para o bucket quanto para o console.

Seu bucket de origem

  • Autorização automática

    Recomendamos fortemente o uso do recurso de autorização automática de função. Execute essa operação com um clique no console Data Online Migration, em Migration Implementation > Step 2 > Authorize Role.

  • Autorização manual

Nota

Utilize a autorização manual nos seguintes cenários:

  • Você deseja usar uma única função para conceder permissões em vários buckets de origem, visando gerenciar recursos com mais eficiência.

  • O número de funções RAM existentes na sua conta está próximo do limite e você quer evitar a criação de novas funções.

  • A autorização automática é inadequada ou indisponível para o seu caso de uso.

1. Criar uma função RAM

Faça login no console RAM como o usuário RAM criado. Na página Roles, clique em Create Role.

  1. Em Select Trusted Entity, selecione Alibaba Cloud Service.

  2. Em Role Type, selecione Normal Service Role e escolha Data Transport na lista suspensa.

  3. Insira um Role Name (o nome da função deve ser todo em minúsculas).

    Para Select Trusted Entity, selecione Alibaba Cloud Service. Para Role Type, selecione Data Transport mgw.aliyuncs.com e clique em OK.

    Por exemplo, insira role-test e clique em OK.

2. Conceder permissões ao bucket de origem

Na página Roles, localize a função RAM criada e clique em Add Permissions na coluna Actions.

  • Política personalizada: esta política deve incluir as permissões oss:List* e oss:Get*.

Para mais informações sobre gerenciamento de permissões, consulte Criar uma política personalizada. Veja abaixo um exemplo de política:

Nota

Esta política serve apenas como referência. Substitua o placeholder pelo nome do seu bucket de origem.

Para mais informações sobre políticas de permissão do OSS, consulte Exemplos comuns de políticas RAM.

Importante

Se o bucket de origem contiver objetos criptografados com o Key Management Service (KMS), conceda também a política de sistema AliyunKMSFullAccess à função.

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:List*",
        "oss:Get*"
      ],
      "Resource": [
        "acs:oss:*:*:<mySrcBucket>",
        "acs:oss:*:*:<mySrcBucket>/*"
      ]
    }
  ]
}

Bucket em outra conta

1. Criar uma função RAM

Faça login no console RAM como o usuário RAM criado. Na página Roles, clique em Create Role.

  1. Em Select Trusted Entity, selecione Alibaba Cloud Service.

  2. Em Role Type, selecione Normal Service Role e escolha Data Transport na lista suspensa.

  3. Insira um Role Name (o nome da função deve ser todo em minúsculas).

2. Conceder permissões ao bucket de origem

Importante

Ao adicionar uma política de bucket, ela substitui quaisquer políticas existentes. Para evitar a perda de permissões atuais, combine a nova política com as já existentes antes de salvar.

  1. Faça login no console OSS com a conta Alibaba Cloud proprietária do bucket de origem.

  2. No painel de navegação à esquerda, clique em Buckets e, em seguida, clique no nome do bucket de origem.

  3. No painel de navegação à esquerda, escolha Permission Control > Bucket Policy.

  4. Na aba Add by Syntax, clique em Edit para adicionar uma política de bucket personalizada.

  • Conceda à função RAM permissões para listar, obter, enviar e abortar uploads multipart de todos os objetos no bucket.

    Nota

    Esta política serve apenas como referência. Substitua os placeholders pelos seus valores reais: substitua pelo nome do bucket de origem, pelo UID da conta Alibaba Cloud proprietária do bucket de origem, pelo UID da conta Alibaba Cloud usada para acessar o console Data Online Migration e pelo nome da função RAM que você criou. Para mais informações sobre políticas de permissão do OSS, consulte Exemplos comuns de políticas RAM.

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:List*",
            "oss:Get*",
            "oss:Put*",
            "oss:AbortMultipartUpload"
          ],
          "Principal": [
             "arn:sts::<myUid>:assumed-role/<roleName>/*"
          ],
          "Resource": [
            "acs:oss:*:<otherUid>:<otherSrcBucket>",
            "acs:oss:*:<otherUid>:<otherSrcBucket>/*"
          ]
        }
      ]
    }

3. Conceder permissões KMS

  1. Caso o bucket de origem contenha objetos criptografados com KMS, conceda também a política de sistema AliyunKMSFullAccess à função.

  2. Se os objetos no bucket de origem estiverem criptografados com uma chave KMS personalizada, a função também precisará de acesso a essa chave. Para isso, execute as seguintes etapas:

    1. Faça login no console Key Management Service e localize a chave.

    2. Defina a Key Policy, selecione Users in Other Accounts e insira o ARN da entidade principal. Para mais informações, consulte Definir uma política de chave. Na página de detalhes da chave, abra a caixa de diálogo de configuração Key Policy e configure Administrators, Users e Users in Other Accounts. Nas duas primeiras opções, faça uma busca aproximada inserindo o nome de um usuário RAM ou função RAM na caixa de pesquisa suspensa. Para Users in Other Accounts, insira o ARN da entidade principal em um formato como acs:ram::<userId>:role/<ramrole> ou acs:ram::<userId>:user/<ramuser>. Clique em Add ARN of User in Other Account para adicionar múltiplos ARNs.

Etapa 4: Autorizar o bucket de destino

Siga as etapas correspondentes à propriedade do seu bucket de destino.

Seu bucket de destino

  • Autorização automática

    Recomendamos fortemente o uso do recurso de autorização automática de função. Execute essa operação com um clique no console Data Online Migration, em Migration Implementation > Step 3 > Authorize Role.

  • Autorização manualConceder permissões ao bucket de destino

    Na página Roles, localize a função RAM criada e clique em Add Permissions na coluna Actions.

    • Política personalizada: esta política deve incluir as permissões oss:List*, oss:Get*, oss:Put* e oss:AbortMultipartUpload.

    Para mais informações sobre gerenciamento de permissões, consulte Criar uma política personalizada. Veja abaixo um exemplo de política:

    Nota

    Esta política serve apenas como referência. Substitua o placeholder pelo nome do bucket de destino na sua conta.

    Para mais informações sobre políticas de permissão do OSS, consulte Exemplos comuns de políticas RAM.

    Importante

    Se a criptografia no lado do servidor com KMS estiver configurada para o bucket de destino, conceda também a política de sistema AliyunKMSFullAccess à função.

    {
      "Version": "1",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "oss:List*",
            "oss:Get*",
            "oss:Put*",
            "oss:AbortMultipartUpload"
          ],
          "Resource": [
            "acs:oss:*:*:<myDestBucket>",
            "acs:oss:*:*:<myDestBucket>/*"
          ]
        }
      ]
    }

Bucket em outra conta

1. Conceder permissões ao bucket de destino

Importante

Ao adicionar uma política de bucket, ela substitui quaisquer políticas existentes. Para evitar a perda de permissões atuais, combine a nova política com as já existentes antes de salvar.

  1. Faça login no console OSS com a conta Alibaba Cloud proprietária do bucket de destino.

  2. No painel de navegação à esquerda, clique em Buckets e, em seguida, clique no nome do bucket de destino.

  3. No painel de navegação à esquerda, escolha Permission Control > Bucket Policy.

  4. Na aba Add by Syntax, clique em Edit para adicionar uma política de bucket personalizada.

    • Conceda à função RAM permissões para listar, obter, enviar e abortar uploads multipart de todos os objetos no bucket.

Nota

Esta política serve apenas como referência. Substitua os placeholders pelos seus valores reais: substitua pelo nome do bucket de destino, pelo UID da conta Alibaba Cloud proprietária do bucket de destino, pelo UID da conta Alibaba Cloud usada para acessar o console Data Online Migration e pelo nome da função RAM que você criou. Para mais informações sobre políticas de permissão do OSS, consulte Exemplos comuns de políticas RAM.

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:List*",
        "oss:Get*",
        "oss:Put*",
        "oss:AbortMultipartUpload"
      ],
      "Principal": [
         "arn:sts::<myUid>:assumed-role/<roleName>/*"
      ],
      "Resource": [
        "acs:oss:*:<otherUid>:<otherDestBucket>",
        "acs:oss:*:<otherUid>:<otherDestBucket>/*"
      ]
    }
  ]
}

2. Conceder permissões KMS

  1. Caso a criptografia no lado do servidor com KMS esteja configurada para o bucket de destino, conceda também a política de sistema AliyunKMSFullAccess à função.

  2. Se a criptografia no lado do servidor do bucket de destino utilizar uma chave KMS personalizada, a função também precisará de acesso a essa chave. Para isso, execute as seguintes etapas:

    1. Faça login no console Key Management Service e localize a chave.

    2. Configure a key policy. Selecione Cross-account Users e insira o ARN da entidade principal. Para mais informações, consulte Definir uma política de chave.

Etapa 5: Restaurar dados no bucket de origem

  • Restaure manualmente os objetos da classe de armazenamento Archive antes de criar um endereço de dados de origem e uma tarefa de migração.

  • Defina o período de restauração (número de dias em que o objeto permanece restaurado) com duração suficiente para concluir toda a migração. Isso evita que os objetos retornem ao estado arquivado durante o processo.

  • A operação de restauração pode gerar cobranças, e o valor pode ser relativamente alto. Para mais informações sobre os métodos de faturamento, entre em contato com o provedor de serviços que oferece o bucket de origem.

Nota

O Data Online Migration não restaura objetos arquivados automaticamente. Objetos ainda arquivados ou em processo de restauração não podem ser migrados e serão ignorados.

Para restaurar objetos no Alibaba Cloud OSS, consulte Restaurar objetos.