Streaming Endpoints - Create

Başvuru

Service:: Media Services

API Version:: 2022-11-01

StreamingEndpoint Oluşturma
Akış uç noktası oluşturur.

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

With optional parameters:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
accountName	path	True	string	Media Services hesap adı.
resourceGroupName	path	True	string	Azure aboneliğindeki kaynak grubunun adı.
streamingEndpointName	path	True	string	Akış uç noktasının adı, uzunluk üst sınırı 24'tür. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	Microsoft Azure aboneliğinin benzersiz tanımlayıcısı.
api-version	query	True	string	İstemci isteğiyle kullanılacak API'nin sürümü.
autoStart	query		boolean	bayrağı, kaynağın oluşturma işleminde otomatik olarak başlatılması gerekip gerekmediğini gösterir.

İstek Gövdesi

Name	Gerekli	Tür	Description
location	True	string	Kaynağın bulunduğu coğrafi konum
properties.scaleUnits	True	integer	Ölçek birimi sayısı. Bu değeri ayarlamak için Ölçeklendirme işlemini kullanın.
properties.accessControl		StreamingEndpointAccessControl	Akış uç noktasının erişim denetimi tanımı.
properties.availabilitySetName		string	Bu özellik kullanım dışı bırakıldı, bu özellik için bir değer ayarlamayın.
properties.cdnEnabled		boolean	CDN etkin bayrağı.
properties.cdnProfile		string	CDN profil adı.
properties.cdnProvider		string	CDN sağlayıcı adı.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Akış uç noktası erişim ilkeleri.
properties.customHostNames		string[]	Akış uç noktasının özel konak adları
properties.description		string	Akış uç noktası açıklaması.
properties.maxCacheAge		integer	En fazla önbellek yaşı
sku		ArmStreamingEndpointCurrentSku	Akış uç noktası sku'su.
tags		object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	StreamingEndpoint	Tamam ögesini seçin. İstek başarılı oldu.
201 Created	StreamingEndpoint	Oluşturulan. İstek işlenmek üzere kabul edildi ve işlem zaman uyumsuz olarak tamamlanacak. Azure-AsyncOperation yanıt üst bilgisini kullanarak zaman uyumsuz Azure işlemlerini izleme hakkında ayrıntılı bilgi için bkz https://go.microsoft.com/fwlink/?linkid=2087017 .
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan akış hatası yanıtı.

Örnekler

Create a streaming endpoint

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

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

Sample Response

Status code:: 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

Response Body

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

Tanımlar

Name	Description
AkamaiAccessControl	Akamai erişim denetimi
AkamaiSignatureHeaderAuthenticationKey	Akamai İmza Üst Bilgisi kimlik doğrulama anahtarı.
ArmStreamingEndpointCurrentSku	Akış uç noktası geçerli sku'su.
createdByType	Kaynağı oluşturan kimliğin türü.
CrossSiteAccessPolicies	İstemci erişim ilkesi.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
IPAccessControl	IP erişim denetimi.
IPRange	CIDR düzenindeki IP adresi aralığı.
StreamingEndpoint	Akış uç noktası.
StreamingEndpointAccessControl	Akış uç noktası erişim denetimi tanımı.
StreamingEndpointResourceState	Akış uç noktasının kaynak durumu.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

AkamaiAccessControl

Akamai erişim denetimi

Name	Tür	Description
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	kimlik doğrulama anahtarı listesi

AkamaiSignatureHeaderAuthenticationKey

Akamai İmza Üst Bilgisi kimlik doğrulama anahtarı.

Name	Tür	Description
base64Key	string	kimlik doğrulama anahtarı
expiration	string	Kimlik doğrulama anahtarının sona erme zamanı.
identifier	string	anahtarın tanımlayıcısı

ArmStreamingEndpointCurrentSku

Akış uç noktası geçerli sku'su.

Name	Tür	Description
capacity	integer	Akış uç noktası sku kapasitesi.
name	string	Akış uç noktası sku adı.

createdByType

Kaynağı oluşturan kimliğin türü.

Name	Tür	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

İstemci erişim ilkesi.

Name	Tür	Description
clientAccessPolicy	string	Silverlight tarafından kullanılan clientaccesspolicy.xml içeriği.
crossDomainPolicy	string	Silverlight tarafından kullanılan crossdomain.xml içeriği.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

IPAccessControl

IP erişim denetimi.

Name	Tür	Description
allow	IPRange[]	IP izin verme listesi.

IPRange

CIDR düzenindeki IP adresi aralığı.

Name	Tür	Description
address	string	IP adresi.
name	string	IP adresi aralığının kolay adı.
subnetPrefixLength	integer	Alt ağ maskesi ön ek uzunluğu (bkz. CIDR gösterimi).

StreamingEndpoint

Akış uç noktası.

Name	Tür	Description
id	string	Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties.accessControl	StreamingEndpointAccessControl	Akış uç noktasının erişim denetimi tanımı.
properties.availabilitySetName	string	Bu özellik kullanım dışı bırakıldı, bu özellik için bir değer ayarlamayın.
properties.cdnEnabled	boolean	CDN etkin bayrağı.
properties.cdnProfile	string	CDN profil adı.
properties.cdnProvider	string	CDN sağlayıcı adı.
properties.created	string	Akış uç noktasının oluşturulduğu tam zaman.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Akış uç noktası erişim ilkeleri.
properties.customHostNames	string[]	Akış uç noktasının özel konak adları
properties.description	string	Akış uç noktası açıklaması.
properties.freeTrialEndTime	string	Ücretsiz deneme süre sonu.
properties.hostName	string	Akış uç noktası ana bilgisayar adı.
properties.lastModified	string	Akış uç noktasının son değiştirilme zamanı.
properties.maxCacheAge	integer	En fazla önbellek yaşı
properties.provisioningState	string	Akış uç noktasının sağlama durumu.
properties.resourceState	StreamingEndpointResourceState	Akış uç noktasının kaynak durumu.
properties.scaleUnits	integer	Ölçek birimi sayısı. Bu değeri ayarlamak için Ölçeklendirme işlemini kullanın.
sku	ArmStreamingEndpointCurrentSku	Akış uç noktası sku'su.
systemData	systemData	Bu kaynakla ilgili sistem meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

StreamingEndpointAccessControl

Akış uç noktası erişim denetimi tanımı.

Name	Tür	Description
akamai	AkamaiAccessControl	Akamai'nin erişim denetimi
ip	IPAccessControl	Akış uç noktasının IP erişim denetimi.

StreamingEndpointResourceState

Akış uç noktasının kaynak durumu.

Name	Tür	Description
Deleting	string	Akış uç noktası siliniyor.
Running	string	Akış uç noktası çalışıyor. İstemcilere içerik akışı yapabilir
Scaling	string	Akış uç noktası ölçek birimlerini artırıyor veya azalıyor.
Starting	string	Akış uç noktası çalışıyor durumuna geçiliyor.
Stopped	string	Akış uç noktasının oluşturma işleminden sonraki ilk durumu. İçerik bu uç noktadan akışa alınmaya hazır değil.
Stopping	string	Akış uç noktası durdurulmuş duruma geçiliyor.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimliğin türü.