Servers - Create

Referens

Tjänst:: Analysis Services

API-version:: 2017-08-01

Etablerar den angivna Analysis Services-servern baserat på den konfiguration som anges i begäran.

PUT 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 måste vara minst 3 tecken och högst 63. 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	Obligatorisk	Typ	Description
location	True	string	Platsen för Analysis Services-resursen.
sku	True	ResourceSku	SKU:n för 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	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
properties.sku		ResourceSku	SKU:n för Analysis Services-resursen.
tags		object	Nyckel/värde-par med ytterligare resursetableringsegenskaper.

Svar

Name	Typ	Description
200 OK	AnalysisServicesServer	OK. Åtgärden slutfördes.
201 Created	AnalysisServicesServer	InProgress. Åtgärden slutförs fortfarande.
202 Accepted	AnalysisServicesServer	Förbereda. Åtgärden slutförs fortfarande.
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

Create a server.

Exempelbegäran

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

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

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

Definitioner

Name	Description
AnalysisServicesServer	Representerar en instans av en Analysis Services-resurs.
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.

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 - Create

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Create a server.

Exempelbegäran

Exempelsvar

Definitioner

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Ytterligare resurser