Videos - Create Or Update

Cria um novo recurso de vídeo ou atualiza um existente.
Cria um novo recurso de vídeo ou atualiza um recurso de vídeo existente com o nome fornecido.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/videoAnalyzers/{accountName}/videos/{videoName}?api-version=2021-11-01-preview

Parâmetros de URI

Name In Required Type Description
accountName
path True
  • string

O nome da conta do Analisador de Vídeo do Azure.

resourceGroupName
path True
  • string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

subscriptionId
path True
  • string

A ID da assinatura de destino.

videoName
path True
  • string

O nome do vídeo.

api-version
query True
  • string

A versão da API a ser usada para essa operação.

Corpo da solicitação

Name Type Description
properties.archival

Propriedades de arquivamento de vídeo.

properties.description
  • string

Descrição de vídeo opcional fornecida pelo usuário. O valor pode ter até 2048 caracteres.

properties.mediaInfo

Contém informações sobre o conteúdo de áudio e vídeo.

properties.title
  • string

Título de vídeo opcional fornecido pelo usuário. O valor pode ter até 256 caracteres.

Respostas

Name Type Description
200 OK

OK

201 Created

Criado

Other Status Codes

Informações detalhadas de erro.

Exemplos

Register video entity.

Sample Request

PUT https://management.azure.com/subscriptions/591e76c3-3e97-44db-879c-3e2b12961b62/resourceGroups/testrg/providers/Microsoft.Media/videoAnalyzers/testaccount2/videos/video1?api-version=2021-11-01-preview

{
  "properties": {
    "title": "Sample Title 1",
    "description": "Sample Description 1"
  }
}

Sample Response

{
  "name": "video2",
  "id": "/subscriptions/591e76c3-3e97-44db-879c-3e2b12961b62/resourceGroups/testrg/providers/Microsoft.Media/videoAnalyzers/testaccount2/videos/video2",
  "type": "Microsoft.Media/videoAnalyzers/videos",
  "properties": {
    "title": "Sample Title 1",
    "description": "Sample Description 1",
    "type": "Archive",
    "flags": {
      "canStream": false,
      "hasData": false,
      "isInUse": false
    },
    "archival": {
      "retentionPeriod": "P7D"
    }
  },
  "systemData": {
    "createdBy": "user@microsoft.com",
    "createdByType": "User",
    "createdAt": "0001-01-01T00:00:00Z",
    "lastModifiedBy": "user@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "0001-01-01T00:00:00Z"
  }
}
{
  "name": "video1",
  "id": "/subscriptions/591e76c3-3e97-44db-879c-3e2b12961b62/resourceGroups/testrg/providers/Microsoft.Media/videoAnalyzers/testaccount2/videos/video1",
  "type": "Microsoft.Media/videoAnalyzers/videos",
  "properties": {
    "title": "Sample Title 1",
    "description": "Sample Description 1",
    "type": "Archive",
    "flags": {
      "canStream": true,
      "hasData": true,
      "isInUse": false
    },
    "contentUrls": {
      "downloadUrl": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/content.mp4",
      "archiveBaseUrl": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/content.ism",
      "rtspTunnelUrl": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62",
      "previewImageUrls": {
        "small": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/images/latest/small.jpg",
        "medium": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/images/latest/medium.jpg",
        "large": "https://591e76c33e9744db879c3e2b12961b62.streaming.westus.videoanalyzer.net/591e76c33e9744db879c3e2b12961b62/images/latest/large.jpg"
      }
    },
    "mediaInfo": {
      "segmentLength": "PT30S"
    },
    "archival": {
      "retentionPeriod": "P7D"
    }
  },
  "systemData": {
    "createdBy": "user@microsoft.com",
    "createdByType": "User",
    "createdAt": "0001-01-01T00:00:00Z",
    "lastModifiedBy": "user@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "0001-01-01T00:00:00Z"
  }
}

Definições

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais sobre o erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

systemData

Metadados relativos à criação e última modificação do recurso.

VideoArchival

Propriedades de arquivamento de vídeo.

VideoContentUrls

Conjunto de URLs para o conteúdo do vídeo.

VideoEntity

Representa um recurso de vídeo no Analisador de Vídeo do Azure. Os vídeos podem ser ingeridos de câmeras RTSP por meio de pipelines ao vivo ou podem ser criados exportando sequências de vídeo capturado existente por meio de um trabalho de pipeline. Os vídeos ingeridos por meio de pipelines ao vivo podem ser transmitidos por meio do Widget do Player do Analisador de Vídeo do Azure ou de jogadores compatíveis. Vídeos exportados podem ser baixados como arquivos MP4.

VideoFlags

Os sinalizadores de vídeo contêm informações sobre as ações de vídeo disponíveis e suas propriedades dinâmicas com base no estado atual do vídeo.

VideoMediaInfo

Contém informações sobre o conteúdo de áudio e vídeo.

VideoPreviewImageUrls

URLs de imagem de visualização de vídeo. Essas URLs podem ser usadas em conjunto com o token de autorização de conteúdo de vídeo para baixar a imagem ainda mais recente do arquivo de vídeo em resoluções diferentes. Eles estão disponíveis quando o tipo de vídeo é 'archive' e as imagens de visualização estão habilitadas.

VideoType

Tipo de conteúdo de vídeo. Diferentes tipos de conteúdo são adequados para diferentes aplicativos e cenários.

createdByType

O tipo de identidade que criou o recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorAdditionalInfo

As informações adicionais sobre o erro de gerenciamento de recursos.

Name Type Description
info
  • object

As informações adicionais.

type
  • string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Type Description
additionalInfo

As informações adicionais do erro.

code
  • string

O código de erro.

details

Os detalhes do erro.

message
  • string

A mensagem de erro.

target
  • string

O destino do erro.

ErrorResponse

Resposta de erro

Name Type Description
error

O objeto de erro.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Type Description
createdAt
  • string

O carimbo de data/hora da criação de recursos (UTC).

createdBy
  • string

A identidade que criou o recurso.

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt
  • string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy
  • string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

O tipo de identidade que modificou o recurso pela última vez.

VideoArchival

Propriedades de arquivamento de vídeo.

Name Type Description
retentionPeriod
  • string

O período de retenção de vídeo indica a idade máxima dos segmentos de arquivo de vídeo que devem ser mantidos no armazenamento. Ele deve ser fornecido no formato de duração ISO8601 na granularidade de dias, até um máximo de 10 anos. Por exemplo, se isso for definido como P30D (30 dias), o conteúdo com mais de 30 dias será excluído periodicamente. Esse valor pode ser atualizado a qualquer momento e o novo período de retenção desejado entrará em vigor dentro de 24 horas.

VideoContentUrls

Conjunto de URLs para o conteúdo do vídeo.

Name Type Description
archiveBaseUrl
  • string

URL base de streaming de arquivo de vídeo. O conteúdo arquivado pode ser reproduzido automaticamente pelo widget do player do Analisador de Vídeo do Azure. Como alternativa, essa URL pode ser usada em conjunto com o token de autorização de conteúdo de vídeo em qualquer player de DASH ou HLS compatível acrescentando o seguinte à URL base:

- HLSv4:     /manifest(format=m3u8-aapl).m3u8
- HLS CMAF:  /manifest(format=m3u8-cmaf)
- DASH CMAF: /manifest(format=mpd-time-cmaf)

Moreover, an ongoing video recording can be played in "live mode" with latencies which are approximately double of the chosen video segment length. It is available when the video type is 'archive' and video archiving is enabled.
downloadUrl
  • string

URL de download de arquivo de vídeo. Essa URL pode ser usada em conjunto com o token de autorização de conteúdo de vídeo para baixar o arquivo MP4 de vídeo. O arquivo MP4 resultante pode ser reproduzido em qualquer player de mídia padrão. Ele está disponível quando o tipo de vídeo é "arquivo" e o arquivo de vídeo está disponível para consumo.

previewImageUrls

URLs de imagem de visualização de vídeo. Essas URLs podem ser usadas em conjunto com o token de autorização de conteúdo de vídeo para baixar a imagem ainda mais recente do arquivo de vídeo em resoluções diferentes. Eles estão disponíveis quando o tipo de vídeo é 'archive' e as imagens de visualização estão habilitadas.

rtspTunnelUrl
  • string

URL de streaming de baixa latência de vídeo. O conteúdo ao vivo pode ser reproduzido automaticamente pelo widget do player do Analisador de Vídeo do Azure. Como alternativa, essa URL pode ser usada em conjunto com o token de autorização de conteúdo de vídeo para expor um fluxo RTSP em túnel do WebSocket. Ele está disponível quando o tipo de vídeo é 'archive' e um feed dinâmico de baixa latência está disponível na origem.

VideoEntity

Representa um recurso de vídeo no Analisador de Vídeo do Azure. Os vídeos podem ser ingeridos de câmeras RTSP por meio de pipelines ao vivo ou podem ser criados exportando sequências de vídeo capturado existente por meio de um trabalho de pipeline. Os vídeos ingeridos por meio de pipelines ao vivo podem ser transmitidos por meio do Widget do Player do Analisador de Vídeo do Azure ou de jogadores compatíveis. Vídeos exportados podem ser baixados como arquivos MP4.

Name Type Description
id
  • string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

O nome do recurso

properties.archival

Propriedades de arquivamento de vídeo.

properties.contentUrls

Conjunto de URLs para o conteúdo do vídeo.

properties.description
  • string

Descrição de vídeo opcional fornecida pelo usuário. O valor pode ter até 2048 caracteres.

properties.flags

Os sinalizadores de vídeo contêm informações sobre as ações de vídeo disponíveis e suas propriedades dinâmicas com base no estado atual do vídeo.

properties.mediaInfo

Contém informações sobre o conteúdo de áudio e vídeo.

properties.title
  • string

Título de vídeo opcional fornecido pelo usuário. O valor pode ter até 256 caracteres.

properties.type

Tipo de conteúdo de vídeo. Diferentes tipos de conteúdo são adequados para diferentes aplicativos e cenários.

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

type
  • string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft. Armazenamento/storageAccounts"

VideoFlags

Os sinalizadores de vídeo contêm informações sobre as ações de vídeo disponíveis e suas propriedades dinâmicas com base no estado atual do vídeo.

Name Type Description
canStream
  • boolean

Valor que indica se o vídeo pode ou não ser transmitido. Somente vídeos de tipo "arquivar" podem ser transmitidos.

hasData
  • boolean

Valor que indica se houve ou não dados gravados ou carregados no vídeo. Vídeos recém-criados têm esse valor definido como false.

isInUse
  • boolean

Valor que indica se o vídeo está sendo referenciado ou não como um pipeline ativo no momento. O fato de ser referenciado não indica necessariamente que os dados estão sendo recebidos. Por exemplo, a gravação de vídeo pode ser controlada em eventos ou a câmera pode não estar acessível no momento.

VideoMediaInfo

Contém informações sobre o conteúdo de áudio e vídeo.

Name Type Description
segmentLength
  • string

O comprimento do segmento de vídeo indica o comprimento de arquivos de vídeo individuais (segmentos) que são persistidos no armazenamento. Segmentos menores fornecem latência de reprodução de arquivo inferior, mas geram um volume maior de transações de armazenamento. Segmentos maiores reduzem a quantidade de transações de armazenamento, aumentando a latência de reprodução de arquivo morto. O valor deve ser especificado no formato de duração ISO8601 (ou seja, "PT30S" é igual a 30 segundos) e pode variar entre 30 segundos e 5 minutos, em incrementos de 30 segundos.

VideoPreviewImageUrls

URLs de imagem de visualização de vídeo. Essas URLs podem ser usadas em conjunto com o token de autorização de conteúdo de vídeo para baixar a imagem ainda mais recente do arquivo de vídeo em resoluções diferentes. Eles estão disponíveis quando o tipo de vídeo é 'archive' e as imagens de visualização estão habilitadas.

Name Type Description
large
  • string

URL de imagem de visualização de alta resolução.

medium
  • string

URL de imagem de visualização de resolução média.

small
  • string

URL de imagem de visualização de baixa resolução.

VideoType

Tipo de conteúdo de vídeo. Diferentes tipos de conteúdo são adequados para diferentes aplicativos e cenários.

Name Type Description
Archive
  • string

O arquivo morto é um formato flexível que representa um fluxo de vídeo associado ao tempo do relógio de parede. O arquivo de vídeo pode ser contínuo ou descontinuado. Um arquivo é descontinuado quando há lacunas na gravação devido a vários motivos, como o pipeline ao vivo sendo interrompido, a câmera sendo desconectada ou devido ao uso de gravações baseadas em eventos por meio do uso de uma porta de sinal. Não há limite para a duração do arquivo e novos dados de vídeo podem ser acrescentados ao arquivo existente a qualquer momento, desde que os mesmos parâmetros codec e codec de vídeo estejam sendo usados. Vídeos desse tipo são adequados para anexação e arquivamento de longo prazo.

File
  • string

O arquivo representa um vídeo que é armazenado como um único arquivo de mídia, como MP4. Vídeos desse tipo são adequados para serem baixados para consumo externo.