Servers - Update

Referentie

Service:: Analysis Services

API-versie:: 2017-08-01

Updates de huidige status van de opgegeven Analysis Services-server.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de Azure-resourcegroep waarvan een bepaalde Analysis Services-server deel uitmaakt. Deze naam moet ten minste 1 teken lang zijn en niet meer dan 90 tekens. Regex-patroon: `^[-\w\._]+$`
serverName	path	True	string	De naam van de Analysis Services-server. Het moet ten minste 3 tekens lang zijn en niet meer dan 63 tekens. Regex-patroon: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Een unieke id voor een Microsoft Azure-abonnement. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.
api-version	query	True	string	De client-API-versie.

Aanvraagbody

Name	Type	Description
properties.asAdministrators	ServerAdministrators	Een verzameling AS-serverbeheerders
properties.backupBlobContainerUri	string	De SAS-container-URI naar de back-upcontainer.
properties.gatewayDetails	GatewayDetails	De gatewaydetails die zijn geconfigureerd voor de AS-server.
properties.ipV4FirewallSettings	IPv4FirewallSettings	De firewallinstellingen voor de AS-server.
properties.managedMode	ManagedMode	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
properties.querypoolConnectionMode	ConnectionMode	Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly: geeft aan dat de lees-schrijfserver niet is bedoeld om deel te nemen aan querybewerkingen alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
properties.serverMonitorMode	ServerMonitorMode	De servermonitormodus voor AS-server
sku	ResourceSku	De SKU van de Analysis Services-resource.
tags	object	Sleutel-waardeparen van aanvullende inrichtingseigenschappen.

Antwoorden

Name	Type	Description
200 OK	AnalysisServicesServer	OK
202 Accepted	AnalysisServicesServer	Geaccepteerd
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Update a server.

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
AnalysisServicesServer	Vertegenwoordigt een exemplaar van een Analysis Services-resource.
AnalysisServicesServerUpdateParameters	Specificatie van inrichtingsaanvraag
ConnectionMode	Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly: geeft aan dat de lees-schrijfserver niet is bedoeld om deel te nemen aan querybewerkingen alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Beschrijft de indeling van foutreactie.
GatewayDetails	De gatewaydetails.
IPv4FirewallRule	De details van de firewallregel.
IPv4FirewallSettings	Een matrix met firewallregels.
ManagedMode	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
ProvisioningState	De huidige implementatiestatus van Analysis Services-resource. De provisioningState is om statussen voor het inrichten van resources aan te geven.
ResourceSku	Vertegenwoordigt de naam van de SKU en de Azure-prijscategorie voor de Analysis Services-resource.
ServerAdministrators	Een matrix met beheerdersgebruikersidentiteiten.
ServerMonitorMode	De servermonitormodus voor AS-server
SkuTier	De naam van de Azure-prijscategorie waarop de SKU van toepassing is.
State	De huidige status van Analysis Services-resource. De status is om meer statussen aan te geven buiten het inrichten van resources.

AnalysisServicesServer

Vertegenwoordigt een exemplaar van een Analysis Services-resource.

Name	Type	Default value	Description
id	string		Een id die de Analysis Services-resource vertegenwoordigt.
location	string		Locatie van de Analysis Services-resource.
name	string		De naam van de Analysis Services-resource.
properties.asAdministrators	ServerAdministrators		Een verzameling AS-serverbeheerders
properties.backupBlobContainerUri	string		De SAS-container-URI naar de back-upcontainer.
properties.gatewayDetails	GatewayDetails		De gatewaydetails die zijn geconfigureerd voor de AS-server.
properties.ipV4FirewallSettings	IPv4FirewallSettings		De firewallinstellingen voor de AS-server.
properties.managedMode	ManagedMode	1	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
properties.provisioningState	ProvisioningState		De huidige implementatiestatus van Analysis Services-resource. De provisioningState is om statussen voor het inrichten van resources aan te geven.
properties.querypoolConnectionMode	ConnectionMode	All	Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly: geeft aan dat de lees-schrijfserver niet is bedoeld om deel te nemen aan querybewerkingen alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
properties.serverFullName	string		De volledige naam van de Analysis Services-resource.
properties.serverMonitorMode	ServerMonitorMode	1	De servermonitormodus voor AS-server
properties.sku	ResourceSku		De SKU van de Analysis Services-resource.
properties.state	State		De huidige status van Analysis Services-resource. De status is om meer statussen aan te geven buiten het inrichten van resources.
sku	ResourceSku		De SKU van de Analysis Services-resource.
tags	object		Sleutel-waardeparen van aanvullende resource-inrichtingseigenschappen.
type	string		Het type van de Analysis Services-resource.

AnalysisServicesServerUpdateParameters

Specificatie van inrichtingsaanvraag

Name	Type	Default value	Description
properties.asAdministrators	ServerAdministrators		Een verzameling AS-serverbeheerders
properties.backupBlobContainerUri	string		De SAS-container-URI naar de back-upcontainer.
properties.gatewayDetails	GatewayDetails		De gatewaydetails die zijn geconfigureerd voor de AS-server.
properties.ipV4FirewallSettings	IPv4FirewallSettings		De firewallinstellingen voor de AS-server.
properties.managedMode	ManagedMode	1	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
properties.querypoolConnectionMode	ConnectionMode	All	Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly: geeft aan dat de lees-schrijfserver niet is bedoeld om deel te nemen aan querybewerkingen alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
properties.serverMonitorMode	ServerMonitorMode	1	De servermonitormodus voor AS-server
sku	ResourceSku		De SKU van de Analysis Services-resource.
tags	object		Sleutel-waardeparen van aanvullende inrichtingseigenschappen.

ConnectionMode

Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd.
Het kan de volgende waarden hebben:

readOnly: geeft aan dat de lees-schrijfserver niet is bedoeld om deel te nemen aan querybewerkingen
alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen

Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.

Name	Type	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
httpStatusCode	integer	De HTTP-statuscode
message	string	Het foutbericht.
subCode	integer	De subcode van de fout
target	string	Het foutdoel.
timeStamp	string	de tijdstempel voor de fout.

ErrorResponse

Beschrijft de indeling van foutreactie.

Name	Type	Description
error	ErrorDetail	Het foutobject

GatewayDetails

De gatewaydetails.

Name	Type	Description
dmtsClusterUri	string	URI van het DMTS-cluster.
gatewayObjectId	string	Gatewayobject-id van in het DMTS-cluster voor de gatewayresource.
gatewayResourceId	string	Gatewayresource die aan de server moet worden gekoppeld.

IPv4FirewallRule

De details van de firewallregel.

Name	Type	Description
firewallRuleName	string	De regelnaam.
rangeEnd	string	Het eindbereik van IPv4.
rangeStart	string	Het beginbereik van IPv4.

IPv4FirewallSettings

Een matrix met firewallregels.

Name	Type	Description
enablePowerBIService	boolean	De indicator voor het inschakelen van de PBI-service.
firewallRules	IPv4FirewallRule[]	Een matrix met firewallregels.

ManagedMode

De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).

Name	Type	Description
0	Integer
1	Integer

ProvisioningState

De huidige implementatiestatus van Analysis Services-resource. De provisioningState is om statussen voor het inrichten van resources aan te geven.

Name	Type	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

Vertegenwoordigt de naam van de SKU en de Azure-prijscategorie voor de Analysis Services-resource.

Name	Type	Default value	Description
capacity	integer	1	Het aantal exemplaren in de alleen-lezen querygroep.
name	string		Naam van het SKU-niveau.
tier	SkuTier		De naam van de Azure-prijscategorie waarop de SKU van toepassing is.

ServerAdministrators

Een matrix met beheerdersgebruikersidentiteiten.

Name	Type	Description
members	string[]	Een matrix met beheerdersgebruikersidentiteiten.

ServerMonitorMode

De servermonitormodus voor AS-server

Name	Type	Description
0	Integer
1	Integer

SkuTier

De naam van de Azure-prijscategorie waarop de SKU van toepassing is.

Name	Type	Description
Basic	string
Development	string
Standard	string

State

De huidige status van Analysis Services-resource. De status is om meer statussen aan te geven buiten het inrichten van resources.

Name	Type	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

Delen via

Servers - Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Update a server.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AnalysisServicesServer

AnalysisServicesServerUpdateParameters

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Aanvullende resources