Partager via


Servers - Create

Provisionne le serveur Analysis Services spécifié en fonction de la configuration spécifiée dans la requête.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

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

Nom du groupe de ressources Azure dont un serveur Analysis Services donné fait partie. Ce nom doit comporter au moins 1 caractère de longueur, et pas plus de 90.

serverName
path True

string

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

Nom du serveur Analysis Services. Il doit s’agir d’un minimum de 3 caractères et d’un maximum de 63.

subscriptionId
path True

string

Identificateur unique d’un abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.

api-version
query True

string

Version de l’API cliente.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement de la ressource Analysis Services.

sku True

ResourceSku

Référence SKU de la ressource Analysis Services.

properties.asAdministrators

ServerAdministrators

Collection d’administrateurs de serveur AS

properties.backupBlobContainerUri

string

URI du conteneur SAS vers le conteneur de sauvegarde.

properties.gatewayDetails

GatewayDetails

Détails de la passerelle configurés pour le serveur AS.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Paramètres de pare-feu pour le serveur AS.

properties.managedMode

ManagedMode (int32)

Mode managé du serveur (0 = non géré, 1 = géré).

properties.querypoolConnectionMode

ConnectionMode

Comment la participation du serveur en lecture-écriture au pool de requêtes est contrôlée.
Il peut avoir les valeurs suivantes :

  • readOnly : indique que le serveur en lecture-écriture est destiné à ne pas participer aux opérations de requête
  • all : indique que le serveur en lecture-écriture peut participer aux opérations de requête
La spécification de readOnly lorsque la capacité est 1 entraîne une erreur.

properties.serverMonitorMode

ServerMonitorMode (int32)

Mode moniteur de serveur pour le serveur AS

properties.sku

ResourceSku

Référence SKU de la ressource Analysis Services.

tags

object

Paires clé-valeur de propriétés d’approvisionnement de ressources supplémentaires.

Réponses

Nom Type Description
200 OK

AnalysisServicesServer

D’ACCORD. L’opération s’est terminée avec succès.

201 Created

AnalysisServicesServer

InProgress. L’opération se termine toujours.

202 Accepted

AnalysisServicesServer

Préparation. L’opération se termine toujours.

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Create a server.

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
AnalysisServicesServer

Représente une instance d’une ressource Analysis Services.

ConnectionMode

Comment la participation du serveur en lecture-écriture au pool de requêtes est contrôlée.
Il peut avoir les valeurs suivantes :

  • readOnly : indique que le serveur en lecture-écriture est destiné à ne pas participer aux opérations de requête
  • all : indique que le serveur en lecture-écriture peut participer aux opérations de requête
La spécification de readOnly lorsque la capacité est 1 entraîne une erreur.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Décrit le format de la réponse d’erreur.

GatewayDetails

Détails de la passerelle.

IPv4FirewallRule

Détail de la règle de pare-feu.

IPv4FirewallSettings

Tableau de règles de pare-feu.

ManagedMode

Mode managé du serveur (0 = non géré, 1 = géré).

ProvisioningState

État actuel du déploiement de la ressource Analysis Services. ProvisioningState consiste à indiquer les états d’approvisionnement des ressources.

ResourceSku

Représente le nom de la référence SKU et le niveau tarifaire Azure pour la ressource Analysis Services.

ServerAdministrators

Tableau d’identités utilisateur d’administrateur.

ServerMonitorMode

Mode moniteur de serveur pour le serveur AS

SkuTier

Nom du niveau tarifaire Azure auquel la référence SKU s’applique.

State

État actuel de la ressource Analysis Services. L’état consiste à indiquer plus d’états en dehors du provisionnement des ressources.

AnalysisServicesServer

Représente une instance d’une ressource Analysis Services.

Nom Type Valeur par défaut Description
id

string

Identificateur qui représente la ressource Analysis Services.

location

string

Emplacement de la ressource Analysis Services.

name

string

Nom de la ressource Analysis Services.

properties.asAdministrators

ServerAdministrators

Collection d’administrateurs de serveur AS

properties.backupBlobContainerUri

string

URI du conteneur SAS vers le conteneur de sauvegarde.

properties.gatewayDetails

GatewayDetails

Détails de la passerelle configurés pour le serveur AS.

properties.ipV4FirewallSettings

IPv4FirewallSettings

Paramètres de pare-feu pour le serveur AS.

properties.managedMode

ManagedMode (int32)

1

Mode managé du serveur (0 = non géré, 1 = géré).

properties.provisioningState

ProvisioningState

État actuel du déploiement de la ressource Analysis Services. ProvisioningState consiste à indiquer les états d’approvisionnement des ressources.

properties.querypoolConnectionMode

ConnectionMode

All

Comment la participation du serveur en lecture-écriture au pool de requêtes est contrôlée.
Il peut avoir les valeurs suivantes :

  • readOnly : indique que le serveur en lecture-écriture est destiné à ne pas participer aux opérations de requête
  • all : indique que le serveur en lecture-écriture peut participer aux opérations de requête
La spécification de readOnly lorsque la capacité est 1 entraîne une erreur.

properties.serverFullName

string

Nom complet de la ressource Analysis Services.

properties.serverMonitorMode

ServerMonitorMode (int32)

1

Mode moniteur de serveur pour le serveur AS

properties.sku

ResourceSku

Référence SKU de la ressource Analysis Services.

properties.state

State

État actuel de la ressource Analysis Services. L’état consiste à indiquer plus d’états en dehors du provisionnement des ressources.

sku

ResourceSku

Référence SKU de la ressource Analysis Services.

tags

object

Paires clé-valeur de propriétés d’approvisionnement de ressources supplémentaires.

type

string

Type de la ressource Analysis Services.

ConnectionMode

Comment la participation du serveur en lecture-écriture au pool de requêtes est contrôlée.
Il peut avoir les valeurs suivantes :

  • readOnly : indique que le serveur en lecture-écriture est destiné à ne pas participer aux opérations de requête
  • all : indique que le serveur en lecture-écriture peut participer aux opérations de requête
La spécification de readOnly lorsque la capacité est 1 entraîne une erreur.

Valeur Description
All
ReadOnly

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

httpStatusCode

integer (int32)

Code d’état http

message

string

Message d’erreur.

subCode

integer (int32)

Sous-code d’erreur

target

string

Cible d’erreur.

timeStamp

string

horodatage de l’erreur.

ErrorResponse

Décrit le format de la réponse d’erreur.

Nom Type Description
error

ErrorDetail

Objet d’erreur

GatewayDetails

Détails de la passerelle.

Nom Type Description
dmtsClusterUri

string

Uri du cluster DMTS.

gatewayObjectId

string

ID d’objet de passerelle à partir du cluster DMTS pour la ressource de passerelle.

gatewayResourceId

string

Ressource de passerelle à associer au serveur.

IPv4FirewallRule

Détail de la règle de pare-feu.

Nom Type Description
firewallRuleName

string

Nom de la règle.

rangeEnd

string

Plage de fin de IPv4.

rangeStart

string

Plage de début de IPv4.

IPv4FirewallSettings

Tableau de règles de pare-feu.

Nom Type Description
enablePowerBIService

boolean

Indicateur de l’activation du service PBI.

firewallRules

IPv4FirewallRule[]

Tableau de règles de pare-feu.

ManagedMode

Mode managé du serveur (0 = non géré, 1 = géré).

Valeur Description
0
1

ProvisioningState

État actuel du déploiement de la ressource Analysis Services. ProvisioningState consiste à indiquer les états d’approvisionnement des ressources.

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

ResourceSku

Représente le nom de la référence SKU et le niveau tarifaire Azure pour la ressource Analysis Services.

Nom Type Valeur par défaut Description
capacity

integer (int32)

minimum: 1
maximum: 8
1

Nombre d’instances dans le pool de requêtes en lecture seule.

name

string

Nom du niveau de référence SKU.

tier

SkuTier

Nom du niveau tarifaire Azure auquel la référence SKU s’applique.

ServerAdministrators

Tableau d’identités utilisateur d’administrateur.

Nom Type Description
members

string[]

Tableau d’identités utilisateur d’administrateur.

ServerMonitorMode

Mode moniteur de serveur pour le serveur AS

Valeur Description
0
1

SkuTier

Nom du niveau tarifaire Azure auquel la référence SKU s’applique.

Valeur Description
Development
Basic
Standard

State

État actuel de la ressource Analysis Services. L’état consiste à indiquer plus d’états en dehors du provisionnement des ressources.

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