Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda> Direct Connect> Referencia de la API> API> Conexión> Consulta de detalles sobre una conexión alojada de un tenant

Actualización más reciente 2023-02-13 GMT+08:00

Ver PDF

Consulta de detalles sobre una conexión alojada de un tenant

Función

Esta API se utiliza para consultar una conexión alojada de un socio.

URI

GET /v3/{project_id}/dcaas/hosted-connects/{hosted_connect_id}

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto.
hosted_connect_id	Sí	String	Especifica el ID de conexión alojada. Mínimo: 36 Máximo: 36

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
limit	No	Integer	Especifica el número de registros devueltos en cada página. Rango de valores: 1 a 2000 Mínimo: 1 Máximo: 2000 Predeterminado: 2000
marker	No	String	Especifica el ID del último registro de recursos de la página anterior. Si este parámetro se deja en blanco, se consulta la primera página. Este parámetro debe usarse junto con limit. Mínimo: 0 Máximo: 36
fields	No	Array	Especifica la lista de campos que se mostrarán.
sort_dir	No	Array	Especifica el orden de clasificación de los resultados devueltos, que puede ser asc (orden ascendente) o desc (orden descendente). El valor predeterminado es asc.
sort_key	No	String	Especifica el campo de la ordenación. Predeterminado: created_at Mínimo: 0 Máximo: 36
hosting_id	No	Array	Especifica el identificador de conexión de operaciones por el que se filtran las conexiones alojadas.

Parámetros de solicitud

**Tabla 3** Parámetros de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token de usuario. Para obtener el token, consulte la sección "Obtención del token de usuario" en la Referencia de las API de Identity and Access Management. El token es el valor de X-Subject-Token en la cabecera de respuesta. Mínimo: 0 Máximo: 10240

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
request_id	String	Especifica el ID de la solicitud.
hosted_connect	HostedDirectConnect object	Especifica los parámetros para crear una conexión alojada.

**Tabla 5** HostedDirectConnect
Parámetro	Tipo	Descripción
id	String	Especifica el ID de conexión alojada. Mínimo: 36 Máximo: 36
tenant_id	String	Especifica el ID del proyecto al que pertenece la instancia.
name	String	Especifica el nombre de la conexión. Mínimo: 0 Máximo: 64
description	String	Proporciona la información complementaria sobre la conexión. Mínimo: 0 Máximo: 128
bandwidth	Integer	Especifica el ancho de banda de conexión en Mbit/s. Mínimo: 2 Máximo: 400000
location	String	Especifica la información acerca de la ubicación de Direct Connect. Mínimo: 0 Máximo: 255
peer_location	String	Especifica la ubicación de la instalación local en el otro extremo de la conexión, específica del nombre de la calle o del centro de datos. Mínimo: 0 Máximo: 255
hosting_id	String	Especifica el identificador de la conexión de operaciones en la que se crea la conexión alojada.
provider	String	Especifica el proveedor de la línea arrendada.
admin_state_up	Boolean	Especifica el estado administrativo, que puede ser true o false. Predeterminado: true
vlan	Integer	Especifica la VLAN preasignada a la conexión alojada. Mínimo: 0 Máximo: 3999
status	String	Especifica el estado del gateway virtual. El valor puede ser ACTIVE, ERROR, PENDING_CREATE o PENDING_UPDATE ACTIVE: El gateway virtual es normal. ERROR: El gateway virtual es anormal. PENDING_CREATE: Se está creando el gateway virtual. PENDING_UPDATE: El gateway virtual se está actualizando. Valores de enumeración: BUILD PAID APPLY PENDING_SURVEY ACTIVE DOWN ERROR PENDING_DELETE DELETED DENY PENDING_PAY ORDERING ACCEPT REJECTED
apply_time	String	Especifica cuándo se solicitó la conexión.
create_time	String	Especifica cuándo se creó la conexión.
provider_status	String	Especifica el estado de la línea arrendada del operador. El estado puede ser ACTIVE o DOWN. Valores de enumeración: ACTIVE DOWN

Ejemplo de las solicitudes

GET https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects/0278b472-ffa5-4eb3-8c0d-979d479f8ef6

Ejemplo de las respuestas

Código de estado: 200

{
  "hosted_connect" : {
    "id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6",
    "name" : "client-dc-faf1",
    "description" : "",
    "tenant_id" : "0605768a3300d5762f82c01180692873",
    "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836",
    "vlan" : 441,
    "bandwidth" : 10,
    "location" : "hangzhou",
    "peer_location" : "",
    "provider" : "client-dc-faf1%20\n\n",
    "provider_status" : "ACTIVE",
    "status" : "ACTIVE",
    "apply_time" : "2022-07-13T08:25:38.000Z",
    "admin_state_up" : true,
    "create_time" : "2022-07-13T08:25:38.000Z"
  },
  "request_id" : "a59a3776faa1d055f8124dc7b0977a90"
}