Streaming Endpoints - Create

Service:

Media Services

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

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

Имя	В	Обязательно	Тип	Описание
accountName	path	True	string	Имя учетной записи Служб мультимедиа.
resourceGroupName	path	True	string	Имя группы ресурсов в подписке Azure.
streamingEndpointName	path	True	string	Имя конечной точки потоковой передачи, максимальная длина — 24. Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
subscriptionId	path	True	string	Уникальный идентификатор подписки Microsoft Azure.
api-version	query	True	string	Версия API, используемая с клиентским запросом.
autoStart	query		boolean	Флаг указывает, следует ли автоматически запускать ресурс при создании.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
properties.scaleUnits	True	integer	Количество единиц масштабирования. Используйте операцию Масштабирование, чтобы изменить это значение.
properties.accessControl		StreamingEndpointAccessControl	Определение управления доступом конечной точки потоковой передачи.
properties.availabilitySetName		string	Эта функция является устаревшей, не устанавливайте значение для этого свойства.
properties.cdnEnabled		boolean	Флаг CDN включен.
properties.cdnProfile		string	Имя профиля CDN.
properties.cdnProvider		string	Имя поставщика CDN.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Политики доступа к конечной точке потоковой передачи.
properties.customHostNames		string[]	Пользовательские имена узлов конечной точки потоковой передачи
properties.description		string	Описание конечной точки потоковой передачи.
properties.maxCacheAge		integer	Максимальный возраст кэша
sku		ArmStreamingEndpointCurrentSku	SKU конечной точки потоковой передачи.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	StreamingEndpoint	Все в порядке. Запрос выполнен успешно.
201 Created	StreamingEndpoint	Создан. Запрос принят для обработки, и операция будет выполнена асинхронно. Дополнительные https://go.microsoft.com/fwlink/?linkid=2087017 сведения о мониторинге асинхронных операций Azure с помощью заголовка ответа Azure-AsyncOperation.
Other Status Codes	ErrorResponse	Ответ об ошибке потоковой передачи, описывающий причину сбоя операции.

Примеры

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

Определения

Имя	Описание
AkamaiAccessControl	Управление доступом Akamai
AkamaiSignatureHeaderAuthenticationKey	Ключ проверки подлинности заголовка подписи Akamai.
ArmStreamingEndpointCurrentSku	Текущий номер SKU конечной точки потоковой передачи.
createdByType	Тип удостоверения, создавшего ресурс.
CrossSiteAccessPolicies	Политика клиентского доступа.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
IPAccessControl	Управление доступом по IP-адресу.
IPRange	Диапазон IP-адресов в схеме CIDR.
StreamingEndpoint	Конечная точка потоковой передачи.
StreamingEndpointAccessControl	Определение управления доступом к конечной точке потоковой передачи.
StreamingEndpointResourceState	Состояние ресурса конечной точки потоковой передачи.
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.

AkamaiAccessControl

Управление доступом Akamai

Имя	Тип	Описание
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	Список ключей проверки подлинности

AkamaiSignatureHeaderAuthenticationKey

Ключ проверки подлинности заголовка подписи Akamai.

Имя	Тип	Описание
base64Key	string	ключ проверки подлинности
expiration	string	Срок действия ключа проверки подлинности.
identifier	string	идентификатор ключа

ArmStreamingEndpointCurrentSku

Текущий номер SKU конечной точки потоковой передачи.

Имя	Тип	Описание
capacity	integer	Емкость SKU конечной точки потоковой передачи.
name	string	Имя SKU конечной точки потоковой передачи.

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Политика клиентского доступа.

Имя	Тип	Описание
clientAccessPolicy	string	Содержимое clientaccesspolicy.xml, используемое Silverlight.
crossDomainPolicy	string	Содержимое crossdomain.xml, используемое Silverlight.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

IPAccessControl

Управление доступом по IP-адресу.

Имя	Тип	Описание
allow	IPRange[]	Список разрешенных IP-адресов.

IPRange

Диапазон IP-адресов в схеме CIDR.

Имя	Тип	Описание
address	string	IP-адрес.
name	string	Понятное имя диапазона IP-адресов.
subnetPrefixLength	integer	Длина префикса маски подсети (см. нотацию CIDR).

StreamingEndpoint

Конечная точка потоковой передачи.

Имя	Тип	Описание
id	string	Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса.
properties.accessControl	StreamingEndpointAccessControl	Определение управления доступом конечной точки потоковой передачи.
properties.availabilitySetName	string	Эта функция является устаревшей, не устанавливайте значение для этого свойства.
properties.cdnEnabled	boolean	Флаг CDN включен.
properties.cdnProfile	string	Имя профиля CDN.
properties.cdnProvider	string	Имя поставщика CDN.
properties.created	string	Точное время создания конечной точки потоковой передачи.
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Политики доступа к конечной точке потоковой передачи.
properties.customHostNames	string[]	Пользовательские имена узлов конечной точки потоковой передачи
properties.description	string	Описание конечной точки потоковой передачи.
properties.freeTrialEndTime	string	Срок действия бесплатной пробной версии.
properties.hostName	string	Имя узла конечной точки потоковой передачи.
properties.lastModified	string	Точное время последнего изменения конечной точки потоковой передачи.
properties.maxCacheAge	integer	Максимальный возраст кэша
properties.provisioningState	string	Состояние подготовки конечной точки потоковой передачи.
properties.resourceState	StreamingEndpointResourceState	Состояние ресурса конечной точки потоковой передачи.
properties.scaleUnits	integer	Количество единиц масштабирования. Используйте операцию Масштабирование, чтобы изменить это значение.
sku	ArmStreamingEndpointCurrentSku	SKU конечной точки потоковой передачи.
systemData	systemData	Системные метаданные, относящиеся к этому ресурсу.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

StreamingEndpointAccessControl

Определение управления доступом к конечной точке потоковой передачи.

Имя	Тип	Описание
akamai	AkamaiAccessControl	Управление доступом Akamai
ip	IPAccessControl	Управление доступом по IP-адресу конечной точки потоковой передачи.

StreamingEndpointResourceState

Состояние ресурса конечной точки потоковой передачи.

Имя	Тип	Описание
Deleting	string	Выполняется удаление конечной точки потоковой передачи.
Running	string	Конечная точка потоковой передачи запущена. Он может передавать содержимое в потоковую передачу клиентам
Scaling	string	Конечная точка потоковой передачи увеличивает или уменьшает единицы масштабирования.
Starting	string	Конечная точка потоковой передачи переходит в рабочее состояние.
Stopped	string	Начальное состояние конечной точки потоковой передачи после ее создания. Содержимое не готово для потоковой передачи из этой конечной точки.
Stopping	string	Конечная точка потоковой передачи останавливается.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Удостоверение, которое в последний раз изменял ресурс.
lastModifiedByType	createdByType	Тип удостоверения, изменяющего ресурс в последний раз.