Streaming Endpoints - Create

Criar StreamingEndpoint
Cria um ponto de extremidade de streaming.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/streamingEndpoints/{streamingEndpointName}?api-version=2020-05-01
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/streamingEndpoints/{streamingEndpointName}?api-version=2020-05-01&autoStart={autoStart}

Parâmetros de URI

Name In Required Type Description
accountName
path True
  • string

O Serviços de Mídia da conta.

resourceGroupName
path True
  • string

O nome do grupo de recursos dentro da assinatura do Azure.

streamingEndpointName
path True
  • string

O nome do ponto de extremidade de streaming, comprimento máximo é 24.

Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

subscriptionId
path True
  • string

O identificador exclusivo de uma Microsoft Azure assinatura.

api-version
query True
  • string

A versão da API a ser usada com a solicitação do cliente.

autoStart
query
  • boolean

O sinalizador indica se o recurso deve ser iniciado automaticamente na criação.

Corpo da solicitação

Name Required Type Description
location True
  • string

A localização geográfica em que o recurso reside

properties.scaleUnits True
  • integer

O número de unidades de escala. Use a operação Escala para ajustar esse valor.

properties.accessControl

A definição de controle de acesso do ponto de extremidade de streaming.

properties.availabilitySetName
  • string

Esse recurso foi preterido, não de definido um valor para essa propriedade.

properties.cdnEnabled
  • boolean

O CDN habilitado.

properties.cdnProfile
  • string

O nome CDN do perfil.

properties.cdnProvider
  • string

O CDN do provedor.

properties.crossSiteAccessPolicies

As políticas de acesso do ponto de extremidade de streaming.

properties.customHostNames
  • string[]

Os nomes de host personalizados do ponto de extremidade de streaming

properties.description
  • string

A descrição do ponto de extremidade de streaming.

properties.maxCacheAge
  • integer

Idade máxima do cache

tags
  • object

Marcas de recurso.

Respostas

Name Type Description
200 OK

OK. A solicitação foi bem-sucedida.

201 Created

Criado. A solicitação foi aceita para processamento e a operação será concluída de forma assíncrona. Consulte https://go.microsoft.com/fwlink/?linkid=2087017 para obter detalhes sobre como monitorar operações assíncronas do Azure usando o Azure-AsyncOperation de resposta.

Other Status Codes

A resposta de erro de streaming que descreve por que a operação falhou.

Exemplos

Create a streaming endpoint

Sample Request

PUT https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingEndpoints/myStreamingEndpoint1?api-version=2020-05-01
{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "scaleUnits": 1,
    "availabilitySetName": "availableset",
    "accessControl": {
      "akamai": {
        "akamaiSignatureHeaderAuthenticationKeyList": [
          {
            "identifier": "id1",
            "expiration": "2029-12-31T16:00:00-08:00",
            "base64Key": "dGVzdGlkMQ=="
          },
          {
            "identifier": "id2",
            "expiration": "2030-12-31T16:00:00-08:00",
            "base64Key": "dGVzdGlkMQ=="
          }
        ]
      },
      "ip": {
        "allow": [
          {
            "name": "AllowedIp",
            "address": "192.168.1.1"
          }
        ]
      }
    },
    "cdnEnabled": false
  }
}

Sample Response

{
  "name": "myStreamingEndpoint1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1",
  "type": "Microsoft.Media/mediaservices/streamingEndpoints",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "scaleUnits": 1,
    "availabilitySetName": "availableset",
    "cdnEnabled": false,
    "cdnProvider": null,
    "cdnProfile": "",
    "customHostNames": [],
    "accessControl": {
      "akamai": {
        "akamaiSignatureHeaderAuthenticationKeyList": [
          {
            "identifier": "id1",
            "expiration": "2030-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          },
          {
            "identifier": "id2",
            "expiration": "2031-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          }
        ]
      },
      "ip": {
        "allow": [
          {
            "name": "AllowedIp",
            "address": "192.168.1.1",
            "subnetPrefixLength": null
          }
        ]
      }
    },
    "maxCacheAge": null,
    "hostName": "mystreamingendpoint1-slitestmedia10.streaming.mediaservices.windows.net",
    "freeTrialEndTime": "0001-01-01T00:00:00-08:00",
    "provisioningState": "InProgress",
    "resourceState": "Creating",
    "created": "2018-03-03T02:25:09.7561389Z",
    "lastModified": "2018-03-03T02:25:09.7561389Z"
  }
}
{
  "name": "myStreamingEndpoint1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1",
  "type": "Microsoft.Media/mediaservices/streamingEndpoints",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "scaleUnits": 1,
    "availabilitySetName": "availableset",
    "cdnEnabled": false,
    "cdnProvider": null,
    "cdnProfile": "",
    "customHostNames": [],
    "accessControl": {
      "akamai": {
        "akamaiSignatureHeaderAuthenticationKeyList": [
          {
            "identifier": "id1",
            "expiration": "2030-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          },
          {
            "identifier": "id2",
            "expiration": "2031-01-01T00:00:00Z",
            "base64Key": "dGVzdGlkMQ=="
          }
        ]
      },
      "ip": {
        "allow": [
          {
            "name": "AllowedIp",
            "address": "192.168.1.1",
            "subnetPrefixLength": null
          }
        ]
      }
    },
    "maxCacheAge": null,
    "hostName": "mystreamingendpoint1-slitestmedia10.streaming.mediaservices.windows.net",
    "freeTrialEndTime": "0001-01-01T00:00:00-08:00",
    "provisioningState": "Succeeded",
    "resourceState": "Stopped",
    "created": "2018-03-03T02:25:09.7561389Z",
    "lastModified": "2018-03-03T02:25:09.7561389Z"
  }
}

Definições

AkamaiAccessControl

Controle de acesso do Akamai

AkamaiSignatureHeaderAuthenticationKey

Chave de autenticação do Akamai Signature Header.

ApiError

O erro de API.

createdByType

O tipo de identidade que criou o recurso.

CrossSiteAccessPolicies

A política de acesso do cliente.

IPAccessControl

O controle de acesso IP.

IPRange

O intervalo de endereços IP no esquema CIDR.

ODataError

Informações sobre um erro.

StreamingEndpoint

O ponto de extremidade de streaming.

StreamingEndpointAccessControl

Definição de controle de acesso do ponto de extremidade de streaming.

StreamingEndpointResourceState

O estado do recurso do ponto de extremidade de streaming.

systemData

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

AkamaiAccessControl

Controle de acesso do Akamai

Name Type Description
akamaiSignatureHeaderAuthenticationKeyList

lista de chaves de autenticação

AkamaiSignatureHeaderAuthenticationKey

Chave de autenticação do Akamai Signature Header.

Name Type Description
base64Key
  • string

chave de autenticação

expiration
  • string

O tempo de expiração da chave de autenticação.

identifier
  • string

identificador da chave

ApiError

O erro de API.

Name Type Description
error

As propriedades de erro.

createdByType

O tipo de identidade que criou o recurso.

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

CrossSiteAccessPolicies

A política de acesso do cliente.

Name Type Description
clientAccessPolicy
  • string

O conteúdo de clientaccesspolicy.xml usado pelo Silverlight.

crossDomainPolicy
  • string

O conteúdo de crossdomain.xml usado pelo Silverlight.

IPAccessControl

O controle de acesso IP.

Name Type Description
allow

A lista de permitir IP.

IPRange

O intervalo de endereços IP no esquema CIDR.

Name Type Description
address
  • string

O endereço IP.

name
  • string

O nome amigável para o intervalo de endereços IP.

subnetPrefixLength
  • integer

O comprimento do prefixo da máscara de sub-rede (consulte notação CIDR).

ODataError

Informações sobre um erro.

Name Type Description
code
  • string

Um nome de erro independente de idioma.

details

Os detalhes do erro.

message
  • string

A mensagem de erro.

target
  • string

O destino do erro (por exemplo, o nome da propriedade em erro).

StreamingEndpoint

O ponto de extremidade de streaming.

Name Type Description
id
  • string

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

location
  • string

A localização geográfica em que o recurso reside

name
  • string

O nome do recurso

properties.accessControl

A definição de controle de acesso do ponto de extremidade de streaming.

properties.availabilitySetName
  • string

Esse recurso foi preterido, não de definido um valor para essa propriedade.

properties.cdnEnabled
  • boolean

O CDN habilitado.

properties.cdnProfile
  • string

O nome CDN do perfil.

properties.cdnProvider
  • string

O CDN do provedor.

properties.created
  • string

A hora exata em que o ponto de extremidade de streaming foi criado.

properties.crossSiteAccessPolicies

As políticas de acesso do ponto de extremidade de streaming.

properties.customHostNames
  • string[]

Os nomes de host personalizados do ponto de extremidade de streaming

properties.description
  • string

A descrição do ponto de extremidade de streaming.

properties.freeTrialEndTime
  • string

O tempo de expiração da avaliação gratuita.

properties.hostName
  • string

O nome do host do ponto de extremidade de streaming.

properties.lastModified
  • string

A hora exata em que o ponto de extremidade de streaming foi modificado pela última vez.

properties.maxCacheAge
  • integer

Idade máxima do cache

properties.provisioningState
  • string

O estado de provisionamento do ponto de extremidade de streaming.

properties.resourceState

O estado do recurso do ponto de extremidade de streaming.

properties.scaleUnits
  • integer

O número de unidades de escala. Use a operação Escala para ajustar esse valor.

systemData

Os metadados do sistema relacionados a esse recurso.

tags
  • object

Marcas de recurso.

type
  • string

Tipo do recurso. Por ex.: "Microsoft.Compute/virtualMachines" ou "Microsoft. Armazenamento/storageAccounts"

StreamingEndpointAccessControl

Definição de controle de acesso do ponto de extremidade de streaming.

Name Type Description
akamai

O controle de acesso do Akamai

ip

O controle de acesso IP do ponto de extremidade de streaming.

StreamingEndpointResourceState

O estado do recurso do ponto de extremidade de streaming.

Name Type Description
Deleting
  • string

O ponto de extremidade de streaming está sendo excluído.

Running
  • string

O ponto de extremidade de streaming está em execução. Ele é capaz de transmitir conteúdo para clientes

Scaling
  • string

O ponto de extremidade de streaming está aumentando ou diminuindo unidades de escala.

Starting
  • string

O ponto de extremidade de streaming está em transição para o estado de execução.

Stopped
  • string

O estado inicial de um ponto de extremidade de streaming após a criação. O conteúdo não está pronto para ser transmitido desse ponto de extremidade.

Stopping
  • string

O ponto de extremidade de streaming está fazendo transição para o estado parado.

systemData

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

Name Type Description
createdAt
  • string

O 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 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.