Servers - Update

Referenz

Dienst:: Analysis Services

API-Version:: 2017-08-01

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

package armanalysisservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/analysisservices/armanalysisservices"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7a2ac91de424f271cf91cc8009f3fe9ee8249086/specification/analysisservices/resource-manager/Microsoft.AnalysisServices/stable/2017-08-01/examples/updateServer.json
func ExampleServersClient_BeginUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armanalysisservices.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewServersClient().BeginUpdate(ctx, "TestRG", "azsdktest", armanalysisservices.ServerUpdateParameters{
		Properties: &armanalysisservices.ServerMutableProperties{
			AsAdministrators: &armanalysisservices.ServerAdministrators{
				Members: []*string{
					to.Ptr("azsdktest@microsoft.com"),
					to.Ptr("azsdktest2@microsoft.com")},
			},
		},
		SKU: &armanalysisservices.ResourceSKU{
			Name:     to.Ptr("S1"),
			Capacity: to.Ptr[int32](1),
			Tier:     to.Ptr(armanalysisservices.SKUTierStandard),
		},
		Tags: map[string]*string{
			"testKey": to.Ptr("testValue"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Server = armanalysisservices.Server{
	// 	Name: to.Ptr("azsdktest"),
	// 	ID: to.Ptr("/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.AnalysisServices/servers/azsdktest"),
	// 	Location: to.Ptr("West US"),
	// 	SKU: &armanalysisservices.ResourceSKU{
	// 		Name: to.Ptr("S1"),
	// 		Capacity: to.Ptr[int32](1),
	// 		Tier: to.Ptr(armanalysisservices.SKUTierStandard),
	// 	},
	// 	Tags: map[string]*string{
	// 		"testKey": to.Ptr("testValue"),
	// 	},
	// 	Properties: &armanalysisservices.ServerProperties{
	// 		AsAdministrators: &armanalysisservices.ServerAdministrators{
	// 			Members: []*string{
	// 				to.Ptr("azsdktest@microsoft.com"),
	// 				to.Ptr("azsdktest2@microsoft.com")},
	// 			},
	// 			ProvisioningState: to.Ptr(armanalysisservices.ProvisioningStateSucceeded),
	// 			ServerFullName: to.Ptr("asazure://nightly1.asazure-int.windows.net/azsdktest"),
	// 			State: to.Ptr(armanalysisservices.StateProvisioning),
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { AzureAnalysisServices } = require("@azure/arm-analysisservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates the current state of the specified Analysis Services server.
 *
 * @summary Updates the current state of the specified Analysis Services server.
 * x-ms-original-file: specification/analysisservices/resource-manager/Microsoft.AnalysisServices/stable/2017-08-01/examples/updateServer.json
 */
async function updateAServer() {
  const subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
  const resourceGroupName = "TestRG";
  const serverName = "azsdktest";
  const serverUpdateParameters = {
    asAdministrators: {
      members: ["azsdktest@microsoft.com", "azsdktest2@microsoft.com"],
    },
    sku: { name: "S1", capacity: 1, tier: "Standard" },
    tags: { testKey: "testValue" },
  };
  const credential = new DefaultAzureCredential();
  const client = new AzureAnalysisServices(credential, subscriptionId);
  const result = await client.servers.beginUpdateAndWait(
    resourceGroupName,
    serverName,
    serverUpdateParameters
  );
  console.log(result);
}

updateAServer().catch(console.error);

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Analysis;
using Azure.ResourceManager.Analysis.Models;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/analysisservices/resource-manager/Microsoft.AnalysisServices/stable/2017-08-01/examples/updateServer.json
// this example is just showing the usage of "Servers_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this AnalysisServerResource created on azure
// for more information of creating AnalysisServerResource, please refer to the document of AnalysisServerResource
string subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
string resourceGroupName = "TestRG";
string serverName = "azsdktest";
ResourceIdentifier analysisServerResourceId = AnalysisServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
AnalysisServerResource analysisServer = client.GetAnalysisServerResource(analysisServerResourceId);

// invoke the operation
AnalysisServerPatch patch = new AnalysisServerPatch()
{
    Sku = new AnalysisResourceSku("S1")
    {
        Tier = AnalysisSkuTier.Standard,
        Capacity = 1,
    },
    Tags =
    {
    ["testKey"] = "testValue",
    },
    AsAdministratorIdentities =
    {
    "azsdktest@microsoft.com","azsdktest2@microsoft.com"
    },
};
ArmOperation<AnalysisServerResource> lro = await analysisServer.UpdateAsync(WaitUntil.Completed, patch);
AnalysisServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
AnalysisServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 202

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

Freigeben über

Servers - Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Update a server.

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AnalysisServicesServer

AnalysisServicesServerUpdateParameters

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Zusätzliche Ressourcen