Object Storage Service:variable

Casos de uso en la consola

• Tareas: Puede hacer referencia a la información del objeto de origen en la ruta de salida de una tarea de procesamiento. Por ejemplo, para convertir un documento a imágenes JPG, establezca la ruta de salida en oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Durante el procesamiento, {autoext} se reemplaza por jpg. Las imágenes resultantes se guardan en oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg.

  En el cuadro de diálogo Create Task, seleccione doc_to_jpg en Style. Un mensaje debajo de Output Path indica que debe introducir una clave de objeto completa; dicha clave puede incluir variables, y las rutas de entrada y salida deben ser diferentes. En la sección Notification Configuration, puede seleccionar Message Queue. Una vez completada la configuración, haga clic en OK.

• Procesamiento por lotes: Al crear un trabajo de procesamiento por lotes, el sistema genera una tarea para cada objeto existente. Para evitar la sobrescritura de datos, se recomienda usar variables en la ruta de salida. Por ejemplo, para extraer fotogramas de un video y guardarlos como imágenes PNG, establezca la ruta de salida en oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Durante el procesamiento, {autoext} se reemplaza por png. Las imágenes PNG generadas se guardan en oss://test-bucket/output/source-directory/source-filename/frame-number.png.

  Después de configurar la ruta de salida en la sección Output Configuration, asegúrese de que la ruta de salida sea distinta de la ruta de entrada si utiliza las variables key, barename o basename. Esto evita que se sobrescriba el objeto de origen y previene la creación de bucles infinitos. En la sección Permission Configuration, seleccione AliyunIMMBatchTriggerRole (Default Role) en Service Role y luego haga clic en OK.

• Disparadores: La creación de un disparador genera una tarea para cada nuevo objeto. Para evitar la sobrescritura de objetos, se recomienda usar variables en la ruta de salida. Por ejemplo, si se crea un disparador de conversión de documentos para convertirlos a imágenes JPG, establezca la ruta de salida en oss://test-bucket/output/{dirname}/{barename}/{index}.{autoext}. Durante el procesamiento, {autoext} se reemplaza por jpg. Las imágenes JPG generadas se guardan en oss://test-bucket/output/source-directory/source-filename/image-sequence-number.jpg.

  Si utiliza las variables de clave de objeto, barename o basename, asegúrese de que la ruta de salida sea diferente de la ruta de entrada para prevenir la sobrescritura de objetos. En la sección Permission Configuration, seleccione AliyunIMMBatchTriggerRole (Default Role) en Service Role y luego haga clic en OK.

Casos de uso de la API

• Guardar como (sys/saveas): Los parámetros b (bucket) y o (objeto) de la operación guardar como (sys/saveas) admiten variables. Por ejemplo, para convertir las páginas 1 a 10 de un documento llamado example.docx a imágenes PNG, puede establecer el parámetro sys/saveas en b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw. En este parámetro, e2J1Y2tldH0 es el valor codificado en Base64 de {bucket}, y ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw es el valor codificado en Base64 de doc_images/{index}.png. Las imágenes convertidas se guardan entonces en el mismo bucket que el objeto de origen, en la ruta doc_images/index.png.

• Tareas: La ruta de salida para las tareas admite variables. Por ejemplo, al llamar a la operación CreateOfficeConversionTask para crear una tarea de conversión de documentos, debe establecer el parámetro TargetURI en la ruta de salida completa, incluida la extensión. El TargetURI puede contener variables, como oss://test-bucket/output/{dirname}/{barename}/{index}.jpg.

Ejemplo 1: Conversión de formato de documento

El siguiente ejemplo de API RESTful muestra cómo agregar parámetros de procesamiento a una solicitud PostObject para convertir el formato de example.docx. Los parámetros b (bucket) y o (objeto) de la operación guardar como (sys/saveas) utilizan variables.

• pages_MS0xMA: Convierte las páginas 1 a 10 del documento. MS0xMA es el valor codificado en Base64 de "1-10".

• target_png: Convierte el documento al formato de imagen PNG.

• source_docx: Especifica que el tipo de objeto de origen es DOCX.

• sys/saveas: Guardar como.

  • b_e2J1Y2tldH0: Una vez completada la transcodificación, la variable {bucket} guarda las imágenes resultantes en el bucket de origen. e2J1Y2tldH0 es el valor codificado en Base64 de {bucket}.

  • o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw: Guarda el objeto en el directorio doc_images. La clave del objeto usa la variable {index}, que corresponde al número de página de example.docx. ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw es el valor codificado en Base64 de doc_images/{index}.png.

POST /exmaple.docx?x-oss-async-process HTTP/1.1
Host: doc-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
 // Converts pages 1 to 10 of the example.docx object to PNG images. The processed objects are saved to oss://source-bucket/doc_images/page-number.png.
x-oss-async-process=doc/convert,pages_MS0xMA,target_png,source_docx|sys/saveas,b_e2J1Y2tldH0,o_ZG9jX2ltYWdlcy97aW5kZXh9LnBuZw

Ejemplo 2: Transcodificación de video

Este ejemplo demuestra cómo transcodificar el objeto example.avi mediante la configuración de múltiples parámetros de procesamiento.

• f_mp4: Establece el contenedor del archivo de medios transcodificado en MP4.

• vcodec_h265: Establece el formato de la secuencia de video en H.265.

• s_1920x1080: Establece la resolución en 1920x1080.

• vb_2000000: Establece la tasa de bits de video en 2 Mbps.

• fps_30: Establece la tasa de fotogramas de video en 30 fps.

• acodec_aac: Establece el formato de codificación de audio en AAC.

• ab_100000: Establece la tasa de bits de audio en 100 Kbps.

• sn_1: Deshabilita la secuencia de subtítulos.

• sys/saveas: Guardar como.

  • b_e2J1Y2tldH0: Una vez completada la transcodificación, el objeto resultante se guarda en el bucket de origen mediante la variable {bucket}. e2J1Y2tldH0 es el valor codificado en Base64 de {bucket}.

  • o_b3V0cHV0LnthdXRvZXh0fQ: La variable {autoext} agrega automáticamente una extensión al objeto, lo que da como resultado un objeto guardado con el nombre output.mp4. b3V0cHV0LnthdXRvZXh0fQ es el valor codificado en Base64 de output.{autoext}.

POST /exmaple.avi?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-async-process=video/convert,f_mp4,vcodec_h265,s_1920x1080,vb_2000000,fps_30,acodec_aac,ab_100000,sn_1|sys/saveas,b_e2J1Y2tldH0,o_b3V0cHV0LnthdXRvZXh0fQ