Servers - Create

Referencia

Szolgáltatás:: Analysis Services

API-verzió:: 2017-08-01

A megadott Analysis Services-kiszolgálót a kérelemben megadott konfiguráció alapján helyezi üzembe.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Annak az Azure-erőforráscsoportnak a neve, amelynek egy adott Analysis Services-kiszolgáló része. Ennek a névnek legalább 1 karakter hosszúságúnak és legfeljebb 90 karakternek kell lennie.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Az Analysis Services-kiszolgáló neve. Legalább 3 karakterből és legfeljebb 63 karakterből állhat.
subscriptionId	path	True	string	Egy Microsoft Azure-előfizetés egyedi azonosítója. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.
api-version	query	True	string	Az ügyfél API-verziója.

Kérelem törzse

Name	Kötelező	Típus	Description
location	True	string	Az Analysis Services-erőforrás helye.
sku	True	ResourceSku	Az Analysis Services-erőforrás termékváltozata.
properties.asAdministrators		ServerAdministrators	AS-kiszolgálógazdák gyűjteménye
properties.backupBlobContainerUri		string	Az SAS-tároló URI-ja a biztonsági mentési tárolóhoz.
properties.gatewayDetails		GatewayDetails	Az AS-kiszolgálóhoz konfigurált átjáró részletei.
properties.ipV4FirewallSettings		IPv4FirewallSettings	Az AS-kiszolgáló tűzfalbeállításai.
properties.managedMode		ManagedMode (int32)	A kiszolgáló felügyelt módja (0 = nem felügyelt, 1 = felügyelt).
properties.querypoolConnectionMode		ConnectionMode	Az olvasási-írási kiszolgáló lekérdezéskészletben való részvételének szabályozása. A következő értékekkel rendelkezhet: readOnly – azt jelzi, hogy az olvasási-írási kiszolgáló nem kíván részt venni a lekérdezési műveletekben all – azt jelzi, hogy az írás-olvasási kiszolgáló részt vehet a lekérdezési műveletekben Ha a readOnly értéket adja meg, ha a kapacitás 1, hiba történik.
properties.serverMonitorMode		ServerMonitorMode (int32)	Az AS-kiszolgáló kiszolgálómonitorozási módja
properties.sku		ResourceSku	Az Analysis Services-erőforrás termékváltozata.
tags		object	Kulcs-érték párok további erőforrás-kiépítési tulajdonságokhoz.

Válaszok

Name	Típus	Description
200 OK	AnalysisServicesServer	OKÉ. A művelet sikeresen befejeződött.
201 Created	AnalysisServicesServer	Bejövő forgalom. A művelet még folyamatban van.
202 Accepted	AnalysisServicesServer	Előkészítése. A művelet még folyamatban van.
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Create a server.

Mintakérelem

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 Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
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

Mintaválasz

Állapotkó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"
  }
}

Állapotkó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"
  }
}

Állapotkó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"
  }
}

Definíciók

Name	Description
AnalysisServicesServer	Egy Analysis Services-erőforrás egy példányát jelöli.
ConnectionMode	Az olvasási-írási kiszolgáló lekérdezéskészletben való részvételének szabályozása. A következő értékekkel rendelkezhet: readOnly – azt jelzi, hogy az olvasási-írási kiszolgáló nem kíván részt venni a lekérdezési műveletekben all – azt jelzi, hogy az írás-olvasási kiszolgáló részt vehet a lekérdezési műveletekben Ha a readOnly értéket adja meg, ha a kapacitás 1, hiba történik.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	A hibaválasz formátumát ismerteti.
GatewayDetails	Az átjáró részletei.
IPv4FirewallRule	A tűzfalszabály részletei.
IPv4FirewallSettings	Tűzfalszabályok tömbje.
ManagedMode	A kiszolgáló felügyelt módja (0 = nem felügyelt, 1 = felügyelt).
ProvisioningState	Az Analysis Services-erőforrás jelenlegi üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotainak jelzése.
ResourceSku	Az Analysis Services-erőforrás termékváltozatának nevét és Azure tarifacsomagját jelöli.
ServerAdministrators	Rendszergazdai felhasználói identitások tömbje.
ServerMonitorMode	Az AS-kiszolgáló kiszolgálómonitorozási módja
SkuTier	Annak az Azure-tarifacsomagnak a neve, amelyre az SKU vonatkozik.
State	Az Analysis Services-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez.

AnalysisServicesServer

Objektum

Egy Analysis Services-erőforrás egy példányát jelöli.

Name	Típus	Alapértelmezett érték	Description
id	string		Az Analysis Services-erőforrást jelképező azonosító.
location	string		Az Analysis Services-erőforrás helye.
name	string		Az Analysis Services-erőforrás neve.
properties.asAdministrators	ServerAdministrators		AS-kiszolgálógazdák gyűjteménye
properties.backupBlobContainerUri	string		Az SAS-tároló URI-ja a biztonsági mentési tárolóhoz.
properties.gatewayDetails	GatewayDetails		Az AS-kiszolgálóhoz konfigurált átjáró részletei.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Az AS-kiszolgáló tűzfalbeállításai.
properties.managedMode	ManagedMode (int32)	1	A kiszolgáló felügyelt módja (0 = nem felügyelt, 1 = felügyelt).
properties.provisioningState	ProvisioningState		Az Analysis Services-erőforrás jelenlegi üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotainak jelzése.
properties.querypoolConnectionMode	ConnectionMode	All	Az olvasási-írási kiszolgáló lekérdezéskészletben való részvételének szabályozása. A következő értékekkel rendelkezhet: readOnly – azt jelzi, hogy az olvasási-írási kiszolgáló nem kíván részt venni a lekérdezési műveletekben all – azt jelzi, hogy az írás-olvasási kiszolgáló részt vehet a lekérdezési műveletekben Ha a readOnly értéket adja meg, ha a kapacitás 1, hiba történik.
properties.serverFullName	string		Az Analysis Services-erőforrás teljes neve.
properties.serverMonitorMode	ServerMonitorMode (int32)	1	Az AS-kiszolgáló kiszolgálómonitorozási módja
properties.sku	ResourceSku		Az Analysis Services-erőforrás termékváltozata.
properties.state	State		Az Analysis Services-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez.
sku	ResourceSku		Az Analysis Services-erőforrás termékváltozata.
tags	object		Kulcs-érték párok további erőforrás-kiépítési tulajdonságokhoz.
type	string		Az Analysis Services-erőforrás típusa.

ConnectionMode

Enumerálás

Az olvasási-írási kiszolgáló lekérdezéskészletben való részvételének szabályozása.
A következő értékekkel rendelkezhet:

readOnly – azt jelzi, hogy az olvasási-írási kiszolgáló nem kíván részt venni a lekérdezési műveletekben
all – azt jelzi, hogy az írás-olvasási kiszolgáló részt vehet a lekérdezési műveletekben

Ha a readOnly értéket adja meg, ha a kapacitás 1, hiba történik.

Érték	Description
All
ReadOnly

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
httpStatusCode	integer (int32)	A HTTP állapotkódja
message	string	A hibaüzenet.
subCode	integer (int32)	A hiba alkódja
target	string	A hibacél.
timeStamp	string	a hiba időbélyege.

ErrorResponse

Objektum

A hibaválasz formátumát ismerteti.

Name	Típus	Description
error	ErrorDetail	A hibaobjektum

GatewayDetails

Objektum

Az átjáró részletei.

Name	Típus	Description
dmtsClusterUri	string	A DMTS-fürt URI-ja.
gatewayObjectId	string	Az átjáró-erőforrás DMTS-fürtjében található átjáróobjektum-azonosító.
gatewayResourceId	string	A kiszolgálóhoz társítandó átjáró-erőforrás.

IPv4FirewallRule

Objektum

A tűzfalszabály részletei.

Name	Típus	Description
firewallRuleName	string	A szabály neve.
rangeEnd	string	Az IPv4 végponttartománya.
rangeStart	string	Az IPv4 kezdőtartománya.

IPv4FirewallSettings

Objektum

Tűzfalszabályok tömbje.

Name	Típus	Description
enablePowerBIService	boolean	A PBI-szolgáltatás engedélyezésének jelzője.
firewallRules	IPv4FirewallRule[]	Tűzfalszabályok tömbje.

ManagedMode

Enumerálás

A kiszolgáló felügyelt módja (0 = nem felügyelt, 1 = felügyelt).

Érték	Description
0
1

ProvisioningState

Enumerálás

Az Analysis Services-erőforrás jelenlegi üzembehelyezési állapota. A provisioningState az erőforrás-kiépítés állapotainak jelzése.

Érték	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

ResourceSku

Objektum

Az Analysis Services-erőforrás termékváltozatának nevét és Azure tarifacsomagját jelöli.

Name	Típus	Alapértelmezett érték	Description
capacity	integer (int32) minimum: 1 maximum: 8	1	Az írásvédett lekérdezéskészlet példányainak száma.
name	string		A termékváltozat-szint neve.
tier	SkuTier		Annak az Azure-tarifacsomagnak a neve, amelyre az SKU vonatkozik.

ServerAdministrators

Objektum

Rendszergazdai felhasználói identitások tömbje.

Name	Típus	Description
members	string[]	Rendszergazdai felhasználói identitások tömbje.

ServerMonitorMode

Enumerálás

Az AS-kiszolgáló kiszolgálómonitorozási módja

Érték	Description
0
1

SkuTier

Enumerálás

Annak az Azure-tarifacsomagnak a neve, amelyre az SKU vonatkozik.

Érték	Description
Basic
Development
Standard

State

Enumerálás

Az Analysis Services-erőforrás aktuális állapota. Az állapot több, az erőforrás-kiépítésen kívüli állapotot jelez.

Érték	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

Megosztás a következőn keresztül:

Servers - Create

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Create a server.

Mintakérelem

Mintaválasz

Definíciók

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State