Guías de integración › Guía de referencia de la API de BFC › Documentación detallada de la API › URIs de red › Recuperación de intervalos IP para diversas direcciones en una red

Recuperación de intervalos IP para diversas direcciones en una red

Recupere información de direcciones que no se utilizan para una red o VLAN de red que se basa en el tipo de uso de IP y el recuento opcional de direcciones:

GET BFC/networks/<network base address>/address_space/address_pools/<IP type>/availableRanges
GET BFC/networks/<network base address>/vlan_address_spaces/<vlan>/address_pools/<IP type>/available_ranges
GET BFC/networks/<network base address>/address_space/address_pools//<IP type>/availableRanges?numIPs=<num>
GET BFC/networks/<network base address>/vlan_address_spaces/<vlan>/address_pools/<IP type>/available_ranges?numIPs=<num>

El URI de GET es compatible con los siguientes parámetros de cadena de consulta:

numIPs

Si aparece, especifica el número de direcciones IP que se deben incluir mediante los intervalos. Cuando no se especifican los intervalos devueltos, se incluyen todas las IP disponibles para la red, el tipo de uso de IP y la VLAN (si aparece).

Result

Si el resultado es correcto, se devuelve un código 200 de HTTP y una carga útil que es el estado del grid como una cadena. Si el resultado es un error, se devuelve un código de error de HTTP y la información de error asociada.

Descripción

Recupera los intervalos IP que abarcan el número de direcciones solicitado (especificado mediante un parámetro de cadena de consulta opcional). Además, también puede incluir todas las direcciones disponibles cuando no se solicita un recuento, para una red única, el tipo de uso de IP designado y una VLAN opcional. Si no se incluye una VLAN en la cadena de consulta, se devuelven los intervalos IP del espacio de direcciones básicas o que no son de VLAN. Si aparece y equivale a la ID de VLAN, la red cuenta con un espacio de IP de aplicación configurado en la VLAN consultada para direcciones disponibles.

Los intervalos de direcciones se devuelven en una lista de registros de intervalo de IP donde la suma de los tamaños de intervalo equivale al número solicitado de direcciones o las direcciones totales disponibles cuando no se solicite ningún recuento. Se produce un error al solicitar un recuento que supere el número total de direcciones libres.

Se pueden utilizar los intervalos IP para especificar la IP del controlador del grid y un intervalo IP de aplicación cuando se crean o actualizan grids.

Ejemplo de python

de la importación de httplib HTTPSConnection
importación de json
import os
import sys

networkBase = sys.argv[1]
ipType = sys.argv[2]
bfcHost = os.environ["BFC_HOST"]
bfcSession = os.environ["BFC_SESSION"]
conn = HTTPSConnection(bfcHost + ':8443')
conn.connect()
conn.request(method='GET',
             url='/BFC/networks' + 'networkBase' + '/address_pools/' + 'ipType' + '/availableRanges/,
             headers={'Content-Type':'application/json',
                      'Authorization':bfcSession})
r1 = conn.getresponse()
print 'HTTP Response Code: {0}'.format(r1.status)
servers = json.loads(r1.read())
print json.dumps(servers, sort_keys=True, indent=4)