Servers - Update

Updates den aktuellen Zustand des angegebenen Analysis Services-Servers.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Azure-Ressourcengruppe, zu der ein bestimmter Analysis Services-Server gehört. Dieser Name muss mindestens 1 Zeichen lang und nicht mehr als 90 sein.

RegEx-Muster: ^[-\w\._\(\)]+$

serverName
path True

string

Der Name des Analysis Services-Servers. Er muss mindestens 3 Zeichen lang sein und darf nicht mehr als 63 Zeichen lang sein.

RegEx-Muster: ^[a-z][a-z0-9]*$

subscriptionId
path True

string

Ein eindeutiger Bezeichner für ein Microsoft Azure-Abonnement. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Die Client-API-Version.

Anforderungstext

Name Typ Beschreibung
properties.asAdministrators

ServerAdministrators

Eine Sammlung von AS-Serveradministratoren

properties.backupBlobContainerUri

string

Der SAS-Container-URI für den Sicherungscontainer.

properties.gatewayDetails

GatewayDetails

Die Gatewaydetails, die für den AS-Server konfiguriert sind.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Die Firewalleinstellungen für den AS-Server.

properties.managedMode

ManagedMode

Der verwaltete Modus des Servers (0 = nicht verwaltet, 1 = verwaltet).

properties.querypoolConnectionMode

ConnectionMode

Wie die Teilnahme des Lese-/Schreibservers am Abfragepool gesteuert wird.
Die folgenden Werte sind möglich:

  • readOnly: Gibt an, dass der Lese-/Schreibserver nicht an Abfragevorgängen teilnehmen soll.
  • all: Gibt an, dass der Lese-/Schreibserver an Abfragevorgängen teilnehmen kann.
Die Angabe von readOnly, wenn die Kapazität 1 beträgt, führt zu einem Fehler.

properties.serverMonitorMode

ServerMonitorMode

Der Servermonitormodus für den AS-Server

sku

ResourceSku

Die SKU der Analysis Services-Ressource.

tags

object

Schlüssel-Wert-Paare mit zusätzlichen Bereitstellungseigenschaften.

Antworten

Name Typ Beschreibung
200 OK

AnalysisServicesServer

OK

202 Accepted

AnalysisServicesServer

Akzeptiert

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Update a server.

Beispielanforderung

PATCH 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"
  },
  "properties": {
    "asAdministrators": {
      "members": [
        "azsdktest@microsoft.com",
        "azsdktest2@microsoft.com"
      ]
    }
  }
}

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
AnalysisServicesServer

Stellt eine instance einer Analysis Services-Ressource dar.

AnalysisServicesServerUpdateParameters

Spezifikation der Bereitstellungsanforderung

ConnectionMode

Wie die Teilnahme des Lese-/Schreibservers am Abfragepool gesteuert wird.
Die folgenden Werte sind möglich:

  • readOnly: Gibt an, dass der Lese-/Schreibserver nicht an Abfragevorgängen teilnehmen soll.
  • all: Gibt an, dass der Lese-/Schreibserver an Abfragevorgängen teilnehmen kann.
Die Angabe von readOnly, wenn die Kapazität 1 beträgt, führt zu einem Fehler.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Beschreibt das Format der Fehlerantwort.

GatewayDetails

Die Gatewaydetails.

IPv4FirewallRule

Das Detail der Firewallregel.

IPv4FirewallSettings

Ein Array von Firewallregeln.

ManagedMode

Der verwaltete Modus des Servers (0 = nicht verwaltet, 1 = verwaltet).

ProvisioningState

Der aktuelle Bereitstellungsstatus der Analysis Services-Ressource. ProvisioningState gibt Zustände für die Ressourcenbereitstellung an.

ResourceSku

Stellt den SKU-Namen und den Azure-Tarif für die Analysis Services-Ressource dar.

ServerAdministrators

Ein Array von Administratorbenutzeridentitäten.

ServerMonitorMode

Der Servermonitormodus für den AS-Server

SkuTier

Der Name des Azure-Tarifs, für den die SKU gilt.

State

Der aktuelle Zustand der Analysis Services-Ressource. Der Zustand ist, um mehr Zustände außerhalb der Ressourcenbereitstellung anzugeben.

AnalysisServicesServer

Stellt eine instance einer Analysis Services-Ressource dar.

Name Typ Standardwert Beschreibung
id

string

Ein Bezeichner, der die Analysis Services-Ressource darstellt.

location

string

Speicherort der Analysis Services-Ressource.

name

string

Der Name der Analysis Services-Ressource.

properties.asAdministrators

ServerAdministrators

Eine Sammlung von AS-Serveradministratoren

properties.backupBlobContainerUri

string

Der SAS-Container-URI für den Sicherungscontainer.

properties.gatewayDetails

GatewayDetails

Die Gatewaydetails, die für den AS-Server konfiguriert sind.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Die Firewalleinstellungen für den AS-Server.

properties.managedMode

ManagedMode

1

Der verwaltete Modus des Servers (0 = nicht verwaltet, 1 = verwaltet).

properties.provisioningState

ProvisioningState

Der aktuelle Bereitstellungsstatus der Analysis Services-Ressource. ProvisioningState gibt Zustände für die Ressourcenbereitstellung an.

properties.querypoolConnectionMode

ConnectionMode

All

Wie die Teilnahme des Lese-/Schreibservers am Abfragepool gesteuert wird.
Die folgenden Werte sind möglich:

  • readOnly: Gibt an, dass der Lese-/Schreibserver nicht an Abfragevorgängen teilnehmen soll.
  • all: Gibt an, dass der Lese-/Schreibserver an Abfragevorgängen teilnehmen kann.
Die Angabe von readOnly, wenn die Kapazität 1 beträgt, führt zu einem Fehler.

properties.serverFullName

string

Der vollständige Name der Analysis Services-Ressource.

properties.serverMonitorMode

ServerMonitorMode

1

Der Servermonitormodus für den AS-Server

properties.sku

ResourceSku

Die SKU der Analysis Services-Ressource.

properties.state

State

Der aktuelle Zustand der Analysis Services-Ressource. Der Zustand ist, um mehr Zustände außerhalb der Ressourcenbereitstellung anzugeben.

sku

ResourceSku

Die SKU der Analysis Services-Ressource.

tags

object

Schlüssel-Wert-Paare zusätzlicher Ressourcenbereitstellungseigenschaften.

type

string

Der Typ der Analysis Services-Ressource.

AnalysisServicesServerUpdateParameters

Spezifikation der Bereitstellungsanforderung

Name Typ Standardwert Beschreibung
properties.asAdministrators

ServerAdministrators

Eine Sammlung von AS-Serveradministratoren

properties.backupBlobContainerUri

string

Der SAS-Container-URI für den Sicherungscontainer.

properties.gatewayDetails

GatewayDetails

Die Gatewaydetails, die für den AS-Server konfiguriert sind.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Die Firewalleinstellungen für den AS-Server.

properties.managedMode

ManagedMode

1

Der verwaltete Modus des Servers (0 = nicht verwaltet, 1 = verwaltet).

properties.querypoolConnectionMode

ConnectionMode

All

Wie die Teilnahme des Lese-/Schreibservers am Abfragepool gesteuert wird.
Die folgenden Werte sind möglich:

  • readOnly: Gibt an, dass der Lese-/Schreibserver nicht an Abfragevorgängen teilnehmen soll.
  • all: Gibt an, dass der Lese-/Schreibserver an Abfragevorgängen teilnehmen kann.
Die Angabe von readOnly, wenn die Kapazität 1 beträgt, führt zu einem Fehler.

properties.serverMonitorMode

ServerMonitorMode

1

Der Servermonitormodus für den AS-Server

sku

ResourceSku

Die SKU der Analysis Services-Ressource.

tags

object

Schlüssel-Wert-Paare mit zusätzlichen Bereitstellungseigenschaften.

ConnectionMode

Wie die Teilnahme des Lese-/Schreibservers am Abfragepool gesteuert wird.
Die folgenden Werte sind möglich:

  • readOnly: Gibt an, dass der Lese-/Schreibserver nicht an Abfragevorgängen teilnehmen soll.
  • all: Gibt an, dass der Lese-/Schreibserver an Abfragevorgängen teilnehmen kann.
Die Angabe von readOnly, wenn die Kapazität 1 beträgt, führt zu einem Fehler.

Name Typ Beschreibung
All

string

ReadOnly

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

httpStatusCode

integer

Http-status-Code

message

string

Die Fehlermeldung.

subCode

integer

Der Fehleruntercode

target

string

Das Fehlerziel.

timeStamp

string

der Zeitstempel für den Fehler.

ErrorResponse

Beschreibt das Format der Fehlerantwort.

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt

GatewayDetails

Die Gatewaydetails.

Name Typ Beschreibung
dmtsClusterUri

string

URI des DMTS-Clusters.

gatewayObjectId

string

Gatewayobjekt-ID aus dem DMTS-Cluster für die Gatewayressource.

gatewayResourceId

string

Gatewayressource, die dem Server zugeordnet werden soll.

IPv4FirewallRule

Das Detail der Firewallregel.

Name Typ Beschreibung
firewallRuleName

string

Name der Regel

rangeEnd

string

Der Endbereich von IPv4.

rangeStart

string

Der Startbereich von IPv4.

IPv4FirewallSettings

Ein Array von Firewallregeln.

Name Typ Beschreibung
enablePowerBIService

boolean

Der Indikator für die Aktivierung des PBI-Diensts.

firewallRules

IPv4FirewallRule[]

Ein Array von Firewallregeln.

ManagedMode

Der verwaltete Modus des Servers (0 = nicht verwaltet, 1 = verwaltet).

Name Typ Beschreibung
0

Integer

1

Integer

ProvisioningState

Der aktuelle Bereitstellungsstatus der Analysis Services-Ressource. ProvisioningState gibt Zustände für die Ressourcenbereitstellung an.

Name Typ Beschreibung
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

Stellt den SKU-Namen und den Azure-Tarif für die Analysis Services-Ressource dar.

Name Typ Standardwert Beschreibung
capacity

integer

1

Die Anzahl der Instanzen im schreibgeschützten Abfragepool.

name

string

Name der SKU-Ebene.

tier

SkuTier

Der Name des Azure-Tarifs, für den die SKU gilt.

ServerAdministrators

Ein Array von Administratorbenutzeridentitäten.

Name Typ Beschreibung
members

string[]

Ein Array von Administratorbenutzeridentitäten.

ServerMonitorMode

Der Servermonitormodus für den AS-Server

Name Typ Beschreibung
0

Integer

1

Integer

SkuTier

Der Name des Azure-Tarifs, für den die SKU gilt.

Name Typ Beschreibung
Basic

string

Development

string

Standard

string

State

Der aktuelle Zustand der Analysis Services-Ressource. Der Zustand ist, um mehr Zustände außerhalb der Ressourcenbereitstellung anzugeben.

Name Typ Beschreibung
Deleting

string

Failed

string

Paused

string

Pausing

string

Preparing

string

Provisioning

string

Resuming

string

Scaling

string

Succeeded

string

Suspended

string

Suspending

string

Updating

string