你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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	媒体服务帐户名称。
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	Created. 已接受请求进行处理，操作将以异步方式完成。有关使用 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 签名标头身份验证密钥。
ArmStreamingEndpointCurrentSku	流式处理终结点当前 SKU。
createdByType	创建资源的标识类型。
CrossSiteAccessPolicies	客户端访问策略。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
IPAccessControl	IP 访问控制。
IPRange	CIDR 方案中的 IP 地址范围。
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	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	错误对象。

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	缩放单元数。使用缩放操作调整此值。
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	上次修改资源的标识类型。

通过