ApsaraVideo VOD:Migrate resources to ApsaraVideo VOD

Cas d'utilisation

Utilisez le téléchargement par lot basé sur les URL lorsque :

• Les ressources sont stockées à distance (et non sur des appareils locaux) et sont accessibles publiquement

• Vous devez migrer un grand nombre de fichiers de manière efficace

• Les ressources se trouvent dans les régions prises en charge : Chine (Shanghai), Chine (Pékin), Chine (Shenzhen), Singapour ou États-Unis (Silicon Valley)

Pour les autres régions, utilisez plutôt la méthode 2 (téléchargement via SDK).

Remarques d'utilisation

• Traitement asynchrone : Les tâches de téléchargement par lot s'exécutent de manière asynchrone. Les migrations volumineuses peuvent prendre plusieurs heures, voire plusieurs jours.

• Nouveaux ID média : Chaque téléchargement crée un nouvel ID média dans VOD. L'opération UploadMediaByURL ne permet pas de spécifier un ID vidéo cible ; vous ne pouvez donc pas écraser un ID vidéo existant ou supprimé, et le fichier source d'une vidéo supprimée ne peut pas être restauré via la migration. Conservez une trace de la correspondance entre les adresses des fichiers sources et les ID média à titre de référence.

• Vidéos supprimées : Si une vidéo a été supprimée de VOD, la migration ne permet pas de la restaurer. Les fichiers sources supprimés via l'appel à DeleteMezzanines ne peuvent pas non plus être récupérés. Avant de procéder à la migration, vérifiez l'état du fichier source. Pour gérer ou supprimer des vidéos téléchargées par erreur, consultez la rubrique Supprimer des fichiers multimédias.

• Exigences relatives aux URL : Les URL doivent inclure les noms de fichiers avec leurs extensions (par exemple, https://example.com/video.mp4)

• Signature d'URL : Si votre source active la signature d'URL, assurez-vous que les URL restent valides tout au long de la période de migration.

• Visibilité du flux du fichier original : Si vous ne définissez pas le paramètre TemplateGroupId (mode par défaut VOD_NO_TRANSCODE), les adresses de lecture de la vidéo migrée n'affichent que le flux « Qualité originale ». Pour exposer également un flux « Fichier original », spécifiez un TemplateGroupId correspondant à un groupe de modèles de transcodage autre que VOD_NO_TRANSCODE.

Procédure

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-vod</artifactId>
    <version>2.16.11</version>
</dependency>

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.vod.model.v20170321.UploadMediaByURLRequest;
import com.aliyuncs.vod.model.v20170321.UploadMediaByURLResponse;

public class UploadByURL {
    public static void main(String[] args) {
        // Read credentials from environment variables
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
        String regionId = "cn-shanghai";  // Region where VOD service is activated

        // Initialize VOD client
        DefaultProfile profile = DefaultProfile.getProfile(regionId, accessKeyId, accessKeySecret);
        DefaultAcsClient client = new DefaultAcsClient(profile);

        // Create upload request
        UploadMediaByURLRequest request = new UploadMediaByURLRequest();

        // Specify source URLs (comma-separated for multiple files)
        request.setUploadURLs("https://example.com/video1.mp4,https://example.com/video2.mp4");

        // Optional: Specify a transcoding template group. If you don't set this parameter,
        // VOD transcodes the uploaded file using the destination account's default
        // transcoding template group, which may replace the mezzanine file with a
        // transcoded output instead of preserving the original file.
        request.setTemplateGroupId("");

        // Optional: Set metadata for uploaded videos
        request.setUploadMetadatas("[{\"Title\":\"Video 1\"},{\"Title\":\"Video 2\"}]");

        try {
            UploadMediaByURLResponse response = client.getAcsResponse(request);
            System.out.println("Request ID: " + response.getRequestId());
            System.out.println("Upload jobs created:");
            for (UploadMediaByURLResponse.UploadJob job : response.getUploadJobs()) {
                System.out.println("- Job ID: " + job.getJobId());
                System.out.println("  Source URL: " + job.getSourceURL());
            }
        } catch (Exception e) {
            System.err.println("Upload failed: " + e.getMessage());
        }
    }
}

{
  "Status": "success",
  "EventTime": "2026-03-10T09:15:00Z",
  "EventType": "UploadByURLComplete",
  "VideoId": "43q9fjdun3f2a5b",
  "JobId": "4c815bjs83j1d8f",
  "SourceURL": "https://example.com/video.mp4",
  "Size": "123456789"
}

{
  "Status": "fail",
  "EventTime": "2026-03-10T09:15:00Z",
  "EventType": "UploadByURLComplete",
  "ErrorCode": "URLInvalidError",
  "ErrorMessage": "Download video failed by the URL, please check it",
  "JobId": "4c815bjsued1f9a",
  "SourceURL": "https://example.com/invalid-video.mp4"
}

GetURLUploadInfosRequest request = new GetURLUploadInfosRequest();
request.setJobIds("job-id-1,job-id-2");  // Comma-separated job IDs

GetURLUploadInfosResponse response = client.getAcsResponse(request);
for (GetURLUploadInfosResponse.UrlUploadJobInfo job : response.getURLUploadInfoList()) {
    System.out.println("Job ID: " + job.getJobId());
    System.out.println("Status: " + job.getStatus());  // NotStarted/Uploading/Success/Failed
    if ("Success".equals(job.getStatus())) {
        System.out.println("Video ID: " + job.getVideoId());
    }
}

Vérification

Une fois les téléchargements terminés :

1. Vérifiez l'état des tâches de téléchargement : Assurez-vous que toutes les tâches affichent l'état « Success » (Succès)

2. Confirmez les ID vidéo : Vérifiez que chaque ressource téléchargée possède un ID vidéo correspondant

3. Testez la lecture : Lancez la lecture d'échantillons vidéo pour confirmer le succès de la migration

4. Mappez la source vers la destination : Enregistrez la correspondance entre les URL sources et les ID vidéo VOD à titre de référence

Scénario A : Téléchargement via le réseau interne

Cas d'utilisation : Votre instance ECS et votre bucket OSS source se trouvent dans la même région.

Avantages : Vitesse de téléchargement plus élevée, aucun coût de trafic sur le réseau public.

import com.aliyun.vod.upload.impl.UploadVideoImpl;
import com.aliyun.vod.upload.req.UploadStreamRequest;
import com.aliyun.vod.upload.resp.UploadStreamResponse;
import java.io.InputStream;
import java.net.URL;

public class InternalNetworkUpload {
    public static void main(String[] args) throws Exception {
        // Read credentials from environment variables
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        // Internal network URL (obtained in Step 1)
        String internalUrl = "https://bucket.oss-cn-shanghai-internal.aliyuncs.com/video.mp4";

        // Download from internal network URL
        InputStream inputStream = new URL(internalUrl).openStream();

        // Create upload request
        UploadStreamRequest request = new UploadStreamRequest(
            accessKeyId,
            accessKeySecret,
            "Video Title",    // Video title
            "video.mp4",      // File name with extension
            inputStream
        );

        // Set region (must match ECS region for internal network)
        request.setApiRegionId("cn-shanghai");
        request.setEcsRegionId("cn-shanghai");

        // Optional: Specify a transcoding template group. If you don't set this parameter,
        // VOD transcodes the uploaded file using the destination account's default
        // transcoding template group, which may replace the mezzanine file with a
        // transcoded output instead of preserving the original file.
        request.setTemplateGroupId("");

        // Upload
        UploadVideoImpl uploader = new UploadVideoImpl();
        UploadStreamResponse response = uploader.uploadStream(request);

        if (response.isSuccess()) {
            System.out.println("Upload successful");
            System.out.println("Video ID: " + response.getVideoId());
        } else {
            System.err.println("Upload failed: " + response.getMessage());
        }
    }
}

Scénario B : Téléchargement via Internet

Cas d'utilisation :

• Vous ne disposez pas d'instance ECS, ou votre instance ECS se trouve dans une région différente de celle des ressources sources

• Les ressources sources se trouvent sur des plateformes tierces (AWS S3, Azure Blob, sites web personnels, etc.)

import com.aliyun.vod.upload.impl.UploadVideoImpl;
import com.aliyun.vod.upload.req.UploadStreamRequest;
import com.aliyun.vod.upload.resp.UploadStreamResponse;
import java.io.InputStream;
import java.net.URL;

public class InternetUpload {
    public static void main(String[] args) throws Exception {
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        // Public URL
        String sourceUrl = "https://example.com/video.mp4";

        // Download from source
        InputStream inputStream = new URL(sourceUrl).openStream();

        // Create upload request
        UploadStreamRequest request = new UploadStreamRequest(
            accessKeyId,
            accessKeySecret,
            "Video Title",
            "video.mp4",
            inputStream
        );

        request.setApiRegionId("cn-shanghai");  // VOD service region

        // Upload
        UploadVideoImpl uploader = new UploadVideoImpl();
        UploadStreamResponse response = uploader.uploadStream(request);

        if (response.isSuccess()) {
            System.out.println("Video ID: " + response.getVideoId());
        }
    }
}

Cas d'utilisation

Utilisez cette méthode pour migrer des ressources OSS vers VOD au sein du même compte Alibaba Cloud sans déplacer physiquement les données. Il s'agit de la méthode la plus rapide et la plus rentable pour une migration au sein du même compte.

Limitations

• Classe de stockage : Seuls les buckets OSS Standard sont pris en charge

• Quota de bucket : Maximum 10 buckets OSS par région peuvent être ajoutés à VOD

• Restriction de compte : Le bucket OSS source et le service VOD de destination doivent appartenir au même compte Alibaba Cloud

Procédure

Étape 1 : Ajouter un bucket OSS à VOD

Ajoutez le bucket OSS source à votre service VOD :

1. Connectez-vous à la console ApsaraVideo VOD

2. Dans le volet de navigation de gauche, choisissez Configuration Management > Media Management > Storage

3. Cliquez sur Add Storage

4. Sélectionnez votre bucket OSS et configurez les autorisations

5. Cliquez sur OK

Pour obtenir des étapes détaillées, consultez la rubrique Gérer le stockage VOD.

Étape 2 : Enregistrer les ressources multimédias

Enregistrez les objets OSS en tant qu'actifs multimédias VOD à l'aide de l'API RegisterMedia :

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.vod.model.v20170321.RegisterMediaRequest;
import com.aliyuncs.vod.model.v20170321.RegisterMediaResponse;

public class RegisterOSSMedia {
    public static void main(String[] args) throws Exception {
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", accessKeyId, accessKeySecret);
        DefaultAcsClient client = new DefaultAcsClient(profile);

        RegisterMediaRequest request = new RegisterMediaRequest();

        // Specify OSS file URL (must include OSS domain name)
        request.setRegisterMetadatas(
            "[{\"FileURL\":\"https://bucket-name.oss-cn-hangzhou.aliyuncs.com/video/example.mp4\"," +
            "\"Title\":\"Example Video\"}]"
        );

        RegisterMediaResponse response = client.getAcsResponse(request);
        System.out.println("Registered video IDs:");
        for (RegisterMediaResponse.RegisteredMedia media : response.getRegisteredMediaList()) {
            System.out.println("- " + media.getMediaId());
        }
    }
}

Paramètres clés :

• FileURL : Chemin OSS complet incluant le nom de domaine (par exemple, https://bucket.oss-cn-hangzhou.aliyuncs.com/path/to/video.mp4)

• Title : Titre de la vidéo dans VOD

Pour plus d'informations, consultez la rubrique RegisterMedia.

Vérification

Après l'enregistrement :

1. Vérifiez la bibliothèque multimédia : Assurez-vous que les vidéos enregistrées apparaissent dans la console VOD

2. Testez la lecture : Lancez la lecture des vidéos enregistrées pour confirmer leur accessibilité

3. Vérifiez les métadonnées : Contrôlez si les titres et attributs des vidéos correspondent à vos attentes

Planification de la migration

• Estimez le temps de migration : Le téléchargement par lot basé sur les URL est asynchrone. Les migrations volumineuses (plus de 1 000 fichiers) peuvent prendre plusieurs heures, voire plusieurs jours.

• Taille des lots : Divisez les migrations volumineuses en lots de 100 à 500 fichiers pour faciliter le suivi et la récupération en cas d'erreur.

• Bande passante réseau : Tenez compte de votre bande passante réseau lors du choix entre le téléchargement via le réseau interne et via Internet.

Optimisation des coûts

• Utilisez le réseau interne : Lors de la migration de ressources OSS dans la même région, utilisez les adresses du réseau interne pour éviter les coûts de trafic sur le réseau public.

• Privilégiez l'enregistrement au téléchargement : Pour la migration OSS vers VOD au sein du même compte, utilisez l'enregistrement de bucket (méthode 3) pour éviter les coûts et le temps liés au téléchargement.

Gestion des ressources

• Suivez les correspondances : Enregistrez toujours la correspondance entre les URL sources et les ID vidéo VOD pour référence future.

• Migration des métadonnées : Incluez les métadonnées vidéo (titre, tags, description) lors du téléchargement pour éviter des mises à jour manuelles ultérieures.

• Nettoyage : Après avoir vérifié le succès de la migration, supprimez les ressources sources pour réduire les coûts de stockage (si elles ne sont plus nécessaires).

Gestion des erreurs

• Validité des URL : Assurez-vous que les URL signées restent valides tout au long de la période de migration.

• Nouvelle tentative pour les tâches échouées : Surveillez l'état des tâches de téléchargement et relancez les téléchargements ayant échoué avec des URL corrigées.

• Validation : Testez le téléchargement avec un petit échantillon avant de migrer de grands volumes.

Échec du téléchargement basé sur les URL

Symptôme : L'état de la tâche de téléchargement affiche « Failed » (Échec) dans le callback ou la réponse API.

Causes courantes :

• URL inaccessible : L'URL source renvoie une erreur 403 ou 404

  • Solution : Vérifiez que l'URL est accessible publiquement. Si vous utilisez des URL signées, assurez-vous que la signature n'a pas expiré.

• Format d'URL invalide : L'URL n'inclut pas le nom de fichier ou l'extension

  • Solution : Assurez-vous que les URL suivent le format https://domain.com/path/file.mp4

• Région non prise en charge : La région source ne prend pas en charge le téléchargement basé sur les URL

  • Solution : Utilisez plutôt la méthode 2 (téléchargement via SDK)

Les performances du téléchargement via SDK sont lentes

Symptôme : Le téléchargement prend plus de temps que prévu.

Causes courantes :

• Limitation de la bande passante réseau : Bande passante de téléchargement limitée

  • Solution : Utilisez le téléchargement via le réseau interne (scénario A) si l'instance ECS et la source se trouvent dans la même région

• Taille du fichier : Les fichiers vidéo volumineux prennent plus de temps à télécharger

  • Solution : Envisagez de compresser les vidéos avant le téléchargement ou utilisez le téléchargement multipart pour les fichiers de plus de 100 Mo

Échec de RegisterMedia

Symptôme : L'API renvoie une erreur lors de l'enregistrement des objets OSS.

Causes courantes :

• Bucket OSS non ajouté : Le bucket n'a pas été ajouté à VOD

  • Solution : Effectuez d'abord l'étape 1 pour ajouter le bucket OSS à VOD

• FileURL invalide : Le format de l'URL est incorrect

  • Solution : Assurez-vous que FileURL inclut le nom de domaine OSS complet (par exemple, https://bucket.oss-cn-hangzhou.aliyuncs.com/video.mp4)

• Autorisation refusée : VOD ne dispose pas de l'autorisation d'accès au bucket OSS

  • Solution : Accordez l'autorisation de lecture VOD à votre bucket OSS dans la console VOD