Streaming Endpoints - Create

Service:
Media Services
API Version:
2020-05-01

Utwórz StreamingEndpoint
Tworzy punkt końcowy przesyłania strumieniowego.

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

Parametry identyfikatora URI

Name In Required Type Description
accountName
 path True
  • string

Nazwa konta Media Services.
resourceGroupName
 path True
  • string

Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
streamingEndpointName
 path True
  • string

Nazwa punktu końcowego przesyłania strumieniowego, Maksymalna długość to 24.

Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
subscriptionId
 path True
  • string

Unikatowy identyfikator subskrypcji Microsoft Azureej.
api-version
 query True
  • string

Wersja interfejsu API, która ma być używana z żądaniem klienta.
autoStart
 query
  • boolean

Flaga wskazuje, czy zasób powinien być uruchamiany automatycznie podczas tworzenia.

Treść żądania

Name Required Type Description
location True
  • string

Lokalizacja geograficzna, w której przebywa zasób
properties.scaleUnits True
  • integer

Liczba jednostek skali. Aby dostosować tę wartość, użyj operacji skalowania.
properties.accessControl

Definicja kontroli dostępu do punktu końcowego przesyłania strumieniowego.
properties.availabilitySetName
  • string

Ta funkcja jest przestarzała, nie należy ustawiać wartości tej właściwości.
properties.cdnEnabled
  • boolean

Flaga włączenia usługi CDN.
properties.cdnProfile
  • string

Nazwa profilu CDN.
properties.cdnProvider
  • string

Nazwa dostawcy sieci CDN.
properties.crossSiteAccessPolicies

Zasady dostępu do punktu końcowego przesyłania strumieniowego.
properties.customHostNames
  • string[]

Niestandardowe nazwy hostów punktu końcowego przesyłania strumieniowego
properties.description
  • string

Opis punktu końcowego przesyłania strumieniowego.
properties.maxCacheAge
  • integer

Maksymalny wiek pamięci podręcznej
tags
  • object

Tagi zasobów.

Odpowiedzi

Name Type Description
200 OK

OK. Żądanie zakończyło się pomyślnie.
201 Created

Utworzony. Żądanie zostało zaakceptowane do przetwarzania, a operacja zakończy się asynchronicznie. Zobacz https://go.microsoft.com/fwlink/?linkid=2087017 , aby uzyskać szczegółowe informacje na temat monitorowania asynchronicznych operacji platformy Azure przy użyciu nagłówka odpowiedzi Azure-AsyncOperation.
Other Status Codes

Odpowiedź na błąd przesyłania strumieniowego opisująca przyczynę niepowodzenia operacji.

Przykłady

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

Status code:
201 
{
  "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"
  }
}
Status code:
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"
  }
}

Definicje

AkamaiAccessControl

Akamai kontroli dostępu
AkamaiSignatureHeaderAuthenticationKey

Klucz uwierzytelniania nagłówka sygnatury Akamai.
ApiError

Błąd interfejsu API.
createdByType

Typ tożsamości, która utworzyła zasób.
CrossSiteAccessPolicies

Zasady dostępu klienta.
IPAccessControl

Kontrola dostępu do adresów IP.
IPRange

Zakres adresów IP w schemacie CIDR.
ODataError

Informacje o błędzie.
StreamingEndpoint

Punkt końcowy przesyłania strumieniowego.
StreamingEndpointAccessControl

Definicja kontroli dostępu do punktu końcowego przesyłania strumieniowego.
StreamingEndpointResourceState

Stan zasobu punktu końcowego przesyłania strumieniowego.
systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AkamaiAccessControl

Akamai kontroli dostępu

Name Type Description
akamaiSignatureHeaderAuthenticationKeyList

Lista kluczy uwierzytelniania

AkamaiSignatureHeaderAuthenticationKey

Klucz uwierzytelniania nagłówka sygnatury Akamai.

Name Type Description
base64Key
  • string

klucz uwierzytelniania
expiration
  • string

Czas wygaśnięcia klucza uwierzytelniania.
identifier
  • string

Identyfikator klucza

ApiError

Błąd interfejsu API.

Name Type Description
error

Właściwości błędu.

createdByType

Typ tożsamości, która utworzyła zasób.

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

CrossSiteAccessPolicies

Zasady dostępu klienta.

Name Type Description
clientAccessPolicy
  • string

Zawartość clientaccesspolicy.xml używana przez program Silverlight.
crossDomainPolicy
  • string

Zawartość crossdomain.xml używana przez program Silverlight.

IPAccessControl

Kontrola dostępu do adresów IP.

Name Type Description
allow

Lista dozwolonych adresów IP.

IPRange

Zakres adresów IP w schemacie CIDR.

Name Type Description
address
  • string

Adres IP.
name
  • string

Przyjazna nazwa zakresu adresów IP.
subnetPrefixLength
  • integer

Długość prefiksu maski podsieci (zobacz notacja CIDR).

ODataError

Informacje o błędzie.

Name Type Description
code
  • string

Niezależna od języka nazwa błędu.
details

Szczegóły błędu.
message
  • string

Komunikat o błędzie.
target
  • string

Obiekt docelowy błędu (na przykład nazwa właściwości w błąd).

StreamingEndpoint

Punkt końcowy przesyłania strumieniowego.

Name Type Description
id
  • string

W pełni kwalifikowany identyfikator zasobu dla zasobu. /Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location
  • string

Lokalizacja geograficzna, w której przebywa zasób
name
  • string

Nazwa zasobu
properties.accessControl

Definicja kontroli dostępu do punktu końcowego przesyłania strumieniowego.
properties.availabilitySetName
  • string

Ta funkcja jest przestarzała, nie należy ustawiać wartości tej właściwości.
properties.cdnEnabled
  • boolean

Flaga włączenia usługi CDN.
properties.cdnProfile
  • string

Nazwa profilu CDN.
properties.cdnProvider
  • string

Nazwa dostawcy sieci CDN.
properties.created
  • string

Dokładny czas utworzenia punktu końcowego przesyłania strumieniowego.
properties.crossSiteAccessPolicies

Zasady dostępu do punktu końcowego przesyłania strumieniowego.
properties.customHostNames
  • string[]

Niestandardowe nazwy hostów punktu końcowego przesyłania strumieniowego
properties.description
  • string

Opis punktu końcowego przesyłania strumieniowego.
properties.freeTrialEndTime
  • string

Czas wygaśnięcia bezpłatnej wersji próbnej.
properties.hostName
  • string

Nazwa hosta punktu końcowego przesyłania strumieniowego.
properties.lastModified
  • string

Dokładny czas ostatniej modyfikacji punktu końcowego przesyłania strumieniowego.
properties.maxCacheAge
  • integer

Maksymalny wiek pamięci podręcznej
properties.provisioningState
  • string

Stan aprowizacji punktu końcowego przesyłania strumieniowego.
properties.resourceState

Stan zasobu punktu końcowego przesyłania strumieniowego.
properties.scaleUnits
  • integer

Liczba jednostek skali. Aby dostosować tę wartość, użyj operacji skalowania.
systemData

Metadane systemowe dotyczące tego zasobu.
tags
  • object

Tagi zasobów.
type
  • string

Typ zasobu. Na przykład "Microsoft. COMPUTE/virtualMachines" lub "Microsoft. Storage/storageAccounts"

StreamingEndpointAccessControl

Definicja kontroli dostępu do punktu końcowego przesyłania strumieniowego.

Name Type Description
akamai

Kontrola dostępu Akamai
ip

Kontrola dostępu do adresu IP w punkcie końcowym przesyłania strumieniowego.

StreamingEndpointResourceState

Stan zasobu punktu końcowego przesyłania strumieniowego.

Name Type Description
Deleting
  • string

Trwa usuwanie punktu końcowego przesyłania strumieniowego.
Running
  • string

Punkt końcowy przesyłania strumieniowego jest uruchomiony. Możliwość przesyłania strumieniowego zawartości do klientów
Scaling
  • string

Punkt końcowy przesyłania strumieniowego zwiększa lub zmniejsza liczbę jednostek skalowania.
Starting
  • string

Punkt końcowy przesyłania strumieniowego przechodzi do stanu uruchomienia.
Stopped
  • string

Początkowy stan punktu końcowego przesyłania strumieniowego po utworzeniu. Zawartość nie jest gotowa do przesyłania strumieniowego z tego punktu końcowego.
Stopping
  • string

Punkt końcowy przesyłania strumieniowego przechodzi do stanu zatrzymania.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Name Type Description
createdAt
  • string

Sygnatura czasowa tworzenia zasobów (UTC).
createdBy
  • string

Tożsamość, która utworzyła zasób.
createdByType

Typ tożsamości, która utworzyła zasób.
lastModifiedAt
  • string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy
  • string

Tożsamość, która ostatnio zmodyfikował zasób.
lastModifiedByType

Typ tożsamości, który ostatnio zmodyfikował zasób.