Condividi tramite


Streaming Endpoints - Create

Creare un'entità StreamingEndpoint
Crea un endpoint di streaming.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
path True

string

Nome dell'account di Servizi multimediali.

resourceGroupName
path True

string

Nome del gruppo di risorse all'interno della sottoscrizione di Azure.

streamingEndpointName
path True

string

Il nome dell'endpoint di streaming, la lunghezza massima è 24.

Criterio di espressione regolare: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

subscriptionId
path True

string

Identificatore univoco per una sottoscrizione di Microsoft Azure.

api-version
query True

string

Versione dell'API da usare con la richiesta client.

autoStart
query

boolean

Il flag indica se la risorsa deve essere avviata automaticamente alla creazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
location True

string

Posizione geografica in cui risiede la risorsa

properties.scaleUnits True

integer

Numero di unità di scala. Utilizzare l'operazione Scala per modificare questo valore.

properties.accessControl

StreamingEndpointAccessControl

Definizione del controllo di accesso dell'endpoint di streaming.

properties.availabilitySetName

string

Questa funzionalità è deprecata, non impostare un valore per questa proprietà.

properties.cdnEnabled

boolean

Flag abilitato per la rete CDN.

properties.cdnProfile

string

Nome del profilo della rete CDN.

properties.cdnProvider

string

Nome del provider della rete CDN.

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Criteri di accesso agli endpoint di streaming.

properties.customHostNames

string[]

Nomi host personalizzati dell'endpoint di streaming

properties.description

string

Descrizione dell'endpoint di streaming.

properties.maxCacheAge

integer

Validità massima cache

sku

ArmStreamingEndpointCurrentSku

SKU dell'endpoint di streaming.

tags

object

Tag delle risorse.

Risposte

Nome Tipo Descrizione
200 OK

StreamingEndpoint

OK. La richiesta ha avuto esito positivo.

201 Created

StreamingEndpoint

Creazione riuscita. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Per https://go.microsoft.com/fwlink/?linkid=2087017 informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure tramite l'intestazione della risposta Azure-AsyncOperation.

Other Status Codes

ErrorResponse

Risposta di errore di streaming che descrive il motivo per cui l'operazione non è riuscita.

Esempio

Create a streaming endpoint

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
AkamaiAccessControl

Controllo di accesso Akamai

AkamaiSignatureHeaderAuthenticationKey

Chiave di autenticazione dell'intestazione della firma Akamai.

ArmStreamingEndpointCurrentSku

SKU corrente dell'endpoint di streaming.

createdByType

Tipo di identità che ha creato la risorsa.

CrossSiteAccessPolicies

Criteri di accesso client.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

IPAccessControl

Controllo di accesso IP.

IPRange

Intervallo di indirizzi IP nello schema CIDR.

StreamingEndpoint

Endpoint di streaming.

StreamingEndpointAccessControl

Definizione del controllo di accesso dell'endpoint di streaming.

StreamingEndpointResourceState

Stato della risorsa dell'endpoint di streaming.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

AkamaiAccessControl

Controllo di accesso Akamai

Nome Tipo Descrizione
akamaiSignatureHeaderAuthenticationKeyList

AkamaiSignatureHeaderAuthenticationKey[]

elenco di chiavi di autenticazione

AkamaiSignatureHeaderAuthenticationKey

Chiave di autenticazione dell'intestazione della firma Akamai.

Nome Tipo Descrizione
base64Key

string

chiave di autenticazione

expiration

string

Ora di scadenza della chiave di autenticazione.

identifier

string

identificatore della chiave

ArmStreamingEndpointCurrentSku

SKU corrente dell'endpoint di streaming.

Nome Tipo Descrizione
capacity

integer

Capacità dello SKU dell'endpoint di streaming.

name

string

Nome sku dell'endpoint di streaming.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

CrossSiteAccessPolicies

Criteri di accesso client.

Nome Tipo Descrizione
clientAccessPolicy

string

Contenuto di clientaccesspolicy.xml utilizzato da Silverlight.

crossDomainPolicy

string

Contenuto di crossdomain.xml utilizzato da Silverlight.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

IPAccessControl

Controllo di accesso IP.

Nome Tipo Descrizione
allow

IPRange[]

Elenco indirizzi IP consentiti.

IPRange

Intervallo di indirizzi IP nello schema CIDR.

Nome Tipo Descrizione
address

string

Indirizzo IP.

name

string

Nome descrittivo per l'intervallo di indirizzi IP.

subnetPrefixLength

integer

Lunghezza del prefisso della subnet mask (vedere notazione CIDR).

StreamingEndpoint

Endpoint di streaming.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Posizione geografica in cui risiede la risorsa

name

string

nome della risorsa.

properties.accessControl

StreamingEndpointAccessControl

Definizione del controllo di accesso dell'endpoint di streaming.

properties.availabilitySetName

string

Questa funzionalità è deprecata, non impostare un valore per questa proprietà.

properties.cdnEnabled

boolean

Flag abilitato per la rete CDN.

properties.cdnProfile

string

Nome del profilo della rete CDN.

properties.cdnProvider

string

Nome del provider della rete CDN.

properties.created

string

Ora esatta in cui è stato creato l'endpoint di streaming.

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Criteri di accesso agli endpoint di streaming.

properties.customHostNames

string[]

Nomi host personalizzati dell'endpoint di streaming

properties.description

string

Descrizione dell'endpoint di streaming.

properties.freeTrialEndTime

string

Ora di scadenza della versione di valutazione gratuita.

properties.hostName

string

Nome host dell'endpoint di streaming.

properties.lastModified

string

Ora esatta dell'ultima modifica dell'endpoint di streaming.

properties.maxCacheAge

integer

Validità massima cache

properties.provisioningState

string

Stato di provisioning dell'endpoint di streaming.

properties.resourceState

StreamingEndpointResourceState

Stato della risorsa dell'endpoint di streaming.

properties.scaleUnits

integer

Numero di unità di scala. Utilizzare l'operazione Scala per modificare questo valore.

sku

ArmStreamingEndpointCurrentSku

SKU dell'endpoint di streaming.

systemData

systemData

Metadati di sistema relativi a questa risorsa.

tags

object

Tag delle risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

StreamingEndpointAccessControl

Definizione del controllo di accesso dell'endpoint di streaming.

Nome Tipo Descrizione
akamai

AkamaiAccessControl

Controllo di accesso di Akamai

ip

IPAccessControl

Controllo di accesso IP dell'endpoint di streaming.

StreamingEndpointResourceState

Stato della risorsa dell'endpoint di streaming.

Nome Tipo Descrizione
Deleting

string

L'endpoint di streaming viene eliminato.

Running

string

L'endpoint di streaming è in esecuzione. È in grado di trasmettere contenuto ai client

Scaling

string

L'endpoint di streaming aumenta o riduce le unità di scala.

Starting

string

L'endpoint di streaming esegue la transizione allo stato di esecuzione.

Stopped

string

Lo stato iniziale di un endpoint di streaming dopo la creazione. Il contenuto non è pronto per essere trasmesso da questo endpoint.

Stopping

string

L'endpoint di streaming esegue la transizione allo stato di arresto.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.