Share via

AssetFile

  • Artículo

La entidad AssetFile representa un archivo de vídeo o audio real almacenado en un contenedor blob. Un archivo de recursos siempre está asociado con un recurso y un recurso puede contener uno o varios archivos. La tarea de Media Services produce un error si un objeto de archivo de recursos no está asociado a un archivo digital de un contenedor de blobs.

En este tema encontrará un resumen de la entidad AssetFile y una demostración de cómo ejecutar distintas operaciones con la API de REST de Media Services.

Importante

Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración del desarrollo de la API de REST de Media Services y Conexión a Media Services con la API de REST de Media Services.

Propiedades de la entidad AssetFile

Propiedad Tipo Descripción
Id

Solo lectura. Se establece por Media Services en el momento de la creación.		 Edm.String Identificador único.
Name

Necesario.		 Edm.String Nombre descriptivo para AssetFile. El valor predeterminado es el nombre de archivo usado durante la carga de archivos. La longitud máxima es 260. Nota: Media Services usa el valor de la Name propiedad al compilar direcciones URL para el contenido de streaming (por ejemplo, http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters). Por este motivo, no se permite la codificación porcentual. El valor de la propiedad Name no puede tener ninguno de los siguientes caracteres reservados para la codificación porcentual: !*'();:@&=+$,/?%#[]". Además, solo puede haber un "." Además, solo puede haber un '.' para la extensión del nombre de archivo.
ContentFileSize

Opcional.		 Edm.Int64 Tamaño de AssetFile (en bytes) del contenido.
ParentAssetId

Necesario. No se puede actualizar después de la creación de la entidad.		 Edm.String Identificador del recurso al que está asociado el archivo.
EncryptionVersion

Opcional.		 Edm.String La versión actual compatible con StorageEncryption y CommonEncryption es "1.0"
EncryptionScheme

Opcional.		 Edm.String Esquema de cifrado usado para el archivo. Los valores válidos son: "StorageEncryption" o "CommonEncryption".
IsEncrypted

Opcional.		 Edm.Boolean Este valor debe configurarse como true si el archivo está cifrado y almacenado.
EncryptionKeyId

Opcional.		 Edm.String Identificador de ContentKey cifrado.
InitializationVector

Opcional.		 Edm.String Vector de inicialización que se usa para el cifrado de almacenamiento.
IsPrimary

Opcional.		 Edm.Boolean Determina si se trata del archivo principal de un recurso con varios archivos.
LastModified

Solo lectura. Se establece por Media Services en el momento de la creación.		 Edm.DateTime Media Services actualiza este valor después de realizar cualquier cambio de propiedad. Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
Created

Solo lectura. Se establece por Media Services en el momento de la creación.		 Edm.DateTime Representa el número de milisegundos desde la medianoche del 1 de enero de 1970.
MimeType

Opcional.		 Edm.String Media Services no inspecciona los blobs que se cargan, de modo que debe definir el tipo MIME manualmente. Por ejemplo, "text/plain" o "video/x-ms-wmv" son valores válidos que se pueden usar. La longitud máxima es 4000.
ContentChecksum

Opcional.		 Edm.String Un número hexadecimal que representa un valor implícito de mensaje MD5 (RFC 1321). El cliente o la biblioteca del cliente define el valor para que sirva de validación de la carga correcta de contenido. La longitud máxima es 4000.

Creación de AssetFile

La función CreateFileInfos se usa para crear una entidad AssetFile nueva. Para obtener más información, consulte Funciones de la API rest.

Lista de AssetFiles

Los AssetFiles se recuperan mediante una solicitud HTTP GET.

Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files> HTTP/1.1
Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1
Método URI de solicitud Versión HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net

Actualización de AssetFile

Los AssetFiles se actualizan a través de la solicitud MERGE HTTP.

Método URI de solicitud Versión HTTP
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Content-Length: 27  
Expect: 100-continue  
  
{"MimeType" : "video/mp4" }

Eliminación de AssetFile

Los AssetFiles se eliminan cuando se elimina su recurso asociado. Para obtener un ejemplo, vea Eliminar un recurso.

Consulte también

ContentKey
Recurso
AccessPolicy
Trabajo
JobTemplate
Localizador
MediaProcessor
Task
TaskTemplate
Cuotas y limitaciones