Streaming Endpoints - Create

Ссылка

Служба:: Media Services

Версия API:: 2022-11-01

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

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}

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountName	path	True	string	Имя учетной записи Служб мультимедиа.
resourceGroupName	path	True	string	Имя группы ресурсов в подписке Azure.
streamingEndpointName	path	True	string	Имя конечной точки потоковой передачи, максимальная длина — 24. Шаблон регулярного выражения: `^[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

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();
    }

    // Use "Map.of" if available
    @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

Пример ответа

Код состояния:: 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

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

Код состояния:: 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).