Servers - Update

Referens

Tjänst:: Analysis Services

API-version:: 2017-08-01

Uppdaterar det aktuella tillståndet för den angivna Analysis Services-servern.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Namnet på den Azure-resursgrupp som en viss Analysis Services-server ingår i. Det här namnet måste vara minst 1 tecken långt och högst 90.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Namnet på Analysis Services-servern. Det måste vara minst 3 tecken långt och högst 63 tecken.
subscriptionId	path	True	string	En unik identifierare för en Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.
api-version	query	True	string	Klient-API-versionen.

Begärandetext

Name	Typ	Description
properties.asAdministrators	ServerAdministrators	En samling AS-serveradministratörer
properties.backupBlobContainerUri	string	SAS-containerns URI till säkerhetskopieringscontainern.
properties.gatewayDetails	GatewayDetails	Gatewayinformationen som konfigurerats för AS-servern.
properties.ipV4FirewallSettings	IPv4FirewallSettings	Brandväggsinställningarna för AS-servern.
properties.managedMode	ManagedMode (int32)	Serverns hanterade läge (0 = inte hanterad, 1 = hanterad).
properties.querypoolConnectionMode	ConnectionMode	Hur läs- och skrivserverns deltagande i frågepoolen styrs. Den kan ha följande värden: readOnly – anger att skrivskyddad server inte är avsedd att delta i frågeåtgärder all – anger att skrivskyddad server kan delta i frågeåtgärder Om du anger readOnly när kapaciteten är 1 uppstår ett fel.
properties.serverMonitorMode	ServerMonitorMode (int32)	Serverövervakningsläget för AS-servern
sku	ResourceSku	SKU:n för Analysis Services-resursen.
tags	object	Nyckel/värde-par med ytterligare etableringsegenskaper.

Svar

Name	Typ	Description
200 OK	AnalysisServicesServer	OKEJ
202 Accepted	AnalysisServicesServer	Accepterad
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Update a server.

Exempelbegäran

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 Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
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

Exempelsvar

Statuskod:: 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"
  }
}

Statuskod:: 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"
  }
}

Definitioner

Name	Description
AnalysisServicesServer	Representerar en instans av en Analysis Services-resurs.
AnalysisServicesServerUpdateParameters	Specifikation för etableringsbegäran
ConnectionMode	Hur läs- och skrivserverns deltagande i frågepoolen styrs. Den kan ha följande värden: readOnly – anger att skrivskyddad server inte är avsedd att delta i frågeåtgärder all – anger att skrivskyddad server kan delta i frågeåtgärder Om du anger readOnly när kapaciteten är 1 uppstår ett fel.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Beskriver formatet för Felsvar.
GatewayDetails	Gatewayinformationen.
IPv4FirewallRule	Information om brandväggsregeln.
IPv4FirewallSettings	En matris med brandväggsregler.
ManagedMode	Serverns hanterade läge (0 = inte hanterad, 1 = hanterad).
ProvisioningState	Det aktuella distributionstillståndet för Analysis Services-resursen. ProvisioningState är att ange tillstånd för resursetablering.
ResourceSku	Representerar SKU-namnet och Azure-prisnivån för Analysis Services-resursen.
ServerAdministrators	En matris med administratörsanvändares identiteter.
ServerMonitorMode	Serverövervakningsläget för AS-servern
SkuTier	Namnet på den Azure-prisnivå som SKU:n gäller för.
State	Det aktuella tillståndet för Analysis Services-resursen. Tillståndet är att ange fler tillstånd utanför resursetablering.

AnalysisServicesServer

Objekt

Representerar en instans av en Analysis Services-resurs.

Name	Typ	Standardvärde	Description
id	string		En identifierare som representerar Analysis Services-resursen.
location	string		Platsen för Analysis Services-resursen.
name	string		Namnet på Analysis Services-resursen.
properties.asAdministrators	ServerAdministrators		En samling AS-serveradministratörer
properties.backupBlobContainerUri	string		SAS-containerns URI till säkerhetskopieringscontainern.
properties.gatewayDetails	GatewayDetails		Gatewayinformationen som konfigurerats för AS-servern.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Brandväggsinställningarna för AS-servern.
properties.managedMode	ManagedMode (int32)	1	Serverns hanterade läge (0 = inte hanterad, 1 = hanterad).
properties.provisioningState	ProvisioningState		Det aktuella distributionstillståndet för Analysis Services-resursen. ProvisioningState är att ange tillstånd för resursetablering.
properties.querypoolConnectionMode	ConnectionMode	All	Hur läs- och skrivserverns deltagande i frågepoolen styrs. Den kan ha följande värden: readOnly – anger att skrivskyddad server inte är avsedd att delta i frågeåtgärder all – anger att skrivskyddad server kan delta i frågeåtgärder Om du anger readOnly när kapaciteten är 1 uppstår ett fel.
properties.serverFullName	string		Det fullständiga namnet på Analysis Services-resursen.
properties.serverMonitorMode	ServerMonitorMode (int32)	1	Serverövervakningsläget för AS-servern
properties.sku	ResourceSku		SKU:n för Analysis Services-resursen.
properties.state	State		Det aktuella tillståndet för Analysis Services-resursen. Tillståndet är att ange fler tillstånd utanför resursetablering.
sku	ResourceSku		SKU:n för Analysis Services-resursen.
tags	object		Nyckel/värde-par med ytterligare egenskaper för resursetablering.
type	string		Typen av Analysis Services-resurs.

AnalysisServicesServerUpdateParameters

Objekt

Specifikation för etableringsbegäran

Name	Typ	Standardvärde	Description
properties.asAdministrators	ServerAdministrators		En samling AS-serveradministratörer
properties.backupBlobContainerUri	string		SAS-containerns URI till säkerhetskopieringscontainern.
properties.gatewayDetails	GatewayDetails		Gatewayinformationen som konfigurerats för AS-servern.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Brandväggsinställningarna för AS-servern.
properties.managedMode	ManagedMode (int32)	1	Serverns hanterade läge (0 = inte hanterad, 1 = hanterad).
properties.querypoolConnectionMode	ConnectionMode	All	Hur läs- och skrivserverns deltagande i frågepoolen styrs. Den kan ha följande värden: readOnly – anger att skrivskyddad server inte är avsedd att delta i frågeåtgärder all – anger att skrivskyddad server kan delta i frågeåtgärder Om du anger readOnly när kapaciteten är 1 uppstår ett fel.
properties.serverMonitorMode	ServerMonitorMode (int32)	1	Serverövervakningsläget för AS-servern
sku	ResourceSku		SKU:n för Analysis Services-resursen.
tags	object		Nyckel/värde-par med ytterligare etableringsegenskaper.

ConnectionMode

Uppräkning

Hur läs- och skrivserverns deltagande i frågepoolen styrs.
Den kan ha följande värden:

readOnly – anger att skrivskyddad server inte är avsedd att delta i frågeåtgärder
all – anger att skrivskyddad server kan delta i frågeåtgärder

Om du anger readOnly när kapaciteten är 1 uppstår ett fel.

Värde	Description
All
ReadOnly

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
httpStatusCode	integer (int32)	Http-statuskoden
message	string	Felmeddelandet.
subCode	integer (int32)	Felunderkoden
target	string	Felmålet.
timeStamp	string	tidsstämpeln för felet.

ErrorResponse

Objekt

Beskriver formatet för Felsvar.

Name	Typ	Description
error	ErrorDetail	Felobjektet

GatewayDetails

Objekt

Gatewayinformationen.

Name	Typ	Description
dmtsClusterUri	string	Uri för DMTS-klustret.
gatewayObjectId	string	Gateway-objekt-ID från i DMTS-klustret för gatewayresursen.
gatewayResourceId	string	Gatewayresurs som ska associeras med servern.

IPv4FirewallRule

Objekt

Information om brandväggsregeln.

Name	Typ	Description
firewallRuleName	string	Regelnamnet.
rangeEnd	string	Slutintervallet för IPv4.
rangeStart	string	Startintervallet för IPv4.

IPv4FirewallSettings

Objekt

En matris med brandväggsregler.

Name	Typ	Description
enablePowerBIService	boolean	Indikatorn för att aktivera PBI-tjänsten.
firewallRules	IPv4FirewallRule[]	En matris med brandväggsregler.

ManagedMode

Uppräkning

Serverns hanterade läge (0 = inte hanterad, 1 = hanterad).

Värde	Description
0
1

ProvisioningState

Uppräkning

Det aktuella distributionstillståndet för Analysis Services-resursen. ProvisioningState är att ange tillstånd för resursetablering.

Värde	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

ResourceSku

Objekt

Representerar SKU-namnet och Azure-prisnivån för Analysis Services-resursen.

Name	Typ	Standardvärde	Description
capacity	integer (int32) minimum: 1 maximum: 8	1	Antalet instanser i den skrivskyddade frågepoolen.
name	string		Namnet på SKU-nivån.
tier	SkuTier		Namnet på den Azure-prisnivå som SKU:n gäller för.

ServerAdministrators

Objekt

En matris med administratörsanvändares identiteter.

Name	Typ	Description
members	string[]	En matris med administratörsanvändares identiteter.

ServerMonitorMode

Uppräkning

Serverövervakningsläget för AS-servern

Värde	Description
0
1

SkuTier

Uppräkning

Namnet på den Azure-prisnivå som SKU:n gäller för.

Värde	Description
Basic
Development
Standard

State

Uppräkning

Det aktuella tillståndet för Analysis Services-resursen. Tillståndet är att ange fler tillstånd utanför resursetablering.

Värde	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

Dela via

Servers - Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Update a server.

Exempelbegäran

Exempelsvar

Definitioner

AnalysisServicesServer

AnalysisServicesServerUpdateParameters

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Ytterligare resurser