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

Servers - Create

根据请求中指定的配置预配指定的 Analysis Services 服务器。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AnalysisServices/servers/{serverName}?api-version=2017-08-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

给定 Analysis Services 服务器所属的 Azure 资源组的名称。 此名称的长度必须至少为 1 个字符,且不超过 90 个字符。

正则表达式模式: ^[-\w\._\(\)]+$

serverName
path True

string

Analysis Services 服务器的名称。 它必须至少包含 3 个字符,最多 63 个字符。

正则表达式模式: ^[a-z][a-z0-9]*$

subscriptionId
path True

string

Microsoft Azure 订阅的唯一标识符。 此订阅 ID 是每个服务调用的 URI 的一部分。

api-version
query True

string

客户端 API 版本。

请求正文

名称 必需 类型 说明
location True

string

Analysis Services 资源的位置。

sku True

ResourceSku

Analysis Services 资源的 SKU。

properties.asAdministrators

ServerAdministrators

AS 服务器管理员的集合

properties.backupBlobContainerUri

string

备份容器的 SAS 容器 URI。

properties.gatewayDetails

GatewayDetails

为 AS 服务器配置的网关详细信息。

properties.ipV4FirewallSettings

IPv4FirewallSettings

AS 服务器的防火墙设置。

properties.managedMode

ManagedMode

服务器的托管模式 (0 = 非托管,1 = 托管) 。

properties.querypoolConnectionMode

ConnectionMode

如何控制读写服务器参与查询池。
该选项可具有以下值:

  • readOnly - 指示读写服务器不打算参与查询操作
  • all - 指示读写服务器可以参与查询操作
当容量为 1 时指定 readOnly 会导致错误。

properties.serverMonitorMode

ServerMonitorMode

AS 服务器的服务器监视模式

properties.sku

ResourceSku

Analysis Services 资源的 SKU。

tags

object

其他资源预配属性的键值对。

响应

名称 类型 说明
200 OK

AnalysisServicesServer

没问题。 操作已成功完成。

201 Created

AnalysisServicesServer

InProgress。 操作仍在完成。

202 Accepted

AnalysisServicesServer

准备。 操作仍在完成。

Other Status Codes

ErrorResponse

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Create a server.

示例请求

PUT https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.AnalysisServices/servers/azsdktest?api-version=2017-08-01

{
  "sku": {
    "capacity": 1,
    "name": "S1",
    "tier": "Standard"
  },
  "tags": {
    "testKey": "testValue"
  },
  "location": "West US",
  "properties": {
    "asAdministrators": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    }
  }
}

示例响应

{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.AnalysisServices/servers/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "asAdministrators": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "serverFullName": "asazure://nightly1.asazure-int.windows.net/azsdktest",
    "state": "Provisioning"
  },
  "sku": {
    "capacity": 1,
    "name": "S1",
    "tier": "Standard"
  },
  "tags": {
    "testKey": "testValue"
  }
}
{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.AnalysisServices/servers/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "asAdministrators": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Provisioning",
    "serverFullName": "asazure://nightly1.asazure-int.windows.net/azsdktest",
    "state": "Provisioning"
  },
  "sku": {
    "capacity": 1,
    "name": "S1",
    "tier": "Standard"
  },
  "tags": {
    "testKey": "testValue"
  }
}
{
  "id": "/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.AnalysisServices/servers/azsdktest",
  "location": "West US",
  "name": "azsdktest",
  "properties": {
    "asAdministrators": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    },
    "provisioningState": "Preparing",
    "serverFullName": "asazure://nightly1.asazure-int.windows.net/azsdktest",
    "state": "Preparing"
  },
  "sku": {
    "capacity": 1,
    "name": "S1",
    "tier": "Standard"
  },
  "tags": {
    "testKey": "testValue"
  }
}

定义

名称 说明
AnalysisServicesServer

表示 Analysis Services 资源的实例。

ConnectionMode

如何控制读写服务器参与查询池。
该选项可具有以下值:

  • readOnly - 指示读写服务器不打算参与查询操作
  • all - 指示读写服务器可以参与查询操作
当容量为 1 时指定 readOnly 会导致错误。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

描述错误响应的格式。

GatewayDetails

网关详细信息。

IPv4FirewallRule

防火墙规则的详细信息。

IPv4FirewallSettings

防火墙规则数组。

ManagedMode

服务器的托管模式 (0 = 非托管,1 = 托管) 。

ProvisioningState

Analysis Services 资源的当前部署状态。 provisioningState 用于指示资源预配的状态。

ResourceSku

表示 Analysis Services 资源的 SKU 名称和 Azure 定价层。

ServerAdministrators

管理员用户标识的数组。

ServerMonitorMode

AS 服务器的服务器监视模式

SkuTier

SKU 应用到的 Azure 定价层的名称。

State

Analysis Services 资源的当前状态。 状态是指示资源预配之外的更多状态。

AnalysisServicesServer

表示 Analysis Services 资源的实例。

名称 类型 默认值 说明
id

string

表示 Analysis Services 资源的标识符。

location

string

Analysis Services 资源的位置。

name

string

Analysis Services 资源的名称。

properties.asAdministrators

ServerAdministrators

AS 服务器管理员的集合

properties.backupBlobContainerUri

string

备份容器的 SAS 容器 URI。

properties.gatewayDetails

GatewayDetails

为 AS 服务器配置的网关详细信息。

properties.ipV4FirewallSettings

IPv4FirewallSettings

AS 服务器的防火墙设置。

properties.managedMode

ManagedMode

1

服务器的托管模式 (0 = 非托管,1 = 托管) 。

properties.provisioningState

ProvisioningState

Analysis Services 资源的当前部署状态。 provisioningState 用于指示资源预配的状态。

properties.querypoolConnectionMode

ConnectionMode

All

如何控制读写服务器参与查询池。
该选项可具有以下值:

  • readOnly - 指示读写服务器不打算参与查询操作
  • all - 指示读写服务器可以参与查询操作
当容量为 1 时指定 readOnly 会导致错误。

properties.serverFullName

string

Analysis Services 资源的全名。

properties.serverMonitorMode

ServerMonitorMode

1

AS 服务器的服务器监视模式

properties.sku

ResourceSku

Analysis Services 资源的 SKU。

properties.state

State

Analysis Services 资源的当前状态。 状态是指示资源预配之外的更多状态。

sku

ResourceSku

Analysis Services 资源的 SKU。

tags

object

其他资源预配属性的键值对。

type

string

Analysis Services 资源的类型。

ConnectionMode

如何控制读写服务器参与查询池。
该选项可具有以下值:

  • readOnly - 指示读写服务器不打算参与查询操作
  • all - 指示读写服务器可以参与查询操作
当容量为 1 时指定 readOnly 会导致错误。

名称 类型 说明
All

string

ReadOnly

string

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

httpStatusCode

integer

http 状态代码

message

string

错误消息。

subCode

integer

错误子代码

target

string

错误目标。

timeStamp

string

错误的时间戳。

ErrorResponse

描述错误响应的格式。

名称 类型 说明
error

ErrorDetail

错误对象

GatewayDetails

网关详细信息。

名称 类型 说明
dmtsClusterUri

string

DMTS 群集的 URI。

gatewayObjectId

string

网关资源的 DMTS 群集中的网关对象 ID。

gatewayResourceId

string

要与服务器关联的网关资源。

IPv4FirewallRule

防火墙规则的详细信息。

名称 类型 说明
firewallRuleName

string

规则名称。

rangeEnd

string

IPv4 的结束范围。

rangeStart

string

IPv4 的起始范围。

IPv4FirewallSettings

防火墙规则数组。

名称 类型 说明
enablePowerBIService

boolean

启用 PBI 服务的指示器。

firewallRules

IPv4FirewallRule[]

防火墙规则数组。

ManagedMode

服务器的托管模式 (0 = 非托管,1 = 托管) 。

名称 类型 说明
0

Integer

1

Integer

ProvisioningState

Analysis Services 资源的当前部署状态。 provisioningState 用于指示资源预配的状态。

名称 类型 说明
Deleting

string

Failed

string

Paused

string

Pausing

string

Preparing

string

Provisioning

string

Resuming

string

Scaling

string

Succeeded

string

Suspended

string

Suspending

string

Updating

string

ResourceSku

表示 Analysis Services 资源的 SKU 名称和 Azure 定价层。

名称 类型 默认值 说明
capacity

integer

1

只读查询池中的实例数。

name

string

SKU 级别的名称。

tier

SkuTier

SKU 应用到的 Azure 定价层的名称。

ServerAdministrators

管理员用户标识的数组。

名称 类型 说明
members

string[]

管理员用户标识的数组。

ServerMonitorMode

AS 服务器的服务器监视模式

名称 类型 说明
0

Integer

1

Integer

SkuTier

SKU 应用到的 Azure 定价层的名称。

名称 类型 说明
Basic

string

Development

string

Standard

string

State

Analysis Services 资源的当前状态。 状态是指示资源预配之外的更多状态。

名称 类型 说明
Deleting

string

Failed

string

Paused

string

Pausing

string

Preparing

string

Provisioning

string

Resuming

string

Scaling

string

Succeeded

string

Suspended

string

Suspending

string

Updating

string