Exportar (0) Imprimir
Expandir todo

Activo

Actualizado: noviembre de 2014

La entidad Asset contiene archivos digitales (como vídeos, audio, imágenes, colecciones de miniaturas, pistas de texto y subtítulos) y metadatos de estos archivos. Una vez cargados los archivos digitales en un recurso, se podrían utilizar en los flujos de trabajo de codificación y streaming de Servicios multimedia.

Cuando codifica un recurso, se produce un recurso de salida al finalizar el trabajo de codificación. Entre los archivos mencionados anteriormente, el recurso de salida contiene archivos de metadatos XML que describen el recurso de entrada y el recurso de salida. Para más información, vea los temas Metadatos de entrada y Metadatos de salida.

En Media Services, un Asset presenta las características siguientes:
Un Asset es una unidad lógica que representa una única presentación audiovisual.

Un Asset contiene una colección de uno o varios archivos multimedia.

Los archivos de un Asset se encuentran en un único contenedor de almacenamiento blobs.

Algunos ejemplos de Asset son: una película, un programa de televisión o una edición específica completos; un clip de una película, un programa de televisión, una animación, un archivo ISO de cámara, un evento; un tráiler de una película o un vídeo promocional; un anuncio, un archivo de audio, un programa de radio, un podcast o un archivo de sonido.

En Media Services, un Asset NO presenta las características siguientes:
Un simple contenedor de almacenamiento

Una carpeta para organizar y almacenar varias versiones de la misma presentación

Una carpeta para enviar el procesamiento por lotes de varias presentaciones audiovisuales a Azure Media Encoder

Por ejemplo, no debe almacenar una película, su tráiler, un anuncio y una versión de edición internacional de la misma película en un único Asset.

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

ImportantImportante
Al trabajar con la API de REST de Servicios multimedia, tenga en cuenta las consideraciones siguientes:

 

Propiedad Tipo Descripción

Id

De solo lectura. Definida por Media Services en el momento de la creación.

Cadena

Identificador único.

State

De solo lectura. Definida por Media Services.

Edm.Int32

Valor de enumeración que describe el estado del recurso. Los valores válidos son:

  • Initialized = 0

  • Published = 1

    WarningAdvertencia
    La acción Publish está en desuso. Quite el código que comprueba si un recurso tiene el estado Published.

  • Eliminado = 2

Un recurso siempre se encuentra en un estado inicializado hasta que se elimina.

Created

De solo lectura. Definida por Media Services en el momento de la creación.

Edm.DateTime

Media Services define este valor en el momento de la creación.

LastModified

De solo lectura. Definida por Media Services.

Edm.DateTime

Media Services actualiza este valor cuando se aplican cambios de propiedad.

AlternateId

Opcional.

Edm.String

Valor de identificador alternativo que se corresponde con un identificador de otro sistema de administración de contenido. La longitud máxima es 4000.

Name

Opcional.

Edm.String

Nombre descriptivo del recurso. La longitud máxima es 4000.

Options

Requerido. No se puede actualizar después de la creación de la entidad.

Edm.Int32

Valor de enumeración que describe las opciones de cifrado con las que se puede crear un Asset. A continuación se incluyen los valores válidos, que no se pueden combinar:

  • None = 0: No se especifican opciones de creación de recursos.

  • StorageEncrypted = 1: Especifica que los archivos de un recurso se deben cifrar para la carga y el almacenamiento al crear el recurso.

  • CommonEncryptionProtected = 2: Especifica que los archivos de un recurso están protegidos con un método de cifrado común (por ejemplo, PlayReady).

  • EnvelopeEncryptionProtected = 4

Uri

De solo lectura. Definida por Media Services.

Edm.String

El Uri del contenedor de almacenamiento de blob del recurso específico.

Locators

De solo lectura. Definida por Media Services.

Conjunto de entidades Locator

El conjunto de entidades devuelto contiene todas las entidades Locator vinculadas al Asset especificado.

ContentKeys

Opcional.

Conjunto de entidades ContentKey

El conjunto de entidades devuelto contiene todas las entidades ContentKey vinculadas al Asset especificado.

Files

De solo lectura. Definida por Media Services.

Conjunto de entidades File

El conjunto de entidades devuelto contiene todas las entidades File vinculadas al Asset especificado.

ParentAssets

Opcional.

Conjunto de entidades de recursos principales

El conjunto de entidades devuelto contiene todas las entidades del recurso principal vinculadas al recurso especificado.

StorageAccountName

Opcional. No se puede actualizar después de la creación de la entidad.

Edm.String

Nombre de la cuenta de almacenamiento que contiene el contenedor blob del recurso.

Si no se especifica en el momento de la creación, Media Services define el nombre de la cuenta de almacenamiento predeterminado.

StorageAccount

De solo lectura. Definida por Media Services.

Conjunto de entidades StorageAccount

El conjunto de entidades devuelto contiene todas las entidades StorageAccount vinculadas al recurso especificado.

DeliveryPolicies

Conjunto de entidades AssetDeliveryPolicy

El conjunto de entidades devuelto contiene directivas de entrega asociadas al activo.

Para crear Assets, puede usar una solicitud HTTP POST y especificar valores de propiedad.

 

Método URI de solicitud Versión de HTTP

POST

https://media.windows.net/API/Assets

HTTP/1.1

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

POST https://media.windows.net/API/Assets HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 27
Expect: 100-continue

{ "Name" : "NewJSONAsset" }

Para recuperar Assets, use una solicitud HTTP GET.

 

Método URI de solicitud Versión de HTTP

GET

https://media.windows.net/API/Assets

HTTP/1.1

 

Método URI de solicitud Versión de HTTP

GET

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

GET https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0


Para actualizar Assets, use una solicitud HTTP MERGE y las propiedades específicas que desee cambiar.

 

Método URI de solicitud Versión de HTTP

MERGE

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

MERGE https://media.windows.net/API/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337083279&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=DMLQXWah4jO0icpfwyws5k%2b1aCDfz9KDGIGao20xk6g%3d
Host: media.windows.net
Content-Length: 21
Expect: 100-continue

{"Name" : "NewName" }

Para eliminar Assets, puede hacer referencia al valor de identificador de Asset. Al eliminar un recurso, Servicios multimedia de Microsoft Azure elimina todos sus localizadores. Si el recurso tenía localizadores de origen, estos también se revocarán y eliminarán. Todos los vínculos a ContentKeys se eliminarán, así como cualquier ContentKey que no esté vinculada a otros recursos.

 

Método URI de solicitud Versión de HTTP

DELETE

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0


noteNota
La acción Publish está en desuso. A partir de la última versión de Media Services, no se debe usar Publish.

Si el código usa Publish, tenga en cuenta las consideraciones siguientes:

  1. La acción Publish no elimina los localizadores asociados al recurso. Debe eliminar los localizadores del código explícitamente después de llamar a Publish.

  2. La acción Publish no define el estado del recurso como Published. Quite el código que comprueba si un recurso tiene el estado Published. Actualmente, un recurso solo puede tener el estado Initialized o Deleted.

Para vincular una ContentKey a un recurso, haga referencia al identificador del recurso mediante una solicitud HTTP POST. Debe incluir el URI de ContentKey en el cuerpo de la solicitud. Solo puede vincular un tipo de ContentKey que coincida con el tipo especificado en la sección CreationOptions del recurso. Por ejemplo, si el Asset tiene opciones definidas como StorageEncrypted(1), el tipo de ContentKey debe ser StorageEncryption(1).

 

Método URI de solicitud Versión de HTTP

POST

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys

HTTP/1.1

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

POST https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 121
Expect: 100-continue

{ "uri": "https://media.windows.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

Para quitar vínculos de ContentKey de un recurso, haga referencia al identificador de recurso y de ContentKey en una solicitud HTTP DELETE. Si ContentKey no está vinculada a ningún otro recurso, se eliminará.

 

Método URI de solicitud Versión de HTTP

DELETE

https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys('ContentKey Id')

HTTP/1.1

ImportantImportante
Después de conectarse correctamente a https://media.windows.net, recibirá una redirección 301 que especifica otro URI de Servicios multimedia. Debe realizar llamadas subsecuentes a la nueva URI.

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.7
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 0

Vea también

Mostrar:
© 2014 Microsoft