Servers - Create

Referentie

Service:: Analysis Services

API-versie:: 2017-08-01

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

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 minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	De naam van de Azure-resourcegroep waarvan een bepaalde Analysis Services-server deel uitmaakt. Deze naam moet ten minste 1 teken lang zijn en niet meer dan 90.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	De naam van de Analysis Services-server. Het moet minimaal 3 tekens en maximaal 63 tekens zijn.
subscriptionId	path	True	string	Een unieke id voor een Microsoft Azure-abonnement. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.
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 (int32)	De beheerde modus van de server (0 = niet beheerd, 1 = beheerd).
properties.querypoolConnectionMode		ConnectionMode	Hoe de deelname van de read-write-server aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly - geeft aan dat de read-write-server is bedoeld om niet deel te nemen aan querybewerkingen all - geeft aan dat de read-write-server kan deelnemen aan querybewerkingen Het opgeven van readOnly wanneer capaciteit 1 is, resulteert in een fout.
properties.serverMonitorMode		ServerMonitorMode (int32)	De servermonitormodus voor AS-server
properties.sku		ResourceSku	De SKU van de Analysis Services-resource.
tags		object	Sleutel-waardeparen van aanvullende eigenschappen voor het inrichten van resources.

Antwoorden

Name	Type	Description
200 OK	AnalysisServicesServer	OK. De bewerking is voltooid.
201 Created	AnalysisServicesServer	InProgress. De bewerking wordt nog steeds voltooid.
202 Accepted	AnalysisServicesServer	Voorbereiding. De bewerking wordt nog steeds 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 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

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 read-write-server aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly - geeft aan dat de read-write-server is bedoeld om niet deel te nemen aan querybewerkingen all - geeft aan dat de read-write-server 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 foutreactie.
GatewayDetails	De details van de gateway.
IPv4FirewallRule	Het detail van de firewallregel.
IPv4FirewallSettings	Een matrix met 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 de statussen voor het inrichten van resources aan te geven.
ResourceSku	Vertegenwoordigt de naam van de SKU en de Azure-prijscategorie voor Analysis Services-resource.
ServerAdministrators	Een matrix met gebruikersidentiteiten van beheerders.
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

Object

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 (int32)	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 de statussen voor het inrichten van resources aan te geven.
properties.querypoolConnectionMode	ConnectionMode	All	Hoe de deelname van de read-write-server aan de querygroep wordt beheerd. Het kan de volgende waarden hebben: readOnly - geeft aan dat de read-write-server is bedoeld om niet deel te nemen aan querybewerkingen all - geeft aan dat de read-write-server 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 (int32)	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 eigenschappen voor het inrichten van resources.
type	string		Het type Analysis Services-resource.

ConnectionMode

Inventarisatie

Hoe de deelname van de read-write-server aan de querygroep wordt beheerd.
Het kan de volgende waarden hebben:

readOnly - geeft aan dat de read-write-server is bedoeld om niet deel te nemen aan querybewerkingen
all - geeft aan dat de read-write-server kan deelnemen aan querybewerkingen

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

Waarde	Description
All
ReadOnly

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

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

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
httpStatusCode	integer (int32)	De HTTP-statuscode
message	string	Het foutbericht.
subCode	integer (int32)	De foutcode
target	string	Het foutdoel.
timeStamp	string	de tijdstempel voor de fout.

ErrorResponse

Object

Beschrijft de indeling van foutreactie.

Name	Type	Description
error	ErrorDetail	Het foutobject

GatewayDetails

Object

De details van de gateway.

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

IPv4FirewallRule

Object

Het detail van de firewallregel.

Name	Type	Description
firewallRuleName	string	De naam van de regel.
rangeEnd	string	Het eindbereik van IPv4.
rangeStart	string	Het beginbereik van IPv4.

IPv4FirewallSettings

Object

Een matrix met firewallregels.

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

ManagedMode

Inventarisatie

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

Waarde	Description
0
1

ProvisioningState

Inventarisatie

De huidige implementatiestatus van Analysis Services-resource. De provisioningState is om de statussen voor het inrichten van resources aan te geven.

Waarde	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

ResourceSku

Object

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

Name	Type	Default value	Description
capacity	integer (int32) minimum: 1 maximum: 8	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

Object

Een matrix met gebruikersidentiteiten van beheerders.

Name	Type	Description
members	string[]	Een matrix met gebruikersidentiteiten van beheerders.

ServerMonitorMode

Inventarisatie

De servermonitormodus voor AS-server

Waarde	Description
0
1

SkuTier

Inventarisatie

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

Waarde	Description
Basic
Development
Standard

State

Inventarisatie

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

Waarde	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

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