Creación de tokens de servicio Z-Side
Un token de servicio de Z-Side es una clave única que permite a otro cliente en Equinix Fabric establecer una conexión con usted.
Puede crear tokens de Z-Side para los siguientes tipos de activos:
- Puertos de Fabric (ambos tipos EVPL, EPL)
- Dispositivos virtuales de Network Edge
- Redes multipunto - E-LAN, E-Árbol y E-Access.
Una vez que se cree y comparta un token de servicio de Z-Side con otro cliente, puede canjearlo para crear una conexión con su activo predefinido como destino.

El cliente que canjee el token de Z-Side (el propietario del activo De A-Side de origen) se facturará por la conexión virtual una vez que la cree. También se puede utilizar un token de servicio de Z-Side para permitir que otro usuario dentro de su propia organización que tenga activos en un proyecto diferente, de modo que pueda conectarse a un activo de su proyecto.
Para obtener más información sobre cómo canjear un token de servicio de Z-Side, consulte Canjear un token de servicio de Z-Side .
Requisitos previos
Antes de crear un token de servicio, debe tener lo siguiente:
- Una cuenta del portal del cliente.
- Un puerto, dispositivo virtual o red multipunto existente.
- Permisos de acceso a un activo para el que desea crear un token de servicio.
- Portal
- API
-
Inicie sesión en el portal del cliente y navegue hasta el panel de control de Fabric .
-
En el menú Tokens de servicio, seleccione Crear token de servicio .

-
En la sección Tipo de token de servicio, seleccione token de servicio de Z-Side .

Seleccione el tipo de activo para el que desea crear el token de Z-Side: Puerto, dispositivo virtual o red multipunto .
-
Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.
-
Determine la información de su activo de Z-Side.
-
Si está utilizando un puerto, envíe una
GETsolicitud al/fabric/v4/portspunto final. Necesita el(los) UUID(s) del puerto, el tipo de puerto, el tipo de protocolo de enlace (DOT1Q o QINQ). -
Si está utilizando un dispositivo virtual, envíe una
GETsolicitud al/ne/v1/devicespunto final. Necesita el UUID(s) del dispositivo. Envíe unaGETsolicitud al/ne/v1/devices/{device_id}punto final para obtener los detalles de un dispositivo. Puede elegir cualquier interfaz disponible en el dispositivo para su conexión. Si no especifica una, la conexión se asigna automáticamente a la siguiente interfaz disponible. -
Si utiliza una red multipunto, envíe una
GETsolicitud al/fabric/v4/networks/{networkId}punto final. Necesita el tipo de red y el UUID.
-
Cree un token de servicio para un puerto
- Portal
- API
-
En el menú desplegable Activo de Z-Side, seleccione Puerto.
-
Haga clic en + Seleccionar puerto y elija el puerto específico para el token de servicio de la lista. Haga clic en Seleccionar puerto.

-
Haga clic en Siguiente.
-
En Configuración de conexión :
- Introduzca los ID de VLAN para la conexión en su activo de Z-Side.
- Seleccione los anchos de banda que desea poner a disposición del usuario del token. Haga clic en Añadir otro ancho de banda para crear una opción de ancho de banda personalizada.
- Elija si desea permitir conexiones remotas. Compruebe el BOX Permitir conexiones remotas para permitir que los usuarios de token se conecten desde un área metropolitana diferente a la ubicación del activo de Z-Side.

-
En la configuración del token de servicio:
- Introduzca una fecha de caducidad para el token de servicio. El token debe canjearse antes de esta fecha o caduca. El intervalo máximo de fechas es de 90 días.
- Introduzca las direcciones de correo electrónico de los usuarios autorizados a utilizar el token de servicio. Puede introducir hasta 12 destinatarios. El token solo puede ser utilizado una vez por cualquiera de los destinatarios.

-
Haga clic en Siguiente.
-
En la página Revisión, revise la información en los paneles Tipo de token de servicio y configuración de token de servicio.

Cuando esté listo, haga clic en Crear token de servicio .
Para crear un token de servicio de Z-Side para un puerto, envíe una POST solicitud al /fabric/v4/serviceTokens punto final. Proporcione la configuración de su conexión, los detalles del puerto y la configuración del token de servicio en el cuerpo de la solicitud.
-
En el
connectionobjeto, especifique:- El tipo de conexión basado en el puerto subyacente:
EVPL_VCoEPL_VC. - Si este token se puede utilizar para crear conexiones remotas.
- El ancho de banda permitido para la conexión.
- Si este token permite utilizar ancho de banda personalizado para la conexión.
- El tipo de conexión basado en el puerto subyacente:
-
En el
zSideobjeto, especifique:- El
typeASCOLO. - El UUID del puerto.
- El tipo de protocolo de enlace del puerto y la información de VLAN apropiada.
- El
-
Utilice el
expirationDateTimecampo para especificar la fecha y hora en que el token caduca en formato ISO 8601. -
En el
notificationsobjeto, especifique las direcciones de correo electrónico de los destinatarios del token.
Ejemplo de solicitud cURL:
curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
"type": "VC_TOKEN",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPL_VC",
"allowRemoteConnection": <boolean>,
"allowCustomBandwidth": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "COLO",
"port": {
"uuid": "<port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": "<vlan_ID>"
}
}
]
}
},
"expirationDateTime": "<expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
Cree un token de servicio para un dispositivo virtual
- Portal
- API
-
En el menú desplegable Activo de Z-Side, seleccione Dispositivo virtual .
-
Elija un tipo de dispositivo virtual:
- Dispositivo único - Dispositivos virtuales de instancia única.
- Dispositivos redundantes - Un par de dispositivos virtuales redundantes. Importante: Para crear conexiones redundantes a dispositivos redundantes, debe crear un token de servicio independiente para cada dispositivo del par de redundancia.
- Clústeres - Dispositivos virtuales agrupados en clústeres.
-
Haga clic en + Seleccionar dispositivo virtual y seleccione una instancia de dispositivo virtual de la lista. Haga clic en Seleccionar dispositivo virtual .

-
Haga clic en Siguiente.
-
En Configuración de conexión :
- Configure la interfaz que se va a utilizar para la conexión. Elija si desea utilizar la siguiente interfaz disponible o elija una interfaz específica.
- Seleccione los anchos de banda que desea poner a disposición del usuario del token. Haga clic en Añadir otro ancho de banda para crear una opción de ancho de banda personalizada.
- Elija si desea permitir conexiones remotas. Compruebe el BOX Permitir conexiones remotas para permitir que los usuarios de token se conecten desde un área metropolitana diferente a la ubicación del activo de Z-Side.

-
En la configuración del token de servicio:
- Introduzca una fecha de caducidad para el token de servicio. El token debe canjearse antes de esta fecha o caduca. El intervalo máximo de fechas es de 90 días.
- Introduzca las direcciones de correo electrónico de los usuarios autorizados a utilizar el token de servicio. Puede introducir hasta 12 destinatarios. El token solo puede ser utilizado una vez por cualquiera de los destinatarios.

-
Haga clic en Siguiente.
-
En la página Revisión, revise la información en los paneles Tipo de token de servicio y configuración de token de servicio.

Cuando esté listo, haga clic en Crear token de servicio .
Para crear un token de servicio de Z-Side para un dispositivo virtual, envíe una POST solicitud al /fabric/v4/serviceTokens punto final. Proporcione la configuración de su conexión, los detalles del dispositivo virtual y la configuración del token de servicio en el cuerpo de la solicitud.
-
En el
connectionobjeto, especifique:- Si este token se puede utilizar para crear conexiones remotas.
- El ancho de banda permitido para la conexión.
- Si este token permite utilizar ancho de banda personalizado para la conexión.
-
En el
zSideobjeto, especifique:- El
typeASVD. - UUID de sus dispositivos virtuales.
- La interfaz a utilizar para la conexión del token de servicio. Si se omite el
interfaceobjeto, se utiliza la siguiente interfaz disponible en el dispositivo para la conexión.
- El
-
Utilice el
expirationDateTimecampo para especificar la fecha y hora en que el token caduca en formato ISO 8601. -
En el
notificationsobjeto, especifique las direcciones de correo electrónico de los destinatarios del token.
Ejemplo de solicitud cURL:
curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
"type": "VC_TOKEN",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPL_VC",
"allowRemoteConnection": <boolean>,
"allowCustomBandwidth": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "VD",
"virtualDevice": {
"type": "EDGE",
"uuid": "<virtual_device_uuid>"
},
"interface": {
"type": "NETWORK",
"id": <interface_id>
}
}
]
}
},
"expirationDateTime": "<expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
Cree un token de servicio para una red multipunto
- Portal
- API
-
En el menú desplegable Activos de Z-Side, seleccione Red multipunto .
-
Haga clic en + Seleccionar red y seleccione la red multipunto de la lista. Haga clic en Seleccionar red.

-
Haga clic en Siguiente.
-
En Configuración de conexión :
- Tenga en cuenta que las conexiones creadas a partir de tokens de servicio E-Tree serán Leaf. Como propietario de la red, puede editar el rol de conexión en root una vez que se canjee el token de servicio y se haya aprovisionado la conexión.
- Seleccione los anchos de banda que desea poner a disposición del usuario del token. Haga clic en Añadir otro ancho de banda para crear una opción de ancho de banda personalizada.

-
En la configuración del token de servicio:
- Introduzca una fecha de caducidad para el token de servicio. El token debe canjearse antes de esta fecha o caduca. El intervalo máximo de fechas es de 90 días.
- Introduzca las direcciones de correo electrónico de los usuarios autorizados a utilizar el token de servicio. Puede introducir hasta 12 destinatarios. El token solo puede ser utilizado una vez por cualquiera de los destinatarios.

-
Haga clic en Siguiente.
-
En la página Revisión, revise la información en los paneles Tipo de token de servicio y configuración de token de servicio.

Cuando esté listo, haga clic en Crear token de servicio .
Para crear un token de servicio de Z-Side para una red multipunto, envíe una POST solicitud al /fabric/v4/serviceTokens punto final. Proporcione la configuración de su conexión, los detalles de la red y la configuración del token de servicio en el cuerpo de la solicitud.
-
En el
connectionobjeto, especifique:- El tipo de conexión como
EVPLAN_VC,EPLAN_VCEVPTREE_VCoEPTREE_VCdependiendo de su configuración de red. - Si este token se puede utilizar para crear conexiones remotas.
- El ancho de banda permitido para la conexión.
- Si este token permite utilizar ancho de banda personalizado para la conexión.
- El tipo de conexión como
-
En el
zSideobjeto:- Especifique el
typeASNETWORK. - Indíquese el tipo de red como
EVPLAN,EPLAN, ,EVPTREEoEPTREE. - Proporcione el UUID de su red.
- Especifique el
-
Utilice el
expirationDateTimecampo para especificar la fecha y hora en que el token caduca en formato ISO 8601. -
En el
notificationsobjeto, especifique las direcciones de correo electrónico de los destinatarios del token.
Ejemplo de solicitud cURL:
curl -X POST 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Content-Type: application/json'
-H 'Authorization: Bearer <token>'
-d '{
"type": "VC_TOKEN",
"name": "<service_token_name>",
"description": "<service_token_description>",
"connection": {
"type": "EVPLAN_VC",
"allowRemoteConnection": <boolean>,
"supportedBandwidths": [
<bandwidth_speed>,
<bandwidth_speed>,
<bandwidth_speed>
],
"zSide": {
"accessPointSelectors": [
{
"type": "NETWORK",
"network": {
"type": "EVPLAN",
"uuid": "<network_uuid>"
}
}
]
}
},
"expirationDateTime": "<token_expiration_date>",
"notifications": [
{
"type": "NOTIFICATION",
"emails": [
"<email_address>"
]
}
]
}'
Estado del token de servicio
Una vez que haya creado un token de servicio, puede comprobar su estado, incluido si ha sido canjeado por el otro cliente. Si el estado es Inactive, el token de servicio aún no se ha canjeado. Si el estado es Active, se ha canjeado el token de servicio.
El creador de la conexión que utiliza un token de Z-Side se factura por la conexión.
Si el estado es Expired, el token de servicio ha llegado a su fecha de caducidad sin canjear.
- Portal
- API
Para comprobar el estado de su token de servicio, inicie sesión en el portal del cliente y vaya a su inventario de tokens de servicio

Para comprobar el estado de sus tokens de servicio, envíe una GET solicitud al /fabric/v4/serviceTokenspunto final. La respuesta incluye una lista de sus tokens de servicio junto con sus estados en el state campo.
Ejemplo de solicitud cURL:
curl -X GET 'https://api.equinix.com/fabric/v4/serviceTokens'
-H 'Authorization: Bearer <token>'
Hay más información sobre la gestión de tokens de servicio disponible en la páginaInventario de tokens de servicio.