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

OK です。 操作は正常に完了しました。

201 Created

AnalysisServicesServer

InProgress。 操作はまだ完了しています。

202 Accepted

AnalysisServicesServer

準備。 操作はまだ完了しています。

Other Status Codes

ErrorResponse

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 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

管理者ユーザー ID の配列。

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

error オブジェクト

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

管理者ユーザー ID の配列。

名前 説明
members

string[]

管理者ユーザー ID の配列。

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