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 參數

名稱	位於	必要	類型	Description
resourceGroupName	path	True	string	指定 Analysis Services 伺服器所屬的 Azure 資源群組名稱。此名稱長度必須至少為1個字元，且不超過90個字元。 Regex 模式: `^[-\w\._]+$`
serverName	path	True	string	Analysis Services 伺服器的名稱。它至少必須是 3 個字元，最多 63 個字元。 Regex 模式: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Microsoft Azure 訂用帳戶的唯一標識符。訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。

要求本文

名稱	必要	類型	Description
location	True	string	Analysis Services 資源的位置。
sku	True	ResourceSku	Analysis Services 資源的 SKU。
properties.asAdministrators		ServerAdministrators	AS 伺服器管理員的集合
properties.backupBlobContainerUri		string	備份容器的 SAS 容器 URI。
properties.gatewayDetails		GatewayDetails	為 AS 伺服器設定的閘道詳細資料。
properties.ipV4FirewallSettings		IPv4FirewallSettings	AS 伺服器的防火牆設定。
properties.managedMode		ManagedMode	伺服器 (0 = 未受管理，1 = managed) 。
properties.querypoolConnectionMode		ConnectionMode	如何控制讀寫伺服器參與查詢集區。它具有下列值： readOnly - 指出讀寫伺服器不適合參與查詢作業 all - 表示讀寫伺服器可以參與查詢作業當容量為 1 時指定 readOnly 會導致錯誤。
properties.serverMonitorMode		ServerMonitorMode	AS 伺服器的伺服器監視模式
properties.sku		ResourceSku	Analysis Services 資源的 SKU。
tags		object	其他資源布建屬性的索引鍵/值組。

回應

名稱	類型	Description
200 OK	AnalysisServicesServer	正常。作業已成功完成。
201 Created	AnalysisServicesServer	InProgress。作業仍在完成中。
202 Accepted	AnalysisServicesServer	準備。作業仍在完成中。
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
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"
  }
}

定義

名稱	Description
AnalysisServicesServer	表示 Analysis Services 資源的實例。
ConnectionMode	如何控制讀寫伺服器參與查詢集區。它具有下列值： readOnly - 指出讀寫伺服器不適合參與查詢作業 all - 表示讀寫伺服器可以參與查詢作業當容量為 1 時指定 readOnly 會導致錯誤。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	描述錯誤回應的格式。
GatewayDetails	閘道詳細數據。
IPv4FirewallRule	防火牆規則的詳細數據。
IPv4FirewallSettings	防火牆規則的陣列。
ManagedMode	伺服器 (0 = 未受管理，1 = managed) 。
ProvisioningState	Analysis Services 資源的目前部署狀態。 provisioningState是指出資源布建的狀態。
ResourceSku	代表 Analysis Services 資源的 SKU 名稱和 Azure 定價層。
ServerAdministrators	系統管理員使用者身分識別的陣列。
ServerMonitorMode	AS 伺服器的伺服器監視模式
SkuTier	套用 SKU 的 Azure 定價層名稱。
State	Analysis Services 資源的目前狀態。狀態是指出資源布建以外的更多狀態。

AnalysisServicesServer

表示 Analysis Services 資源的實例。

名稱	類型	預設值	Description
id	string		表示 Analysis Services 資源的標識碼。
location	string		Analysis Services 資源的位置。
name	string		Analysis Services 資源的名稱。
properties.asAdministrators	ServerAdministrators		AS 伺服器管理員的集合
properties.backupBlobContainerUri	string		備份容器的 SAS 容器 URI。
properties.gatewayDetails	GatewayDetails		為 AS 伺服器設定的閘道詳細資料。
properties.ipV4FirewallSettings	IPv4FirewallSettings		AS 伺服器的防火牆設定。
properties.managedMode	ManagedMode	1	伺服器 (0 = 未受管理，1 = managed) 。
properties.provisioningState	ProvisioningState		Analysis Services 資源的目前部署狀態。 provisioningState是指出資源布建的狀態。
properties.querypoolConnectionMode	ConnectionMode	All	如何控制讀寫伺服器參與查詢集區。它具有下列值： readOnly - 指出讀寫伺服器不適合參與查詢作業 all - 表示讀寫伺服器可以參與查詢作業當容量為 1 時指定 readOnly 會導致錯誤。
properties.serverFullName	string		Analysis Services 資源的完整名稱。
properties.serverMonitorMode	ServerMonitorMode	1	AS 伺服器的伺服器監視模式
properties.sku	ResourceSku		Analysis Services 資源的 SKU。
properties.state	State		Analysis Services 資源的目前狀態。狀態是指出資源布建以外的更多狀態。
sku	ResourceSku		Analysis Services 資源的 SKU。
tags	object		其他資源布建屬性的索引鍵/值組。
type	string		Analysis Services 資源的類型。

ConnectionMode

如何控制讀寫伺服器參與查詢集區。
它具有下列值：

readOnly - 指出讀寫伺服器不適合參與查詢作業
all - 表示讀寫伺服器可以參與查詢作業

當容量為 1 時指定 readOnly 會導致錯誤。

名稱	類型	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細資料。
httpStatusCode	integer	HTTP 狀態代碼
message	string	錯誤訊息。
subCode	integer	錯誤子碼
target	string	錯誤目標。
timeStamp	string	錯誤的時間戳。

ErrorResponse

描述錯誤回應的格式。

名稱	類型	Description
error	ErrorDetail	錯誤物件

GatewayDetails

閘道詳細數據。

名稱	類型	Description
dmtsClusterUri	string	DMTS 叢集的 URI。
gatewayObjectId	string	閘道資源之 DMTS 叢集中的閘道物件識別碼。
gatewayResourceId	string	要與伺服器相關聯的閘道資源。

IPv4FirewallRule

防火牆規則的詳細數據。

名稱	類型	Description
firewallRuleName	string	規則名稱。
rangeEnd	string	IPv4 的結束範圍。
rangeStart	string	IPv4 的開始範圍。

IPv4FirewallSettings

防火牆規則的陣列。

名稱	類型	Description
enablePowerBIService	boolean	啟用 PBI 服務的指標。
firewallRules	IPv4FirewallRule[]	防火牆規則的陣列。

ManagedMode

伺服器 (0 = 未受管理，1 = managed) 。

名稱	類型	Description
0	Integer
1	Integer

ProvisioningState

Analysis Services 資源的目前部署狀態。 provisioningState是指出資源布建的狀態。

名稱	類型	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

代表 Analysis Services 資源的 SKU 名稱和 Azure 定價層。

名稱	類型	預設值	Description
capacity	integer	1	唯讀查詢集區中的實例數目。
name	string		SKU 層級的名稱。
tier	SkuTier		套用 SKU 的 Azure 定價層名稱。

ServerAdministrators

系統管理員使用者身分識別的陣列。

名稱	類型	Description
members	string[]	系統管理員使用者身分識別的陣列。

ServerMonitorMode

AS 伺服器的伺服器監視模式

名稱	類型	Description
0	Integer
1	Integer

SkuTier

套用 SKU 的 Azure 定價層名稱。

名稱	類型	Description
Basic	string
Development	string
Standard	string

State

Analysis Services 資源的目前狀態。狀態是指出資源布建以外的更多狀態。

名稱	類型	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

共用方式為

Servers - Create

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

Create a server.

範例要求

範例回覆

定義

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

其他資源