Servers - Create

Referensi

Service:: Analysis Services

API Version:: 2017-08-01

Menyediakan server Analysis Services yang ditentukan berdasarkan konfigurasi yang ditentukan dalam permintaan.

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

Parameter URI

Name	In	Required	Type	Description
resourceGroupName	path	True	string	Nama grup Sumber Daya Azure tempat server Analysis Services tertentu menjadi bagiannya. Panjang nama ini harus minimal 1 karakter, dan tidak lebih dari 90. Regex pattern: `^[-\w\._]+$`
serverName	path	True	string	Nama server Analysis Services. Minimal harus 3 karakter, dan maksimal 63 karakter. Regex pattern: `^[a-z][a-z0-9]*$`
subscriptionId	path	True	string	Pengidentifikasi unik untuk langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
api-version	query	True	string	Versi API klien.

Isi Permintaan

Name	Required	Type	Description
location	True	string	Lokasi sumber daya Analysis Services.
sku	True	ResourceSku	SKU sumber daya Analysis Services.
properties.asAdministrators		ServerAdministrators	Kumpulan administrator server AS
properties.backupBlobContainerUri		string	URI kontainer SAS ke kontainer cadangan.
properties.gatewayDetails		GatewayDetails	Detail gateway dikonfigurasi untuk server AS.
properties.ipV4FirewallSettings		IPv4FirewallSettings	Pengaturan firewall untuk server AS.
properties.managedMode		ManagedMode	Mode terkelola server (0 = tidak dikelola, 1 = dikelola).
properties.querypoolConnectionMode		ConnectionMode	Bagaimana partisipasi server baca-tulis dalam kumpulan kueri dikontrol. Parameter dapat memiliki nilai berikut: readOnly - menunjukkan bahwa server baca-tulis dimaksudkan untuk tidak berpartisipasi dalam operasi kueri all - menunjukkan bahwa server baca-tulis dapat berpartisipasi dalam operasi kueri Menentukan readOnly ketika kapasitas adalah 1 menghasilkan kesalahan.
properties.serverMonitorMode		ServerMonitorMode	Mode monitor server untuk server AS
properties.sku		ResourceSku	SKU sumber daya Analysis Services.
tags		object	Pasangan kunci-nilai dari properti provisi sumber daya tambahan.

Respons

Name	Type	Description
200 OK	AnalysisServicesServer	OK. Operasi berhasil diselesaikan.
201 Created	AnalysisServicesServer	InProgress. Operasi masih selesai.
202 Accepted	AnalysisServicesServer	Mempersiapkan. Operasi masih selesai.
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	meniru akun pengguna Anda

Contoh

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/tree/main/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()
	client, err := armanalysisservices.NewServersClient("613192d7-503f-477a-9cfe-4efc3ee2bd60", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := client.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)
	}
	// TODO: use response item
	_ = res
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:: 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"
  }
}

Status code:: 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"
  }
}

Status code:: 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"
  }
}

Definisi

AnalysisServicesServer	Mewakili instans sumber daya Analysis Services.
ConnectionMode	Bagaimana partisipasi server baca-tulis dalam kumpulan kueri dikontrol. Parameter dapat memiliki nilai berikut: readOnly - menunjukkan bahwa server baca-tulis dimaksudkan untuk tidak berpartisipasi dalam operasi kueri all - menunjukkan bahwa server baca-tulis dapat berpartisipasi dalam operasi kueri Menentukan readOnly ketika kapasitas adalah 1 menghasilkan kesalahan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Menjelaskan format respons Kesalahan.
GatewayDetails	Detail gateway.
IPv4FirewallRule	Detail aturan firewall.
IPv4FirewallSettings	Array aturan firewall.
ManagedMode	Mode terkelola server (0 = tidak dikelola, 1 = dikelola).
ProvisioningState	Status penyebaran sumber daya Analysis Services saat ini. ProvisioningState adalah untuk menunjukkan status untuk provisi sumber daya.
ResourceSku	Mewakili nama SKU dan tingkat harga Azure untuk sumber daya Analysis Services.
ServerAdministrators	Array identitas pengguna administrator.
ServerMonitorMode	Mode monitor server untuk server AS
SkuTier	Nama tingkat harga Azure tempat SKU berlaku.
State	Status sumber daya Analysis Services saat ini. Statusnya adalah untuk menunjukkan lebih banyak status di luar provisi sumber daya.

AnalysisServicesServer

Mewakili instans sumber daya Analysis Services.

Name	Type	Default Value	Description
id	string		Pengidentifikasi yang mewakili sumber daya Analysis Services.
location	string		Lokasi sumber daya Analysis Services.
name	string		Nama sumber daya Analysis Services.
properties.asAdministrators	ServerAdministrators		Kumpulan administrator server AS
properties.backupBlobContainerUri	string		URI kontainer SAS ke kontainer cadangan.
properties.gatewayDetails	GatewayDetails		Detail gateway dikonfigurasi untuk server AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		Pengaturan firewall untuk server AS.
properties.managedMode	ManagedMode	1	Mode terkelola server (0 = tidak dikelola, 1 = dikelola).
properties.provisioningState	ProvisioningState		Status penyebaran sumber daya Analysis Services saat ini. ProvisioningState adalah untuk menunjukkan status untuk provisi sumber daya.
properties.querypoolConnectionMode	ConnectionMode	All	Bagaimana partisipasi server baca-tulis dalam kumpulan kueri dikontrol. Parameter dapat memiliki nilai berikut: readOnly - menunjukkan bahwa server baca-tulis dimaksudkan untuk tidak berpartisipasi dalam operasi kueri all - menunjukkan bahwa server baca-tulis dapat berpartisipasi dalam operasi kueri Menentukan readOnly ketika kapasitas adalah 1 menghasilkan kesalahan.
properties.serverFullName	string		Nama lengkap sumber daya Analysis Services.
properties.serverMonitorMode	ServerMonitorMode	1	Mode monitor server untuk server AS
properties.sku	ResourceSku		SKU sumber daya Analysis Services.
properties.state	State		Status sumber daya Analysis Services saat ini. Statusnya adalah untuk menunjukkan lebih banyak status di luar provisi sumber daya.
sku	ResourceSku		SKU sumber daya Analysis Services.
tags	object		Pasangan kunci-nilai dari properti provisi sumber daya tambahan.
type	string		Jenis sumber daya Analysis Services.

ConnectionMode

Bagaimana partisipasi server baca-tulis dalam kumpulan kueri dikontrol.
Parameter dapat memiliki nilai berikut:

readOnly - menunjukkan bahwa server baca-tulis dimaksudkan untuk tidak berpartisipasi dalam operasi kueri
all - menunjukkan bahwa server baca-tulis dapat berpartisipasi dalam operasi kueri

Menentukan readOnly ketika kapasitas adalah 1 menghasilkan kesalahan.

Name	Type	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Name	Type	Description
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
httpStatusCode	integer	Kode status http
message	string	Pesan kesalahan.
subCode	integer	Sub kode kesalahan
target	string	Target kesalahan.
timeStamp	string	tanda waktu untuk kesalahan.

ErrorResponse

Menjelaskan format respons Kesalahan.

Name	Type	Description
error	ErrorDetail	Objek kesalahan

GatewayDetails

Detail gateway.

Name	Type	Description
dmtsClusterUri	string	Uri kluster DMTS.
gatewayObjectId	string	Id objek gateway dari dalam kluster DMTS untuk sumber daya gateway.
gatewayResourceId	string	Sumber daya gateway yang akan dikaitkan dengan server.

IPv4FirewallRule

Detail aturan firewall.

Name	Type	Description
firewallRuleName	string	Nama aturan.
rangeEnd	string	Rentang akhir IPv4.
rangeStart	string	Rentang awal IPv4.

IPv4FirewallSettings

Array aturan firewall.

Name	Type	Description
enablePowerBIService	boolean	Indikator pengaktifan layanan PBI.
firewallRules	IPv4FirewallRule[]	Array aturan firewall.

ManagedMode

Mode terkelola server (0 = tidak dikelola, 1 = dikelola).

Name	Type	Description
0	Integer
1	Integer

ProvisioningState

Status penyebaran sumber daya Analysis Services saat ini. ProvisioningState adalah untuk menunjukkan status untuk provisi sumber daya.

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

Mewakili nama SKU dan tingkat harga Azure untuk sumber daya Analysis Services.

Name	Type	Default Value	Description
capacity	integer	1	Jumlah instans dalam kumpulan kueri baca-saja.
name	string		Nama tingkat SKU.
tier	SkuTier		Nama tingkat harga Azure tempat SKU berlaku.

ServerAdministrators

Array identitas pengguna administrator.

Name	Type	Description
members	string[]	Array identitas pengguna administrator.

ServerMonitorMode

Mode monitor server untuk server AS

Name	Type	Description
0	Integer
1	Integer

SkuTier

Nama tingkat harga Azure tempat SKU berlaku.

Name	Type	Description
Basic	string
Development	string
Standard	string

State

Status sumber daya Analysis Services saat ini. Statusnya adalah untuk menunjukkan lebih banyak status di luar provisi sumber daya.

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