Partager via


Servers - Create

Approvisionne le serveur Analysis Services spécifié en fonction de la configuration spécifiée dans la demande.

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

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

Regex pattern: ^[-\w\._\(\)]+$

serverName
path True

string

Nom du serveur Analysis Services. Il doit comporter au moins 3 caractères et un maximum de 63.

Regex pattern: ^[a-z][a-z0-9]*$

subscriptionId
path True

string

Identificateur unique pour un abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour 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 du 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

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

properties.querypoolConnectionMode

ConnectionMode

Comment la participation du serveur en lecture-écriture dans le 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

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

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

201 Created

AnalysisServicesServer

InProgress. L’opération est toujours terminée.

202 Accepted

AnalysisServicesServer

Préparation. L’opération est toujours terminée.

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

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

Exemples

Create a server.

Sample Request

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

Sample Response

{
  "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 dans le 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 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 = managé).

ProvisioningState

État de déploiement actuel de la ressource Analysis Services. ProvisioningState indique les états pour l’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 d’utilisateur 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 indique plus d’états en dehors de l’approvisionnement 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 du 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

1

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

properties.provisioningState

ProvisioningState

État de déploiement actuel de la ressource Analysis Services. ProvisioningState indique les états pour l’approvisionnement des ressources.

properties.querypoolConnectionMode

ConnectionMode

All

Comment la participation du serveur en lecture-écriture dans le 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

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 indique plus d’états en dehors de l’approvisionnement 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 dans le 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.

Nom Type Description
All

string

ReadOnly

string

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émentaires.

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

Code status http

message

string

Message d’erreur.

subCode

integer

Sous-code d’erreur

target

string

Cible d’erreur.

timeStamp

string

horodatage de l’erreur.

ErrorResponse

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

Nom Type Description
error

ErrorDetail

Objet error

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 d’IPv4.

rangeStart

string

Plage de début d’IPv4.

IPv4FirewallSettings

Tableau de règles de pare-feu.

Nom Type Description
enablePowerBIService

boolean

Indicateur d’activation du service PBI.

firewallRules

IPv4FirewallRule[]

Tableau de règles de pare-feu.

ManagedMode

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

Nom Type Description
0

Integer

1

Integer

ProvisioningState

État de déploiement actuel de la ressource Analysis Services. ProvisioningState indique les états pour l’approvisionnement des ressources.

Nom 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

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

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 d’utilisateur administrateur.

Nom Type Description
members

string[]

Tableau d’identités d’utilisateur administrateur.

ServerMonitorMode

Mode moniteur de serveur pour le serveur AS

Nom Type Description
0

Integer

1

Integer

SkuTier

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

Nom Type Description
Basic

string

Development

string

Standard

string

State

État actuel de la ressource Analysis Services. L’état indique plus d’états en dehors de l’approvisionnement des ressources.

Nom 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