Servers - Create

Ссылка

Служба:: Analysis Services

Версия API:: 2017-08-01

Подготавливает указанный сервер служб Analysis Services на основе конфигурации, указанной в запросе.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов Azure, частью которой является данный сервер служб Analysis Services. Это имя должно содержать не менее 1 символа и не более 90 символов. Шаблон регулярного выражения: `^[-\w\._]+$`
serverName	path	True	string	Имя сервера служб Analysis Services. Он должен содержать не менее 3 символов и не более 63 символов. Шаблон регулярного выражения: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Уникальный идентификатор подписки Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.
api-version	query	True	string	Версия КЛИЕНТСКОго API.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Расположение ресурса служб Analysis Services.
sku	True	ResourceSku	Номер SKU ресурса служб Analysis Services.
properties.asAdministrators		ServerAdministrators	Коллекция администраторов сервера AS
properties.backupBlobContainerUri		string	Универсальный код ресурса (URI) контейнера SAS для контейнера резервной копии.
properties.gatewayDetails		GatewayDetails	Сведения о шлюзе, настроенные для сервера AS.
properties.ipV4FirewallSettings		IPv4FirewallSettings	Параметры брандмауэра для сервера AS.
properties.managedMode		ManagedMode	Управляемый режим сервера (0 = неуправляемый, 1 = управляемый).
properties.querypoolConnectionMode		ConnectionMode	Как контролируется участие сервера чтения и записи в пуле запросов. Может иметь следующие значения. readOnly — указывает, что сервер чтения и записи не должен участвовать в операциях запросов. all — указывает, что сервер чтения и записи может участвовать в операциях запросов. Указание readOnly, если емкость равно 1, приводит к ошибке.
properties.serverMonitorMode		ServerMonitorMode	Режим монитора сервера для СЕРВЕРА AS
properties.sku		ResourceSku	Номер SKU ресурса служб Analysis Services.
tags		object	Пары "ключ-значение" дополнительных свойств подготовки ресурсов.

Ответы

Имя	Тип	Описание
200 OK	AnalysisServicesServer	Все в порядке. Операция выполнена успешно.
201 Created	AnalysisServicesServer	Inprogress. Операция по-прежнему завершается.
202 Accepted	AnalysisServicesServer	Подготовка. Операция по-прежнему завершается.
Other Status Codes	ErrorResponse	Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Create a server.

Образец запроса

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

Пример ответа

Код состояния:: 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"
  }
}

Код состояния:: 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"
  }
}

Код состояния:: 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"
  }
}

Определения

Имя	Описание
AnalysisServicesServer	Представляет экземпляр ресурса служб Analysis Services.
ConnectionMode	Как контролируется участие сервера чтения и записи в пуле запросов. Может иметь следующие значения. readOnly — указывает, что сервер чтения и записи не должен участвовать в операциях запросов. all — указывает, что сервер чтения и записи может участвовать в операциях запросов. Указание readOnly, если емкость равно 1, приводит к ошибке.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Описывает формат ответа об ошибке.
GatewayDetails	Сведения о шлюзе.
IPv4FirewallRule	Сведения о правиле брандмауэра.
IPv4FirewallSettings	Массив правил брандмауэра.
ManagedMode	Управляемый режим сервера (0 = неуправляемый, 1 = управляемый).
ProvisioningState	Текущее состояние развертывания ресурса служб Analysis Services. ProvisioningState указывает состояния для подготовки ресурсов.
ResourceSku	Представляет имя SKU и ценовую категорию Azure для ресурса служб Analysis Services.
ServerAdministrators	Массив удостоверений пользователей администратора.
ServerMonitorMode	Режим монитора сервера для СЕРВЕРА AS
SkuTier	Имя ценовой категории Azure, к которой применяется номер SKU.
State	Текущее состояние ресурса служб Analysis Services. Состояние заключается в том, чтобы указать больше состояний вне подготовки ресурсов.

AnalysisServicesServer

Представляет экземпляр ресурса служб Analysis Services.

Имя	Тип	Default value	Описание
id	string		Идентификатор, представляющий ресурс служб Analysis Services.
location	string		Расположение ресурса служб Analysis Services.
name	string		Имя ресурса служб Analysis Services.
properties.asAdministrators	ServerAdministrators		Коллекция администраторов сервера AS
properties.backupBlobContainerUri	string		Универсальный код ресурса (URI) контейнера SAS для контейнера резервной копии.
properties.gatewayDetails	GatewayDetails		Сведения о шлюзе, настроенные для сервера AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Параметры брандмауэра для сервера AS.
properties.managedMode	ManagedMode	1	Управляемый режим сервера (0 = неуправляемый, 1 = управляемый).
properties.provisioningState	ProvisioningState		Текущее состояние развертывания ресурса служб Analysis Services. ProvisioningState указывает состояния для подготовки ресурсов.
properties.querypoolConnectionMode	ConnectionMode	All	Как контролируется участие сервера чтения и записи в пуле запросов. Может иметь следующие значения. readOnly — указывает, что сервер чтения и записи не должен участвовать в операциях запросов. all — указывает, что сервер чтения и записи может участвовать в операциях запросов. Указание readOnly, если емкость равно 1, приводит к ошибке.
properties.serverFullName	string		Полное имя ресурса служб Analysis Services.
properties.serverMonitorMode	ServerMonitorMode	1	Режим монитора сервера для СЕРВЕРА AS
properties.sku	ResourceSku		Номер SKU ресурса служб Analysis Services.
properties.state	State		Текущее состояние ресурса служб Analysis Services. Состояние заключается в том, чтобы указать больше состояний вне подготовки ресурсов.
sku	ResourceSku		Номер SKU ресурса служб Analysis Services.
tags	object		Пары "ключ-значение" дополнительных свойств подготовки ресурсов.
type	string		Тип ресурса служб Analysis Services.

ConnectionMode

Как контролируется участие сервера чтения и записи в пуле запросов.
Может иметь следующие значения.

readOnly — указывает, что сервер чтения и записи не должен участвовать в операциях запросов.
all — указывает, что сервер чтения и записи может участвовать в операциях запросов.

Указание readOnly, если емкость равно 1, приводит к ошибке.

Имя	Тип	Описание
All	string
ReadOnly	string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
httpStatusCode	integer	Код состояния HTTP
message	string	Сообщение об ошибке.
subCode	integer	Вложенный код ошибки
target	string	Целевой объект ошибки.
timeStamp	string	метка времени для ошибки.

ErrorResponse

Описывает формат ответа об ошибке.

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки

GatewayDetails

Сведения о шлюзе.

Имя	Тип	Описание
dmtsClusterUri	string	URI кластера DMTS.
gatewayObjectId	string	Идентификатор объекта шлюза из в кластере DMTS для ресурса шлюза.
gatewayResourceId	string	Ресурс шлюза, связанный с сервером.

IPv4FirewallRule

Сведения о правиле брандмауэра.

Имя	Тип	Описание
firewallRuleName	string	Имя правила.
rangeEnd	string	Конечный диапазон IPv4.
rangeStart	string	Начальный диапазон IPv4.

IPv4FirewallSettings

Массив правил брандмауэра.

Имя	Тип	Описание
enablePowerBIService	boolean	Индикатор включения службы PBI.
firewallRules	IPv4FirewallRule[]	Массив правил брандмауэра.

ManagedMode

Управляемый режим сервера (0 = неуправляемый, 1 = управляемый).

Имя	Тип	Описание
0	Integer
1	Integer

ProvisioningState

Текущее состояние развертывания ресурса служб Analysis Services. ProvisioningState указывает состояния для подготовки ресурсов.

Имя	Тип	Описание
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

Представляет имя SKU и ценовую категорию Azure для ресурса служб Analysis Services.

Имя	Тип	Default value	Описание
capacity	integer	1	Количество экземпляров в пуле запросов только для чтения.
name	string		Имя уровня SKU.
tier	SkuTier		Имя ценовой категории Azure, к которой применяется номер SKU.

ServerAdministrators

Массив удостоверений пользователей администратора.

Имя	Тип	Описание
members	string[]	Массив удостоверений пользователей администратора.

ServerMonitorMode

Режим монитора сервера для СЕРВЕРА AS

Имя	Тип	Описание
0	Integer
1	Integer

SkuTier

Имя ценовой категории Azure, к которой применяется номер SKU.

Имя	Тип	Описание
Basic	string
Development	string
Standard	string

State

Текущее состояние ресурса служб Analysis Services. Состояние заключается в том, чтобы указать больше состояний вне подготовки ресурсов.

Имя	Тип	Описание
Deleting	string
Failed	string
Paused	string
Pausing	string
Preparing	string
Provisioning	string
Resuming	string
Scaling	string
Succeeded	string
Suspended	string
Suspending	string
Updating	string

Поделиться через

Servers - Create

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Create a server.

Образец запроса

Пример ответа

Определения

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Дополнительные ресурсы