Streaming Endpoints - Create

참조

서비스:: Media Services

API 버전:: 2022-11-01

StreamingEndpoint 만들기
스트리밍 엔드포인트를 만듭니다.

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 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountName	path	True	string	Media Services 계정 이름입니다.
resourceGroupName	path	True	string	Azure 구독 내 리소스 그룹의 이름입니다.
streamingEndpointName	path	True	string	스트리밍 엔드포인트의 이름, 최대 길이는 24입니다. regex 패턴: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
subscriptionId	path	True	string	Microsoft Azure 구독의 고유 식별자입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다.
autoStart	query		boolean	플래그는 리소스를 만들 때 자동으로 시작해야 하는지를 나타냅니다.

요청 본문

Name	필수	형식	Description
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	리소스 태그.

응답

Name	형식	Description
200 OK	StreamingEndpoint	OK. 요청이 성공했습니다.
201 Created	StreamingEndpoint	만들어졌습니다. 처리를 위해 요청이 수락되었으며 작업이 비동기적으로 완료됩니다. Azure-AsyncOperation 응답 헤더를 사용하여 비동기 Azure 작업을 모니터링하는 방법에 대한 자세한 내용은 를 참조하세요 https://go.microsoft.com/fwlink/?linkid=2087017 .
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"
  }
}

정의

Name	Description
AkamaiAccessControl	Akamai 액세스 제어
AkamaiSignatureHeaderAuthenticationKey	Akamai 서명 헤더 인증 키입니다.
ArmStreamingEndpointCurrentSku	스트리밍 엔드포인트 현재 sku입니다.
createdByType	리소스를 만든 ID 유형입니다.
CrossSiteAccessPolicies	클라이언트 액세스 정책입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
IPAccessControl	IP 액세스 제어입니다.
IPRange	CIDR 체계의 IP 주소 범위입니다.
StreamingEndpoint	스트리밍 엔드포인트입니다.
StreamingEndpointAccessControl	스트리밍 엔드포인트 액세스 제어 정의.
StreamingEndpointResourceState	스트리밍 엔드포인트의 리소스 상태입니다.
systemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

AkamaiAccessControl

Akamai 액세스 제어

Name	형식	Description
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	인증 키 목록

AkamaiSignatureHeaderAuthenticationKey

Akamai 서명 헤더 인증 키입니다.

Name	형식	Description
base64Key	string	인증 키
expiration	string	인증 키의 만료 시간입니다.
identifier	string	키의 식별자

ArmStreamingEndpointCurrentSku

스트리밍 엔드포인트 현재 sku입니다.

Name	형식	Description
capacity	integer	스트리밍 엔드포인트 sku 용량입니다.
name	string	스트리밍 엔드포인트 sku 이름입니다.

createdByType

리소스를 만든 ID 유형입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

클라이언트 액세스 정책입니다.

Name	형식	Description
clientAccessPolicy	string	Silverlight에서 사용하는 clientaccesspolicy.xml 콘텐츠입니다.
crossDomainPolicy	string	Silverlight에서 사용하는 crossdomain.xml 콘텐츠입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

IPAccessControl

IP 액세스 제어입니다.

Name	형식	Description
allow	IPRange[]	IP 허용 목록입니다.

IPRange

CIDR 체계의 IP 주소 범위입니다.

Name	형식	Description
address	string	IP 주소입니다.
name	string	IP 주소 범위의 이름입니다.
subnetPrefixLength	integer	서브넷 마스크 접두사 길이(CIDR 표기법 참조).

StreamingEndpoint

스트리밍 엔드포인트입니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /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

스트리밍 엔드포인트 액세스 제어 정의.

Name	형식	Description
akamai	AkamaiAccessControl	Akamai의 액세스 제어
ip	IPAccessControl	스트리밍 엔드포인트의 IP 액세스 제어입니다.

StreamingEndpointResourceState

스트리밍 엔드포인트의 리소스 상태입니다.

Name	형식	Description
Deleting	string	스트리밍 엔드포인트를 삭제하는 중입니다.
Running	string	스트리밍 엔드포인트가 실행 중입니다. 클라이언트에 콘텐츠를 스트리밍할 수 있습니다.
Scaling	string	스트리밍 엔드포인트는 배율 단위를 늘리거나 감소시키고 있습니다.
Starting	string	스트리밍 엔드포인트가 실행 중 상태로 전환되고 있습니다.
Stopped	string	만든 후 스트리밍 엔드포인트의 초기 상태입니다. 이 엔드포인트에서 콘텐츠를 스트리밍할 준비가 되지 않았습니다.
Stopping	string	스트리밍 엔드포인트가 중지됨 중 상태로 전환되고 있습니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	UTC(리소스 만들기)의 타임스탬프입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID 유형입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID 유형입니다.

다음을 통해 공유