Streaming Endpoints - Create

Serviço:

Media Services

Versão da API:

2022-11-01

Criar StreamingEndpoint
Cria um ponto final de transmissão em fluxo.

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

Com parâmetros opcionais:

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Multimédia.
resourceGroupName	path	True	string	O nome do grupo de recursos na subscrição do Azure.
streamingEndpointName	path	True	string	O nome do ponto final de transmissão em fluxo, comprimento máximo é 24. Padrão Regex: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
subscriptionId	path	True	string	O identificador exclusivo de uma subscrição do Microsoft Azure.
api-version	query	True	string	A versão da API a utilizar com o pedido de cliente.
autoStart	query		boolean	O sinalizador indica se o recurso deve ser iniciado automaticamente na criação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A localização geográfica onde o recurso se encontra
properties.scaleUnits	True	integer	O número de unidades de escala. Utilize a operação Dimensionamento para ajustar este valor.
properties.accessControl		StreamingEndpointAccessControl	A definição de controlo de acesso do ponto final de transmissão em fluxo.
properties.availabilitySetName		string	Esta funcionalidade foi preterida, não defina um valor para esta propriedade.
properties.cdnEnabled		boolean	O sinalizador da CDN ativado.
properties.cdnProfile		string	O nome do perfil da CDN.
properties.cdnProvider		string	O nome do fornecedor da CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	As políticas de acesso a pontos finais de transmissão em fluxo.
properties.customHostNames		string[]	Os nomes de anfitrião personalizados do ponto final de transmissão em fluxo
properties.description		string	A descrição do ponto final de transmissão em fluxo.
properties.maxCacheAge		integer	Idade máxima da cache
sku		ArmStreamingEndpointCurrentSku	O sku do ponto final de transmissão em fluxo.
tags		object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	StreamingEndpoint	OK. O pedido foi bem-sucedido.
201 Created	StreamingEndpoint	Criado. O pedido foi aceite para processamento e a operação será concluída de forma assíncrona. Veja https://go.microsoft.com/fwlink/?linkid=2087017 os detalhes sobre a monitorização de operações assíncronas do Azure com o cabeçalho de resposta Azure-AsyncOperation.
Other Status Codes	ErrorResponse	A resposta a erros de transmissão em fluxo que descreve a razão pela qual a operação falhou.

Exemplos

Create a streaming endpoint

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingEndpoints/myStreamingEndpoint1?api-version=2022-11-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
  }
}

Java

import com.azure.resourcemanager.mediaservices.models.AkamaiAccessControl;
import com.azure.resourcemanager.mediaservices.models.AkamaiSignatureHeaderAuthenticationKey;
import com.azure.resourcemanager.mediaservices.models.IpAccessControl;
import com.azure.resourcemanager.mediaservices.models.IpRange;
import com.azure.resourcemanager.mediaservices.models.StreamingEndpointAccessControl;
import java.time.OffsetDateTime;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/** Samples for StreamingEndpoints Create. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/streamingendpoint-create.json
     */
    /**
     * Sample code: Create a streaming endpoint.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createAStreamingEndpoint(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .streamingEndpoints()
            .define("myStreamingEndpoint1")
            .withRegion("West US")
            .withExistingMediaservice("mediaresources", "slitestmedia10")
            .withTags(mapOf("tag1", "value1", "tag2", "value2"))
            .withDescription("test event 1")
            .withScaleUnits(1)
            .withAvailabilitySetName("availableset")
            .withAccessControl(
                new StreamingEndpointAccessControl()
                    .withAkamai(
                        new AkamaiAccessControl()
                            .withAkamaiSignatureHeaderAuthenticationKeyList(
                                Arrays
                                    .asList(
                                        new AkamaiSignatureHeaderAuthenticationKey()
                                            .withIdentifier("id1")
                                            .withBase64Key("fakeTokenPlaceholder")
                                            .withExpiration(OffsetDateTime.parse("2029-12-31T16:00:00-08:00")),
                                        new AkamaiSignatureHeaderAuthenticationKey()
                                            .withIdentifier("id2")
                                            .withBase64Key("fakeTokenPlaceholder")
                                            .withExpiration(OffsetDateTime.parse("2030-12-31T16:00:00-08:00")))))
                    .withIp(
                        new IpAccessControl()
                            .withAllow(Arrays.asList(new IpRange().withName("AllowedIp").withAddress("192.168.1.1")))))
            .withCdnEnabled(false)
            .create();
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:

201

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpointoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/streamingendpoints/myStreamingEndpoint1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01

{
  "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"
  }
}

Código de estado:

200

{
  "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

Name	Description
AkamaiAccessControl	Controlo de acesso do Akamai
AkamaiSignatureHeaderAuthenticationKey	Chave de autenticação cabeçalho de assinatura do Akamai.
ArmStreamingEndpointCurrentSku	O sku atual do ponto final de transmissão em fluxo.
createdByType	O tipo de identidade que criou o recurso.
CrossSiteAccessPolicies	A política de acesso do cliente.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta a erros
IPAccessControl	O controlo de acesso ao IP.
IPRange	O intervalo de endereços IP no esquema CIDR.
StreamingEndpoint	O ponto final de transmissão em fluxo.
StreamingEndpointAccessControl	Definição de controlo de acesso a pontos finais de transmissão em fluxo.
StreamingEndpointResourceState	O estado do recurso do ponto final de transmissão em fluxo.
systemData	Metadados relativos à criação e última modificação do recurso.

AkamaiAccessControl

Controlo de acesso do Akamai

Name	Tipo	Description
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	lista de chaves de autenticação

AkamaiSignatureHeaderAuthenticationKey

Chave de autenticação cabeçalho de assinatura do Akamai.

Name	Tipo	Description
base64Key	string	chave de autenticação
expiration	string	O tempo de expiração da chave de autenticação.
identifier	string	identificador da chave

ArmStreamingEndpointCurrentSku

O sku atual do ponto final de transmissão em fluxo.

Name	Tipo	Description
capacity	integer	A capacidade de SKU do ponto final de transmissão em fluxo.
name	string	O nome do SKU do ponto final de transmissão em fluxo.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

A política de acesso do cliente.

Name	Tipo	Description
clientAccessPolicy	string	O conteúdo do clientaccesspolicy.xml utilizado pelo Silverlight.
crossDomainPolicy	string	O conteúdo do crossdomain.xml utilizado pelo Silverlight.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta a erros

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

IPAccessControl

O controlo de acesso ao IP.

Name	Tipo	Description
allow	IPRange[]	A lista de permissões de IP.

IPRange

O intervalo de endereços IP no esquema CIDR.

Name	Tipo	Description
address	string	O endereço IP.
name	string	O nome amigável do intervalo de endereços IP.
subnetPrefixLength	integer	O comprimento do prefixo da máscara de sub-rede (veja Notação CIDR).

StreamingEndpoint

O ponto final de transmissão em fluxo.

Name	Tipo	Description
id	string	ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A localização geográfica onde o recurso se encontra
name	string	O nome do recurso
properties.accessControl	StreamingEndpointAccessControl	A definição de controlo de acesso do ponto final de transmissão em fluxo.
properties.availabilitySetName	string	Esta funcionalidade foi preterida, não defina um valor para esta propriedade.
properties.cdnEnabled	boolean	O sinalizador da CDN ativado.
properties.cdnProfile	string	O nome do perfil da CDN.
properties.cdnProvider	string	O nome do fornecedor da CDN.
properties.created	string	A hora exata em que o ponto final de transmissão em fluxo foi criado.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	As políticas de acesso a pontos finais de transmissão em fluxo.
properties.customHostNames	string[]	Os nomes de anfitrião personalizados do ponto final de transmissão em fluxo
properties.description	string	A descrição do ponto final de transmissão em fluxo.
properties.freeTrialEndTime	string	O tempo de expiração da avaliação gratuita.
properties.hostName	string	O nome do anfitrião do ponto final de transmissão em fluxo.
properties.lastModified	string	A hora exata em que o ponto final de transmissão em fluxo foi modificado pela última vez.
properties.maxCacheAge	integer	Idade máxima da cache
properties.provisioningState	string	O estado de aprovisionamento do ponto final de transmissão em fluxo.
properties.resourceState	StreamingEndpointResourceState	O estado do recurso do ponto final de transmissão em fluxo.
properties.scaleUnits	integer	O número de unidades de escala. Utilize a operação Dimensionamento para ajustar este valor.
sku	ArmStreamingEndpointCurrentSku	O sku do ponto final de transmissão em fluxo.
systemData	systemData	Os metadados do sistema relacionados com este recurso.
tags	object	Etiquetas de recursos.
type	string	O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

StreamingEndpointAccessControl

Definição de controlo de acesso a pontos finais de transmissão em fluxo.

Name	Tipo	Description
akamai	AkamaiAccessControl	O controlo de acesso do Akamai
ip	IPAccessControl	O controlo de acesso ip do ponto final de transmissão em fluxo.

StreamingEndpointResourceState

O estado do recurso do ponto final de transmissão em fluxo.

Name	Tipo	Description
Deleting	string	O ponto final de transmissão em fluxo está a ser eliminado.
Running	string	O ponto final de transmissão em fluxo está em execução. É capaz de transmitir conteúdo em fluxo para clientes
Scaling	string	O ponto final de transmissão em fluxo está a aumentar ou a diminuir as unidades de escala.
Starting	string	O ponto final de transmissão em fluxo está em transição para o estado em execução.
Stopped	string	O estado inicial de um ponto final de transmissão em fluxo após a criação. O conteúdo não está pronto para ser transmitido a partir deste ponto final.
Stopping	string	O ponto final de transmissão em fluxo está em transição para o estado parado.

systemData

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

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	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	createdByType	O tipo de identidade que modificou o recurso pela última vez.