Servers - Get Details

Referencia

Servicio:: Analysis Services

Versión de la API:: 2017-08-01

Obtiene detalles sobre el servidor de Analysis Services especificado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nombre del grupo de recursos de Azure del que forma parte un servidor determinado de Analysis Services. Este nombre debe tener al menos 1 carácter de longitud y no más de 90.
serverName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z][a-z0-9]*$	Nombre del servidor de Analysis Services. Debe tener un mínimo de 3 caracteres y un máximo de 63.
subscriptionId	path	True	string	Identificador único de una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
api-version	query	True	string	Versión de la API de cliente.

Respuestas

Nombre	Tipo	Description
200 OK	AnalysisServicesServer	De acuerdo. La operación se realizó correctamente.
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Get details of a server

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/resourceGroups/TestRG/providers/Microsoft.AnalysisServices/servers/azsdktest?api-version=2017-08-01

package armanalysisservices_test

import (
	"context"
	"log"

	"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/getServer.json
func ExampleServersClient_GetDetails() {
	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)
	}
	res, err := clientFactory.NewServersClient().GetDetails(ctx, "TestRG", "azsdktest", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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")},
	// 			},
	// 			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 Gets details about the specified Analysis Services server.
 *
 * @summary Gets details about the specified Analysis Services server.
 * x-ms-original-file: specification/analysisservices/resource-manager/Microsoft.AnalysisServices/stable/2017-08-01/examples/getServer.json
 */
async function getDetailsOfAServer() {
  const subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
  const resourceGroupName = "TestRG";
  const serverName = "azsdktest";
  const credential = new DefaultAzureCredential();
  const client = new AzureAnalysisServices(credential, subscriptionId);
  const result = await client.servers.getDetails(resourceGroupName, serverName);
  console.log(result);
}

getDetailsOfAServer().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/getServer.json
// this example is just showing the usage of "Servers_GetDetails" 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 ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "613192d7-503f-477a-9cfe-4efc3ee2bd60";
string resourceGroupName = "TestRG";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this AnalysisServerResource
AnalysisServerCollection collection = resourceGroupResource.GetAnalysisServers();

// invoke the operation
string serverName = "azsdktest";
bool result = await collection.ExistsAsync(serverName);

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:: 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"
      ]
    },
    "provisioningState": "Provisioning",
    "serverFullName": "asazure://nightly1.asazure-int.windows.net/azsdktest",
    "state": "Provisioning"
  },
  "sku": {
    "capacity": 1,
    "name": "S1",
    "tier": "Standard"
  },
  "tags": {
    "testKey": "testValue"
  }
}

Definiciones

Nombre	Description
AnalysisServicesServer	Representa una instancia de un recurso de Analysis Services.
ConnectionMode	Cómo se controla la participación del servidor de lectura y escritura en el grupo de consultas. Puede tener los siguientes valores: readOnly: indica que el servidor de lectura y escritura está pensado para no participar en las operaciones de consulta. all: indica que el servidor de lectura y escritura puede participar en las operaciones de consulta. Especificar readOnly cuando la capacidad es 1 produce un error.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Describe el formato de respuesta de error.
GatewayDetails	Detalles de la puerta de enlace.
IPv4FirewallRule	Detalles de la regla de firewall.
IPv4FirewallSettings	Matriz de reglas de firewall.
ManagedMode	Modo administrado del servidor (0 = no administrado, 1 = administrado).
ProvisioningState	Estado de implementación actual del recurso de Analysis Services. ProvisioningState es indicar los estados para el aprovisionamiento de recursos.
ResourceSku	Representa el nombre de la SKU y el plan de tarifa de Azure para el recurso de Analysis Services.
ServerAdministrators	Matriz de identidades de usuario de administrador.
ServerMonitorMode	Modo de supervisión del servidor para el servidor AS
SkuTier	Nombre del plan de tarifa de Azure al que se aplica la SKU.
State	Estado actual del recurso de Analysis Services. El estado es indicar más estados fuera del aprovisionamiento de recursos.

AnalysisServicesServer

Object

Representa una instancia de un recurso de Analysis Services.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador que representa el recurso de Analysis Services.
location	string		Ubicación del recurso de Analysis Services.
name	string		Nombre del recurso de Analysis Services.
properties.asAdministrators	ServerAdministrators		Colección de administradores de servidor AS
properties.backupBlobContainerUri	string		Identificador URI del contenedor de SAS en el contenedor de copia de seguridad.
properties.gatewayDetails	GatewayDetails		Los detalles de la puerta de enlace configurados para el servidor AS.
properties.ipV4FirewallSettings	IPv4FirewallSettings		La configuración del firewall para el servidor AS.
properties.managedMode	ManagedMode (int32)	1	Modo administrado del servidor (0 = no administrado, 1 = administrado).
properties.provisioningState	ProvisioningState		Estado de implementación actual del recurso de Analysis Services. ProvisioningState es indicar los estados para el aprovisionamiento de recursos.
properties.querypoolConnectionMode	ConnectionMode	All	Cómo se controla la participación del servidor de lectura y escritura en el grupo de consultas. Puede tener los siguientes valores: readOnly: indica que el servidor de lectura y escritura está pensado para no participar en las operaciones de consulta. all: indica que el servidor de lectura y escritura puede participar en las operaciones de consulta. Especificar readOnly cuando la capacidad es 1 produce un error.
properties.serverFullName	string		Nombre completo del recurso de Analysis Services.
properties.serverMonitorMode	ServerMonitorMode (int32)	1	Modo de supervisión del servidor para el servidor AS
properties.sku	ResourceSku		SKU del recurso de Analysis Services.
properties.state	State		Estado actual del recurso de Analysis Services. El estado es indicar más estados fuera del aprovisionamiento de recursos.
sku	ResourceSku		SKU del recurso de Analysis Services.
tags	object		Pares clave-valor de propiedades de aprovisionamiento de recursos adicionales.
type	string		Tipo del recurso de Analysis Services.

ConnectionMode

Enumeración

Cómo se controla la participación del servidor de lectura y escritura en el grupo de consultas.
Puede tener los siguientes valores:

readOnly: indica que el servidor de lectura y escritura está pensado para no participar en las operaciones de consulta.
all: indica que el servidor de lectura y escritura puede participar en las operaciones de consulta.

Especificar readOnly cuando la capacidad es 1 produce un error.

Valor	Description
All
ReadOnly

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
httpStatusCode	integer (int32)	Código de estado http
message	string	Mensaje de error.
subCode	integer (int32)	El sub código de error
target	string	Destino del error.
timeStamp	string	marca de tiempo del error.

ErrorResponse

Object

Describe el formato de respuesta de error.

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error

GatewayDetails

Object

Detalles de la puerta de enlace.

Nombre	Tipo	Description
dmtsClusterUri	string	Uri del clúster DMTS.
gatewayObjectId	string	Identificador de objeto de puerta de enlace desde en el clúster DMTS para el recurso de puerta de enlace.
gatewayResourceId	string	Recurso de puerta de enlace que se va a asociar al servidor.

IPv4FirewallRule

Object

Detalles de la regla de firewall.

Nombre	Tipo	Description
firewallRuleName	string	Nombre de la regla.
rangeEnd	string	Intervalo final de IPv4.
rangeStart	string	Intervalo de inicio de IPv4.

IPv4FirewallSettings

Object

Matriz de reglas de firewall.

Nombre	Tipo	Description
enablePowerBIService	boolean	Indicador de habilitación del servicio PBI.
firewallRules	IPv4FirewallRule[]	Matriz de reglas de firewall.

ManagedMode

Enumeración

Modo administrado del servidor (0 = no administrado, 1 = administrado).

Valor	Description
0
1

ProvisioningState

Enumeración

Estado de implementación actual del recurso de Analysis Services. ProvisioningState es indicar los estados para el aprovisionamiento de recursos.

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

ResourceSku

Object

Representa el nombre de la SKU y el plan de tarifa de Azure para el recurso de Analysis Services.

Nombre	Tipo	Valor predeterminado	Description
capacity	integer (int32) minimum: 1 maximum: 8	1	Número de instancias del grupo de consultas de solo lectura.
name	string		Nombre del nivel de SKU.
tier	SkuTier		Nombre del plan de tarifa de Azure al que se aplica la SKU.

ServerAdministrators

Object

Matriz de identidades de usuario de administrador.

Nombre	Tipo	Description
members	string[]	Matriz de identidades de usuario de administrador.

ServerMonitorMode

Enumeración

Modo de supervisión del servidor para el servidor AS

Valor	Description
0
1

SkuTier

Enumeración

Nombre del plan de tarifa de Azure al que se aplica la SKU.

Valor	Description
Basic
Development
Standard

State

Enumeración

Estado actual del recurso de Analysis Services. El estado es indicar más estados fuera del aprovisionamiento de recursos.

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

Compartir a través de

Servers - Get Details

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Get details of a server

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AnalysisServicesServer

ConnectionMode

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GatewayDetails

IPv4FirewallRule

IPv4FirewallSettings

ManagedMode

ProvisioningState

ResourceSku

ServerAdministrators

ServerMonitorMode

SkuTier

State

Recursos adicionales