Validar un servidor de hospedaje

 

Se aplica a: Windows Azure Pack

Valida un servidor de hospedaje en un grupo de servidores.

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
POST	<https:// ServiceMgmt>:30004/services/sqlservers/serverGroups/<GroupId>/hostingServers	HTTP/1.1

Parámetros de identificador URI

En la tabla siguiente se describen los parámetros de URI.

Parámetro del URI	Descripción
Validación	Obligatorio. Establezca en True para iniciar la validación.

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 principal.

Cuerpo de la solicitud

En la tabla siguiente se describen los elementos del cuerpo de la solicitud.

Nombre del elemento	Descripción
HostingServer	Servidor de hospedaje que se va a validar. Para obtener más información, vea HostingServer (Object).

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	Servidor de hospedaje validado. Para obtener más información, vea HostingServer (Object).

Ejemplo

En el ejemplo de código siguiente se muestra una solicitud Validar un servidor de hospedaje .

POST https://:30004/services/sqlservers/serverGroups//hostingServers?Validate=True HTTP/1.1
x-ms-version: 2012-03-01
Accept: application/json
Authorization: Bearer 
x-ms-principal-id: %5cAdministrator
Accept-Language: es-ES
Content-Type: application/json; charset=utf-8
Host: :30004
Content-Length: 289
Expect: 100-continue

{
  "Name": "<computer>",
  "ServerId": null,
  "Created": "0001-01-01T00:00:00+00:00",
  "AvailableSpaceMB": 0,
  "TotalSpaceMB": 0,
  "AvailabilityGroup": null,
  "DatabaseCount": 0,
  "State": null,
  "ServerGroups": [

  ],
  "ConnectionString": "Data Source=<computer>;User ID=sa;Password=pass@word1;Asynchronous Processing=True"
}

En el ejemplo de código siguiente se muestra una respuesta Validar un servidor de hospedaje .

{
  "Name": ""<computer>",
  "ServerId": null,
  "Created": "0001-01-01T00:00:00+00:00",
  "AvailableSpaceMB": 0,
  "TotalSpaceMB": 0,
  "AvailabilityGroup": null,
  "DatabaseCount": 0,
  "State": null,
  "ServerGroups": [

  ],
  "ConnectionString": "Data Source="<computer>;User ID=sa;Password=********;Asynchronous Processing=True"
}

Consulte también

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