Créer un groupe d’options DHCP

Vous pouvez créer un groupe d’options DHCP à associer à un Net. Vous pouvez spécifier un ou plusieurs serveurs NTP et serveurs DNS à utiliser, avec un nom de domaine correspondant.

3DS OUTSCALE fournit automatiquement un groupe d’options DHCP par défaut. Cependant, vous pouvez créer autant de groupes personnalisés que vous le voulez.

Vous pouvez associer un groupe d’options DHCP à un Net pour personnaliser la configuration DHCP utilisée avec les machines virtuelles (VM) créées dans ce Net. Pour en savoir plus, voir Modifier le groupe d’options DHCP associé à un Net.

Créer un groupe d’options DHCP avec Cockpit v2

  1. Dans le dashboard DHCP Options, cliquez sur IconAddFull Créer des options DHCP.
    La boîte de dialogue CRÉER DES OPTIONS DHCP apparaît.

  2. (optionnel) Dans le champ Nom de domaine, tapez le nom de domaine du groupe d’options DHCP.

    Pour utiliser le nom de domaine OUTSCALE, laissez le champ vide. Pour en savoir plus, voir À propos des options DHCP > Groupe d’options DHCP par défaut.

    Cliquez sur Suivant.

  3. Dans la liste Serveurs de nom de domaine, sélectionnez :

    1. Poursuivre avec un DNS par défaut pour utiliser le nom de domaine OUTSCALE.

    2. Sélectionner un ou plusieurs DNS pour utiliser un nom de domaine personnalisé.

  4. Spécifiez au moins l’une des valeurs suivantes :

    • (optionnel) Dans le champ Serveurs NTP, tapez les IP de un ou plusieurs serveurs NTP.

      Spécifier les mêmes informations que celles d’un groupe d’options DHCP existant en crée un nouveau, avec un ID différent.

    • (optionnel) Dans le champ Serveurs de log, tapez les IP de un ou plusieurs serveurs de log.

      Spécifier les mêmes informations que celles d’un groupe d’options DHCP existant en crée un nouveau, avec un ID différent.

  5. Cliquez sur Suivant, puis vérifiez l’ensemble des paramètres du groupe d’options DHCP.

  6. Cliquez sur Créer.
    Le groupe d’options DHCP est créé.

Créer un groupe d’options DHCP avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The CreateDhcpOptions command creates a set of DHCP options, that you can then associate with a Net using the UpdateNet method.

For more information, see About DHCP Options.

Request sample
$ osc-cli api CreateDhcpOptions --profile "default" \
    --DomainName "example.com" \
    --DomainNameServers '["192.0.2.0", "198.51.100.0"]' \
    --NtpServers '["203.0.113.0", "203.0.113.1"]'

This command contains the following attributes that you need to specify:

  • DomainName: (optional) Specify a domain name (for example, MyCompany.com). You can specify only one domain name. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

  • DomainNameServers: (optional) The IPs of domain name servers. If no IPs are specified, the OutscaleProvidedDNS value is set by default. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • LogServers: (optional) The IPs of the log servers. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

  • NtpServers: (optional) The IPs of the Network Time Protocol (NTP) servers. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

The CreateDhcpOptions command returns the following elements:

  • DhcpOptionsSet: Information about the DHCP options set.

    • Default: If true, the DHCP options set is a default one. If false, it is not.

    • DhcpOptionsSetId: The ID of the DHCP options set.

    • DomainName: The domain name.

    • DomainNameServers: One or more IPs for the domain name servers.

    • LogServers: One or more IPs for the log servers.

    • NtpServers: One or more IPs for the NTP servers.

    • Tags: One or more tags associated with the DHCP options set.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "DhcpOptionsSet": {
    "Tags": [],
    "NtpServers": [
      "203.0.113.0",
      "203.0.113.1"
    ],
    "Default": false,
    "DhcpOptionsSetId": "dopt-12345678",
    "DomainName": "example.com",
    "DomainNameServers": [
      "192.0.2.0",
      "198.51.100.0"
    ]
  }
}

Créer un groupe d’options DHCP avec oapi-cli

À ce jour, cette section est disponible en anglais uniquement.

The CreateDhcpOptions command creates a set of DHCP options, that you can then associate with a Net using the UpdateNet method.

For more information, see About DHCP Options.

Request sample
$ oapi-cli --profile "default" CreateDhcpOptions \
    --DomainName "example.com" \
    --DomainNameServers '["192.0.2.0", "198.51.100.0"]' \
    --NtpServers '["203.0.113.0", "203.0.113.1"]'

This command contains the following attributes that you need to specify:

  • DomainName: (optional) Specify a domain name (for example, MyCompany.com). You can specify only one domain name. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

  • DomainNameServers: (optional) The IPs of domain name servers. If no IPs are specified, the OutscaleProvidedDNS value is set by default. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • LogServers: (optional) The IPs of the log servers. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

  • NtpServers: (optional) The IPs of the Network Time Protocol (NTP) servers. You must specify at least one of the following parameters: DomainName, DomainNameServers, LogServers, or NtpServers.

The CreateDhcpOptions command returns the following elements:

  • DhcpOptionsSet: Information about the DHCP options set.

    • Default: If true, the DHCP options set is a default one. If false, it is not.

    • DhcpOptionsSetId: The ID of the DHCP options set.

    • DomainName: The domain name.

    • DomainNameServers: One or more IPs for the domain name servers.

    • LogServers: One or more IPs for the log servers.

    • NtpServers: One or more IPs for the NTP servers.

    • Tags: One or more tags associated with the DHCP options set.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "DhcpOptionsSet": {
    "Tags": [],
    "NtpServers": [
      "203.0.113.0",
      "203.0.113.1"
    ],
    "Default": false,
    "DhcpOptionsSetId": "dopt-12345678",
    "DomainName": "example.com",
    "DomainNameServers": [
      "192.0.2.0",
      "198.51.100.0"
    ]
  }
}

Créer un groupe d’options DHCP avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour créer un groupe d’options DHCP personnalisé, utilisez la commande create-dhcp-options en suivant cette syntaxe :

Exemple de requête
$ aws ec2 create-dhcp-options \
    --profile YOUR_PROFILE \
    --dhcp-configurations Key=domain-name-servers,Values=192.0.0.0,192.0.0.1 Key=domain-name,Values=mycompany.com Key=ntp-servers,Values=192.0.0.2 Key=log-servers,Values=192.0.0.3 \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • dhcp-configurations : Une ou plusieurs options DHCP. Cet attribut contient les éléments suivants que vous devez spécifier :

    • (optionnel) Key : Le type d’option DHCP (domain-name-servers | domain-name | ntp-servers). Pour en savoir plus, voir À propos des options DHCP.

    • (optionnel) Values : La valeur de l’option DHCP (une ou plusieurs IP pour les options domain-name-servers, ntp-servers et log-servers, ou un nom de domaine pour l’option domain-name).

      Vous pouvez spécifier jusqu’à quatre IP pour les options domain-name-servers, ntp-servers et log-servers.

      Pour utiliser le nom de domaine OUTSCALE dans un groupe d’options DHCP personnalisé, vous devez spécifier les valeurs suivantes :

      • domain-name-servers : OutscaleProvidedDNS

      • domain-name : <nom_région>.compute.internal

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande create-dhcp-options renvoie les éléments suivants :

  • DhcpOptions : Informations à propos du groupe d’options DHCP nouvellement créé. Cet élément contient les informations suivantes :

    • DhcpConfigurations : Informations à propos des options DHCP contenues dans le groupe d’options DHCP. Cet élément contient les informations suivantes :

      • Value : Une ou plusieurs valeurs pour l’option DHCP.

      • Key : Le type d’option DHCP.

    • DhcpOptionsId : L’ID du groupe d’options DHCP.

    • Tags : Un ou plusieurs tags attachés au groupe d’options DHCP.

      • TagKey : La clé d’un tag associé à la ressource.

      • TagValue : La valeur d’un tag associé à la ressource.

Exemple de résultat
 {
    "DhcpOptions": {
        "DhcpConfigurations": [
            {
                "Values": [
                    {
                        "Value": "mycompany.com"
                    }
                ],
                "Key": "domain-name"
            },
            {
                "Values": [
                    {
                        "Value": "10.2.5.2"
                    },
                    {
                        "Value": "10.2.5.1"
                    }
                ]
                "Key": "domain-name-servers"
            },
            {
                "Values": [
                    {
                        "Value:": "10.2.5.2"
                    }
                ]
                "Key": "ntp-servers"
            },
            {
                "Key": "log-servers",
                "Values": [
                    {
                        "Value": ""
                    }
                ]
            }
       ],
        "DhcpOptionsId": "dopt-1234abcd",
        "Tags": []
    }
}

Le groupe d’options DHCP est créé.

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.