Creación de una conexión alojada
Función
Esta API es utilizada por los socios para crear las conexiones alojadas. El socio debe tener una conexión de operaciones disponible.
URI
POST /v3/{project_id}/dcaas/hosted-connects
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
Especifica el ID del proyecto. |
Parámetros 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ámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
hosted_connect |
Sí |
CreateHostedDirectConnect object |
Especifica los parámetros para crear una conexión alojada. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
No |
String |
Especifica el nombre de la conexión alojada. Mínimo: 0 Máximo: 64 |
description |
No |
String |
Proporciona la información adicional acerca de la conexión alojada. Mínimo: 0 Máximo: 128 |
bandwidth |
No |
Integer |
Especifica el tamaño de ancho de banda de la conexión alojada en Mbit/s. Mínimo: 2 Máximo: 400000 |
hosting_id |
Sí |
String |
Especifica el identificador de la conexión de operaciones en la que se crea la conexión alojada. |
vlan |
Sí |
Integer |
Especifica la VLAN preasignada a la conexión alojada. Mínimo: 0 Máximo: 3999 |
resource_tenant_id |
Sí |
String |
Especifica el ID de proyecto del tenant especificado para el que se va a crear una conexión alojada. Mínimo: 0 Máximo: 32 |
peer_location |
No |
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 |
Parámetros de respuesta
Código de estado: 201
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. |
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:
|
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:
|
Ejemplo de las solicitudes
Creación de una conexión alojada
POST https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects { "hosted_connect" : { "name" : "client-dc-faf1", "description" : "connect to beijing", "resource_tenant_id" : "0605768a3300d5762f82c01180692873", "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836", "vlan" : 441, "bandwidth" : 10 } }
Ejemplo de las respuestas
Código de estado: 201
CREADO
{ "hosted_connect" : { "id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6", "name" : "client-dc-faf1", "description" : "connect to beijing", "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" }
Códigos de estado
Código de estado |
Descripción |
---|---|
201 |
CREADO |
Códigos de error
Consulte Códigos de error.