---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# IPAddress - Champ d'application, global

# IPAddress - Champ d'application, global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 minutes de lecture

L'API IPAddress fournit des méthodes qui vous permettent de vérifier les différents états d'une adresse IP spécifiée, par exemple si elle est routable, unicast, multicast, publique ou réservée. Il vous permet également d'obtenir les formes canoniques (abrégées/standard) et étendues d'une adresse IP.
Accédez à la classe IPAddress globale et à ses méthodes associées dans l'espace de noms global `SNC` .

Dans cette API, certaines méthodes sont statiques et d'autres non statiques. Les méthodes [isV4()](https://servicenow-prod.fluidtopics.net/p8zyeELUd4YQ7HuYaj23zg#IPAdd-isV4_S "Détermine si l’adresse IP spécifiée est une adresse IPv4 valide.") et [isV6()](https://servicenow-prod.fluidtopics.net/p8zyeELUd4YQ7HuYaj23zg#IPAdd-isV6_S "Détermine si l’adresse IP spécifiée est une adresse IPv6 valide.") fournissent des implémentations statiques et non statiques. L'avantage des méthodes non statiques est que vous n'avez pas besoin d'appeler la méthode [IPAddress()](https://servicenow-prod.fluidtopics.net/p8zyeELUd4YQ7HuYaj23zg#IPAddressAPIBoth "L’API IPAddress fournit des méthodes qui vous permettent de vérifier les différents états d’une adresse IP spécifiée, par exemple si elle est routable, unicast, multicast, publique ou réservée. Il vous permet également d’obtenir les formes canoniques (abrégées/standard) et étendues d’une adresse IP.") pour instancier un objet IPAddress.

## IPAddress - IPAddress (chaîne ipAddress) {#ariaid-title2}

Instancie un objet IPAddress pour l'adresse IP spécifiée.
{#IPAdd-IPAddress_S__table_hvk_txg_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ipAddress | Chaîne | Adresse IP pour laquelle créer l'objet IPAddress. |
[Tableau 1. Paramètres]

{#IPAdd-IPAddress_S__table_hvk_txg_htb}  
L'exemple de code suivant montre comment appeler le constructeur IPAddress lors de l'appel d'une méthode IPAddress non statique.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");

      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is routable?: " + new SNC.IPAddress(ip).isRoutable());
      gs.info("ip address 2 is routable?: " + new SNC.IPAddress(ip2).isRoutable());
    }

## IPAddress - canonicalize(String ipAddress) {#ariaid-title3}

Renvoie la forme canonique (abrégée/standard) de l'adresse IP spécifiée en supprimant tout remplissage zéro de l'adresse.
Par exemple, la forme canonique de l'adresse IPv6 \<\< 0000:0000:0000:0000:0000:0000:0000:00001 \>\> est \<\< ::1 \>\>. La forme canonique de l'adresse IPv4 \<\< 192.168.001.002 \>\> est \<\< 192.268.1.2 \>\>.  
Remarque :  
Il s'agit d'une méthode statique.
{#IPAdd-canonicalize_S__table_r4h_yzg_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ipAddress | Chaîne ou objet | Adresse IP à canoniser ou un objet IPAddress inclus dans le périmètre qui contient l'adresse IP. |
[Tableau 2. Paramètres]

{#IPAdd-canonicalize_S__table_r4h_yzg_htb} {#IPAdd-canonicalize_S__table_s4h_yzg_htb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Adresse IP canonique (raccourcie/standardisée). |
[Tableau 3. Renvoie]

{#IPAdd-canonicalize_S__table_s4h_yzg_htb}  
L'exemple suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour canoniser une adresse IP IPv6.

    function() {
      var grCMDB = new GlideRecord('cmdb_ci');
      grCMDB.get("SYS_ID");
      var ip = grCMDB.getValue('ip_address');
      gs.info("ip address: " + ip);
      gs.info("canonicalized ip: " + SNC.IPAddress.canonicalize(ip));
    }

Sortie :

    ip address: 0000:0000:0000:0000:0000:0000:0000:0001
    canonicalized ip: ::1

## IPAddress : getExpanded(String ipAddress) {#ariaid-title4}

Renvoie la forme développée de l'adresse IP spécifiée
Par exemple, la forme développée de l'adresse IPv6 \<\< ::1 \>\> est \<\< 0000:0000:0000:0000:0000:0000:0000:0001 \>\>. La forme étendue de l'adresse IPv4 \<\< 192.268.1.2 \>\> est \<\< 192.168.001.002 \>\>.  
Remarque :  
Il s'agit d'une méthode statique.
{#IPAdd-getExpanded_S__table_q1m_n1n_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ipAddress | Chaîne | Adresse IP à développer. |
[Tableau 4. Paramètres]

{#IPAdd-getExpanded_S__table_q1m_n1n_htb} {#IPAdd-getExpanded_S__table_r1m_n1n_htb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Adresse IP développée. |
[Tableau 5. Renvoie]

{#IPAdd-getExpanded_S__table_r1m_n1n_htb}  
L'exemple suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour développer une adresse IP IPv6.

    function() {
      var grCMDB = new GlideRecord('cmdb_ci');
      grCMDB.get(SYS_ID);
      var ip = grCMDB.getValue('ip_address');
      gs.info("ip address: " + ip);
      gs.info("expanded ip: " + SNC.IPAddress.getExpanded(ip));
    }

Sortie :

    ip address: ::1
    expanded ip: 0000:0000:0000:0000:0000:0000:0000:0001

## IPAddress : isLinkLocal() {#ariaid-title5}

Détermine si l'objet IPAddress spécifié est une adresse IP lien-local.
Pour plus d'informations sur les adresses IP locales de liaison, consultez [les RFC 3927](https://datatracker.ietf.org/doc/html/rfc3927) et [RFC 4291](https://datatracker.ietf.org/doc/html/rfc4291).  
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isLinkLocal__table_fyr_mg4_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 6. Paramètres]

{#IPAdd-isLinkLocal__table_fyr_mg4_htb} {#IPAdd-isLinkLocal__table_gyr_mg4_htb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'objet d'adresse IP est une adresse lien-local. Valeurs valides : * true : l'adresse IP est une adresse lien-local. * false : l'adresse IP n'est pas une adresse de liaison locale. {#IPAdd-isLinkLocal__ul_bhr_ddn_htb} |
[Tableau 7. Renvoie]

{#IPAdd-isLinkLocal__table_gyr_mg4_htb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses lien-local.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");

      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is link local?: " + new SNC.IPAddress(ip).isLinkLocal());
      gs.info("ip address 2 is link local?: " + new SNC.IPAddress(start_ip).isLinkLocal());
    }

Sortie :

    ip address 1: ::1
    ip address 2: fe80:1::1
    ip address 1 is link local?: false
    ip address 2 is link local?: true

## IPAddress : isLocalhost() {#ariaid-title6}

Détermine si l'objet IPAddress spécifié est l'adresse IP de bouclage.
Pour plus d'informations sur l'adresse IP de bouclage, consultez [Registre d'adresses à usage spécial IPv4 IANA](https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml) et [Registre d'adresses à usage spécial IPv6 IANA](https://www.iana.org/assignments/iana-ipv6-special-registry/iana-ipv6-special-registry.xml).  
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isLocalhost__table_kgl_g3l_3tb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 8. Paramètres]

{#IPAdd-isLocalhost__table_kgl_g3l_3tb} {#IPAdd-isLocalhost__table_lgl_g3l_3tb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'objet d'adresse IP est l'adresse IP de bouclage. Valeurs valides : * vrai : l'adresse IP est l'adresse IP de bouclage. * faux : l'adresse IP n'est pas l'adresse IP de bouclage. {#IPAdd-isLocalhost__ul_bhr_ddn_htb} |
[Tableau 9. Renvoie]

{#IPAdd-isLocalhost__table_lgl_g3l_3tb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont l'adresse IP de bouclage.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is localhost?: " + new SNC.IPAddress(ip).isLocalhost());
      gs.info("ip address 2 is localhost?: " + new SNC.IPAddress(ip2).isLocalhost());
    }

Sortie :

    ip address 1: 127.0.0.1
    ip address 2: <current user's public IP Address>
    ip address 1 is localhost?: true
    ip address 2 is localhost?: false

## IPAddress - isMulticast() {#ariaid-title7}

Détermine si l'objet IPAddress spécifié est une adresse IP de multidiffusion.
Pour plus d'informations sur les adresses IP de multidiffusion, consultez [les RFC 2365](https://datatracker.ietf.org/doc/html/rfc2365) et [RFC 3306](https://datatracker.ietf.org/doc/html/rfc3306).  
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isMulticast__table_qww_sh4_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 10. Paramètres]

{#IPAdd-isMulticast__table_qww_sh4_htb} {#IPAdd-isMulticast__table_rww_sh4_htb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'objet d'adresse IP est une adresse de multidiffusion. Valeurs valides : * true : l'adresse IP est une adresse de multidiffusion. * false : l'adresse IP n'est pas une adresse de multidiffusion. {#IPAdd-isMulticast__ul_bhr_ddn_htb} |
[Tableau 11. Renvoie]

{#IPAdd-isMulticast__table_rww_sh4_htb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses de multidiffusion.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is multicast?: " + new SNC.IPAddress(ip).isMulticast());
      gs.info("ip address 2 is multicast?: " + new SNC.IPAddress(start_ip).isMulticast());
    }

Sortie :

    ip address 1: ::1
    ip address 2: 224.0.0.22
    ip address 1 is multicast?: false
    ip address 2 is multicast?: true

## IPAddress : isPublic() {#ariaid-title8}

Détermine si l'objet IPAddress spécifié est une adresse IP publique. Une adresse IP est considérée comme publique si elle est routable et n'est pas une adresse réservée.
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isPublic__table_l2f_22l_3tb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 12. Paramètres]

{#IPAdd-isPublic__table_l2f_22l_3tb} {#IPAdd-isPublic__table_m2f_22l_3tb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'objet d'adresse IP est une adresse publique. Valeurs valides : * vrai : l'adresse IP est une adresse publique. * faux : l'adresse IP n'est pas une adresse publique. {#IPAdd-isPublic__ul_bhr_ddn_htb} |
[Tableau 13. Renvoie]

{#IPAdd-isPublic__table_m2f_22l_3tb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses publiques.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is public?: " + new SNC.IPAddress(ip).isPublic());
      gs.info("ip address 2 is public?: " + new SNC.IPAddress(ip2).isPublic());
    }

Sortie :

    ip address 1: 2001:1::1
    ip address 2: <current user's public IP Address>
    ip address 1 is public?: false
    ip address 2 is public?: true

## IPAddress - isReserved() {#ariaid-title9}

Détermine si l'objet IPAddress spécifié est une adresse IP réservée.
Pour plus d'informations sur les adresses IP réservées, consultez [Registre d'adresses à usage spécial IANA IPv4](https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml) et [Registre d'adresses à usage spécial IANA IPv6](https://www.iana.org/assignments/iana-ipv6-special-registry/iana-ipv6-special-registry.xml).  
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isReserved__table_lpw_ffl_3tb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 14. Paramètres]

{#IPAdd-isReserved__table_lpw_ffl_3tb} {#IPAdd-isReserved__table_mpw_ffl_3tb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'objet d'adresse IP est une adresse réservée. Valeurs valides : * true : l'adresse IP est une adresse réservée. * faux : l'adresse IP n'est pas une adresse réservée. {#IPAdd-isReserved__ul_bhr_ddn_htb} |
[Tableau 15. Renvoie]

{#IPAdd-isReserved__table_mpw_ffl_3tb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses réservées.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is reserved?: " + new SNC.IPAddress(ip).isReserved());
      gs.info("ip address 2 is reserved?: " + new SNC.IPAddress(ip2).isReserved());
    }

Sortie :

    ip address 1: 2001:1::1
    ip address 2: <current user's public IP Address>
    ip address 1 is reserved?: true
    ip address 2 is reserved?: false

## IPAddress : isRoutable() {#ariaid-title10}

Détermine si l'objet IPAddress spécifié est une adresse IP routable.
Une adresse IP est considérée comme routable si elle n'est pas une adresse privée, une adresse lien-local ou l'adresse de bouclage. Pour plus d'informations sur les adresses privées, consultez [RFC 1918](https://datatracker.ietf.org/doc/html/rfc1918) et [RFC 4193](https://datatracker.ietf.org/doc/html/rfc4193).  
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isRoutable__table_pv3_m34_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 16. Paramètres]

{#IPAdd-isRoutable__table_pv3_m34_htb} {#IPAdd-isRoutable__table_qv3_m34_htb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'objet d'adresse IP est une adresse routable. Valeurs valides : * true : l'adresse IP est une adresse routable. * faux : l'adresse IP n'est pas une adresse routable. {#IPAdd-isRoutable__ul_bhr_ddn_htb} |
[Tableau 17. Renvoie]

{#IPAdd-isRoutable__table_qv3_m34_htb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses routables.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var ip2 = gs.getSession().getClientIP().toString();
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + ip2);
      gs.info("ip address 1 is routable?: " + new SNC.IPAddress(ip).isRoutable());
      gs.info("ip address 2 is routable?: " + new SNC.IPAddress(ip2).isRoutable());
    }

Sortie :

    ip address 1: ::1
    ip address 2: <current user's public IP Address>
    ip address 1 is routable?: false
    ip address 2 is routable?: true

## IPAddress : isSameVersionAs(String ipAddress) {#ariaid-title11}

Détermine si l'objet IPAddress transmis est de la même version, IPv4 ou IPv6, que l'adresse IP spécifiée.
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isSameVersionAs_S__table_x2x_4f4_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ipAddress | Chaîne | Adresse IP à vérifier par rapport à l'adresse IP dans l'objet IPAddress transmis. |
[Tableau 18. Paramètres]

{#IPAdd-isSameVersionAs_S__table_x2x_4f4_htb} {#IPAdd-isSameVersionAs_S__table_y2x_4f4_htb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'adresse IP spécifiée est la même version que celle de l'objet IPAddress. Valeurs valides : * true : la version de l'adresse IP est la même. * false : la version de l'adresse IP est différente. {#IPAdd-isSameVersionAs_S__ul_bhr_ddn_htb} |
[Tableau 19. Renvoie]

{#IPAdd-isSameVersionAs_S__table_y2x_4f4_htb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour comparer si différentes adresses IP sont de la même version (IPv4 ou IPv6).

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      var end_ip = grDiscover.getValue('end_ip_address');
      gs.info("ip address 1: "+ ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 3: " + end_ip);
      var ip1 = new SNC.IPAddress(ip);
      var ip2 = new SNC.IPAddress(start_ip);
      var ip3 = new SNC.IPAddress(end_ip);
      gs.info("ip address 1 is same version as ip address 2?: " + ip1.isSameVersionAs(ip2));
      gs.info("ip address 1 is same version as itself?: " + ip1.isSameVersionAs(ip1));
      gs.info("ip address 2 is same version as ip address 3?: " + ip2.isSameVersionAs(ip3));
    }

Sortie :

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 3: ::3
    ip address 1 is same version as ip address 2?: false
    ip address 1 is same version as itself?: true
    ip address 2 is same version as ip address 3?: true

## IPAddress : isUnicast() {#ariaid-title12}

Détermine si l'objet IPAddress spécifié est une adresse IP unicast.
Une adresse unicast est en fait une adresse qui n'est pas multicast.  
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-isUnicast__table_zk3_bhl_3tb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 20. Paramètres]

{#IPAdd-isUnicast__table_zk3_bhl_3tb} {#IPAdd-isUnicast__table_al3_bhl_3tb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'objet d'adresse IP est une adresse unicast. Valeurs valides : * true : l'adresse IP est une adresse de monodiffusion. * faux : l'adresse IP n'est pas une adresse de monodiffusion. {#IPAdd-isUnicast__ul_bhr_ddn_htb} |
[Tableau 21. Renvoie]

{#IPAdd-isUnicast__table_al3_bhl_3tb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP dans un enregistrement de la table Plages IP de découverte \[discovery_range_item\] sont des adresses de monodiffusion.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is unicast?: " + new SNC.IPAddress(ip).isUnicast());
      gs.info("ip address 2 is unicast?: " + new SNC.IPAddress(ip2).isUnicast());
    }

Sortie :

    ip address 1: 224.0.0.22
    ip address 2: <current user's public IP Address>
    ip address 1 is unicast?: false
    ip address 2 is unicast?: true

## IPAddress : isV4(chaîne ipAddress) {#ariaid-title13}

Détermine si l'adresse IP spécifiée est une adresse IPv4 valide.
Cette méthode a des implémentations statiques et non statiques. La façon dont vous appelez les deux types de méthodes est légèrement différente. Pour l'implémentation non statique, vous n'avez pas besoin d'instancier d'abord un objet IPAddress et vous transmettez l'adresse IP dans la référence de classe IPAddress. Les deux renvoient la même réponse.
{#IPAdd-isV4_S__table_hrb_3gn_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ipAddress | Chaîne | Adresse IP à valider. Pour l'implémentation non statique, l'adresse IP est transmise dans la référence de classe IPAddress au lieu de l'appel de méthode. Par exemple, `Nouveau SNC. IPAddress(<< ::1 >>).isV4() ;`. |
[Tableau 22. Paramètres]

{#IPAdd-isV4_S__table_hrb_3gn_htb} {#IPAdd-isV4_S__table_irb_3gn_htb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'adresse IP spécifiée est une adresse IPv4 valide. Valeurs valides : * vrai : l'adresse IP est valide. * faux : l'adresse IP n'est pas valide. {#IPAdd-isV4_S__ul_bhr_ddn_htb} |
[Tableau 23. Renvoie]

{#IPAdd-isV4_S__table_irb_3gn_htb}  
L'exemple suivant montre comment utiliser la version statique incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses IPv4 valides.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is v4?: " + SNC.IPAddress.isV4(ip));
      gs.info(("ip address 2 is v4?: " + SNC.IPAddress.isV4(start_ip));
    }

Sortie :

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 1 is v4?: true
    ip address 2 is v4?: false

L'exemple suivant montre comment utiliser la version non statique de cette méthode pour vérifier si les adresses IP figurant dans un enregistrement de la table Plages IP de découverte \[discovery_range_item\] sont des adresses IPv4 valides.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is v4?: " + new SNC.IPAddress(ip).isV4());
      gs.info("ip address 2 is v4?: " + new SNC.IPAddress(start_ip).isV4());
    }

Sortie :

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 1 is v4?: true
    ip address 2 is v4?: false

## IPAddress : isV6(chaîne ipAddress) {#ariaid-title14}

Détermine si l'adresse IP spécifiée est une adresse IPv6 valide.
Cette méthode a des implémentations statiques et non statiques. La façon dont vous appelez les deux types de méthodes est légèrement différente. Pour l'implémentation non statique, vous n'avez pas besoin d'instancier d'abord un objet IPAddress et vous transmettez l'adresse IP dans la référence de classe IPAddress. Les deux renvoient la même réponse.
{#IPAdd-isV6_S__table_nkk_sgn_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ipAddress | Chaîne | Adresse IP à valider. Pour l'implémentation non statique, l'adresse IP est transmise dans la référence de classe IPAddress au lieu de l'appel de méthode. Par exemple, `Nouveau SNC. IPAddress(<< ::1 >>).isV6() ;`. |
[Tableau 24. Paramètres]

{#IPAdd-isV6_S__table_nkk_sgn_htb} {#IPAdd-isV6_S__table_okk_sgn_htb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'adresse IP spécifiée est une adresse IPv6 valide. Valeurs valides : * vrai : l'adresse IP est valide. * faux : l'adresse IP n'est pas valide. {#IPAdd-isV6_S__ul_bhr_ddn_htb} |
[Tableau 25. Renvoie]

{#IPAdd-isV6_S__table_okk_sgn_htb}  
L'exemple suivant montre comment utiliser la version statique incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses IPv6 valides.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get(SYS_ID);
      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);
      gs.info("ip address 1 is v6?: " + SNC.IPAddress.isV6(ip));
      gs.info(("ip address 2 is v6?: " + SNC.IPAddress.isV6(start_ip));
    }

Sortie :

    ip address 1: 192.168.0.1
    ip address 2: ::2
    ip address 1 is v6?: false
    ip address 2 is v6?: true

L'exemple suivant montre comment utiliser la version non statique incluse dans le champ d'application de cette méthode pour vérifier si les adresses IP d'un enregistrement dans la table Plages IP de découverte \[discovery_range_item\] sont des adresses IPv6 valides.

    function() {
      var grDiscover = new GlideRecord('discovery_range_item');
      grDiscover.get("SYS_ID");

      var ip = grDiscover.getValue('network_ip');
      var start_ip = grDiscover.getValue('start_ip_address');
      gs.info("ip address 1: " + ip);
      gs.info("ip address 2: " + start_ip);

      gs.info("ip address 1 is v6?: " + new SNC.IPAddress(ip).isV6());
      gs.info("ip address 2 is v6?: " + new SNC.IPAddress(start_ip).isV6());

    }

Sortie :

    ip address 1: 192.168.0.1
    ip address 2: ::1
    ip address 1 is v6?: false
    ip address 2 is v6?: true

## IPAddress : isValid(String ipAddress) {#ariaid-title15}

Détermine si l'adresse IP spécifiée est une adresse IPv4 ou IPv6 valide.
Remarque :  
Il s'agit d'une méthode statique.
{#IPAdd-isValid_S__table_onf_mcn_htb__entry__3}

| Nom | Type | Description |
|-|-|-|
| ipAddress | Chaîne | Adresse IP à valider. |
[Tableau 26. Paramètres]

{#IPAdd-isValid_S__table_onf_mcn_htb} {#IPAdd-isValid_S__table_pnf_mcn_htb__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'adresse IP spécifiée est une adresse IPv4 ou IPv6 valide. Valeurs valides : * vrai : l'adresse IP est valide. * faux : l'adresse IP n'est pas valide. {#IPAdd-isValid_S__ul_bhr_ddn_htb} |
[Tableau 27. Renvoie]

{#IPAdd-isValid_S__table_pnf_mcn_htb}  
L'exemple de code suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour vérifier si l'adresse IP d'un enregistrement dans les éléments de configuration \[cmdb_ci\] est valide.

    function() {
      var grCMDB = new GlideRecord('cmdb_ci');
      grCMDB.get("SYS_ID");
      var ip = grCMDB.getValue('ip_address');
      gs.info("ip address: " + ip)
      var ipAddress = new SNC.IPAddress(ip);
      gs.info("ip is valid?: " + ipAddress.isValid())
    }

Sortie :

    ip address: 127.0.0.1
    ip is valid?: true

## IPAddress - toExpanded() {#ariaid-title16}

Renvoie la forme développée d'un objet IPAddress.
Remarque :  
Il s'agit d'une méthode non statique.
{#IPAdd-toExpanded__table_xn2_mjl_3tb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 28. Paramètres]

{#IPAdd-toExpanded__table_xn2_mjl_3tb} {#IPAdd-toExpanded__table_yn2_mjl_3tb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Adresse IP développée. |
[Tableau 29. Renvoie]

{#IPAdd-toExpanded__table_yn2_mjl_3tb}  
L'exemple suivant montre comment utiliser la version incluse dans le champ d'application de cette méthode pour développer une adresse IP IPv6.

    function() {
      var grDiscover = new GlideRecord('cmdb_ci');
      grDiscover.get("SYS_ID");
      var ip = grDiscover.getValue('ip_address');
      gs.info("ip address: " + ip);
      gs.info("expanded ip address: " + new SNC.IPAddress(ip).toExpanded());
    }

Sortie :

    ip address: 2001:41::1
    expanded ip address: 2001:0041:0000:0000:0000:0000:0000:0001