Servers - Update

Referens

Tjänst:: Analysis Services

API-version:: 2017-08-01

Uppdateringar 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	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. Reguljärt uttrycksmönster: `^[-\w\._]+$`
serverName	path	True	string	Namnet på Analysis Services-servern. Det får innehålla minst 3 tecken och högst 63 tecken. Reguljärt uttrycksmönster: `^[a-z][a-z0-9]*$`
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äkerhetskopian.
properties.gatewayDetails	GatewayDetails	Gatewayinformationen som konfigurerats för AS-servern.
properties.ipV4FirewallSettings	IPv4FirewallSettings	Brandväggsinställningarna för AS-servern.
properties.managedMode	ManagedMode	Serverns hanterade läge (0 = inte hanterad, 1 = hanterad).
properties.querypoolConnectionMode	ConnectionMode	Hur läs-och skriv-serverns 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	Serverövervakarläge för AS-server
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	OK
202 Accepted	AnalysisServicesServer	Har godkänts
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 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

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 skriv-serverns 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 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övervakarläge för AS-server
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

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äkerhetskopian.
properties.gatewayDetails	GatewayDetails		Gatewayinformationen som konfigurerats för AS-servern.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Brandväggsinställningarna för AS-servern.
properties.managedMode	ManagedMode	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 skriv-serverns 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	1	Serverövervakarläge för AS-server
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 resursetableringsegenskaper.
type	string		Typen av Analysis Services-resurs.

AnalysisServicesServerUpdateParameters

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äkerhetskopian.
properties.gatewayDetails	GatewayDetails		Gatewayinformationen som konfigurerats för AS-servern.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Brandväggsinställningarna för AS-servern.
properties.managedMode	ManagedMode	1	Serverns hanterade läge (0 = inte hanterad, 1 = hanterad).
properties.querypoolConnectionMode	ConnectionMode	All	Hur läs-och skriv-serverns 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	1	Serverövervakarläge för AS-server
sku	ResourceSku		SKU:n för Analysis Services-resursen.
tags	object		Nyckel/värde-par med ytterligare etableringsegenskaper.

ConnectionMode

Hur läs-och skriv-serverns 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.

Name	Typ	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

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

ErrorResponse

Beskriver formatet felsvar.

Name	Typ	Description
error	ErrorDetail	Felobjektet

GatewayDetails

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

Information om brandväggsregeln.

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

IPv4FirewallSettings

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

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

Name	Typ	Description
0	Integer
1	Integer

ProvisioningState

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

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

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

Name	Typ	Standardvärde	Description
capacity	integer	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

En matris med administratörsanvändares identiteter.

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

ServerMonitorMode

Serverövervakarläge för AS-server

Name	Typ	Description
0	Integer
1	Integer

SkuTier

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

Name	Typ	Description
Basic	string
Development	string
Standard	string

State

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

Name	Typ	Description
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

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