Servers - Update

Referência

Serviço:: Analysis Services

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

Atualiza o estado atual do servidor do Analysis Services especificado.

PATCH 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 minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	O nome do grupo de Recursos do Azure do qual um determinado servidor do Analysis Services faz parte. Este nome deve ter pelo menos 1 caractere e não mais de 90.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	O nome do servidor do Analysis Services. Deve ter pelo menos 3 caracteres e não mais de 63.
subscriptionId	path	True	string	Um identificador exclusivo para uma assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version	query	True	string	A versão da API do cliente.

Corpo do Pedido

Name	Tipo	Description
properties.asAdministrators	ServerAdministrators	Uma coleção de administradores de servidor AS
properties.backupBlobContainerUri	string	O URI do contêiner SAS para o contêiner de backup.
properties.gatewayDetails	GatewayDetails	Os detalhes do gateway configurados para o servidor AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings	As configurações de firewall para o servidor AS.
properties.managedMode	ManagedMode (int32)	O modo gerenciado do servidor (0 = não gerenciado, 1 = gerenciado).
properties.querypoolConnectionMode	ConnectionMode	Como a participação do servidor de leitura-gravação no pool de consultas é controlada. Pode ter os seguintes valores: readOnly - indica que o servidor de leitura/gravação não se destina a participar de operações de consulta all - indica que o servidor de leitura-gravação pode participar de operações de consulta Especificar readOnly quando a capacidade é 1 resulta em erro.
properties.serverMonitorMode	ServerMonitorMode (int32)	O modo de monitor do servidor para o servidor AS
sku	ResourceSku	A SKU do recurso Analysis Services.
tags	object	Pares chave-valor de propriedades de provisionamento adicionais.

Respostas

Name	Tipo	Description
200 OK	AnalysisServicesServer	OK
202 Accepted	AnalysisServicesServer	Aceito
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Update a server.

Pedido de amostra

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 Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
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

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

Definições

Name	Description
AnalysisServicesServer	Representa uma instância de um recurso do Analysis Services.
AnalysisServicesServerUpdateParameters	Especificação de solicitação de provisão
ConnectionMode	Como a participação do servidor de leitura-gravação no pool de consultas é controlada. Pode ter os seguintes valores: readOnly - indica que o servidor de leitura/gravação não se destina a participar de operações de consulta all - indica que o servidor de leitura-gravação pode participar de operações de consulta Especificar readOnly quando a capacidade é 1 resulta em erro.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Descreve o formato de 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 gerenciado do servidor (0 = não gerenciado, 1 = gerenciado).
ProvisioningState	O estado atual de implantação do recurso Analysis Services. O provisioningState deve indicar estados para provisionamento de recursos.
ResourceSku	Representa o nome da SKU e a camada de preços do Azure para o recurso Analysis Services.
ServerAdministrators	Uma matriz de identidades de usuário administrador.
ServerMonitorMode	O modo de monitor do servidor para o servidor AS
SkuTier	O nome da camada de preços do Azure à qual a SKU se aplica.
State	O estado atual do recurso Analysis Services. O estado deve indicar mais estados fora do provisionamento de recursos.

AnalysisServicesServer

Object

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 Analysis Services.
name	string		O nome do recurso Analysis Services.
properties.asAdministrators	ServerAdministrators		Uma coleção de administradores de servidor AS
properties.backupBlobContainerUri	string		O URI do contêiner SAS para o contêiner de backup.
properties.gatewayDetails	GatewayDetails		Os detalhes do gateway configurados para o servidor AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		As configurações de firewall para o servidor AS.
properties.managedMode	ManagedMode (int32)	1	O modo gerenciado do servidor (0 = não gerenciado, 1 = gerenciado).
properties.provisioningState	ProvisioningState		O estado atual de implantação do recurso Analysis Services. O provisioningState deve indicar estados para provisionamento de recursos.
properties.querypoolConnectionMode	ConnectionMode	All	Como a participação do servidor de leitura-gravação no pool de consultas é controlada. Pode ter os seguintes valores: readOnly - indica que o servidor de leitura/gravação não se destina a participar de operações de consulta all - indica que o servidor de leitura-gravação pode participar de operações de consulta Especificar readOnly quando a capacidade é 1 resulta em erro.
properties.serverFullName	string		O nome completo do recurso Analysis Services.
properties.serverMonitorMode	ServerMonitorMode (int32)	1	O modo de monitor do servidor para o servidor AS
properties.sku	ResourceSku		A SKU do recurso Analysis Services.
properties.state	State		O estado atual do recurso Analysis Services. O estado deve indicar mais estados fora do provisionamento de recursos.
sku	ResourceSku		A SKU do recurso Analysis Services.
tags	object		Pares chave-valor de propriedades adicionais de provisionamento de recursos.
type	string		O tipo de recurso do Analysis Services.

AnalysisServicesServerUpdateParameters

Object

Especificação de solicitação de provisão

Name	Tipo	Default value	Description
properties.asAdministrators	ServerAdministrators		Uma coleção de administradores de servidor AS
properties.backupBlobContainerUri	string		O URI do contêiner SAS para o contêiner de backup.
properties.gatewayDetails	GatewayDetails		Os detalhes do gateway configurados para o servidor AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		As configurações de firewall para o servidor AS.
properties.managedMode	ManagedMode (int32)	1	O modo gerenciado do servidor (0 = não gerenciado, 1 = gerenciado).
properties.querypoolConnectionMode	ConnectionMode	All	Como a participação do servidor de leitura-gravação no pool de consultas é controlada. Pode ter os seguintes valores: readOnly - indica que o servidor de leitura/gravação não se destina a participar de operações de consulta all - indica que o servidor de leitura-gravação pode participar de operações de consulta Especificar readOnly quando a capacidade é 1 resulta em erro.
properties.serverMonitorMode	ServerMonitorMode (int32)	1	O modo de monitor do servidor para o servidor AS
sku	ResourceSku		A SKU do recurso Analysis Services.
tags	object		Pares chave-valor de propriedades de provisionamento adicionais.

ConnectionMode

Enumeração

Como a participação do servidor de leitura-gravação no pool de consultas é controlada.
Pode ter os seguintes valores:

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

Especificar readOnly quando a capacidade é 1 resulta em erro.

Valor	Description
All
ReadOnly

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

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

ErrorDetail

Object

O detalhe do erro.

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

ErrorResponse

Object

Descreve o formato de Resposta de erro.

Name	Tipo	Description
error	ErrorDetail	O objeto de erro

GatewayDetails

Object

Os detalhes do gateway.

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

IPv4FirewallRule

Object

O detalhe da regra de firewall.

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

IPv4FirewallSettings

Object

Uma matriz de regras de firewall.

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

ManagedMode

Enumeração

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

Valor	Description
0
1

ProvisioningState

Enumeração

O estado atual de implantação do recurso Analysis Services. O provisioningState deve indicar estados para provisionamento de recursos.

Valor	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

ResourceSku

Object

Representa o nome da SKU e a camada de preços do Azure para o recurso Analysis Services.

Name	Tipo	Default value	Description
capacity	integer (int32) minimum: 1 maximum: 8	1	O número de instâncias no pool de consultas somente leitura.
name	string		Nome do nível de SKU.
tier	SkuTier		O nome da camada de preços do Azure à qual a SKU se aplica.

ServerAdministrators

Object

Uma matriz de identidades de usuário administrador.

Name	Tipo	Description
members	string[]	Uma matriz de identidades de usuário administrador.

ServerMonitorMode

Enumeração

O modo de monitor do servidor para o servidor AS

Valor	Description
0
1

SkuTier

Enumeração

O nome da camada de preços do Azure à qual a SKU se aplica.

Valor	Description
Basic
Development
Standard

State

Enumeração

O estado atual do recurso Analysis Services. O estado deve indicar mais estados fora do provisionamento de recursos.

Valor	Description
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

Partilhar via

Servers - Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Update a server.

Pedido de amostra

Resposta da amostra

Definições

AnalysisServicesServer

AnalysisServicesServerUpdateParameters

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Recursos adicionais