Servers - Create

Reference

Služba:: Analysis Services

Verze rozhraní API:: 2017-08-01

Zřídí zadaný server Analysis Services na základě konfigurace zadané v požadavku.

PUT 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. Vzor regulárního výrazu: `^[-\w\._]+$`
serverName	path	True	string	Název serveru Analysis Services. Musí obsahovat minimálně 3 znaky a maximálně 63. Vzor regulárního výrazu: `^[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	Vyžadováno	Typ	Description
location	True	string	Umístění prostředku Analysis Services
sku	True	ResourceSku	Skladová položka prostředku Analysis Services.
properties.asAdministrators		ServerAdministrators	Kolekce správců serveru AS
properties.backupBlobContainerUri		string	Identifikátor URI kontejneru SAS pro záložní kontejner.
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 = nespravovaných, 1 = spravovaný).
properties.querypoolConnectionMode		ConnectionMode	Jak se řídí účast serveru pro čtení a 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 tomu, aby se neúčastnil operací dotazů. all – označuje, že server pro čtení i zápis se může účastnit operací dotazů. Zadání readOnly, pokud je kapacita 1, má za následek chybu.
properties.serverMonitorMode		ServerMonitorMode	Režim monitorování serveru pro server AS
properties.sku		ResourceSku	Skladová položka prostředku Analysis Services.
tags		object	Páry klíč-hodnota dalších vlastností zřizování prostředků.

Odpovědi

Name	Typ	Description
200 OK	AnalysisServicesServer	OK. Operace se úspěšně dokončila.
201 Created	AnalysisServicesServer	InProgress. Operace se stále dokončuje.
202 Accepted	AnalysisServicesServer	Příprava. Operace se stále dokončuje.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

Create a server.

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 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"
  }
}

Stavový kód:: 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"
  }
}

Definice

Name	Description
AnalysisServicesServer	Představuje instanci prostředku Analysis Services.
ConnectionMode	Jak se řídí účast serveru pro čtení a 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 tomu, aby se neúčastnil operací dotazů. all – označuje, že server pro čtení i zápis se může účastnit operací dotazů. Zadání readOnly, pokud je kapacita 1, má za následek 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 pravidle brány firewall.
IPv4FirewallSettings	Pole pravidel brány firewall.
ManagedMode	Spravovaný režim serveru (0 = nespravovaných, 1 = spravovaný).
ProvisioningState	Aktuální stav nasazení prostředku 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 Analysis Services.
ServerAdministrators	Pole identit uživatelů 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 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	Default value	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 Analysis Services.
properties.asAdministrators	ServerAdministrators		Kolekce správců serveru AS
properties.backupBlobContainerUri	string		Identifikátor URI kontejneru SAS pro záložní kontejner.
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 = nespravovaných, 1 = spravovaný).
properties.provisioningState	ProvisioningState		Aktuální stav nasazení prostředku Analysis Services. ProvisioningState označuje stavy zřizování prostředků.
properties.querypoolConnectionMode	ConnectionMode	All	Jak se řídí účast serveru pro čtení a 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 tomu, aby se neúčastnil operací dotazů. all – označuje, že server pro čtení i zápis se může účastnit operací dotazů. Zadání readOnly, pokud je kapacita 1, má za následek 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 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 Analysis Services.

ConnectionMode

Jak se řídí účast serveru pro čtení a 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 tomu, aby se neúčastnil operací dotazů.
all – označuje, že server pro čtení i zápis se může účastnit operací dotazů.

Zadání readOnly, pokud je kapacita 1, má za následek 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	Další typ informací.

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 chyby

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 pravidle brány firewall.

Name	Typ	Description
firewallRuleName	string	Název pravidla.
rangeEnd	string	Koncový rozsah protokolu IPv4.
rangeStart	string	Počáteční rozsah protokolu 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 = nespravovaných, 1 = spravovaný).

Name	Typ	Description
0	Integer
1	Integer

ProvisioningState

Aktuální stav nasazení prostředku 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 Analysis Services.

Name	Typ	Default value	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 identit uživatelů správce.

Name	Typ	Description
members	string[]	Pole identit uživatelů 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 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 - Create

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Create a server.

Ukázkový požadavek

Ukázková odpověď

Definice

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Další materiály