Servers - Update

Reference

Service:: Analysis Services

API Version:: 2017-08-01

Aktualizace aktuální stav zadaného serveru Analysis Services.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků Azure, jejíž součástí je daný server Analysis Services. Tento název musí mít délku nejméně 1 znak a nesmí být delší než 90. Regex pattern: `^[-\w\._]+$`
serverName	path	True	string	Název serveru Analysis Services. Musí mít alespoň 3 znaky a nesmí být delší než 63. Regex pattern: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Jedinečný identifikátor předplatného Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby.
api-version	query	True	string	Verze rozhraní API klienta

Text požadavku

Name	Typ	Description
properties.asAdministrators	ServerAdministrators	Kolekce správců serveru AS
properties.backupBlobContainerUri	string	Identifikátor URI kontejneru SAS pro kontejner zálohování.
properties.gatewayDetails	GatewayDetails	Podrobnosti o bráně nakonfigurované pro server AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings	Nastavení brány firewall pro server AS.
properties.managedMode	ManagedMode	Spravovaný režim serveru (0 = nespravuje se, 1 = spravovaný).
properties.querypoolConnectionMode	ConnectionMode	Jak se řídí účast serveru pro čtení i zápis ve fondu dotazů. Může mít následující hodnoty: readOnly – označuje, že server pro čtení i zápis není určen k účasti na operacích dotazů. all – označuje, že server pro čtení i zápis se může účastnit operací dotazů. Zadání readOnly, pokud je kapacita 1, způsobí chybu.
properties.serverMonitorMode	ServerMonitorMode	Režim monitorování serveru pro server AS
sku	ResourceSku	Skladová položka prostředku Analysis Services.
tags	object	Páry klíč-hodnota dalších vlastností zřizování.

Odpovědi

Name	Typ	Description
200 OK	AnalysisServicesServer	OK
202 Accepted	AnalysisServicesServer	Přijato
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Update a server.

Sample Request

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

Sample Response

Status code:: 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"
  }
}

Status code:: 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"
  }
}

Definice

Name	Description
AnalysisServicesServer	Představuje instanci prostředku Analysis Services.
AnalysisServicesServerUpdateParameters	Specifikace žádosti o zřízení
ConnectionMode	Jak se řídí účast serveru pro čtení i zápis ve fondu dotazů. Může mít následující hodnoty: readOnly – označuje, že server pro čtení i zápis není určen k účasti na operacích dotazů. all – označuje, že server pro čtení i zápis se může účastnit operací dotazů. Zadání readOnly, pokud je kapacita 1, způsobí chybu.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě
ErrorResponse	Popisuje formát chybové odpovědi.
GatewayDetails	Podrobnosti o bráně.
IPv4FirewallRule	Podrobnosti o pravidlu brány firewall
IPv4FirewallSettings	Pole pravidel brány firewall.
ManagedMode	Spravovaný režim serveru (0 = nespravuje se, 1 = spravovaný).
ProvisioningState	Aktuální stav nasazení prostředku služby Analysis Services. ProvisioningState označuje stavy zřizování prostředků.
ResourceSku	Představuje název skladové položky a cenovou úroveň Azure pro prostředek služby Analysis Services.
ServerAdministrators	Pole uživatelských identit správce.
ServerMonitorMode	Režim monitorování serveru pro server AS
SkuTier	Název cenové úrovně Azure, na kterou se skladová položka vztahuje.
State	Aktuální stav prostředku služby Analysis Services Stav má označit více stavů mimo zřizování prostředků.

AnalysisServicesServer

Představuje instanci prostředku Analysis Services.

Name	Typ	Výchozí hodnota	Description
id	string		Identifikátor, který představuje prostředek analysis services.
location	string		Umístění prostředku Analysis Services
name	string		Název prostředku služby Analysis Services.
properties.asAdministrators	ServerAdministrators		Kolekce správců serveru AS
properties.backupBlobContainerUri	string		Identifikátor URI kontejneru SAS pro kontejner zálohování.
properties.gatewayDetails	GatewayDetails		Podrobnosti o bráně nakonfigurované pro server AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Nastavení brány firewall pro server AS.
properties.managedMode	ManagedMode	1	Spravovaný režim serveru (0 = nespravuje se, 1 = spravovaný).
properties.provisioningState	ProvisioningState		Aktuální stav nasazení prostředku služby Analysis Services. ProvisioningState označuje stavy zřizování prostředků.
properties.querypoolConnectionMode	ConnectionMode	All	Jak se řídí účast serveru pro čtení i zápis ve fondu dotazů. Může mít následující hodnoty: readOnly – označuje, že server pro čtení i zápis není určen k účasti na operacích dotazů. all – označuje, že server pro čtení i zápis se může účastnit operací dotazů. Zadání readOnly, pokud je kapacita 1, způsobí chybu.
properties.serverFullName	string		Úplný název prostředku Analysis Services.
properties.serverMonitorMode	ServerMonitorMode	1	Režim monitorování serveru pro server AS
properties.sku	ResourceSku		Skladová položka prostředku Analysis Services.
properties.state	State		Aktuální stav prostředku služby Analysis Services Stav má označit více stavů mimo zřizování prostředků.
sku	ResourceSku		Skladová položka prostředku Analysis Services.
tags	object		Páry klíč-hodnota dalších vlastností zřizování prostředků.
type	string		Typ prostředku služby Analysis Services.

AnalysisServicesServerUpdateParameters

Specifikace žádosti o zřízení

Name	Typ	Výchozí hodnota	Description
properties.asAdministrators	ServerAdministrators		Kolekce správců serveru AS
properties.backupBlobContainerUri	string		Identifikátor URI kontejneru SAS pro kontejner zálohování.
properties.gatewayDetails	GatewayDetails		Podrobnosti o bráně nakonfigurované pro server AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Nastavení brány firewall pro server AS.
properties.managedMode	ManagedMode	1	Spravovaný režim serveru (0 = nespravuje se, 1 = spravovaný).
properties.querypoolConnectionMode	ConnectionMode	All	Jak se řídí účast serveru pro čtení i zápis ve fondu dotazů. Může mít následující hodnoty: readOnly – označuje, že server pro čtení i zápis není určen k účasti na operacích dotazů. all – označuje, že server pro čtení i zápis se může účastnit operací dotazů. Zadání readOnly, pokud je kapacita 1, způsobí chybu.
properties.serverMonitorMode	ServerMonitorMode	1	Režim monitorování serveru pro server AS
sku	ResourceSku		Skladová položka prostředku Analysis Services.
tags	object		Páry klíč-hodnota dalších vlastností zřizování.

ConnectionMode

Jak se řídí účast serveru pro čtení i zápis ve fondu dotazů.
Může mít následující hodnoty:

readOnly – označuje, že server pro čtení i zápis není určen k účasti na operacích dotazů.
all – označuje, že server pro čtení i zápis se může účastnit operací dotazů.

Zadání readOnly, pokud je kapacita 1, způsobí chybu.

Name	Typ	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby
details	ErrorDetail[]	Podrobnosti o chybě.
httpStatusCode	integer	Stavový kód HTTP
message	string	Chybová zpráva
subCode	integer	Dílčí kód chyby
target	string	Cíl chyby.
timeStamp	string	časové razítko chyby.

ErrorResponse

Popisuje formát chybové odpovědi.

Name	Typ	Description
error	ErrorDetail	Objekt error

GatewayDetails

Podrobnosti o bráně.

Name	Typ	Description
dmtsClusterUri	string	Identifikátor URI clusteru DMTS
gatewayObjectId	string	ID objektu brány z clusteru DMTS pro prostředek brány.
gatewayResourceId	string	Prostředek brány, který se má přidružit k serveru.

IPv4FirewallRule

Podrobnosti o pravidlu brány firewall

Name	Typ	Description
firewallRuleName	string	Název pravidla.
rangeEnd	string	Koncový rozsah protokolu IPv4.
rangeStart	string	Počáteční rozsah IPv4.

IPv4FirewallSettings

Pole pravidel brány firewall.

Name	Typ	Description
enablePowerBIService	boolean	Indikátor povolení služby PBI.
firewallRules	IPv4FirewallRule[]	Pole pravidel brány firewall.

ManagedMode

Spravovaný režim serveru (0 = nespravuje se, 1 = spravovaný).

Name	Typ	Description
0	Integer
1	Integer

ProvisioningState

Aktuální stav nasazení prostředku služby Analysis Services. ProvisioningState označuje stavy zřizování prostředků.

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

Představuje název skladové položky a cenovou úroveň Azure pro prostředek služby Analysis Services.

Name	Typ	Výchozí hodnota	Description
capacity	integer	1	Počet instancí ve fondu dotazů jen pro čtení.
name	string		Název úrovně skladové položky.
tier	SkuTier		Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

ServerAdministrators

Pole uživatelských identit správce.

Name	Typ	Description
members	string[]	Pole uživatelských identit správce.

ServerMonitorMode

Režim monitorování serveru pro server AS

Name	Typ	Description
0	Integer
1	Integer

SkuTier

Název cenové úrovně Azure, na kterou se skladová položka vztahuje.

Name	Typ	Description
Basic	string
Development	string
Standard	string

State

Aktuální stav prostředku služby Analysis Services Stav má označit více stavů mimo zřizování prostředků.

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

Sdílet prostřednictvím

Servers - Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Scopes

Příklady

Update a server.

Sample Request

Sample Response

Definice

AnalysisServicesServer

AnalysisServicesServerUpdateParameters

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Další materiály