Servers - Update

참조

서비스:: Analysis Services

API 버전:: 2017-08-01

지정된 Analysis Services 서버의 현재 상태를 업데이트.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	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 구독에 대한 고유 식별자입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.
api-version	query	True	string	클라이언트 API 버전입니다.

요청 본문

Name	형식	Description
properties.asAdministrators	ServerAdministrators	AS 서버 관리자의 컬렉션
properties.backupBlobContainerUri	string	백업 컨테이너에 대한 SAS 컨테이너 URI입니다.
properties.gatewayDetails	GatewayDetails	AS 서버에 대해 구성된 게이트웨이 세부 정보입니다.
properties.ipV4FirewallSettings	IPv4FirewallSettings	AS 서버에 대한 방화벽 설정입니다.
properties.managedMode	ManagedMode	서버의 관리 모드입니다(0 = 관리되지 않음, 1 = 관리됨).
properties.querypoolConnectionMode	ConnectionMode	읽기-쓰기 서버가 쿼리 풀에 참여하는 방식을 제어합니다. 다음과 같은 값을 가질 수 있습니다. readOnly - 읽기-쓰기 서버가 쿼리 작업에 참여하지 않음을 나타냅니다. all - 읽기-쓰기 서버가 쿼리 작업에 참여할 수 있음을 나타냅니다. 용량이 1일 때 readOnly를 지정하면 오류가 발생합니다.
properties.serverMonitorMode	ServerMonitorMode	AS 서버의 서버 모니터 모드
sku	ResourceSku	Analysis Services 리소스의 SKU입니다.
tags	object	추가 프로비저닝 속성의 키-값 쌍입니다.

응답

Name	형식	Description
200 OK	AnalysisServicesServer	정상
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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Update a server.

샘플 요청

PATCH 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"
  },
  "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/updateServer.json
func ExampleServersClient_BeginUpdate() {
	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().BeginUpdate(ctx, "TestRG", "azsdktest", armanalysisservices.ServerUpdateParameters{
		Properties: &armanalysisservices.ServerMutableProperties{
			AsAdministrators: &armanalysisservices.ServerAdministrators{
				Members: []*string{
					to.Ptr("azsdktest@microsoft.com"),
					to.Ptr("azsdktest2@microsoft.com")},
			},
		},
		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"),
		},
	}, 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 Updates the current state of the specified Analysis Services server.
 *
 * @summary Updates the current state of the specified Analysis Services server.
 * x-ms-original-file: specification/analysisservices/resource-manager/Microsoft.AnalysisServices/stable/2017-08-01/examples/updateServer.json
 */
async function updateAServer() {
  const subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
  const resourceGroupName = "TestRG";
  const serverName = "azsdktest";
  const serverUpdateParameters = {
    asAdministrators: {
      members: ["azsdktest@microsoft.com", "azsdktest2@microsoft.com"],
    },
    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.beginUpdateAndWait(
    resourceGroupName,
    serverName,
    serverUpdateParameters
  );
  console.log(result);
}

updateAServer().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/updateServer.json
// this example is just showing the usage of "Servers_Update" 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 AnalysisServerResource created on azure
// for more information of creating AnalysisServerResource, please refer to the document of AnalysisServerResource
string subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
string resourceGroupName = "TestRG";
string serverName = "azsdktest";
ResourceIdentifier analysisServerResourceId = AnalysisServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
AnalysisServerResource analysisServer = client.GetAnalysisServerResource(analysisServerResourceId);

// invoke the operation
AnalysisServerPatch patch = new AnalysisServerPatch()
{
    Sku = new AnalysisResourceSku("S1")
    {
        Tier = AnalysisSkuTier.Standard,
        Capacity = 1,
    },
    Tags =
    {
    ["testKey"] = "testValue",
    },
    AsAdministratorIdentities =
    {
    "azsdktest@microsoft.com","azsdktest2@microsoft.com"
    },
};
ArmOperation<AnalysisServerResource> lro = await analysisServer.UpdateAsync(WaitUntil.Completed, patch);
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"
  }
}

상태 코드:: 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": "Provisioning",
    "serverFullName": "asazure://nightly1.asazure-int.windows.net/azsdktest",
    "state": "Provisioning"
  },
  "sku": {
    "capacity": 1,
    "name": "S1",
    "tier": "Standard"
  },
  "tags": {
    "testKey": "testValue"
  }
}

정의

Name	Description
AnalysisServicesServer	Analysis Services 리소스의 instance 나타냅니다.
AnalysisServicesServerUpdateParameters	프로비전 요청 사양
ConnectionMode	읽기-쓰기 서버가 쿼리 풀에 참여하는 방식을 제어합니다. 다음과 같은 값을 가질 수 있습니다. readOnly - 읽기-쓰기 서버가 쿼리 작업에 참여하지 않음을 나타냅니다. all - 읽기-쓰기 서버가 쿼리 작업에 참여할 수 있음을 나타냅니다. 용량이 1일 때 readOnly를 지정하면 오류가 발생합니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답의 형식을 설명합니다.
GatewayDetails	게이트웨이 세부 정보입니다.
IPv4FirewallRule	방화벽 규칙의 세부 정보입니다.
IPv4FirewallSettings	방화벽 규칙의 배열입니다.
ManagedMode	서버의 관리 모드입니다(0 = 관리되지 않음, 1 = 관리됨).
ProvisioningState	Analysis Services 리소스의 현재 배포 상태입니다. provisioningState는 리소스 프로비저닝 상태를 나타내는 것입니다.
ResourceSku	Analysis Services 리소스에 대한 SKU 이름 및 Azure 가격 책정 계층을 나타냅니다.
ServerAdministrators	관리자 사용자 ID의 배열입니다.
ServerMonitorMode	AS 서버의 서버 모니터 모드
SkuTier	SKU가 적용되는 Azure 가격 책정 계층의 이름입니다.
State	Analysis Services 리소스의 현재 상태입니다. 상태는 리소스 프로비저닝 외부에서 더 많은 상태를 나타내는 것입니다.

AnalysisServicesServer

Analysis Services 리소스의 instance 나타냅니다.

Name	형식	Default value	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 = 관리됨).
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 리소스의 형식입니다.

AnalysisServicesServerUpdateParameters

프로비전 요청 사양

Name	형식	Default value	Description
properties.asAdministrators	ServerAdministrators		AS 서버 관리자의 컬렉션
properties.backupBlobContainerUri	string		백업 컨테이너에 대한 SAS 컨테이너 URI입니다.
properties.gatewayDetails	GatewayDetails		AS 서버에 대해 구성된 게이트웨이 세부 정보입니다.
properties.ipV4FirewallSettings	IPv4FirewallSettings		AS 서버에 대한 방화벽 설정입니다.
properties.managedMode	ManagedMode	1	서버의 관리 모드입니다(0 = 관리되지 않음, 1 = 관리됨).
properties.querypoolConnectionMode	ConnectionMode	All	읽기-쓰기 서버가 쿼리 풀에 참여하는 방식을 제어합니다. 다음과 같은 값을 가질 수 있습니다. readOnly - 읽기-쓰기 서버가 쿼리 작업에 참여하지 않음을 나타냅니다. all - 읽기-쓰기 서버가 쿼리 작업에 참여할 수 있음을 나타냅니다. 용량이 1일 때 readOnly를 지정하면 오류가 발생합니다.
properties.serverMonitorMode	ServerMonitorMode	1	AS 서버의 서버 모니터 모드
sku	ResourceSku		Analysis Services 리소스의 SKU입니다.
tags	object		추가 프로비저닝 속성의 키-값 쌍입니다.

ConnectionMode

읽기-쓰기 서버가 쿼리 풀에 참여하는 방식을 제어합니다.
다음과 같은 값을 가질 수 있습니다.

readOnly - 읽기-쓰기 서버가 쿼리 작업에 참여하지 않음을 나타냅니다.
all - 읽기-쓰기 서버가 쿼리 작업에 참여할 수 있음을 나타냅니다.

용량이 1일 때 readOnly를 지정하면 오류가 발생합니다.

Name	형식	Description
All	string
ReadOnly	string

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
httpStatusCode	integer	http 상태 코드
message	string	오류 메시지입니다.
subCode	integer	오류 하위 코드
target	string	오류 대상입니다.
timeStamp	string	오류에 대한 타임스탬프입니다.

ErrorResponse

오류 응답의 형식을 설명합니다.

Name	형식	Description
error	ErrorDetail	오류 개체

GatewayDetails

게이트웨이 세부 정보입니다.

Name	형식	Description
dmtsClusterUri	string	DMTS 클러스터의 URI입니다.
gatewayObjectId	string	게이트웨이 리소스에 대한 DMTS 클러스터의 게이트웨이 개체 ID입니다.
gatewayResourceId	string	서버와 연결할 게이트웨이 리소스입니다.

IPv4FirewallRule

방화벽 규칙의 세부 정보입니다.

Name	형식	Description
firewallRuleName	string	규칙 이름입니다.
rangeEnd	string	IPv4의 끝 범위입니다.
rangeStart	string	IPv4의 시작 범위입니다.

IPv4FirewallSettings

방화벽 규칙의 배열입니다.

Name	형식	Description
enablePowerBIService	boolean	PBI 서비스를 사용하도록 설정하는 표시기입니다.
firewallRules	IPv4FirewallRule[]	방화벽 규칙의 배열입니다.

ManagedMode

서버의 관리 모드입니다(0 = 관리되지 않음, 1 = 관리됨).

Name	형식	Description
0	Integer
1	Integer

ProvisioningState

Analysis Services 리소스의 현재 배포 상태입니다. provisioningState는 리소스 프로비저닝 상태를 나타내는 것입니다.

Name	형식	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 가격 책정 계층을 나타냅니다.

Name	형식	Default value	Description
capacity	integer	1	읽기 전용 쿼리 풀의 인스턴스 수입니다.
name	string		SKU 수준의 이름입니다.
tier	SkuTier		SKU가 적용되는 Azure 가격 책정 계층의 이름입니다.

ServerAdministrators

관리자 사용자 ID의 배열입니다.

Name	형식	Description
members	string[]	관리자 사용자 ID의 배열입니다.

ServerMonitorMode

AS 서버의 서버 모니터 모드

Name	형식	Description
0	Integer
1	Integer

SkuTier

SKU가 적용되는 Azure 가격 책정 계층의 이름입니다.

Name	형식	Description
Basic	string
Development	string
Standard	string

State

Analysis Services 리소스의 현재 상태입니다. 상태는 리소스 프로비저닝 외부에서 더 많은 상태를 나타내는 것입니다.

Name	형식	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 - Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

Update a server.

샘플 요청

샘플 응답

정의

AnalysisServicesServer

AnalysisServicesServerUpdateParameters

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

추가 리소스