Dans Object Storage Service (OSS), un style d'image vous permet d'effectuer une série d'opérations de traitement d'image, telles que le redimensionnement, le recadrage, la rotation et l'ajout de filigranes. Vous pouvez créer un style d'image pour définir ces opérations, puis l'appliquer aux images d'un bucket pour un traitement et une transformation rapides.
Notes
Pour plus d'informations sur les paramètres de traitement d'image pris en charge par les styles d'image, consultez la rubrique Traitement d'image.
Cette rubrique utilise le point de terminaison public de la région Chine (Hangzhou). Si vous souhaitez accéder à OSS depuis d'autres services Alibaba Cloud situés dans la même région, utilisez un point de terminaison interne. Pour plus d'informations sur les régions et les points de terminaison OSS, consultez la rubrique Régions et points de terminaison.
Dans cette rubrique, les identifiants d'accès sont obtenus à partir des variables d'environnement. Pour savoir comment configurer les identifiants d'accès, consultez la rubrique Configurer les identifiants d'accès à l'aide du SDK OSS pour Python 1.0.
Cette rubrique montre comment créer une instance OSSClient avec un endpoint OSS. Pour d'autres configurations, comme l'utilisation d'un domaine personnalisé ou l'authentification avec des identifiants issus du Security Token Service (STS), consultez la rubrique Initialisation.
-
Permissions
Par défaut, un compte Alibaba Cloud dispose des permissions requises pour les opérations liées aux styles d'image. Pour effectuer ces opérations en tant qu'utilisateur Resource Access Management (RAM) ou via STS, vous devez disposer des permissions correspondantes :
Pour créer un style d'image, vous devez disposer de l'autorisation
oss:PutStyle.Pour interroger les informations relatives à un style d'image spécifique dans un bucket, vous devez disposer de l'autorisation
oss:GetStyle.Pour lister tous les styles d'image créés dans un bucket, vous devez disposer de l'autorisation
oss:ListStyle.Pour supprimer un style d'image spécifique dans un bucket, vous devez disposer de l'autorisation
oss:DeleteStyle.
Pour plus d'informations, consultez la rubrique Accorder des stratégies d'accès personnalisées à un utilisateur RAM.
Créer un style d'image
Vous pouvez créer jusqu'à 50 styles d'image pour un bucket. Le code suivant montre comment créer un style d'image :
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Specify the endpoint of the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Specify the region of the endpoint. Example: cn-hangzhou. This parameter is required if you use the V4 signature algorithm.
region = "cn-hangzhou"
# Replace examplebucket with the name of the bucket.
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# Specify the name of the image style, such as imagestyle.
style = 'imagestyle'
# Specify the operation of the image style, such as resizing the image to a width of 200 pixels.
content = 'image/resize,w_200'
# Create an image style.
result = bucket.put_bucket_style(style, content)
print('The style is created. The status code is: ' + str(result.status))Une fois le style d'image créé, vous pouvez l'utiliser pour traiter les images. Pour plus d'informations, consultez la rubrique Utiliser des styles d'image pour traiter les images.
Interroger un style d'image spécifique
Le code suivant montre comment interroger les informations relatives à un style d'image spécifique dans un bucket.
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before you run this code, set the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Set endpoint to the endpoint of the region where the bucket is located. For example, for the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Set region to the region that corresponds to your endpoint, such as cn-hangzhou. Note: This parameter is required for V4 signatures.
region = "cn-hangzhou"
# Replace examplebucket with your bucket name.
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# Specify the name of the image style, such as imagestyle.
style = 'imagestyle'
# Query information about the specified image style in the examplebucket bucket.
result = bucket.get_bucket_style(style)
print('name: ' + result.name)
print('content: ' + result.content)Interroger tous les styles d'image
Le code suivant montre comment interroger tous les styles d'image créés dans un bucket.
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before running this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Specify the endpoint of the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Specify the region that corresponds to the endpoint, such as cn-hangzhou. Note: This parameter is required for V4 signatures.
region = "cn-hangzhou"
# Replace examplebucket with your bucket name.
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# Query all created image styles in the examplebucket bucket.
result = bucket.list_bucket_style()
for sty in result.styles:
print('name: ' + sty.name)
print('content: ' + sty.content)Supprimer un style d'image spécifique
Utilisez le code suivant pour supprimer un style d'image spécifique du bucket examplebucket.
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before you run this code, set the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Set endpoint to the endpoint of the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set endpoint to https://oss-cn-hangzhou.aliyuncs.com.
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Set the region that corresponds to the endpoint, such as cn-hangzhou. This parameter is required for V4 signatures.
region = "cn-hangzhou"
# Replace examplebucket with your bucket name.
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# Specify the name of the image style, such as imagestyle.
style = 'imagestyle'
# Delete the specified image style.
result = bucket.delete_bucket_style(style)
print('Style deleted successfully. Return status: ' + str(result.status))Références
Pour plus d'informations sur l'opération API permettant de créer un style d'image, consultez la rubrique PutStyle.
Pour plus d'informations sur l'opération API permettant d'interroger un style d'image spécifique dans un bucket, consultez la rubrique GetStyle.
Pour plus d'informations sur l'opération API permettant de lister tous les styles d'image dans un bucket, consultez la rubrique ListStyle.
Pour plus d'informations sur l'opération API permettant de supprimer un style d'image spécifique dans un bucket, consultez la rubrique DeleteStyle.