你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Mediaservices - Create Or Update
创建或更新媒体服务帐户
创建或更新媒体服务帐户
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}?api-version=2023-01-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
account
|
path | True |
string |
媒体服务帐户名称。 |
resource
|
path | True |
string |
Azure 订阅中资源组的名称。 |
subscription
|
path | True |
string |
Microsoft Azure 订阅的唯一标识符。 |
api-version
|
query | True |
string |
要与客户端请求一起使用的 API 的版本。 |
请求正文
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
location | True |
string |
资源所在的地理位置 |
identity |
媒体服务帐户的托管标识。 |
||
properties.encryption |
帐户加密属性。 |
||
properties.keyDelivery |
媒体服务帐户的密钥传递属性。 |
||
properties.minimumTlsVersion |
此帐户请求允许的最低 TLS 版本。 这是一个可选属性。 如果未指定,将使用安全默认值。 |
||
properties.publicNetworkAccess |
媒体服务帐户下的资源是否允许公用网络访问。 |
||
properties.storageAccounts |
此资源的存储帐户。 |
||
properties.storageAuthentication | |||
tags |
object |
资源标记。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 标头
|
|
201 Created |
创建 标头
|
|
Other Status Codes |
详细的错误信息。 |
示例
Create a Media Services account |
Create a Media Services account-managed-identity |
Create a Media Services account
示例请求
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports?api-version=2023-01-01
{
"location": "South Central US",
"tags": {
"key1": "value1",
"key2": "value2"
},
"properties": {
"storageAccounts": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Storage/storageAccounts/teststorageaccount",
"type": "Primary"
}
]
}
}
示例响应
azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Media/locations/westus2/mediaServicesOperationStatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2023-01-01
location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Media/locations/westus2/mediaServicesOperationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2023-01-01
{
"name": "contososports",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports",
"type": "Microsoft.Media/mediaservices",
"location": "South Central US",
"tags": {
"key1": "value1",
"key2": "value2"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
}
},
"properties": {
"provisioningState": "InProgress",
"storageAccounts": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Storage/storageAccounts/teststorageaccount",
"type": "Primary"
}
]
}
}
{
"name": "contososports",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports",
"type": "Microsoft.Media/mediaservices",
"location": "South Central US",
"tags": {
"key1": "value1",
"key2": "value2"
},
"properties": {
"provisioningState": "Succeeded",
"storageAccounts": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Storage/storageAccounts/contososportsstore",
"type": "Primary"
}
]
}
}
Create a Media Services account-managed-identity
示例请求
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports?api-version=2023-01-01
{
"location": "South Central US",
"tags": {
"key1": "value1",
"key2": "value2"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
}
},
"properties": {
"encryption": {
"type": "CustomerKey",
"identity": {
"userAssignedIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1",
"useSystemAssignedIdentity": false
}
},
"storageAccounts": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Storage/storageAccounts/contososportsstore",
"type": "Primary",
"identity": {
"userAssignedIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1",
"useSystemAssignedIdentity": false
}
}
],
"storageAuthentication": "ManagedIdentity",
"publicNetworkAccess": "Enabled",
"keyDelivery": {
"accessControl": {
"defaultAction": "Allow"
}
}
}
}
示例响应
azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Media/locations/westus2/mediaServicesOperationStatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2023-01-01
location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Media/locations/westus2/mediaServicesOperationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2023-01-01
{
"name": "contososports",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports",
"type": "Microsoft.Media/mediaservices",
"location": "South Central US",
"tags": {
"key1": "value1",
"key2": "value2"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
}
},
"properties": {
"provisioningState": "InProgress",
"encryption": {
"type": "CustomerKey",
"keyVaultProperties": {
"keyIdentifier": "https://keyvault.vault.azure.net/keys/key1",
"currentKeyIdentifier": "https://keyvault.vault.azure.net/keys/key1/ver1"
},
"identity": {
"userAssignedIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1",
"useSystemAssignedIdentity": false
}
},
"storageAccounts": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Storage/storageAccounts/contososportsstore",
"type": "Primary",
"identity": {
"userAssignedIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1",
"useSystemAssignedIdentity": false
}
}
],
"storageAuthentication": "ManagedIdentity",
"publicNetworkAccess": "Enabled",
"keyDelivery": {
"accessControl": {
"defaultAction": "Allow"
}
},
"privateEndpointConnections": [
{
"name": "00000000-0000-0000-0000-000000000001",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports/privateEndpointConnections/00000000-0000-0000-0000-000000000001",
"type": "Microsoft.Media/mediaservices/privateEndpointConnections",
"properties": {
"provisioningState": "Succeeded",
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "test description"
},
"privateEndpoint": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/reosuceGroup1/providers/Microsoft.Network/privateEndpoints/pe1"
}
}
},
{
"name": "00000000-0000-0000-0000-000000000002",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports/privateEndpointConnections/00000000-0000-0000-0000-000000000002",
"type": "Microsoft.Media/mediaservices/privateEndpointConnections",
"properties": {
"provisioningState": "Succeeded",
"privateLinkServiceConnectionState": {
"status": "Pending",
"description": "test description"
},
"privateEndpoint": {
"id": "/subscriptions/22222222-2222-2222-2222-222222222222/resourceGroups/reosuceGroup2/providers/Microsoft.Network/privateEndpoints/pe2"
}
}
}
]
}
}
{
"name": "contososports",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports",
"type": "Microsoft.Media/mediaservices",
"location": "South Central US",
"tags": {
"key1": "value1",
"key2": "value2"
},
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {},
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id2": {}
}
},
"properties": {
"provisioningState": "InProgress",
"encryption": {
"type": "CustomerKey",
"keyVaultProperties": {
"keyIdentifier": "https://keyvault.vault.azure.net/keys/key1",
"currentKeyIdentifier": "https://keyvault.vault.azure.net/keys/key1/ver1"
},
"identity": {
"userAssignedIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1",
"useSystemAssignedIdentity": false
}
},
"storageAccounts": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Storage/storageAccounts/contososportsstore",
"type": "Primary",
"identity": {
"userAssignedIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1",
"useSystemAssignedIdentity": false
}
}
],
"storageAuthentication": "ManagedIdentity",
"publicNetworkAccess": "Enabled",
"keyDelivery": {
"accessControl": {
"defaultAction": "Allow"
}
},
"privateEndpointConnections": [
{
"name": "00000000-0000-0000-0000-000000000001",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports/privateEndpointConnections/00000000-0000-0000-0000-000000000001",
"type": "Microsoft.Media/mediaservices/privateEndpointConnections",
"properties": {
"provisioningState": "Succeeded",
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "test description"
},
"privateEndpoint": {
"id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/reosuceGroup1/providers/Microsoft.Network/privateEndpoints/pe1"
}
}
},
{
"name": "00000000-0000-0000-0000-000000000002",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contososports/privateEndpointConnections/00000000-0000-0000-0000-000000000002",
"type": "Microsoft.Media/mediaservices/privateEndpointConnections",
"properties": {
"provisioningState": "Succeeded",
"privateLinkServiceConnectionState": {
"status": "Pending",
"description": "test description"
},
"privateEndpoint": {
"id": "/subscriptions/22222222-2222-2222-2222-222222222222/resourceGroups/reosuceGroup2/providers/Microsoft.Network/privateEndpoints/pe2"
}
}
}
]
}
}
定义
名称 | 说明 |
---|---|
Access |
|
Account |
|
Account |
用于加密帐户密钥的密钥类型。 |
created |
创建资源的标识类型。 |
Default |
密钥传递中 IP 访问控制的行为。 |
Error |
资源管理错误附加信息。 |
Error |
错误详细信息。 |
Error |
错误响应 |
Key |
|
Key |
|
Media |
一个媒体服务帐户。 |
Media |
|
Minimum |
此帐户的请求允许的最低 TLS 版本。 这是一个可选属性。 如果未指定,将使用安全默认值。 |
Private |
专用终结点资源。 |
Private |
专用终结点连接资源。 |
Private |
当前预配状态。 |
Private |
专用终结点连接状态。 |
Private |
有关服务使用者与提供程序之间的连接状态的信息集合。 |
Provisioning |
媒体服务帐户的预配状态。 |
Public |
媒体服务帐户下的资源是否允许公用网络访问。 |
Resource |
|
Storage |
存储帐户详细信息。 |
Storage |
存储帐户的类型。 |
Storage |
|
system |
与资源的创建和上次修改相关的元数据。 |
User |
AccessControl
名称 | 类型 | 说明 |
---|---|---|
defaultAction |
密钥传递中 IP 访问控制的行为。 |
|
ipAllowList |
string[] |
密钥传递中访问控制的 IP 允许列表。 如果默认操作设置为“允许”,则 IP 允许列表必须为空。 |
AccountEncryption
名称 | 类型 | 说明 |
---|---|---|
identity |
密钥保管库标识。 |
|
keyVaultProperties |
用于加密帐户的密钥的属性。 |
|
status |
string |
密钥保管库映射的当前状态。 |
type |
用于加密帐户密钥的密钥类型。 |
AccountEncryptionKeyType
用于加密帐户密钥的密钥类型。
名称 | 类型 | 说明 |
---|---|---|
CustomerKey |
string |
帐户密钥使用客户密钥进行加密。 |
SystemKey |
string |
帐户密钥使用系统密钥进行加密。 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
密钥传递中 IP 访问控制的行为。
名称 | 类型 | 说明 |
---|---|---|
Allow |
string |
允许所有公共 IP 地址。 |
Deny |
string |
阻止公共 IP 地址。 |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorResponse
错误响应
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
KeyDelivery
名称 | 类型 | 说明 |
---|---|---|
accessControl |
密钥传递的访问控制属性。 |
KeyVaultProperties
名称 | 类型 | 说明 |
---|---|---|
currentKeyIdentifier |
string |
用于加密媒体服务帐户的当前密钥,包括密钥版本。 |
keyIdentifier |
string |
用于加密帐户的密钥保管库密钥的 URL。 例如 https://vault/keys/mykey/version1) ,密钥可以 (版本控制,也可以引用没有版本 (的密钥 https://vault/keys/mykey). |
MediaService
一个媒体服务帐户。
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
id |
string |
资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
identity |
媒体服务的托管标识帐户。 |
||
location |
string |
资源所在的地理位置 |
|
name |
string |
资源的名称 |
|
properties.encryption |
帐户加密属性。 |
||
properties.keyDelivery |
媒体服务帐户的密钥传递属性。 |
||
properties.mediaServiceId |
string |
媒体服务帐户 ID。 |
|
properties.minimumTlsVersion | Tls12 |
此帐户的请求允许的最低 TLS 版本。 这是一个可选属性。 如果未指定,将使用安全默认值。 |
|
properties.privateEndpointConnections |
Connections为媒体服务帐户创建的专用终结点。 |
||
properties.provisioningState |
媒体服务帐户的预配状态。 |
||
properties.publicNetworkAccess |
媒体服务帐户下的资源是否允许公用网络访问。 |
||
properties.storageAccounts |
此资源的存储帐户。 |
||
properties.storageAuthentication | |||
systemData |
与此资源相关的系统元数据。 |
||
tags |
object |
资源标记。 |
|
type |
string |
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
MediaServiceIdentity
名称 | 类型 | 说明 |
---|---|---|
principalId |
string |
标识的主体 ID。 |
tenantId |
string |
标识的租户 ID。 |
type |
string |
标识类型。 |
userAssignedIdentities |
<string,
User |
用户分配的托管标识。 |
MinimumTlsVersion
此帐户的请求允许的最低 TLS 版本。 这是一个可选属性。 如果未指定,将使用安全默认值。
名称 | 类型 | 说明 |
---|---|---|
Tls10 |
string |
最低 TLS 版本为 TLS 1.0。 |
Tls11 |
string |
最低 TLS 版本为 TLS 1.1。 |
Tls12 |
string |
最低 TLS 版本为 TLS 1.2。 |
Tls13 |
string |
最低 TLS 版本为 TLS 1.3。 |
PrivateEndpoint
专用终结点资源。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
专用终结点的 ARM 标识符 |
PrivateEndpointConnection
专用终结点连接资源。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
资源的名称 |
properties.privateEndpoint |
专用终结点的资源。 |
|
properties.privateLinkServiceConnectionState |
有关服务使用者与提供程序之间的连接状态的信息集合。 |
|
properties.provisioningState |
专用终结点连接资源的预配状态。 |
|
type |
string |
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
PrivateEndpointConnectionProvisioningState
当前预配状态。
名称 | 类型 | 说明 |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
PrivateEndpointServiceConnectionStatus
专用终结点连接状态。
名称 | 类型 | 说明 |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
有关服务使用者与提供程序之间的连接状态的信息集合。
名称 | 类型 | 说明 |
---|---|---|
actionsRequired |
string |
一条消息,指示服务提供商的更改是否需要对使用者进行任何更新。 |
description |
string |
批准/拒绝连接的原因。 |
status |
指示连接是否已由服务的所有者批准/拒绝/删除。 |
ProvisioningState
媒体服务帐户的预配状态。
名称 | 类型 | 说明 |
---|---|---|
Failed |
string |
预配状态失败。 |
InProgress |
string |
预配状态正在进行中。 |
Succeeded |
string |
预配状态成功。 |
PublicNetworkAccess
媒体服务帐户下的资源是否允许公用网络访问。
名称 | 类型 | 说明 |
---|---|---|
Disabled |
string |
已禁用公用网络访问。 |
Enabled |
string |
已启用公用网络访问。 |
ResourceIdentity
名称 | 类型 | 说明 |
---|---|---|
useSystemAssignedIdentity |
boolean |
指示是否使用系统分配的托管标识。 与用户分配的托管标识互斥。 |
userAssignedIdentity |
string |
用户分配了托管标识的 ARM ID,用于访问资源。 |
StorageAccount
存储帐户详细信息。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
存储帐户资源的 ID。 媒体服务依赖于表和队列以及 Blob,因此主存储帐户必须是标准存储帐户, (Microsoft.ClassicStorage 或 Microsoft.Storage) 。 只能将 Blob 存储帐户添加为辅助存储帐户。 |
identity |
存储帐户标识。 |
|
status |
string |
存储帐户映射的当前状态。 |
type |
存储帐户的类型。 |
StorageAccountType
存储帐户的类型。
名称 | 类型 | 说明 |
---|---|---|
Primary |
string |
媒体服务帐户的主存储帐户。 |
Secondary |
string |
媒体服务帐户的辅助存储帐户。 |
StorageAuthentication
名称 | 类型 | 说明 |
---|---|---|
ManagedIdentity |
string |
托管标识身份验证。 |
System |
string |
系统身份验证。 |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源的创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |
UserAssignedManagedIdentity
名称 | 类型 | 说明 |
---|---|---|
clientId |
string |
客户端 ID。 |
principalId |
string |
主体 ID。 |