Streaming Endpoints - Create

Service:

Media Services

API Version:

2022-11-01

Membuat StreamingEndpoint
Membuat titik akhir streaming.

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}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
accountName	path	True	string	Nama akun Media Services.
resourceGroupName	path	True	string	Nama grup sumber daya dalam langganan Azure.
streamingEndpointName	path	True	string	Nama titik akhir streaming, panjang maksimum adalah 24. Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
subscriptionId	path	True	string	Pengidentifikasi unik untuk langganan Microsoft Azure.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien.
autoStart	query		boolean	Bendera menunjukkan apakah sumber daya harus dimulai secara otomatis saat pembuatan.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
location	True	string	Lokasi geografis tempat sumber daya berada
properties.scaleUnits	True	integer	Jumlah unit skala. Gunakan operasi Skala untuk menyesuaikan nilai ini.
properties.accessControl		StreamingEndpointAccessControl	Definisi kontrol akses titik akhir streaming.
properties.availabilitySetName		string	Fitur ini tidak digunakan lagi, jangan tetapkan nilai untuk properti ini.
properties.cdnEnabled		boolean	Bendera yang diaktifkan CDN.
properties.cdnProfile		string	Nama profil CDN.
properties.cdnProvider		string	Nama penyedia CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Kebijakan akses titik akhir streaming.
properties.customHostNames		string[]	Nama host kustom dari titik akhir streaming
properties.description		string	Deskripsi titik akhir streaming.
properties.maxCacheAge		integer	Usia cache maks
sku		ArmStreamingEndpointCurrentSku	Sku titik akhir streaming.
tags		object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	StreamingEndpoint	OK. Permintaan telah berhasil.
201 Created	StreamingEndpoint	Dibuat. Permintaan telah diterima untuk diproses dan operasi akan selesai secara asinkron. Lihat https://go.microsoft.com/fwlink/?linkid=2087017 untuk detail tentang memantau operasi Azure asinkron menggunakan header respons Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Respons kesalahan streaming yang menjelaskan mengapa operasi gagal.

Contoh

Create a streaming endpoint

Sample Request

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

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

Definisi

Nama	Deskripsi
AkamaiAccessControl	Kontrol akses Akamai
AkamaiSignatureHeaderAuthenticationKey	Kunci autentikasi Header Tanda Tangan Akamai.
ArmStreamingEndpointCurrentSku	Sku titik akhir streaming saat ini.
createdByType	Jenis identitas yang membuat sumber daya.
CrossSiteAccessPolicies	Kebijakan akses klien.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
IPAccessControl	Kontrol akses IP.
IPRange	Rentang alamat IP dalam skema CIDR.
StreamingEndpoint	Titik akhir streaming.
StreamingEndpointAccessControl	Definisi kontrol akses titik akhir streaming.
StreamingEndpointResourceState	Status sumber daya titik akhir streaming.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

AkamaiAccessControl

Kontrol akses Akamai

Nama	Jenis	Deskripsi
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	daftar kunci autentikasi

AkamaiSignatureHeaderAuthenticationKey

Kunci autentikasi Header Tanda Tangan Akamai.

Nama	Jenis	Deskripsi
base64Key	string	kunci autentikasi
expiration	string	Waktu kedaluwarsa kunci autentikasi.
identifier	string	pengidentifikasi kunci

ArmStreamingEndpointCurrentSku

Sku titik akhir streaming saat ini.

Nama	Jenis	Deskripsi
capacity	integer	Kapasitas sku titik akhir streaming.
name	string	Nama sku titik akhir streaming.

createdByType

Jenis identitas yang membuat sumber daya.

Nama	Jenis	Deskripsi
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Kebijakan akses klien.

Nama	Jenis	Deskripsi
clientAccessPolicy	string	Konten clientaccesspolicy.xml digunakan oleh Silverlight.
crossDomainPolicy	string	Konten crossdomain.xml digunakan oleh Silverlight.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

IPAccessControl

Kontrol akses IP.

Nama	Jenis	Deskripsi
allow	IPRange[]	Daftar izin IP.

IPRange

Rentang alamat IP dalam skema CIDR.

Nama	Jenis	Deskripsi
address	string	Alamat IP.
name	string	Nama yang mudah diingat untuk rentang alamat IP.
subnetPrefixLength	integer	Panjang awalan subnet mask (lihat notasi CIDR).

StreamingEndpoint

Titik akhir streaming.

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya.
properties.accessControl	StreamingEndpointAccessControl	Definisi kontrol akses titik akhir streaming.
properties.availabilitySetName	string	Fitur ini tidak digunakan lagi, jangan tetapkan nilai untuk properti ini.
properties.cdnEnabled	boolean	Bendera yang diaktifkan CDN.
properties.cdnProfile	string	Nama profil CDN.
properties.cdnProvider	string	Nama penyedia CDN.
properties.created	string	Waktu yang tepat titik akhir streaming dibuat.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Kebijakan akses titik akhir streaming.
properties.customHostNames	string[]	Nama host kustom dari titik akhir streaming
properties.description	string	Deskripsi titik akhir streaming.
properties.freeTrialEndTime	string	Waktu kedaluwarsa uji coba gratis.
properties.hostName	string	Nama host titik akhir streaming.
properties.lastModified	string	Waktu yang tepat titik akhir streaming terakhir diubah.
properties.maxCacheAge	integer	Usia cache maks
properties.provisioningState	string	Status penyediaan titik akhir streaming.
properties.resourceState	StreamingEndpointResourceState	Status sumber daya titik akhir streaming.
properties.scaleUnits	integer	Jumlah unit skala. Gunakan operasi Skala untuk menyesuaikan nilai ini.
sku	ArmStreamingEndpointCurrentSku	Sku titik akhir streaming.
systemData	systemData	Metadata sistem yang berkaitan dengan sumber daya ini.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

StreamingEndpointAccessControl

Definisi kontrol akses titik akhir streaming.

Nama	Jenis	Deskripsi
akamai	AkamaiAccessControl	Kontrol akses Akamai
ip	IPAccessControl	Kontrol akses IP titik akhir streaming.

StreamingEndpointResourceState

Status sumber daya titik akhir streaming.

Nama	Jenis	Deskripsi
Deleting	string	Titik akhir streaming sedang dihapus.
Running	string	Titik akhir streaming sedang berjalan. Ini dapat mengalirkan konten ke klien
Scaling	string	Titik akhir streaming meningkat atau mengurangi unit skala.
Starting	string	Titik akhir streaming beralih ke status berjalan.
Stopped	string	Status awal titik akhir streaming setelah pembuatan. Isi belum siap untuk dialirkan dari titik akhir ini.
Stopping	string	Titik akhir streaming beralih ke status berhenti.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir mengubah sumber daya.