Servers - Create

Odwołanie

Usługa:: Analysis Services

Wersja interfejsu API:: 2017-08-01

Aprowizuje określony serwer usług Analysis Services na podstawie konfiguracji określonej w żądaniu.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów platformy Azure, której częścią jest dany serwer usług Analysis Services. Ta nazwa musi mieć długość co najmniej 1 znaków i nie więcej niż 90. Wzorzec wyrażenia regularnego: `^[-\w\._]+$`
serverName	path	True	string	Nazwa serwera usług Analysis Services. Musi to być co najmniej 3 znaki i maksymalnie 63. Wzorzec wyrażenia regularnego: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja zasobu usług Analysis Services.
sku	True	ResourceSku	Jednostka SKU zasobu usług Analysis Services.
properties.asAdministrators		ServerAdministrators	Kolekcja administratorów serwera AS
properties.backupBlobContainerUri		string	Identyfikator URI kontenera sygnatury dostępu współdzielonego do kontenera kopii zapasowej.
properties.gatewayDetails		GatewayDetails	Szczegóły bramy skonfigurowane dla serwera AS.
properties.ipV4FirewallSettings		IPv4FirewallSettings	Ustawienia zapory dla serwera AS.
properties.managedMode		ManagedMode	Tryb zarządzany serwera (0 = niezarządzany, 1 = zarządzany).
properties.querypoolConnectionMode		ConnectionMode	Sposób kontrolowania udziału serwera odczytu i zapisu w puli zapytań. Może mieć następujące wartości: readOnly — wskazuje, że serwer odczytu i zapisu ma nie uczestniczyć w operacjach zapytań all — wskazuje, że serwer odczytu i zapisu może uczestniczyć w operacjach zapytań Określanie wartości readOnly, gdy pojemność wynosi 1, powoduje błąd.
properties.serverMonitorMode		ServerMonitorMode	Tryb monitora serwera dla serwera AS
properties.sku		ResourceSku	Jednostka SKU zasobu usług Analysis Services.
tags		object	Pary klucz-wartość dodatkowych właściwości aprowizacji zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AnalysisServicesServer	OK. Operacja została ukończona pomyślnie.
201 Created	AnalysisServicesServer	InProgress. Operacja jest nadal wykonywana.
202 Accepted	AnalysisServicesServer	Przygotowanie. Operacja jest nadal wykonywana.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create a server.

Przykładowe żądanie

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

Przykładowa odpowiedź

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

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

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

Definicje

Nazwa	Opis
AnalysisServicesServer	Reprezentuje wystąpienie zasobu usług Analysis Services.
ConnectionMode	Sposób kontrolowania udziału serwera odczytu i zapisu w puli zapytań. Może mieć następujące wartości: readOnly — wskazuje, że serwer odczytu i zapisu ma nie uczestniczyć w operacjach zapytań all — wskazuje, że serwer odczytu i zapisu może uczestniczyć w operacjach zapytań Określanie wartości readOnly, gdy pojemność wynosi 1, powoduje błąd.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Opisuje format odpowiedzi na błąd.
GatewayDetails	Szczegóły bramy.
IPv4FirewallRule	Szczegóły reguły zapory.
IPv4FirewallSettings	Tablica reguł zapory.
ManagedMode	Tryb zarządzany serwera (0 = niezarządzany, 1 = zarządzany).
ProvisioningState	Bieżący stan wdrożenia zasobu usług Analysis Services. ProvisioningState to wskazanie stanów aprowizacji zasobów.
ResourceSku	Reprezentuje nazwę jednostki SKU i warstwę cenową platformy Azure dla zasobu usług Analysis Services.
ServerAdministrators	Tablica tożsamości użytkowników administratora.
ServerMonitorMode	Tryb monitora serwera dla serwera AS
SkuTier	Nazwa warstwy cenowej platformy Azure, do której ma zastosowanie jednostka SKU.
State	Bieżący stan zasobu usług Analysis Services. Stanem jest wskazanie większej liczby stanów poza aprowizowaniem zasobów.

AnalysisServicesServer

Reprezentuje wystąpienie zasobu usług Analysis Services.

Nazwa	Typ	Domyślna wartość	Opis
id	string		Identyfikator reprezentujący zasób usług Analysis Services.
location	string		Lokalizacja zasobu usług Analysis Services.
name	string		Nazwa zasobu usług Analysis Services.
properties.asAdministrators	ServerAdministrators		Kolekcja administratorów serwera AS
properties.backupBlobContainerUri	string		Identyfikator URI kontenera sygnatury dostępu współdzielonego do kontenera kopii zapasowej.
properties.gatewayDetails	GatewayDetails		Szczegóły bramy skonfigurowane dla serwera AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Ustawienia zapory dla serwera AS.
properties.managedMode	ManagedMode	1	Tryb zarządzany serwera (0 = niezarządzany, 1 = zarządzany).
properties.provisioningState	ProvisioningState		Bieżący stan wdrożenia zasobu usług Analysis Services. ProvisioningState to wskazanie stanów aprowizacji zasobów.
properties.querypoolConnectionMode	ConnectionMode	All	Sposób kontrolowania udziału serwera odczytu i zapisu w puli zapytań. Może mieć następujące wartości: readOnly — wskazuje, że serwer odczytu i zapisu ma nie uczestniczyć w operacjach zapytań all — wskazuje, że serwer odczytu i zapisu może uczestniczyć w operacjach zapytań Określanie wartości readOnly, gdy pojemność wynosi 1, powoduje błąd.
properties.serverFullName	string		Pełna nazwa zasobu usług Analysis Services.
properties.serverMonitorMode	ServerMonitorMode	1	Tryb monitora serwera dla serwera AS
properties.sku	ResourceSku		Jednostka SKU zasobu usług Analysis Services.
properties.state	State		Bieżący stan zasobu usług Analysis Services. Stanem jest wskazanie większej liczby stanów poza aprowizowaniem zasobów.
sku	ResourceSku		Jednostka SKU zasobu usług Analysis Services.
tags	object		Pary klucz-wartość dodatkowych właściwości aprowizacji zasobów.
type	string		Typ zasobu usług Analysis Services.

ConnectionMode

Sposób kontrolowania udziału serwera odczytu i zapisu w puli zapytań.
Może mieć następujące wartości:

readOnly — wskazuje, że serwer odczytu i zapisu ma nie uczestniczyć w operacjach zapytań
all — wskazuje, że serwer odczytu i zapisu może uczestniczyć w operacjach zapytań

Określanie wartości readOnly, gdy pojemność wynosi 1, powoduje błąd.

Nazwa	Typ	Opis
All	string
ReadOnly	string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
httpStatusCode	integer	Kod stanu http
message	string	Komunikat o błędzie.
subCode	integer	Kod podrzędny błędu
target	string	Element docelowy błędu.
timeStamp	string	sygnatura czasowa błędu.

ErrorResponse

Opisuje format odpowiedzi na błąd.

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu

GatewayDetails

Szczegóły bramy.

Nazwa	Typ	Opis
dmtsClusterUri	string	Identyfikator URI klastra DMTS.
gatewayObjectId	string	Identyfikator obiektu bramy z klastra DMTS dla zasobu bramy.
gatewayResourceId	string	Zasób bramy, który ma być skojarzony z serwerem.

IPv4FirewallRule

Szczegóły reguły zapory.

Nazwa	Typ	Opis
firewallRuleName	string	Nazwa reguły.
rangeEnd	string	Zakres końcowy protokołu IPv4.
rangeStart	string	Zakres początkowy protokołu IPv4.

IPv4FirewallSettings

Tablica reguł zapory.

Nazwa	Typ	Opis
enablePowerBIService	boolean	Wskaźnik włączania usługi PBI.
firewallRules	IPv4FirewallRule[]	Tablica reguł zapory.

ManagedMode

Tryb zarządzany serwera (0 = niezarządzany, 1 = zarządzany).

Nazwa	Typ	Opis
0	Integer
1	Integer

ProvisioningState

Bieżący stan wdrożenia zasobu usług Analysis Services. ProvisioningState to wskazanie stanów aprowizacji zasobów.

Nazwa	Typ	Opis
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

Reprezentuje nazwę jednostki SKU i warstwę cenową platformy Azure dla zasobu usług Analysis Services.

Nazwa	Typ	Domyślna wartość	Opis
capacity	integer	1	Liczba wystąpień w puli zapytań tylko do odczytu.
name	string		Nazwa poziomu jednostki SKU.
tier	SkuTier		Nazwa warstwy cenowej platformy Azure, do której ma zastosowanie jednostka SKU.

ServerAdministrators

Tablica tożsamości użytkowników administratora.

Nazwa	Typ	Opis
members	string[]	Tablica tożsamości użytkowników administratora.

ServerMonitorMode

Tryb monitora serwera dla serwera AS

Nazwa	Typ	Opis
0	Integer
1	Integer

SkuTier

Nazwa warstwy cenowej platformy Azure, do której ma zastosowanie jednostka SKU.

Nazwa	Typ	Opis
Basic	string
Development	string
Standard	string

State

Bieżący stan zasobu usług Analysis Services. Stanem jest wskazanie większej liczby stanów poza aprowizowaniem zasobów.

Nazwa	Typ	Opis
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

Udostępnij za pośrednictwem

Servers - Create

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Create a server.

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Dodatkowe zasoby