Compartilhar via


Servers - Create

Provisiona o servidor do Analysis Services especificado com base na configuração especificada na solicitação.

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

Parâmetros de URI

Nome Em Obrigató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. Esse nome deve ter pelo menos 1 caractere de comprimento 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 ser um mínimo de 3 caracteres e um máximo de 63.

subscriptionId
path True

string

Um identificador exclusivo para uma assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True

string

A versão da API do cliente.

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

Local do recurso do Analysis Services.

sku True

ResourceSku

A SKU do recurso do 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)

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.
Ele pode ter os seguintes valores:

  • readOnly - indica que o servidor de leitura/gravação destina-se a não 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

properties.sku

ResourceSku

A SKU do recurso do Analysis Services.

tags

object

Pares chave-valor de propriedades de provisionamento de recursos adicionais.

Respostas

Nome Tipo Description
200 OK

AnalysisServicesServer

OKEY. A operação foi concluída com êxito.

201 Created

AnalysisServicesServer

InProgress. A operação ainda está sendo concluída.

202 Accepted

AnalysisServicesServer

Preparando. A operação ainda está sendo concluída.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Create a server.

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
AnalysisServicesServer

Representa uma instância de um recurso do Analysis Services.

ConnectionMode

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

  • readOnly - indica que o servidor de leitura/gravação destina-se a não 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

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Descreve o formato da 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 de implantação atual do recurso do Analysis Services. O provisioningState deve indicar estados para provisionamento de recursos.

ResourceSku

Representa o nome do SKU e o tipo de preço do Azure para o recurso do Analysis Services.

ServerAdministrators

Uma matriz de identidades de usuário do administrador.

ServerMonitorMode

O modo de monitor do servidor para o servidor AS

SkuTier

O nome do tipo de preço do Azure ao qual a SKU se aplica.

State

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

AnalysisServicesServer

Representa uma instância de um recurso do Analysis Services.

Nome Tipo Valor padrão Description
id

string

Um identificador que representa o recurso do Analysis Services.

location

string

Local do recurso do Analysis Services.

name

string

O nome do recurso do 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 de implantação atual do recurso do 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.
Ele pode ter os seguintes valores:

  • readOnly - indica que o servidor de leitura/gravação destina-se a não 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 do Analysis Services.

properties.serverMonitorMode

ServerMonitorMode (int32)

1

O modo de monitor do servidor para o servidor AS

properties.sku

ResourceSku

A SKU do recurso do Analysis Services.

properties.state

State

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

sku

ResourceSku

A SKU do recurso do Analysis Services.

tags

object

Pares chave-valor de propriedades de provisionamento de recursos adicionais.

type

string

O tipo do recurso do Analysis Services.

ConnectionMode

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

  • readOnly - indica que o servidor de leitura/gravação destina-se a não 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

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

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ód código de erro

target

string

O destino do erro.

timeStamp

string

o carimbo de data/hora do erro.

ErrorResponse

Descreve o formato da resposta de erro.

Nome Tipo Description
error

ErrorDetail

O objeto de erro

GatewayDetails

Os detalhes do gateway.

Nome Tipo Description
dmtsClusterUri

string

Uri do cluster DMTS.

gatewayObjectId

string

ID de objeto do gateway no cluster DMTS para o recurso de gateway.

gatewayResourceId

string

Recurso de gateway a ser associado ao servidor.

IPv4FirewallRule

O detalhe da regra de firewall.

Nome Tipo Description
firewallRuleName

string

O nome da regra.

rangeEnd

string

O intervalo final do IPv4.

rangeStart

string

O intervalo inicial do IPv4.

IPv4FirewallSettings

Uma matriz de regras de firewall.

Nome Tipo Description
enablePowerBIService

boolean

O indicador de habilitação do serviço PBI.

firewallRules

IPv4FirewallRule[]

Uma matriz de regras de firewall.

ManagedMode

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

Valor Description
0
1

ProvisioningState

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

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

ResourceSku

Representa o nome do SKU e o tipo de preço do Azure para o recurso do Analysis Services.

Nome Tipo Valor padrão 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 do tipo de preço do Azure ao qual a SKU se aplica.

ServerAdministrators

Uma matriz de identidades de usuário do administrador.

Nome Tipo Description
members

string[]

Uma matriz de identidades de usuário do administrador.

ServerMonitorMode

O modo de monitor do servidor para o servidor AS

Valor Description
0
1

SkuTier

O nome do tipo de preço do Azure ao qual a SKU se aplica.

Valor Description
Development
Basic
Standard

State

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

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