Servers - Create

Referenz

Service:: Analysis Services

API Version:: 2017-08-01

Stellt den angegebenen Analysis Services-Server basierend auf der in der Anforderung angegebenen Konfiguration bereit.

PUT 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 pattern: `^[-\w\._]+$`
serverName	path	True	string	Der Name des Analysis Services-Servers. Es muss mindestens 3 Zeichen und maximal 63 Zeichen lang sein. Regex pattern: `^[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	Erforderlich	Typ	Beschreibung
location	True	string	Speicherort der Analysis Services-Ressource.
sku	True	ResourceSku	Die SKU 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	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
properties.sku		ResourceSku	Die SKU der Analysis Services-Ressource.
tags		object	Schlüssel-Wert-Paare zusätzlicher Ressourcenbereitstellungseigenschaften.

Antworten

Name	Typ	Beschreibung
200 OK	AnalysisServicesServer	OK. Der Vorgang wurde erfolgreich abgeschlossen.
201 Created	AnalysisServicesServer	InProgress. Der Vorgang ist noch abgeschlossen.
202 Accepted	AnalysisServicesServer	Vorbereitung. Der Vorgang ist noch abgeschlossen.
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Create a server.

Sample Request

PUT 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"
  },
  "location": "West US",
  "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/createServer.json
func ExampleServersClient_BeginCreate() {
	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().BeginCreate(ctx, "TestRG", "azsdktest", armanalysisservices.Server{
		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")},
			},
		},
	}, 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 Provisions the specified Analysis Services server based on the configuration specified in the request.
 *
 * @summary Provisions the specified Analysis Services server based on the configuration specified in the request.
 * x-ms-original-file: specification/analysisservices/resource-manager/Microsoft.AnalysisServices/stable/2017-08-01/examples/createServer.json
 */
async function createAServer() {
  const subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
  const resourceGroupName = "TestRG";
  const serverName = "azsdktest";
  const serverParameters = {
    asAdministrators: {
      members: ["azsdktest@microsoft.com", "azsdktest2@microsoft.com"],
    },
    location: "West US",
    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.beginCreateAndWait(
    resourceGroupName,
    serverName,
    serverParameters
  );
  console.log(result);
}

createAServer().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/createServer.json
// this example is just showing the usage of "Servers_Create" 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 ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
string resourceGroupName = "TestRG";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this AnalysisServerResource
AnalysisServerCollection collection = resourceGroupResource.GetAnalysisServers();

// invoke the operation
string serverName = "azsdktest";
AnalysisServerData data = new AnalysisServerData(new AzureLocation("West US"), new AnalysisResourceSku("S1")
{
    Tier = AnalysisSkuTier.Standard,
    Capacity = 1,
})
{
    AsAdministratorIdentities =
    {
    "azsdktest@microsoft.com","azsdktest2@microsoft.com"
    },
    AnalysisServerSku = new AnalysisResourceSku("S1")
    {
        Tier = AnalysisSkuTier.Standard,
        Capacity = 1,
    },
    Tags =
    {
    ["testKey"] = "testValue",
    },
};
ArmOperation<AnalysisServerResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, serverName, data);
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:: 201

{
  "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": "Preparing",
    "serverFullName": "asazure://nightly1.asazure-int.windows.net/azsdktest",
    "state": "Preparing"
  },
  "sku": {
    "capacity": 1,
    "name": "S1",
    "tier": "Standard"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Definitionen

Name	Beschreibung
AnalysisServicesServer	Stellt eine instance einer Analysis Services-Ressource dar.
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.

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

Servers - Create

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Scopes

Beispiele

Create a server.

Sample Request

Sample Response

Definitionen

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Zusätzliche Ressourcen