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 パラメーター

名前	/	必須	型	説明
accountName	path	True	string	Media Services アカウント名。
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	スケールユニットの数。この値を調整するには、Scale 操作を使用します。
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	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"
  }
}

定義

名前	説明
AkamaiAccessControl	Akamai アクセス制御
AkamaiSignatureHeaderAuthenticationKey	Akamai Signature ヘッダー認証キー。
ArmStreamingEndpointCurrentSku	ストリーミングエンドポイントの現在の SKU。
createdByType	リソースを作成した ID の種類。
CrossSiteAccessPolicies	クライアントアクセスポリシー。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
IPAccessControl	IP アクセス制御。
IPRange	CIDR スキームの IP アドレス範囲。
StreamingEndpoint	ストリーミングエンドポイント。
StreamingEndpointAccessControl	ストリーミングエンドポイントのアクセス制御の定義。
StreamingEndpointResourceState	ストリーミングエンドポイントのリソースの状態。
systemData	リソースの作成と最後の変更に関連するメタデータ。

AkamaiAccessControl

Akamai アクセス制御

名前	型	説明
akamaiSignatureHeaderAuthenticationKeyList	AkamaiSignatureHeaderAuthenticationKey[]	認証キーの一覧

AkamaiSignatureHeaderAuthenticationKey

Akamai Signature ヘッダー認証キー。

名前	型	説明
base64Key	string	認証キー
expiration	string	認証キーの有効期限。
identifier	string	キーの識別子

ArmStreamingEndpointCurrentSku

ストリーミングエンドポイントの現在の SKU。

名前	型	説明
capacity	integer	ストリーミングエンドポイント SKU の容量。
name	string	ストリーミングエンドポイント SKU 名。

createdByType

リソースを作成した ID の種類。

名前	型	説明
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

クライアントアクセスポリシー。

名前	型	説明
clientAccessPolicy	string	Silverlight で使用 clientaccesspolicy.xml の内容。
crossDomainPolicy	string	Silverlight で使用 crossdomain.xml の内容。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細です。
message	string	エラーメッセージ。
target	string	エラーのターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	error オブジェクト。

IPAccessControl

IP アクセス制御。

名前	型	説明
allow	IPRange[]	IP 許可リスト。

IPRange

CIDR スキームの IP アドレス範囲。

名前	型	説明
address	string	IP アドレスです。
name	string	IP アドレス範囲のフレンドリ名。
subnetPrefixLength	integer	サブネットマスクプレフィックスの長さ (CIDR 表記を参照)。

StreamingEndpoint

ストリーミングエンドポイント。

名前	型	説明
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	スケールユニットの数。この値を調整するには、Scale 操作を使用します。
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	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有