Compartir a través de


Streaming Endpoints - Create

Crear StreamingEndpoint
Crea un punto de conexión de 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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accountName
path True

string

Nombre de la cuenta de Media Services.

resourceGroupName
path True

string

Nombre del grupo de recursos dentro de la suscripción de Azure.

streamingEndpointName
path True

string

El nombre del punto de conexión de streaming, la longitud máxima es 24.

Patrón de Regex: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

subscriptionId
path True

string

Identificador único de una suscripción de Microsoft Azure.

api-version
query True

string

Versión de la API que se va a usar con la solicitud de cliente.

autoStart
query

boolean

La marca indica si el recurso se debe iniciar automáticamente al crearse.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación geográfica donde reside el recurso

properties.scaleUnits True

integer

Número de unidades de escalado. Use la operación Scale para ajustar este valor.

properties.accessControl

StreamingEndpointAccessControl

Definición del control de acceso del punto de conexión de streaming.

properties.availabilitySetName

string

Esta característica está en desuso, no establezca un valor para esta propiedad.

properties.cdnEnabled

boolean

Marca habilitada para la red CDN.

properties.cdnProfile

string

Nombre del perfil de la red CDN.

properties.cdnProvider

string

Nombre del proveedor de CDN.

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Las directivas de acceso al punto de conexión de streaming.

properties.customHostNames

string[]

Los nombres de host personalizados del punto de conexión de streaming

properties.description

string

Descripción del punto de conexión de streaming.

properties.maxCacheAge

integer

Antigüedad máxima de caché

sku

ArmStreamingEndpointCurrentSku

SKU del punto de conexión de streaming.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

StreamingEndpoint

Aceptar. La solicitud se ha realizado correctamente.

201 Created

StreamingEndpoint

Creado. La solicitud se ha aceptado para su procesamiento y la operación se completará de forma asincrónica. Consulte https://go.microsoft.com/fwlink/?linkid=2087017 para más información sobre la supervisión de operaciones asincrónicas de Azure mediante el encabezado de respuesta Azure-AsyncOperation.

Other Status Codes

ErrorResponse

Respuesta de error de streaming que describe por qué se produjo un error en la operación.

Ejemplos

Create a streaming endpoint

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
AkamaiAccessControl

Control de acceso de Akamai

AkamaiSignatureHeaderAuthenticationKey

Clave de autenticación de encabezado de firma de Akamai.

ArmStreamingEndpointCurrentSku

SKU actual del punto de conexión de streaming.

createdByType

Tipo de identidad que creó el recurso.

CrossSiteAccessPolicies

Directiva de acceso de cliente.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

IPAccessControl

Control de acceso IP.

IPRange

Intervalo de direcciones IP en el esquema CIDR.

StreamingEndpoint

Punto de conexión de streaming.

StreamingEndpointAccessControl

Definición del control de acceso del punto de conexión de streaming.

StreamingEndpointResourceState

Estado de recurso del punto de conexión de streaming.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

AkamaiAccessControl

Control de acceso de Akamai

Nombre Tipo Description
akamaiSignatureHeaderAuthenticationKeyList

AkamaiSignatureHeaderAuthenticationKey[]

lista de claves de autenticación

AkamaiSignatureHeaderAuthenticationKey

Clave de autenticación de encabezado de firma de Akamai.

Nombre Tipo Description
base64Key

string

clave de autenticación

expiration

string

Hora de expiración de la clave de autenticación.

identifier

string

identificador de la clave

ArmStreamingEndpointCurrentSku

SKU actual del punto de conexión de streaming.

Nombre Tipo Description
capacity

integer

Capacidad de SKU del punto de conexión de streaming.

name

string

Nombre de la SKU del punto de conexión de streaming.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

CrossSiteAccessPolicies

Directiva de acceso de cliente.

Nombre Tipo Description
clientAccessPolicy

string

Contenido de clientaccesspolicy.xml usado por Silverlight.

crossDomainPolicy

string

Contenido de crossdomain.xml usado por Silverlight.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

IPAccessControl

Control de acceso IP.

Nombre Tipo Description
allow

IPRange[]

Lista de direcciones IP permitidas.

IPRange

Intervalo de direcciones IP en el esquema CIDR.

Nombre Tipo Description
address

string

Dirección IP.

name

string

Nombre descriptivo del intervalo de direcciones IP.

subnetPrefixLength

integer

Longitud del prefijo de máscara de subred (consulte notación CIDR).

StreamingEndpoint

Punto de conexión de streaming.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso.

properties.accessControl

StreamingEndpointAccessControl

Definición del control de acceso del punto de conexión de streaming.

properties.availabilitySetName

string

Esta característica está en desuso, no establezca un valor para esta propiedad.

properties.cdnEnabled

boolean

Marca habilitada para la red CDN.

properties.cdnProfile

string

Nombre del perfil de la red CDN.

properties.cdnProvider

string

Nombre del proveedor de CDN.

properties.created

string

Hora exacta en que se creó el punto de conexión de streaming.

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Las directivas de acceso al punto de conexión de streaming.

properties.customHostNames

string[]

Los nombres de host personalizados del punto de conexión de streaming

properties.description

string

Descripción del punto de conexión de streaming.

properties.freeTrialEndTime

string

Tiempo de expiración de la prueba gratuita.

properties.hostName

string

Nombre de host del punto de conexión de streaming.

properties.lastModified

string

Hora exacta en que se modificó por última vez el punto de conexión de streaming.

properties.maxCacheAge

integer

Antigüedad máxima de caché

properties.provisioningState

string

Estado de aprovisionamiento del punto de conexión de streaming.

properties.resourceState

StreamingEndpointResourceState

Estado de recurso del punto de conexión de streaming.

properties.scaleUnits

integer

Número de unidades de escalado. Use la operación Scale para ajustar este valor.

sku

ArmStreamingEndpointCurrentSku

SKU del punto de conexión de streaming.

systemData

systemData

Metadatos del sistema relacionados con este recurso.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

StreamingEndpointAccessControl

Definición del control de acceso del punto de conexión de streaming.

Nombre Tipo Description
akamai

AkamaiAccessControl

El control de acceso de Akamai

ip

IPAccessControl

Control de acceso IP del punto de conexión de streaming.

StreamingEndpointResourceState

Estado de recurso del punto de conexión de streaming.

Nombre Tipo Description
Deleting

string

Se está eliminando el punto de conexión de streaming.

Running

string

El punto de conexión de streaming se está ejecutando. Es capaz de transmitir contenido a los clientes

Scaling

string

El punto de conexión de streaming aumenta o disminuye las unidades de escalado.

Starting

string

El punto de conexión de streaming está realizando la transición al estado en ejecución.

Stopped

string

El estado inicial de un punto de conexión de streaming después de la creación. El contenido no está listo para transmitirse desde este punto de conexión.

Stopping

string

El punto de conexión de streaming está realizando la transición al estado detenido.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.