Enumerar los grupos de servidores

 

Se aplica a: Windows Azure Pack

Recupera una lista de grupos de servidores disponibles.

Solicitud

Reemplace <ServiceMgmt> por la dirección del punto de conexión de la API de Service Management.

Método	URI de solicitud	Versión de HTTP
GET	<https:// ServiceMgmt>:30004/services/sqlservers/serverGroups	HTTP/1.1

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud	Descripción
Autorización: portador	Obligatorio. Token de portador de autorización.
x-ms-principal-id	Obligatorio. El identificador de la entidad de seguridad.
x-ms-client-request-id	Opcional. Identificador de solicitud de cliente.
x-ms-client-session-id	Opcional. Identificador de sesión de cliente.
x-ms-principal-liveid	Opcional. Identificador activo de la entidad de seguridad.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

Encabezados de respuesta

La respuesta de esta operación incluye encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Cuerpo de la respuesta

La tabla siguiente describe los elementos clave del cuerpo de la respuesta:

Nombre del elemento	Descripción
SQLServerGroup	Lista recuperada de grupos de servidores. Para obtener más información, vea SqlServerGroup (Object).

Ejemplo

En el ejemplo de código siguiente se muestra una lista de la solicitud Grupos de servidores.

GET https://:30004/services/sqlservers/serverGroups HTTP/1.1
x-ms-version: 2012-03-01
Accept: application/json
Authorization: Bearer 
x-ms-client-request-id: 5deac5b3-57f1-4f5d-8b9d-152d2103a7e3-2013-08-27 00:46:27Z
x-ms-client-session-id: d6272660-6ee3-45d5-8cb9-cc79a20799cc
x-ms-principal-id: <SERVICEMGMT>%5cAdministrator
Accept-Language: es-ES
Host: :30004

En el ejemplo de código siguiente se muestra una respuesta Enumerar los grupos de servidores.

[
  {
    "GroupId": "2n9c",
    "GroupName": "Default",
    "AlwaysOnEnabled": false,
    "SharedFileServer": null,
    "HostingServerCount": 1
  },
  {
    "GroupId": "n0umne",
    "GroupName": "newgroup",
    "AlwaysOnEnabled": false,
    "SharedFileServer": null,
    "HostingServerCount": 0
  }
]

Consulte también

Interfaces de grupos de servidores de administrador del proveedor de recursos de SQL Server