Condividi tramite


Servers - Update

Aggiorna lo stato corrente del server Analysis Services specificato.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Nome del gruppo di risorse di Azure di cui fa parte un determinato server Analysis Services. Questo nome deve avere una lunghezza minima di 1 carattere e non più di 90.

serverName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-z][a-z0-9]*$

Nome del server Analysis Services. Deve contenere almeno 3 caratteri e non più di 63.

subscriptionId
path True

string

Identificatore univoco per una sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.

api-version
query True

string

Versione dell'API client.

Corpo della richiesta

Nome Tipo Descrizione
properties.asAdministrators

ServerAdministrators

Raccolta di amministratori del server AS

properties.backupBlobContainerUri

string

URI del contenitore sas per il contenitore di backup.

properties.gatewayDetails

GatewayDetails

Dettagli del gateway configurati per il server AS.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Impostazioni del firewall per il server AS.

properties.managedMode

ManagedMode (int32)

Modalità gestita del server (0 = non gestito, 1 = gestito).

properties.querypoolConnectionMode

ConnectionMode

Modalità di controllo della partecipazione del server di lettura/scrittura al pool di query.
Può avere i valori seguenti:

  • readOnly : indica che il server di lettura/scrittura non deve partecipare alle operazioni di query
  • all - indica che il server di lettura/scrittura può partecipare alle operazioni di query
Se si specifica readOnly quando la capacità è 1, viene generato un errore.

properties.serverMonitorMode

ServerMonitorMode (int32)

Modalità di monitoraggio del server per il server AS

sku

ResourceSku

SKU della risorsa di Analysis Services.

tags

object

Coppie chiave-valore di proprietà di provisioning aggiuntive.

Risposte

Nome Tipo Descrizione
200 OK

AnalysisServicesServer

OK

202 Accepted

AnalysisServicesServer

Accettato

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Update a server.

Esempio di richiesta

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

Risposta di esempio

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

Definizioni

Nome Descrizione
AnalysisServicesServer

Rappresenta un'istanza di una risorsa di Analysis Services.

AnalysisServicesServerUpdateParameters

Specifica della richiesta di provisioning

ConnectionMode

Modalità di controllo della partecipazione del server di lettura/scrittura al pool di query.
Può avere i valori seguenti:

  • readOnly : indica che il server di lettura/scrittura non deve partecipare alle operazioni di query
  • all - indica che il server di lettura/scrittura può partecipare alle operazioni di query
Se si specifica readOnly quando la capacità è 1, viene generato un errore.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Descrive il formato della risposta di errore.

GatewayDetails

Dettagli del gateway.

IPv4FirewallRule

Dettaglio della regola del firewall.

IPv4FirewallSettings

Matrice di regole del firewall.

ManagedMode

Modalità gestita del server (0 = non gestito, 1 = gestito).

ProvisioningState

Stato di distribuzione corrente della risorsa di Analysis Services. ProvisioningState indica gli stati per il provisioning delle risorse.

ResourceSku

Rappresenta il nome dello SKU e il piano tariffario di Azure per la risorsa di Analysis Services.

ServerAdministrators

Matrice di identità utente dell'amministratore.

ServerMonitorMode

Modalità di monitoraggio del server per il server AS

SkuTier

Nome del piano tariffario di Azure a cui si applica lo SKU.

State

Stato corrente della risorsa di Analysis Services. Lo stato consiste nell'indicare più stati al di fuori del provisioning delle risorse.

AnalysisServicesServer

Rappresenta un'istanza di una risorsa di Analysis Services.

Nome Tipo Valore predefinito Descrizione
id

string

Identificatore che rappresenta la risorsa di Analysis Services.

location

string

Posizione della risorsa di Analysis Services.

name

string

Nome della risorsa di Analysis Services.

properties.asAdministrators

ServerAdministrators

Raccolta di amministratori del server AS

properties.backupBlobContainerUri

string

URI del contenitore sas per il contenitore di backup.

properties.gatewayDetails

GatewayDetails

Dettagli del gateway configurati per il server AS.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Impostazioni del firewall per il server AS.

properties.managedMode

ManagedMode (int32)

1

Modalità gestita del server (0 = non gestito, 1 = gestito).

properties.provisioningState

ProvisioningState

Stato di distribuzione corrente della risorsa di Analysis Services. ProvisioningState indica gli stati per il provisioning delle risorse.

properties.querypoolConnectionMode

ConnectionMode

All

Modalità di controllo della partecipazione del server di lettura/scrittura al pool di query.
Può avere i valori seguenti:

  • readOnly : indica che il server di lettura/scrittura non deve partecipare alle operazioni di query
  • all - indica che il server di lettura/scrittura può partecipare alle operazioni di query
Se si specifica readOnly quando la capacità è 1, viene generato un errore.

properties.serverFullName

string

Nome completo della risorsa di Analysis Services.

properties.serverMonitorMode

ServerMonitorMode (int32)

1

Modalità di monitoraggio del server per il server AS

properties.sku

ResourceSku

SKU della risorsa di Analysis Services.

properties.state

State

Stato corrente della risorsa di Analysis Services. Lo stato consiste nell'indicare più stati al di fuori del provisioning delle risorse.

sku

ResourceSku

SKU della risorsa di Analysis Services.

tags

object

Coppie chiave-valore di proprietà aggiuntive per il provisioning delle risorse.

type

string

Tipo della risorsa di Analysis Services.

AnalysisServicesServerUpdateParameters

Specifica della richiesta di provisioning

Nome Tipo Valore predefinito Descrizione
properties.asAdministrators

ServerAdministrators

Raccolta di amministratori del server AS

properties.backupBlobContainerUri

string

URI del contenitore sas per il contenitore di backup.

properties.gatewayDetails

GatewayDetails

Dettagli del gateway configurati per il server AS.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Impostazioni del firewall per il server AS.

properties.managedMode

ManagedMode (int32)

1

Modalità gestita del server (0 = non gestito, 1 = gestito).

properties.querypoolConnectionMode

ConnectionMode

All

Modalità di controllo della partecipazione del server di lettura/scrittura al pool di query.
Può avere i valori seguenti:

  • readOnly : indica che il server di lettura/scrittura non deve partecipare alle operazioni di query
  • all - indica che il server di lettura/scrittura può partecipare alle operazioni di query
Se si specifica readOnly quando la capacità è 1, viene generato un errore.

properties.serverMonitorMode

ServerMonitorMode (int32)

1

Modalità di monitoraggio del server per il server AS

sku

ResourceSku

SKU della risorsa di Analysis Services.

tags

object

Coppie chiave-valore di proprietà di provisioning aggiuntive.

ConnectionMode

Modalità di controllo della partecipazione del server di lettura/scrittura al pool di query.
Può avere i valori seguenti:

  • readOnly : indica che il server di lettura/scrittura non deve partecipare alle operazioni di query
  • all - indica che il server di lettura/scrittura può partecipare alle operazioni di query
Se si specifica readOnly quando la capacità è 1, viene generato un errore.

Valore Descrizione
All
ReadOnly

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

httpStatusCode

integer (int32)

Codice di stato HTTP

message

string

Messaggio di errore.

subCode

integer (int32)

Codice secondario dell'errore

target

string

Destinazione dell'errore.

timeStamp

string

timestamp per l'errore.

ErrorResponse

Descrive il formato della risposta di errore.

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error

GatewayDetails

Dettagli del gateway.

Nome Tipo Descrizione
dmtsClusterUri

string

Uri del cluster DMTS.

gatewayObjectId

string

ID oggetto gateway da nel cluster DMTS per la risorsa del gateway.

gatewayResourceId

string

Risorsa gateway da associare al server.

IPv4FirewallRule

Dettaglio della regola del firewall.

Nome Tipo Descrizione
firewallRuleName

string

Nome della regola.

rangeEnd

string

Intervallo finale di IPv4.

rangeStart

string

Intervallo iniziale di IPv4.

IPv4FirewallSettings

Matrice di regole del firewall.

Nome Tipo Descrizione
enablePowerBIService

boolean

Indicatore dell'abilitazione del servizio PBI.

firewallRules

IPv4FirewallRule[]

Matrice di regole del firewall.

ManagedMode

Modalità gestita del server (0 = non gestito, 1 = gestito).

Valore Descrizione
0
1

ProvisioningState

Stato di distribuzione corrente della risorsa di Analysis Services. ProvisioningState indica gli stati per il provisioning delle risorse.

Valore Descrizione
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating

ResourceSku

Rappresenta il nome dello SKU e il piano tariffario di Azure per la risorsa di Analysis Services.

Nome Tipo Valore predefinito Descrizione
capacity

integer (int32)

minimum: 1
maximum: 8
1

Numero di istanze nel pool di query di sola lettura.

name

string

Nome del livello sku.

tier

SkuTier

Nome del piano tariffario di Azure a cui si applica lo SKU.

ServerAdministrators

Matrice di identità utente dell'amministratore.

Nome Tipo Descrizione
members

string[]

Matrice di identità utente dell'amministratore.

ServerMonitorMode

Modalità di monitoraggio del server per il server AS

Valore Descrizione
0
1

SkuTier

Nome del piano tariffario di Azure a cui si applica lo SKU.

Valore Descrizione
Basic
Development
Standard

State

Stato corrente della risorsa di Analysis Services. Lo stato consiste nell'indicare più stati al di fuori del provisioning delle risorse.

Valore Descrizione
Deleting
Failed
Paused
Pausing
Preparing
Provisioning
Resuming
Scaling
Succeeded
Suspended
Suspending
Updating