Recurso

Artigo
08/05/2023

A Asset entidade contém ficheiros digitais (incluindo vídeo, áudio, imagens, coleções de miniaturas, faixas de texto e ficheiros de legenda fechados) e os metadados sobre estes ficheiros. Depois de os ficheiros digitais serem carregados para um recurso, podem ser utilizados nos fluxos de trabalho de codificação e transmissão em fluxo dos Serviços de Multimédia.

Quando codifica um recurso, é produzido um recurso de saída após a conclusão da tarefa de codificação. Entre os ficheiros mencionados acima, o recurso de saída contém ficheiros de metadados XML que descrevem o recurso de entrada e o recurso de saída. Para obter mais informações, veja os artigos Metadados de Entrada e Metadados de Saída .

As seguintes características aplicam-se a um Recurso nos Serviços de Multimédia:

Um Recurso é uma unidade lógica que representa uma única apresentação audiovisual.
Um recurso contém uma coleção de um a muitos ficheiros de multimédia.
Os ficheiros de um recurso estão localizados num único contentor de armazenamento de blobs.

Alguns exemplos de um Recurso são: um filme completo, programa de TV, edição específica; um clip de um filme, programa de TV, animação, ficheiro ISO da câmara ou evento; um trailer de filme ou vídeo promocional; um anúncio; um ficheiro de áudio, um programa de rádio, um podcast ou um ficheiro de som.

As seguintes características NÃO se aplicam a um Recurso nos Serviços de Multimédia:

Simplesmente um contentor de armazenamento
Uma pasta para organizar e armazenar várias versões da mesma apresentação no
Uma pasta para submeter o processamento em lotes de múltiplas apresentações audiovisuais para o Codificador de Multimédia do Azure

Por exemplo, não pode armazenar um filme, o respetivo trailer, um anúncio e uma versão de edição internacional do mesmo filme num único Recurso.

Este tópico fornece uma descrição geral da Asset entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades da Entidade de Recurso

Propriedade	Tipo	Description
`Id` Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.	String	Identificador exclusivo.
`State` Só de leitura. Definido pelos Serviços de Multimédia.	Edm.Int32	Um valor de enumeração que descreve o estado do recurso. Os valores dos valores são: - Inicializado = 0 - Publicado = 1 Aviso: a `Publish` ação foi preterida. Remova o código que verifica se um recurso está no `Published` estado . - Eliminado = 2 Um recurso está sempre no estado Inicializado até ser eliminado.
`Created` Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.	Edm.DateTime	Este valor é definido pelos Serviços de Multimédia no momento da criação.
`LastModified` Só de leitura. Definido pelos Serviços de Multimédia.	Edm.DateTime	Este valor é atualizado pelos Serviços de Multimédia depois de serem efetuadas alterações de propriedade.
`AlternateId` Opcional.	Edm.String	Um valor de ID alternativo que corresponde a um ID noutro sistema de gestão de conteúdos. O comprimento máximo é 4000.
`Name` Opcional.	Edm.String	Nome amigável para o seu elemento. O comprimento máximo é 512.
`Options` Obrigatório. Não é possível atualizar após a criação da entidade.	Edm.Int32	Um valor de enumeração que descreve as opções de encriptação com as quais um Recurso pode ser criado. Um valor válido é um valor da lista abaixo, não uma combinação de valores desta lista: - Nenhum = 0: não especifica opções de criação de recursos. - StorageEncrypted = 1: especifica que os ficheiros de um recurso devem ser encriptados para carregamento e armazenamento ao criar o recurso. - CommonEncryptionProtected = 2: especifica que os ficheiros de um recurso estão protegidos através de um método de encriptação comum (como o PlayReady). - EnvelopeEncryptionProtected = 4
`Uri` Só de leitura. Definido pelos Serviços de Multimédia.	Edm.String	O URI do contentor de armazenamento de blobs do Recurso especificado.
`Locators` Só de leitura. Definido pelos Serviços de Multimédia.	Conjunto de entidades do localizador	O conjunto de entidades devolvido contém todas as entidades Localizador que estão ligadas ao Recurso especificado.
`ContentKeys` Opcional.	Conjunto de entidades ContentKey	O conjunto de entidades devolvido contém todas as entidades ContentKey que estão ligadas ao Recurso especificado.
`Files` Só de leitura. Definido pelos Serviços de Multimédia.	Conjunto de entidades de ficheiros	O conjunto de entidades devolvido contém todas as entidades ficheiro que estão ligadas ao Recurso especificado.
`ParentAssets` Opcional.	Conjunto de entidades de Recursos Principais	O conjunto de entidades devolvidas contém todas as entidades de Recursos principais que estão ligadas ao Recurso especificado.
`StorageAccountName` Opcional. Não é possível atualizar após a criação da entidade.	Edm.String	Nome da conta de armazenamento que contém o contentor de blobs do recurso. Se não for especificado no momento da criação, os Serviços de Multimédia definem o nome da conta de armazenamento predefinido.
`StorageAccount` Só de leitura. Definido pelos Serviços de Multimédia.	Conjunto de entidades StorageAccount	O conjunto de entidades devolvido contém todas as entidades StorageAccount que estão ligadas ao Recurso especificado.
`DeliveryPolicies`	Conjunto de entidades AssetDeliveryPolicy	O conjunto de entidades devolvido contém políticas de entrega associadas ao recurso.
`FormatOption`	Edm.Int32	Especifica diferentes opções de formato com as quais um recurso pode ser criado. Os valores permitidos são: 0 (predefinição) - especifica nenhuma opção de formato de recurso; 1 - especifica que o formato de um recurso será AdaptiveStreaming.

Criar um Elemento

Os recursos podem ser criados com um pedido POST HTTP e especificar valores de propriedade.

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>	HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

POST https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization:  Bearer <token value>  
Host: media.windows.net  
Content-Length: 27  
Expect: 100-continue  
  
{ "Name" : "NewJSONAsset" }

Listar um Recurso

Os recursos podem ser obtidos com um pedido GET HTTP.

Método	URI do pedido	Versão HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>	HTTP/1.1

Método	URI do pedido	Versão HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')	HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

GET https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Atualizar um Recurso

Os recursos podem ser atualizados com um pedido HTTP MERGE e as propriedades específicas que pretende alterar.

Método	URI do pedido	Versão HTTP
INTERCALAR	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')	HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

MERGE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 21  
Expect: 100-continue  
  
{"Name" : "NewName" }

Eliminar um Recurso

Os recursos podem ser eliminados ao referenciar o valor ID do Recurso. Quando um recurso é eliminado, todos os respetivos localizadores são eliminados por Serviços de Multimédia do Microsoft Azure. Se o recurso tiver localizadores de origem, estes localizadores também serão revogados e eliminados. Todas as ligações para ContentKeys serão eliminadas e quaisquer ContentKeys não ligados a outros recursos serão eliminados.

Método	URI do pedido	Versão HTTP
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')	HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

DELETE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Publicar um Recurso

Nota

A Publish ação foi preterida. A partir da versão mais recente dos Serviços de Multimédia, Publish não deve ser utilizado.

Se o código utilizar Publish, tenha em atenção as seguintes considerações:

A Publish ação não elimina localizadores associados ao recurso. Tem de eliminar explicitamente os localizadores no código depois de chamar Publish.
A Publish ação não define o estado do recurso como Published. Remova o código que verifica se um recurso está no Published estado. Atualmente, um recurso só pode ter o Initialized estado ou Deleted .

Associar Chaves de Conteúdo a Recursos

Pode associar uma Chave de Conteúdo a um recurso ao referenciar o ID do recurso com um pedido HTTP POST. O Uri da Chave de Conteúdo tem de ser incluído no corpo do pedido. Só pode ligar um tipo ContentKey que corresponda ao tipo especificado nas CreationOptions do recurso. Por exemplo, se o Recurso tiver opções definidas como StorageEncrypted(1), a Chave de Conteúdo tem de ser do tipo StorageEncryption(1).

Método	URI do pedido	Versão HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('ID do Recurso')/$links/ContentKeys	HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

POST https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 121  
Expect: 100-continue  
  
{ "uri": "https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

Remover Ligações ContentKey

Pode remover ligações ContentKey de um recurso ao referenciar o ID do recurso e o ID ContentKey num pedido HTTP DELETE. Se a Chave de Conteúdo não estiver ligada a outros recursos, será eliminada.

Método	URI do pedido	Versão HTTP
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('ID do Recurso')/$links/ContentKeys('ID contentKey')	HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

DELETE https://<accountname>.restv2.<location>.media.azure.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.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Consulte também

AccessPolicy
ContentKey
AssetFile
Tarefa
JobTemplate
Localizador
MediaProcessor
Tarefa
TaskTemplate
Ingerir Recursos com a API REST dos Serviços de Multimédia
Quotas e Limitações

Partilhar via

Recurso

Propriedades da Entidade de Recurso

Criar um Elemento

Pedido de Amostra

Listar um Recurso

Pedido de Amostra

Atualizar um Recurso

Pedido de Amostra

Eliminar um Recurso

Pedido de Amostra

Publicar um Recurso

Associar Chaves de Conteúdo a Recursos

Pedido de Amostra

Remover Ligações ContentKey

Pedido de Amostra

Consulte também

Recursos adicionais