Compartir a través de

Enumerar los servidores por grupo

  • Artículo

 

Se aplica a: Windows Azure Pack

Recupera una lista de los servidores de hospedaje dentro del grupo de servidores.

Solicitud

Reemplace <ServiceMgmt> por la dirección del punto de conexión de la API de Service Management y <GroupId> por el identificador del grupo de servidores.

Método

URI de solicitud

Versión de HTTP

GET

<https:// ServiceMgmt>:30004/services/sqlservers/serverGroups/<GroupID>/hostingServers

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

HostingServer

Lista recuperada de servidores de hospedaje. Para obtener más información, vea HostingServer (Object).

Ejemplo

En el ejemplo de código siguiente se muestra una solicitud List Hosting Servers By Group .

GET https://<ServiceMgmt>:30004/services/sqlservers/serverGroups/<GroupID>/hostingServers HTTP/1.1
x-ms-version: 2012-03-01
Accept: application/json
Authorization: Bearer <Token>
x-ms-client-request-id: dd40b734-2377-40e9-8d51-b25c4c4377bb-2013-08-27 00:46:40Z
x-ms-client-session-id: d6272660-6ee3-45d5-8cb9-cc79a20799cc
x-ms-principal-id: <SERVICEMGMT>%5cAdministrator
Accept-Language: es-ES
Host: <ServiceMgmt>:30004

En el ejemplo de código siguiente se muestra una respuesta De lista de servidores de hospedaje por grupo .

[
  {
    "Name": ""<computer>",
    "ServerId": "djpf7",
    "Created": "0001-01-01T00:00:00+00:00",
    "AvailableSpaceMB": 20480,
    "TotalSpaceMB": 20480,
    "AvailabilityGroup": null,
    "DatabaseCount": 0,
    "State": 1,
    "ServerGroups": [
      {
        "GroupId": "2n9c",
        "GroupName": "Default",
        "AlwaysOnEnabled": false,
        "SharedFileServer": null,
        "HostingServerCount": 1
      }
    ],
    "ConnectionString": ""
  }
]

Consulte también

Interfaces de servidores de hospedaje de administrador de proveedores de recursos de SQL Server