Servers - Create

Referentie

Service:: Analysis Services

API-versie:: 2017-08-01

Richt de opgegeven Analysis Services-server in op basis van de configuratie die in de aanvraag is opgegeven.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de Azure-resourcegroep waarvan een bepaalde Analysis Services-server deel uitmaakt. Deze naam moet ten minste één teken lang zijn en niet meer dan 90 tekens. Regex-patroon: `^[-\w\._]+$`
serverName	path	True	string	De naam van de Analysis Services-server. Deze moet minimaal 3 tekens en maximaal 63 tekens bevatten. Regex-patroon: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Een unieke id voor een Microsoft Azure-abonnement. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.
api-version	query	True	string	De client-API-versie.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	Locatie van de Analysis Services-resource.
sku	True	ResourceSku	De SKU van de Analysis Services-resource.
properties.asAdministrators		ServerAdministrators	Een verzameling AS-serverbeheerders
properties.backupBlobContainerUri		string	De SAS-container-URI naar de back-upcontainer.
properties.gatewayDetails		GatewayDetails	De gatewaygegevens die zijn geconfigureerd voor de AS-server.
properties.ipV4FirewallSettings		IPv4FirewallSettings	De firewallinstellingen voor de AS-server.
properties.managedMode		ManagedMode	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
properties.querypoolConnectionMode		ConnectionMode	Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly: geeft aan dat de lees-schrijfserver is bedoeld om niet deel te nemen aan querybewerkingen alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
properties.serverMonitorMode		ServerMonitorMode	De servermonitormodus voor AS-server
properties.sku		ResourceSku	De SKU van de Analysis Services-resource.
tags		object	Sleutel-waardeparen van aanvullende resource-inrichtingseigenschappen.

Antwoorden

Name	Type	Description
200 OK	AnalysisServicesServer	OK. De bewerking is voltooid.
201 Created	AnalysisServicesServer	InProgress. De bewerking wordt nog voltooid.
202 Accepted	AnalysisServicesServer	Voorbereiding. De bewerking wordt nog voltooid.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	uw gebruikersaccount imiteren

Voorbeelden

Create a server.

Voorbeeldaanvraag

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

Voorbeeldrespons

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

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

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

Definities

Name	Description
AnalysisServicesServer	Vertegenwoordigt een exemplaar van een Analysis Services-resource.
ConnectionMode	Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly: geeft aan dat de lees-schrijfserver is bedoeld om niet deel te nemen aan querybewerkingen alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Beschrijft de indeling van foutantwoord.
GatewayDetails	De gatewaydetails.
IPv4FirewallRule	De details van de firewallregel.
IPv4FirewallSettings	Een matrix van firewallregels.
ManagedMode	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
ProvisioningState	De huidige implementatiestatus van Analysis Services-resource. De provisioningState is om statussen voor resourceinrichting aan te geven.
ResourceSku	Vertegenwoordigt de naam van de SKU en de Azure-prijscategorie voor de Analysis Services-resource.
ServerAdministrators	Een matrix van beheerdersgebruikersidentiteiten.
ServerMonitorMode	De servermonitormodus voor AS-server
SkuTier	De naam van de Azure-prijscategorie waarop de SKU van toepassing is.
State	De huidige status van Analysis Services-resource. De status is om meer statussen aan te geven buiten het inrichten van resources.

AnalysisServicesServer

Vertegenwoordigt een exemplaar van een Analysis Services-resource.

Name	Type	Default value	Description
id	string		Een id die de Analysis Services-resource vertegenwoordigt.
location	string		Locatie van de Analysis Services-resource.
name	string		De naam van de Analysis Services-resource.
properties.asAdministrators	ServerAdministrators		Een verzameling AS-serverbeheerders
properties.backupBlobContainerUri	string		De SAS-container-URI naar de back-upcontainer.
properties.gatewayDetails	GatewayDetails		De gatewaygegevens die zijn geconfigureerd voor de AS-server.
properties.ipV4FirewallSettings	IPv4FirewallSettings		De firewallinstellingen voor de AS-server.
properties.managedMode	ManagedMode	1	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
properties.provisioningState	ProvisioningState		De huidige implementatiestatus van Analysis Services-resource. De provisioningState is om statussen voor resourceinrichting aan te geven.
properties.querypoolConnectionMode	ConnectionMode	All	Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly: geeft aan dat de lees-schrijfserver is bedoeld om niet deel te nemen aan querybewerkingen alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
properties.serverFullName	string		De volledige naam van de Analysis Services-resource.
properties.serverMonitorMode	ServerMonitorMode	1	De servermonitormodus voor AS-server
properties.sku	ResourceSku		De SKU van de Analysis Services-resource.
properties.state	State		De huidige status van Analysis Services-resource. De status is om meer statussen aan te geven buiten het inrichten van resources.
sku	ResourceSku		De SKU van de Analysis Services-resource.
tags	object		Sleutel-waardeparen van aanvullende resource-inrichtingseigenschappen.
type	string		Het type van de Analysis Services-resource.

ConnectionMode

Hoe de deelname van de lees-schrijfserver aan de querygroep wordt beheerd.
Het kan de volgende waarden hebben:

readOnly: geeft aan dat de lees-schrijfserver is bedoeld om niet deel te nemen aan querybewerkingen
alle: geeft aan dat de lees-schrijfserver kan deelnemen aan querybewerkingen

Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.

Name	Type	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
httpStatusCode	integer	De HTTP-statuscode
message	string	Het foutbericht.
subCode	integer	De subcode van de fout
target	string	Het foutdoel.
timeStamp	string	de tijdstempel voor de fout.

ErrorResponse

Beschrijft de indeling van foutantwoord.

Name	Type	Description
error	ErrorDetail	Het foutobject

GatewayDetails

De gatewaydetails.

Name	Type	Description
dmtsClusterUri	string	URI van het DMTS-cluster.
gatewayObjectId	string	Gatewayobject-id van in het DMTS-cluster voor de gatewayresource.
gatewayResourceId	string	Gatewayresource die moet worden gekoppeld aan de server.

IPv4FirewallRule

De details van de firewallregel.

Name	Type	Description
firewallRuleName	string	De regelnaam.
rangeEnd	string	Het eindbereik van IPv4.
rangeStart	string	Het beginbereik van IPv4.

IPv4FirewallSettings

Een matrix van firewallregels.

Name	Type	Description
enablePowerBIService	boolean	De indicator voor het inschakelen van de PBI-service.
firewallRules	IPv4FirewallRule[]	Een matrix van firewallregels.

ManagedMode

De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).

Name	Type	Description
0	Integer
1	Integer

ProvisioningState

De huidige implementatiestatus van Analysis Services-resource. De provisioningState is om statussen voor resourceinrichting aan te geven.

Name	Type	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

Vertegenwoordigt de naam van de SKU en de Azure-prijscategorie voor de Analysis Services-resource.

Name	Type	Default value	Description
capacity	integer	1	Het aantal exemplaren in de alleen-lezen querygroep.
name	string		Naam van het SKU-niveau.
tier	SkuTier		De naam van de Azure-prijscategorie waarop de SKU van toepassing is.

ServerAdministrators

Een matrix van beheerdersgebruikersidentiteiten.

Name	Type	Description
members	string[]	Een matrix van beheerdersgebruikersidentiteiten.

ServerMonitorMode

De servermonitormodus voor AS-server

Name	Type	Description
0	Integer
1	Integer

SkuTier

De naam van de Azure-prijscategorie waarop de SKU van toepassing is.

Name	Type	Description
Basic	string
Development	string
Standard	string

State

De huidige status van Analysis Services-resource. De status is om meer statussen aan te geven buiten het inrichten van resources.

Name	Type	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

Delen via

Servers - Create

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Create a server.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Aanvullende resources