Servers - Create

Referência

Serviço:: Analysis Services

Versão da API:: 2017-08-01

Aprovisiona o servidor do Analysis Services especificado com base na configuração especificada no pedido.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de Recursos do Azure do qual faz parte um determinado servidor do Analysis Services. Este nome tem de ter, pelo menos, um caráter de comprimento e não mais de 90. Padrão Regex: `^[-\w\._]+$`
serverName	path	True	string	O nome do servidor do Analysis Services. Tem de ter um mínimo de 3 carateres e um máximo de 63. Padrão Regex: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Um identificador exclusivo para uma subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version	query	True	string	A versão da API de cliente.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	Localização do recurso do Analysis Services.
sku	True	ResourceSku	O SKU do recurso do Analysis Services.
properties.asAdministrators		ServerAdministrators	Uma coleção de administradores do servidor AS
properties.backupBlobContainerUri		string	O URI do contentor de SAS para o contentor de cópia de segurança.
properties.gatewayDetails		GatewayDetails	Os detalhes do gateway configurados para o servidor AS.
properties.ipV4FirewallSettings		IPv4FirewallSettings	As definições de firewall para o servidor AS.
properties.managedMode		ManagedMode	O modo gerido do servidor (0 = não gerido, 1 = gerido).
properties.querypoolConnectionMode		ConnectionMode	A forma como a participação do servidor de leitura/escrita no conjunto de consultas é controlada. Pode ter os seguintes valores: readOnly - indica que o servidor de leitura/escrita se destina a não participar em operações de consulta all - indica que o servidor de leitura-escrita pode participar em operações de consulta Especificar readOnly quando a capacidade é 1 resulta num erro.
properties.serverMonitorMode		ServerMonitorMode	O modo de monitorização do servidor para o servidor AS
properties.sku		ResourceSku	O SKU do recurso do Analysis Services.
tags		object	Pares chave-valor de propriedades de aprovisionamento de recursos adicionais.

Respostas

Name	Tipo	Description
200 OK	AnalysisServicesServer	OK. A operação foi concluída com êxito.
201 Created	AnalysisServicesServer	Entrada. A operação ainda está a ser concluída.
202 Accepted	AnalysisServicesServer	A preparar. A operação ainda está a ser concluída.
Other Status Codes	ErrorResponse	Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Create a server.

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Definições

Name	Description
AnalysisServicesServer	Representa uma instância de um recurso do Analysis Services.
ConnectionMode	A forma como a participação do servidor de leitura/escrita no conjunto de consultas é controlada. Pode ter os seguintes valores: readOnly - indica que o servidor de leitura/escrita se destina a não participar em operações de consulta all - indica que o servidor de leitura-escrita pode participar em operações de consulta Especificar readOnly quando a capacidade é 1 resulta num erro.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Descreve o formato da resposta de Erro.
GatewayDetails	Os detalhes do gateway.
IPv4FirewallRule	O detalhe da regra de firewall.
IPv4FirewallSettings	Uma matriz de regras de firewall.
ManagedMode	O modo gerido do servidor (0 = não gerido, 1 = gerido).
ProvisioningState	O estado de implementação atual do recurso do Analysis Services. O provisioningState indica estados para o aprovisionamento de recursos.
ResourceSku	Representa o nome do SKU e o escalão de preço do Azure para o recurso do Analysis Services.
ServerAdministrators	Uma matriz de identidades de utilizador administrador.
ServerMonitorMode	O modo de monitorização do servidor para o servidor AS
SkuTier	O nome do escalão de preço do Azure ao qual o SKU se aplica.
State	O estado atual do recurso do Analysis Services. O estado é indicar mais estados fora do aprovisionamento de recursos.

AnalysisServicesServer

Representa uma instância de um recurso do Analysis Services.

Name	Tipo	Default value	Description
id	string		Um identificador que representa o recurso do Analysis Services.
location	string		Localização do recurso do Analysis Services.
name	string		O nome do recurso do Analysis Services.
properties.asAdministrators	ServerAdministrators		Uma coleção de administradores do servidor AS
properties.backupBlobContainerUri	string		O URI do contentor de SAS para o contentor de cópia de segurança.
properties.gatewayDetails	GatewayDetails		Os detalhes do gateway configurados para o servidor AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		As definições de firewall para o servidor AS.
properties.managedMode	ManagedMode	1	O modo gerido do servidor (0 = não gerido, 1 = gerido).
properties.provisioningState	ProvisioningState		O estado de implementação atual do recurso do Analysis Services. O provisioningState indica estados para o aprovisionamento de recursos.
properties.querypoolConnectionMode	ConnectionMode	All	A forma como a participação do servidor de leitura/escrita no conjunto de consultas é controlada. Pode ter os seguintes valores: readOnly - indica que o servidor de leitura/escrita se destina a não participar em operações de consulta all - indica que o servidor de leitura-escrita pode participar em operações de consulta Especificar readOnly quando a capacidade é 1 resulta num erro.
properties.serverFullName	string		O nome completo do recurso do Analysis Services.
properties.serverMonitorMode	ServerMonitorMode	1	O modo de monitorização do servidor para o servidor AS
properties.sku	ResourceSku		O SKU do recurso do Analysis Services.
properties.state	State		O estado atual do recurso do Analysis Services. O estado é indicar mais estados fora do aprovisionamento de recursos.
sku	ResourceSku		O SKU do recurso do Analysis Services.
tags	object		Pares chave-valor de propriedades de aprovisionamento de recursos adicionais.
type	string		O tipo do recurso do Analysis Services.

ConnectionMode

A forma como a participação do servidor de leitura/escrita no conjunto de consultas é controlada.
Pode ter os seguintes valores:

readOnly - indica que o servidor de leitura/escrita se destina a não participar em operações de consulta
all - indica que o servidor de leitura-escrita pode participar em operações de consulta

Especificar readOnly quando a capacidade é 1 resulta num erro.

Name	Tipo	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
httpStatusCode	integer	O código de estado http
message	string	A mensagem de erro.
subCode	integer	O subcódigo de erro
target	string	O destino do erro.
timeStamp	string	o carimbo de data/hora do erro.

ErrorResponse

Descreve o formato da resposta de Erro.

Name	Tipo	Description
error	ErrorDetail	O objeto de erro

GatewayDetails

Os detalhes do gateway.

Name	Tipo	Description
dmtsClusterUri	string	URI do cluster DMTS.
gatewayObjectId	string	ID de objeto do gateway no cluster DMTS para o recurso de gateway.
gatewayResourceId	string	Recurso de gateway a ser associado ao servidor.

IPv4FirewallRule

O detalhe da regra de firewall.

Name	Tipo	Description
firewallRuleName	string	O nome da regra.
rangeEnd	string	O intervalo final de IPv4.
rangeStart	string	O intervalo inicial de IPv4.

IPv4FirewallSettings

Uma matriz de regras de firewall.

Name	Tipo	Description
enablePowerBIService	boolean	O indicador de ativação do serviço PBI.
firewallRules	IPv4FirewallRule[]	Uma matriz de regras de firewall.

ManagedMode

O modo gerido do servidor (0 = não gerido, 1 = gerido).

Name	Tipo	Description
0	Integer
1	Integer

ProvisioningState

O estado de implementação atual do recurso do Analysis Services. O provisioningState indica estados para o aprovisionamento de recursos.

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

Representa o nome do SKU e o escalão de preço do Azure para o recurso do Analysis Services.

Name	Tipo	Default value	Description
capacity	integer	1	O número de instâncias no conjunto de consultas só de leitura.
name	string		Nome do nível de SKU.
tier	SkuTier		O nome do escalão de preço do Azure ao qual o SKU se aplica.

ServerAdministrators

Uma matriz de identidades de utilizador administrador.

Name	Tipo	Description
members	string[]	Uma matriz de identidades de utilizador administrador.

ServerMonitorMode

O modo de monitorização do servidor para o servidor AS

Name	Tipo	Description
0	Integer
1	Integer

SkuTier

O nome do escalão de preço do Azure ao qual o SKU se aplica.

Name	Tipo	Description
Basic	string
Development	string
Standard	string

State

O estado atual do recurso do Analysis Services. O estado é indicar mais estados fora do aprovisionamento de recursos.

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

Partilhar via

Servers - Create

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create a server.

Pedido de amostra

Resposta da amostra

Definições

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Recursos adicionais