Consulta de hosts MSDTC

Función

Esta API se utiliza para consultar hosts MSDTC.

• Antes de invocar a una API, debe entender la API de Autenticación.

URI

• Formato de URI

  GET /v3/{project_id}/instances/{instance_id}/msdtc/hosts?offset={offset}&limit={limit}

• Descripción de parámetro

  Tabla 1 Parámetros

  Parámetro	Obligatorio	Tipo	Descripción
  project_id	Sí	String	ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
  instance_id	Sí	String	ID de instancia.
  offset	No	Integer	Pagination parameter. The minimum value is 0. Default value: 0
  limit	No	Integer	Parámetro de paginación. El valor varía de 1 a 100. Valor predeterminado: 10

Solicitud

• Parámetros de solicitud

  Ninguna

• Ejemplo de URI

  GET https://{endpoint}/v3/054b93101a00d3a02fe3c01fb31462ac/instances/8ef19e30cbf44c79b63c7e6b2168a400in04/msdtc/hosts

Respuesta

• Respuesta normal

  Tabla 2 Parámetros

  Parámetro	Tipo	Descripción
  total_count	Integer	Número total de hosts.
  hosts	Array of objects	Lista de hosts. Para obtener más información, consulte Tabla 3.

  Tabla 3 descripción de la estructura del elemento hosts

  Parámetro	Tipo	Descripción
  id	String	Host ID.
  host	String	Dirección de host.
  host_name	String	Nombre de host.

• Ejemplo de respuesta normal

  {
     "total_count" : 1,
     "hosts" : [ {
       "id" : "527dd9ca-cc2c-4bac-8707-f9b4f55343f4",
       "host" : "192.168.0.90",
       "host_name" : "MSSQL-00E5FB7A"
     } ]
   }

• Respuesta anormal

  Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

• Normal

  200

• Anormal

  Para obtener más información, consulte Códigos de estado.

Código de error

Para obtener más información, consulte Códigos de error.