IMM Quick Start - Object Storage Service: Central de Documentação do Alibaba Cloud

Os recursos do Intelligent Media Management (IMM) estão integrados ao Object Storage Service (OSS), o que permite utilizar diversas funcionalidades de processamento e análise de dados do IMM diretamente no OSS. Este tópico descreve como usar o OSS para acessar os recursos do IMM.

Pré-requisitos

Os recursos relacionados ao IMM estão disponíveis apenas nas regiões onde há suporte ao serviço. Para mais informações, consulte service registration.
O IMM deve estar ativado. Para mais informações, consulte Activate IMM.
Para usar os recursos do IMM como usuário do Resource Access Management (RAM), verifique se o usuário tem as permissões descritas abaixo.
- Permissões do sistema: permissão AliyunOSSFullAccess para acessar o OSS e permissão AliyunIMMFullAccess para acessar o IMM. Para saber como conceder permissões a usuários RAM, consulte Manage RAM user permissions.
- Permissões personalizadas: permissões oss:ProcessImm e ram:GetRole. Crie as políticas personalizadas correspondentes antes de conceder essas permissões a um usuário RAM. Para mais informações, consulte Grant a custom policy.

Faturamento

O uso do IMM gera cobranças. Para mais informações, consulte billing overview.

Etapa 1: Mapear um projeto IMM para o seu bucket

Faça login no Console de Gerenciamento do OSS.
No painel de navegação à esquerda, clique em Buckets. Na página Buckets, clique no nome do bucket desejado.
No painel de navegação à esquerda, selecione Data Processing.
Clique em Document Processing ou Media Processing e, na página de vinculação exibida, clique no botão Map Project to Bucket.

Nota
Não é necessário mapear um projeto IMM ao bucket para processar imagens.
Na caixa de diálogo Map Project, escolha o método de mapeamento na seção IMM Configuration.
- Create Project: Insira o nome do projeto. O sistema cria automaticamente o projeto IMM correspondente na mesma região do bucket e o mapeia para o bucket atual.
- Map Existing Project: Selecione na lista suspensa o projeto IMM que deseja mapear para o bucket.
  
  Importante
  A opção Map Existing Project só estará disponível se já existir um projeto IMM criado na mesma região do bucket. Para mais informações, consulte create project.
Clique em OK.

Etapa 2: Usar o IMM

Usar o IMM no console do OSS

Clique em Buckets. Na página Buckets, clique no nome do bucket desejado.
No painel de navegação à esquerda, selecione Data Processing.
Acesse menus como Document Processing e Media Processing para usar os recursos do IMM, como criação de estilos e tarefas.

Usar o SDK do OSS para Processamento Inteligente de Mídia

O exemplo de código abaixo demonstra como acionar o IMM usando x-oss-process.

# -*- 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)