你当前正在访问 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 参数

名称 必需 类型 说明
accountName
path True

string

媒体服务帐户名称。

resourceGroupName
path True

string

Azure 订阅中资源组的名称。

subscriptionId
path True

string

Microsoft Azure 订阅的唯一标识符。

api-version
query True

string

要与客户端请求一起使用的 API 的版本。

请求正文

名称 必需 类型 说明
location True

string

资源所在的地理位置

identity

MediaServiceIdentity

媒体服务帐户的托管标识。

properties.encryption

AccountEncryption

帐户加密属性。

properties.keyDelivery

KeyDelivery

媒体服务帐户的密钥传递属性。

properties.minimumTlsVersion

MinimumTlsVersion

此帐户请求允许的最低 TLS 版本。 这是一个可选属性。 如果未指定,将使用安全默认值。

properties.publicNetworkAccess

PublicNetworkAccess

媒体服务帐户下的资源是否允许公用网络访问。

properties.storageAccounts

StorageAccount[]

此资源的存储帐户。

properties.storageAuthentication

StorageAuthentication

tags

object

资源标记。

响应

名称 类型 说明
200 OK

MediaService

确定

标头

  • Retry-After: integer
  • Location: string
  • Azure-AsyncOperation: string
201 Created

MediaService

创建

标头

  • Retry-After: integer
  • Location: string
  • Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

详细的错误信息。

示例

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

定义

名称 说明
AccessControl
AccountEncryption
AccountEncryptionKeyType

用于加密帐户密钥的密钥类型。

createdByType

创建资源的标识类型。

DefaultAction

密钥传递中 IP 访问控制的行为。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

KeyDelivery
KeyVaultProperties
MediaService

一个媒体服务帐户。

MediaServiceIdentity
MinimumTlsVersion

此帐户的请求允许的最低 TLS 版本。 这是一个可选属性。 如果未指定,将使用安全默认值。

PrivateEndpoint

专用终结点资源。

PrivateEndpointConnection

专用终结点连接资源。

PrivateEndpointConnectionProvisioningState

当前预配状态。

PrivateEndpointServiceConnectionStatus

专用终结点连接状态。

PrivateLinkServiceConnectionState

有关服务使用者与提供程序之间的连接状态的信息集合。

ProvisioningState

媒体服务帐户的预配状态。

PublicNetworkAccess

媒体服务帐户下的资源是否允许公用网络访问。

ResourceIdentity
StorageAccount

存储帐户详细信息。

StorageAccountType

存储帐户的类型。

StorageAuthentication
systemData

与资源的创建和上次修改相关的元数据。

UserAssignedManagedIdentity

AccessControl

名称 类型 说明
defaultAction

DefaultAction

密钥传递中 IP 访问控制的行为。

ipAllowList

string[]

密钥传递中访问控制的 IP 允许列表。 如果默认操作设置为“允许”,则 IP 允许列表必须为空。

AccountEncryption

名称 类型 说明
identity

ResourceIdentity

密钥保管库标识。

keyVaultProperties

KeyVaultProperties

用于加密帐户的密钥的属性。

status

string

密钥保管库映射的当前状态。

type

AccountEncryptionKeyType

用于加密帐户密钥的密钥类型。

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

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

KeyDelivery

名称 类型 说明
accessControl

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

MediaServiceIdentity

媒体服务的托管标识帐户。

location

string

资源所在的地理位置

name

string

资源的名称

properties.encryption

AccountEncryption

帐户加密属性。

properties.keyDelivery

KeyDelivery

媒体服务帐户的密钥传递属性。

properties.mediaServiceId

string

媒体服务帐户 ID。

properties.minimumTlsVersion

MinimumTlsVersion

Tls12

此帐户的请求允许的最低 TLS 版本。 这是一个可选属性。 如果未指定,将使用安全默认值。

properties.privateEndpointConnections

PrivateEndpointConnection[]

Connections为媒体服务帐户创建的专用终结点。

properties.provisioningState

ProvisioningState

媒体服务帐户的预配状态。

properties.publicNetworkAccess

PublicNetworkAccess

媒体服务帐户下的资源是否允许公用网络访问。

properties.storageAccounts

StorageAccount[]

此资源的存储帐户。

properties.storageAuthentication

StorageAuthentication

systemData

systemData

与此资源相关的系统元数据。

tags

object

资源标记。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

MediaServiceIdentity

名称 类型 说明
principalId

string

标识的主体 ID。

tenantId

string

标识的租户 ID。

type

string

标识类型。

userAssignedIdentities

<string,  UserAssignedManagedIdentity>

用户分配的托管标识。

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

PrivateEndpoint

专用终结点的资源。

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

有关服务使用者与提供程序之间的连接状态的信息集合。

properties.provisioningState

PrivateEndpointConnectionProvisioningState

专用终结点连接资源的预配状态。

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

PrivateEndpointServiceConnectionStatus

指示连接是否已由服务的所有者批准/拒绝/删除。

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

ResourceIdentity

存储帐户标识。

status

string

存储帐户映射的当前状态。

type

StorageAccountType

存储帐户的类型。

StorageAccountType

存储帐户的类型。

名称 类型 说明
Primary

string

媒体服务帐户的主存储帐户。

Secondary

string

媒体服务帐户的辅助存储帐户。

StorageAuthentication

名称 类型 说明
ManagedIdentity

string

托管标识身份验证。

System

string

系统身份验证。

systemData

与资源的创建和上次修改相关的元数据。

名称 类型 说明
createdAt

string

资源的创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源上次修改的时间戳 (UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识类型。

UserAssignedManagedIdentity

名称 类型 说明
clientId

string

客户端 ID。

principalId

string

主体 ID。