Object Storage Service:Get started with IMM

Prérequis

• Les fonctionnalités liées à IMM sont disponibles uniquement dans les régions où le service est pris en charge. Pour plus d'informations, consultez la page enregistrement du service.

• Le service IMM doit être activé. Pour plus d'informations, consultez la rubrique Activer IMM.

• Si vous souhaitez utiliser les fonctionnalités liées à IMM en tant qu'utilisateur RAM (Resource Access Management), assurez-vous que cet utilisateur dispose des autorisations décrites ci-dessous.

  • Autorisations système : l'autorisation AliyunOSSFullAccess pour accéder à OSS et l'autorisation AliyunIMMFullAccess pour accéder à IMM. Pour savoir comment attribuer des autorisations aux utilisateurs RAM, consultez la rubrique Gérer les autorisations des utilisateurs RAM.

  • Autorisations personnalisées : les autorisations oss:ProcessImm et ram:GetRole. Créez les stratégies personnalisées correspondantes avant d'accorder ces autorisations à un utilisateur RAM. Pour plus d'informations, consultez la section Accorder une stratégie personnalisée.

Facturation

L'utilisation d'IMM est facturée. Pour plus d'informations, consultez la présentation de la facturation.

Étape 1 : Associer un projet IMM à votre bucket

1. Connectez-vous à la console de gestion OSS.

2. Dans le volet de navigation de gauche, cliquez sur Buckets. Sur la page Buckets, cliquez sur le nom du bucket concerné.

3. Dans le volet de navigation de gauche, sélectionnez Data Processing.

4. Cliquez sur Document Processing ou sur Media Processing, puis, dans la fenêtre contextuelle d'association, cliquez sur le bouton Map Project to Bucket.

   Remarque

   Il n'est pas nécessaire d'associer un projet IMM à votre bucket pour le traitement d'images.

5. Sélectionnez la méthode d'association d'un projet IMM dans la section IMM Configuration de la boîte de dialogue Map Project.

   • Create Project : saisissez le nom du projet. Le système crée automatiquement le projet IMM correspondant dans la région où se trouve le bucket et l'associe au bucket actuel.

     

   • Map Existing Project : sélectionnez le projet IMM à associer au bucket dans la liste déroulante.

     

     Important

     L'option map an existing project n'est disponible que si le projet IMM correspondant a été créé dans la région où se trouve le bucket. Pour plus d'informations, consultez la rubrique créer un projet.

6. Cliquez sur OK.

Étape 2 : Utiliser IMM

# -*- coding: utf-8 -*-
import os
import oss2

# Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. 
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# Security risks may arise if you use the AccessKey pair of an Alibaba Cloud account, for the account has permissions on all API operations. We recommend that you use the AccessKey pair of a RAM user for API operations and O&M. To create a RAM user, log on to the RAM console.
access_key_id = 'yourAccessKeyId'
access_key_secret = 'yourAccessKeySecret'
# Specify the name of the bucket in which files are located.
bucket_name = 'examplebucket'
# Specify the full path of the object. Do not include the bucket name in the full path.
key = 'exampledir/example.docx'

# Specify the bucket instance. You must use the bucket instance to call all object-related methods.
bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)

style = 'doc/preview,copy_1,export_1,print_1,pages_3'
# Generate a signed object URL that includes IMG parameters. Set the validity period of the URL to 600 seconds.
url = bucket.sign_url('GET', key, 10 * 60, params={'x-oss-process': style})
print(url)