Referencia CLI de Equinix Metal

Equinix Metal™ proporciona una plataforma Bare Metal basada en API que combina la experiencia de automatización de la nube con las ventajas de los servidores físicos Bare Metal.

La [CLI de Equinix Metal envuelve el SDK de Equinix Metal Go equinix-sdk-go, permitiendo la interacción con la API de Equinix Metal desde una interfaz de línea de comandos.

Instalación

Instalación del binario de la versión

Puede descargar el binario apropiado para su sistema desde la [página de versiones en GitHub. Colóquelo en la ubicación que desee, chmod y cámbiele el nombre a metal.

Instalar el binario desde el código fuente

Si tienes instalado go 1.19 o posterior, puedes compilar e instalar la última versión con:

go install github.com/equinix/metal-cli/cmd/metal@latest

Puede encontrar el ejecutable/binario instalado en la carpeta $GOPATH/bin o $HOME/go/bin.

Elaboración casera

Si prefieres instalar a través de Homebrew, puedes ejecutar lo siguiente:

brew tap equinix/homebrew-tap
brew install metal-cli

Puertos FreeBSD

Las herramientas CLI de Equinix Metal también están disponibles en los ports de FreeBSD:

sudo pkg install -r FreeBSD sysutils/equinix-metal-cli

Autenticación

La CLI utiliza su token de la API de Equinix Metal para la autenticación. El token puede almacenarse en la variable de entorno $METAL_AUTH_TOKEN.

export METAL_AUTH_TOKEN=<your_API_TOKEN>

También puede establecer y almacenar la autenticación y la configuración en un archivo de configuración JSON o YAML creado por metal init.

Metal init

Descripción

Init solicitará la configuración de la cuenta y almacenará los valores por defecto en un archivo de configuración que puede ser compartido con otras herramientas de Equinix Metal. Este archivo se almacena normalmente en $HOME/.config/equinix/metal.yaml. En el archivo de configuración se puede especificar cualquier argumento de línea de comandos de la CLI de Metal. Tenga cuidado de no definir opciones que no vaya a utilizar como predeterminadas. El archivo de configuración en el que se escribe se puede cambiar con METAL_CONFIG y --config.

metal init

Ejemplos

# Example config:
--
token: foo
project-id: 1857dc19-76a5-4589-a9b6-adb729a7d18b
organization-id: 253e9cf1-5b3d-41f5-a4fa-839c130c8c1d

Opciones

-h, --help   help for init
-help   help for init

Opciones heredadas de los comandos padre

Véase Opciones comunes.

Medio ambiente y terminaciones

La CLI de Equinix Metal ofrece comandos que generarán variables de entorno y complementos, dependiendo del shell que esté utilizando.

entorno metálico

Descripción

Imprime o genera variables de entorno. Variables emitidas actualmente: METAL_AUTH_TOKEN, METAL_ORGANIZATION_ID, METAL_PROJECT_ID, METAL_CONFIG. Utilice el indicador --project-id para establecer la variable METAL_PROJECT_ID. Utilice la opción --organization-id para definir la variable METAL_ORGANIZATION_ID.

metal env [-p <project_id>]

Ejemplos

# Print the current environment variables:
metal env

# Print the current environment variables in Terraform format:
metal env --output terraform

# Load environment variables in Bash, Zsh:
source <(metal env)

# Load environment variables in Bash 3.2.x:
eval "$(metal env)"

# Load environment variables in Fish:
metal env | source

Opciones

--export                   Export the environment variables.
-h, --help                     help for env
-O, --organization-id string   A organization UUID to set as an environment variable.
-o, --output string            Output format for environment variables (*sh, terraform, capp). (default "sh")
-p, --project-id string        A project UUID to set as an environment variable.
-project-id string             A project UUID to set as an environment variable.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

terminación metálica

Descripción

Genera scripts de finalización de shell para diferentes shells.

metal completion [bash | zsh | fish | powershell]

Ejemplos

# To load completions in Bash:
source <(metal completion bash)

# To load completions in Bash (3.2.x):
eval "$(metal completion bash)"

# To load completions in Bash for each session, on Linux execute once:
metal completion bash > /etc/bash_completion.d/metal-cli

# To load completions in Bash for each session, on Mac execute once:
metal completion bash > /usr/local/etc/bash_completion.d/metal-cli

# To load completions in Zsh:
source <(metal completion zsh)

# To load completions in Zsh for each session, execute once:
metal completion zsh > "${fpath[1]}/_metal-cli"

# To load completions in Fish:
metal completion fish | source

# To load completions in Fish for each session, execute once:
metal completion fish > ~/.config/fish/completions/metal-cli.fish

Opciones

-h, --help   help for completion

Opciones heredadas de los comandos padre

Véase Opciones comunes.

Generación de documentación

documentos sobre metal

Descripción

Genera documentación markdown de comandos en el directorio especificado. Cada comando obtiene un archivo markdown.

metal docs <destination>

Ejemplos

# Generate documentation in the ./docs directory:
metal docs ./docs

Opciones

-h, --help   help for docs

Opciones comunes

Estas opciones están disponibles para todos los comandos de la CLI de Equinix Metal.

--config string         Path to JSON or YAML configuration file (METAL_CONFIG)
--exclude strings       Comma separated Href references to collapse in results, may be dotted three levels deep
--filter stringArray    Filter 'get' actions with name value pairs. Filter is not supported by all resources and is implemented as request query parameters.
--http-header strings   Headers to add to requests (in format key=value)
--include strings       Comma separated Href references to expand in results, may be dotted three levels deep
-o, --output string         Output format (*table, json, yaml). env output formats are (*sh, terraform, capp).
--search string         Search keyword for use in 'get' actions. Search is not supported by all resources.
--sort-by string        Sort fields for use in 'get' actions. Sort is not supported by all resources.
--sort-dir string       Sort field direction for use in 'get' actions. Sort is not supported by all resources.
--token string          Metal API Token (METAL_AUTH_TOKEN)

Metal 2fa

Descripción

Active o desactive la autenticación de dos factores en su cuenta de usuario o reciba un token OTP. Más información en /metal/identity-access-management/users/.

Opciones

-h, --help   help for 2fa

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal 2fa desactivar

Descripción

Desactiva la autenticación de dos factores. Requiere el código OTP actual de SMS o de la aplicación. Si ya no tienes acceso a tu dispositivo de autenticación de dos factores, ponte en contacto con el servicio de asistencia.

metal 2fa disable (-a | -s) --code <OTP_code>  [flags]

Ejemplos

# Disable two-factor authentication via SMS
metal 2fa disable -s -c <OTP_code>

# Disable two-factor authentication via APP
metal 2fa disable -a -c <OTP_code>

Opciones

-a, --app           The OTP code is issued from an application.
-c, --code string   The two-factor authentication OTP code.
-h, --help          help for disable
-s, --sms           The OTP code is issued to you via SMS.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal 2fa enable

Descripción

Activa la autenticación de dos factores en la cuenta del usuario actual. La autenticación de dos factores está disponible a través de SMS o de una aplicación. Se requiere un código OPT actual, que puede generarse mediante el comando 2fa receive.

metal 2fa enable (-s | -a) --code <OTP_code> [flags]

Ejemplos

# Enable two factor authentication via SMS.
metal 2fa enable -s -c <OTP_code>

# Enable two factor authentication via an application.
metal 2fa enable -a -c <OTP_code>

Opciones

-a, --app           Enables two-factor authentication using an application on the current user's account.
-c, --code string   Two-factor authentication code that is provided by a request to the 2fa receive command.
-h, --help          help for enable
-s, --sms           Enables two-factor authentication using SMS on the current user's account.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal 2fa recibir

Descripción

Genera un token de autenticación de dos factores para utilizarlo en la habilitación de la autenticación de dos factores en la cuenta del usuario actual. Para utilizar SMS, debe haber un número de teléfono asociado a la cuenta para recibir el código. Si se utiliza una aplicación, se devuelve un URI para la aplicación.

metal 2fa receive (-s | -a) [flags]

Ejemplos

# Issue the token via SMS:
metal 2fa receive -s 

# Issue the token via app:
metal 2fa receive -a

Opciones

-a, --app    Issues an OTP URI for an authentication application.
-h, --help   help for receive
-s, --sms    Issues SMS OTP token to the phone number associated with the current user account.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

capacidad de Metal

Descripción

Operaciones de capacidad. Para más información sobre capacidad en metros, visite /metal/locations/metros/. Para más información sobre capacidad en instalaciones, visite /metal/locations/capacity/.

Opciones

-h, --help   help for capacity

Opciones heredadas de los comandos padre

Véase Opciones comunes.

comprobación de la capacidad del metal

Descripción

Valida si el número del plan de servidores especificado está disponible en el metro o instalación especificados. Metro y facility son mutuamente excluyentes. Se requiere al menos un metro (o instalación), un plan y una cantidad de 1 o más.

metal capacity check (-m <metro> | -f <facility>) -P <plan> -q <quantity> [flags]

Ejemplos

# Checks if 10 c3.medium.x86 servers are available in NY or Dallas:
metal capacity check -m ny,da -P c3.medium.x86 -q 10

# Checks if Silicon Valley or Dallas has either 4 c3.medium.x86 or m3.large.x86
metal capacity check -m sv,da -P c3.medium.x86,m3.large.x86 -q 4

Opciones

-f, --facilities strings   A facility or list of facilities.
-h, --help                 help for check
-m, --metros strings       A metro or list of metros.
-P, --plans strings        A plan or list of plans.
-q, --quantity int         The number of devices wanted.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal capacity get

Descripción

Devuelve la capacidad de metros o instalaciones. Hay disponibles filtros para metros, instalaciones y planes. Los indicadores de metro e instalaciones se excluyen mutuamente. Si no se incluye ningún indicador, se devuelve la capacidad de todos los planes en todas las instalaciones.

metal capacity get [-m | -f] | [--metros <list> | --facilities <list>] [-P <list>] [flags]

Ejemplos

# Returns the capacity of all plans in all facilities:
metal capacity get 

# Returns the capacity of the c3.small.x86 in all metros:
metal capacity get -m -P c3.small.x86

# Returns c3.large.arm and c3.medium.x86 capacity in the Silicon Valley, New York, and Dallas metros:
metal capacity get --metros sv,ny,da -P c3.large.arm,c3.medium.x86

Opciones

--facilities strings   A facility or list of facilities for client-side filtering. Will only return the capacity for the specified facilities. Can not be used with --metros.
-f, --facility             Return the capacity for all facilities. Can not be used with -m. (default true)
-h, --help                 help for get
-m, --metro                Return the capacity for all metros. Can not be used with -f.
--metros strings       A metro or list of metros for client-side filtering. Will only return the capacity for the specified metros. Can not be used with --facilities.
-P, --plans strings        Return only the capacity for the specified plans.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

dispositivo de Metal

Descripción

Operaciones del dispositivo que controlan el aprovisionamiento del servidor, los metadatos y las operaciones básicas.

Opciones

-h, --help   help for device

Opciones heredadas de los comandos padre

Véase Opciones comunes.

dispositivo de metal crear

Descripción

Crea un dispositivo en el proyecto especificado. Se requiere un plan, nombre de host, sistema operativo y metro o instalación.

metal device create -p <project_id> (-m <metro> | -f <facility>) -P <plan> -H <hostname> -O <operating_system> [-u <userdata> | --userdata-file <filepath>] [-c <customdata>] [-t <tags>] [-r <hardware_reservation_id>] [-I <ipxe_script_url>] [--always-pxe] [--spot-instance] [--spot-price-max=<max_price>] [flags]

Ejemplos

# Provisions a c3.small.x86 in the Dallas metro running Ubuntu 20.04:
metal device create -p $METAL_PROJECT_ID -P c3.small.x86 -m da -H test-staging-2 -O ubuntu_20_04

# Provisions a c3.medium.x86 in Silicon Valley, running Rocky Linux, from a hardware reservation:
metal device create -p $METAL_PROJECT_ID -P c3.medium.x86 -m sv -H test-rocky -O rocky_8 -r 47161704-1715-4b45-8549-fb3f4b2c32c7

Opciones

-a, --always-pxe                       Sets whether the device always PXE boots on reboot.
-b, --billing-cycle string             Billing cycle  (default "hourly")
-c, --customdata string                Custom data to be included with your device's metadata.
-f, --facility string                  Code of the facility where the device will be created
-r, --hardware-reservation-id string   The UUID of a hardware reservation, if you are provisioning a server from your reserved hardware.
-h, --help                             help for create
-H, --hostname string                  Hostname
-I, --ipxe-script-url string           The URL of an iPXE script.
-m, --metro string                     Code of the metro where the device will be created
-O, --operating-system string          Operating system name for the device
-P, --plan string                      Name of the plan
-p, --project-id string                The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-S, --public-ipv4-subnet-size int      Size of the public IPv4 subnet.
-s, --spot-instance                    Provisions the device as a spot instance.
--spot-price-max float             Sets the maximum spot market price for the device: --spot-price-max=1.2
-t, --tags strings                     Tag or list of tags for the device: --tags="tag1,tag2".
-T, --termination-time string          Device termination time: --termination-time="2023-08-24T15:04:05Z"
-u, --userdata string                  Userdata for device initialization. Can not be used with --userdata-file.
--userdata-file string             Path to a userdata file for device initialization. Can not be used with --userdata.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal device delete

Descripción

Elimina el dispositivo especificado con un mensaje de confirmación. Para omitir la confirmación, utilice --force.

metal device delete -i <device_id> [-f] [flags]

Ejemplos

# Deletes the specified device:
metal device delete -i 7ec86e23-8dcf-48ed-bd9b-c25c20958277
>
✔ Are you sure you want to delete device 7ec86e23-8dcf-48ed-bd9b-c25c20958277 [Y/N]: y

# Deletes a VLAN, skipping confirmation:
metal device delete -f -i 7ec86e23-8dcf-48ed-bd9b-c25c20958277

Opciones

-f, --force       Skips confirmation for the device deletion.
-h, --help        help for delete
-i, --id string   The UUID of the device.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

dispositivo de metal get

Descripción

Recupera una lista de dispositivos del proyecto o los detalles del dispositivo especificado. Se requiere un ID de proyecto o un ID de dispositivo.

metal device get [-p <project_id>] | [-i <device_id>] [flags]

Ejemplos

# Gets the details of the specified device:
metal device get -i 52b60ca7-1ae2-4875-846b-4e4635223471

# Gets a list of devices in the specified project:
metal device get -p 5ad070a5-62e8-4cfe-a0b9-3b79e59f1cfe

# Get a list of devices with the hostname foo and a default project configured:
metal device get --filter hostname=foo

Opciones

-h, --help                help for get
-i, --id string           The UUID of a device.
-p, --project-id string   The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

reinicio del dispositivo de metal

Descripción

Reinicia el dispositivo especificado.

metal device reboot -i <device_id> [flags]

Ejemplos

# Reboots the specified device:
metal device reboot --id 26a9da5f-a0db-41f6-8467-827e144e59a7

Opciones

-h, --help        help for reboot
-i, --id string   The device UUID.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

reinstalación del dispositivo de metal

Descripción

Reinstala el dispositivo proporcionado con el sistema operativo actual o con un nuevo sistema operativo con indicadores opcionales para conservar los datos u omitir la limpieza del disco. Se requiere el ID del dispositivo que se va a reinstalar.

metal device reinstall --id <device-id> [--operating-system <os_slug>] [--deprovision-fast] [--preserve-data] [flags]

Ejemplos

# Reinstalls a device with the current OS:
metal device reinstall -d 50382f72-02b7-4b40-ac8d-253713e1e174

# Reinstalls a device with Ubuntu 22.04 while preserving the data on non-OS disks:
metal device reinstall -d 50382f72-02b7-4b40-ac8d-253713e1e174 -O ubuntu_22_04 --preserve-data

Opciones

--deprovision-fast          Avoid optional potentially slow clean-up tasks.
-h, --help                      help for reinstall
-d, --id string                 ID of device to be reinstalled
-O, --operating-system string   Operating system install on the device. If omitted the current OS will be reinstalled.
--preserve-data             Avoid wiping data on disks where the OS is *not* being installed.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

inicio del dispositivo Metal

Descripción

Arranca o enciende un dispositivo que en ese momento está parado o apagado.

metal device start -i <device_id> [flags]

Ejemplos

# Starts the specified device:
metal device start --id 26a9da5f-a0db-41f6-8467-827e144e59a7

Opciones

-h, --help        help for start
-i, --id string   The UUID of the device.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

tope de dispositivo de metal

Descripción

Detiene o apaga un dispositivo que en ese momento esté arrancado o encendido.

metal device stop -i <device_id> [flags]

Ejemplos

# Stops the specified device:
metal device stop --id [device_UUID]

Opciones

-h, --help        help for stop
-i, --id string   The UUID of the device.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

actualización del dispositivo Metal

Descripción

Actualiza el nombre de host de un dispositivo. Actualiza o añade una descripción, etiquetas, datos de usuario, datos personalizados y ajustes de iPXE para un dispositivo ya aprovisionado. También puede bloquear o desbloquear futuros cambios en el dispositivo.

metal device update -i <device_id> [-H <hostname>] [-d <description>] [--locked <boolean>] [-t <tags>] [-u <userdata> | --userdata-file <filepath>] [-c <customdata>] [-s <ipxe_script_url>] [--always-pxe=<true|false>] [flags]

Ejemplos

# Updates the hostname of a device:
metal device update --id 30c15082-a06e-4c43-bfc3-252616b46eba --hostname renamed-staging04

Opciones

-a, --always-pxe               Updates the always_pxe toggle for the device (<true|false>).
-c, --customdata string        Adds or updates custom data to be included with your device's metadata.
-d, --description string       Adds or updates the description for the device.
-h, --help                     help for update
-H, --hostname string          The new hostname of the device.
-i, --id string                The UUID of the device.
-s, --ipxe-script-url string   Add or update the URL of the iPXE script.
-l, --locked                   Locks or unlocks the device for future changes (<true|false>).
-t, --tags strings             Adds or updates the tags for the device --tags="tag1,tag2".
-u, --userdata string          Adds or updates the userdata for the device.
--userdata-file string     Path to a userdata file for device initialization. Can not be used with --userdata.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

evento Metal

Descripción

Información de eventos para organizaciones, proyectos, dispositivos y el usuario actual.

Opciones

-h, --help   help for event

Opciones heredadas de los comandos padre

Véase Opciones comunes.

evento metal get

Descripción

Recupera eventos para el usuario actual, una organización, un proyecto, un dispositivo o los detalles de un evento específico. Los eventos del usuario actual incluyen todos los eventos de todos los proyectos y dispositivos a los que el usuario tiene acceso. Cuando se utilizan los indicadores --json o --yaml, el indicador --include=relationships está implícito.

metal event get [-p <project_id>] | [-d <device_id>] | [-i <event_id>] | [-O <organization_id>] [flags]

Ejemplos

# Retrieve all events of a current user:
metal event get

# Retrieve the details of a specific event:
metal event get -i e9a969b3-8911-4667-9d99-57cd3dd4ef6f

# Retrieve all the events of an organization:
metal event get -o c079178c-9557-48f2-9ce7-cfb927b81928

# Retrieve all events of a project:
metal event get -p 1867ee8f-6a11-470a-9505-952d6a324040

# Retrieve all events of a device:
metal event get -d ca614540-fbd4-4dbb-9689-457c6ccc8353

Opciones

-d, --device-id string         UUID of the device
-h, --help                     help for get
-i, --id string                UUID of the event
-O, --organization-id string   UUID of the organization
-p, --project-id string        Project ID (METAL_PROJECT_ID)

Opciones heredadas de los comandos padre

Véase Opciones comunes.

instalaciones de Metal

Descripción

Información sobre instalaciones específicas. Las operaciones a nivel de instalación han sido sustituidas en su mayor parte por Metros, pero se mantienen por compatibilidad con versiones anteriores. La documentación sobre instalaciones está disponible en /metal/locations/facilities/.

Opciones

-h, --help   help for facilities

Opciones heredadas de los comandos padre

Véase Opciones comunes.

instalaciones de metal consiguen

Descripción

Recupera una lista de las instalaciones disponibles para el usuario actual.

metal facilities get [flags]

Ejemplos

# Lists facilities for current user:
metal facilities get

Opciones

-h, --help   help for get

Opciones heredadas de los comandos padre

Véase Opciones comunes.

pasarela de metal

Descripción

Un Metal Gateway proporciona una única dirección IPv4 como puerta de enlace para una subred. Para obtener más información, visite /metal/networking/metal-gateway/.

Opciones

-h, --help   help for gateway

Opciones heredadas de los comandos padre

Véase Opciones comunes.

pasarela de metal crear

Descripción

Crea un Metal Gateway en la VLAN. Debe especificarse un ID de reserva IP o un tamaño de subred privada.

metal gateway create -p <project_UUID> --virtual-network <virtual_network_UUID> (--ip-reservation-id <ip_reservation_UUID> | --private-subnet-size <size>) [flags]

Ejemplos

# Creates a Metal Gateway on the VLAN with a given IP Reservation ID:
metal gateway create -p $METAL_PROJECT_ID -v 77e6d57a-d7a4-4816-b451-cf9b043444e2 -r 50052f72-02b7-4b40-ac9d-253713e1e178

# Creates a Metal Gateway on the VLAN with a Private 10.x.x.x/28 subnet:
metal gateway create -p $METAL_PROJECT_ID --virtual-network 77e6d57a-d7a4-4816-b451-cf9b043444e2 --private-subnet-size 16

Opciones

-h, --help                        help for create
-r, --ip-reservation-id string    UUID of the Public or VRF IP Reservation to assign.
-s, --private-subnet-size int32   Size of the private subnet to request (8 for /29)
-p, --project-id string           The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-v, --virtual-network string      UUID of the Virtual Network to assign.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

pasarela metal create-bgp-dynamic-neighbors

Descripción

Crea el vecino dinámico BGP para la pasarela Metal con el rango IP y ASN especificados.

metal gateway create-bgp-dynamic-neighbors [flags]

Ejemplos

# Create a BGP Dynamic Neighbor using ip range and asn for the metal gateway id

metal gateways create-bgp-dynamic-neighbor --id "9c56fa1d-ec05-470b-a938-0e5dd6a1540c" --bgp-neighbor-range "10.70.43.226/29" --asn 65000

Opciones

--asn int                     ASN for the BGP Dynamic Neighbor IP range.
--bgp-neighbor-range string   BGP Dynamic Neighbor IP Range from gateway.
-h, --help                        help for create-bgp-dynamic-neighbors
-i, --id string                   Metal Gateway ID for which the BGP Dynamic Neighbor to be created.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal gateway delete

Descripción

Elimina la puerta de enlace especificada con un mensaje de confirmación. Para omitir la confirmación, utilice --force.

metal gateway delete -i <metal_gateway_UUID> [-f] [flags]

Ejemplos

# Deletes a Gateway, with confirmation.
metal gateway delete -i 77e6d57a-d7a4-4816-b451-cf9b043444e2
>
✔ Are you sure you want to delete Metal Gateway 77e6d57a-d7a4-4816-b451-cf9b043444e2 [Y/N]: y

# Deletes a Gateway, skipping confirmation.
metal gateway delete -f -i 77e6d57a-d7a4-4816-b451-cf9b043444e2

Opciones

-f, --force       Skips confirmation for the removal of the Metal Gateway.
-h, --help        help for delete
-i, --id string   UUID of the Gateway.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

pasarela metal delete-bgp-dynamic-neighbors

Descripción

Elimina el vecino dinámico BGP para la pasarela Metal con el ID especificado.

metal gateway delete-bgp-dynamic-neighbors [flags]

Ejemplos

# Deletes a BGP Dynamic Neighbor using the bgp dynamic neighbor ID

$ metal gateways delete-bgp-dynamic-neighbor --id "9c56fa1d-ec05-470b-a938-0e5dd6a1540c"

BGP Dynamic Neighbor deletion initiated. Please check 'metal gateway get-bgp-dynamic-neighbor -i 9c56fa1d-ec05-470b-a938-0e5dd6a1540c for status

Opciones

--bgp-neighbor-id string   UUID of BGP Dynamic Neighbor.
-h, --help                     help for delete-bgp-dynamic-neighbors

Opciones heredadas de los comandos padre

Véase Opciones comunes.

pasarela de metal get

Descripción

Obtiene una lista de todas las VLAN del proyecto especificado.

metal gateway get -p <project_UUID> [flags]

Ejemplos

# Lists Metal Gateways for project 3b0795ba-ec9a-4a9e-83a7-043e7e11407c:
metal gateways get -p 3b0795ba-ec9a-4a9e-83a7-043e7e11407c

Opciones

-h, --help                help for get
-p, --project-id string   The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

pasarela metal get-bgp-dynamic-neighbors

Descripción

Obtiene el vecino dinámico BGP con el ID especificado

metal gateway get-bgp-dynamic-neighbors [flags]

Ejemplos

# Gets a BGP Dynamic Neighbor using the bgp dynamic neighbor ID

$ metal gateways get-bgp-dynamic-neighbor --id "9c56fa1d-ec05-470b-a938-0e5dd6a1540c"

Opciones

--bgp-neighbor-id string   UUID of BGP Dynamic Neighbor ID.
-h, --help                     help for get-bgp-dynamic-neighbors

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal gateway list-bgp-dynamic-neighbors

Descripción

Lista el vecino dinámico BGP para la puerta de enlace Metal con el ID de puerta de enlace especificado.

metal gateway list-bgp-dynamic-neighbors [flags]

Ejemplos

# Lists BGP Dynamic Neighbor for the specified metal gateway ID

$ metal gateways list-bgp-dynamic-neighbor --id "9c56fa1d-ec05-470b-a938-0e5dd6a1540c"

Opciones

-h, --help        help for list-bgp-dynamic-neighbors
-i, --id string   UUID of Metal Gateway.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

ferretería metálica-reserva

Descripción

Información y operaciones sobre reservas de hardware. El aprovisionamiento de dispositivos específicos desde una reserva puede realizarse con el comando metal device. La documentación está disponible en /metal/deploy/reserved/.

Opciones

-h, --help   help for hardware-reservation

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal hardware-reserva get

Descripción

Lista las reservas de hardware de un proyecto o los detalles de una reserva de hardware especificada. Cuando se utilizan las banderas --json o --yaml, la bandera --include=project,facility,device está implícita.

metal hardware-reservation get [-p <project_id>] | [-i <hardware_reservation_id>] [flags]

Ejemplos

# Retrieve all hardware reservations of a project:
metal hardware-reservations get -p $METAL_PROJECT_ID

# Retrieve the details of a specific hardware reservation:
metal hardware-reservations get -i 8404b73c-d18f-4190-8c49-20bb17501f88

Opciones

-h, --help                help for get
-i, --id string           The UUID of a hardware reservation.
-p, --project-id string   A project's UUID.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal hardware-reserva move

Descripción

Mueve una reserva de hardware a un proyecto especificado. Se requieren tanto el ID de la reserva de hardware como el ID del proyecto de destino.

metal hardware-reservation move -i <hardware_reservation_id> -p <project_id> [flags]

Ejemplos

# Moves a hardware reservation to the specified Project:
metal hardware-reservation move -i 8404b73c-d18f-4190-8c49-20bb17501f88 -p 278bca90-f6b2-4659-b1a4-1bdffa0d80b7

Opciones

-h, --help                help for move
-i, --id string           The UUID of the hardware reservation.
-p, --project-id string   The Project ID of the Project you are moving the hardware reservation to.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

interconexiones metálicas

Descripción

Obtenga información sobre las ubicaciones de Metro. Más información en /metal/interconnections.

Opciones

-h, --help   help for interconnections

Opciones heredadas de los comandos padre

Véase Opciones comunes.

interconexiones metálicas crean

Descripción

Crea una nueva interconexión según el ID de la organización o el ID del proyecto.

metal interconnections create -n <name> [-m <metro>] [-r <redundancy> ] [-t <type> ] [-p <project_id> ] | [-O <organization_id> ] [flags]

Ejemplos

# Creates a new interconnection named "it-interconnection":
metal interconnections create -n <name> [-m <metro>] [-r <redundancy>] [-t "dedicated" ] [-p <project_id>] | [-O <organization_id>]

metal interconnections create -n <name> [-m <metro>] [-r <redundancy>] [-t "shared" ] [-p <project_id>] | [-O <organization_id>] -T <service_token_type>

metal interconnections create -n <name> [-m <metro>] [-r <redundancy>] [-t "shared" ] [-p <project_id>] | [-O <organization_id>] -T <service_token_type> -v <vrfs>

Opciones

-h, --help                        help for create
-m, --metro string                Metro Id or Metro Code from where the interconnection will be originated.
-n, --name string                 Name of the interconnection.
--organization-id string      The Organization's UUID to be used for creating org level interconnection request. Either one of this flag or --project-id is required.
-p, --project-id string           The project's UUID. Either one of this flag or --organization-id is required.
-r, --redundancy string           Types of redundancy for the interconnection. Either 'primary' or 'redundant'.
-T, --service-token-type string   Type of service token for shared connection. Enum: 'a_side', 'z_side'.
-s, --speed int32                 The maximum speed of the interconnections. (default 1000000000)
-t, --type string                 Type of of interconnection. Either 'dedicated' or 'shared' when requesting for a Fabric VC.
--vlan int32Slice             A list of VLANs to attach to the Interconnection. Ex: --vlans 1000, 1001 . (default [])
--vrf strings                 A list of VRFs to attach to the Interconnection. Ex: --vrfs uuid1, uuid2 .

Opciones heredadas de los comandos padre

Véase Opciones comunes.

interconexiones de metal suprimir

Descripción

Elimina la interconexión especificada. Utilice --force para omitir la confirmación.

metal interconnections delete -i <connection_id>  [flags]

Ejemplos

# Deletes the specified interconnection:
metal interconnections delete -i 7ec86e23-8dcf-48ed-bd9b-c25c20958277
>
✔ Are you sure you want to delete device 7ec86e23-8dcf-48ed-bd9b-c25c20958277 [Y/n]: Y

Opciones

-f, --force       Skips confirmation for the interconnection deletion.
-h, --help        help for delete
-i, --id string   The UUID of the interconnection.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

interconexiones metálicas consiguen

Descripción

Recupera las interconexiones para el usuario actual, una organización, un proyecto o los detalles de una interconexión específica.

metal interconnections get [flags]

Ejemplos

# Retrieve all interconnections of a current user::

# Retrieve the details of a specific interconnection:
metal interconnections get -i e9a969b3-8911-4667-9d99-57cd3dd4ef6f

# Retrieve all the interconnection of an organization:
metal interconnections get -O c079178c-9557-48f2-9ce7-cfb927b81928

# Retrieve all interconnection of a project:
metal interconnections get -p 1867ee8f-6a11-470a-9505-952d6a324040 

Opciones

-i, --connID string           UUID of the interconnection
-h, --help                    help for get
-O, --organizationID string   UUID of the organization
-p, --projectID string        Project ID (METAL_PROJECT_ID)

Opciones heredadas de los comandos padre

Véase Opciones comunes.

actualización de las interconexiones de metal

Descripción

Actualiza una conexión especificada.

metal interconnections update -i <connection_id> [flags]

Ejemplos

# Updates a specified connection.:
metal interconnections update --id 30c15082-a06e-4c43-bfc3-252616b46eba -n [<name>] -d [<description>] -r [<'redundant'|'primary'>]-m [<standard|tunnel>] -e [<E-mail>] --tags="tag1,tag2"

Opciones

-e, --contactEmail string   adds or updates the Email
-d, --description string    Adds or updates the description for the interconnection.
-h, --help                  help for update
-i, --id string             The UUID of the interconnection.
-m, --mode string           Adds or updates the mode for the interconnection.
-n, --name string           The new name of the interconnection.
-r, --redundancy string     Updating from 'redundant' to 'primary' will remove a secondary port, while updating from 'primary' to 'redundant' will add one.
-t, --tags strings          Adds or updates the tags for the connection --tags="tag1,tag2".

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ip

Descripción

Operaciones con direcciones IP y subredes, incluyendo la solicitud de direcciones IPv4 e IPv6, la asignación y eliminación de IPs a servidores, y la obtención de información sobre subredes y su uso. Más información en /metal/networking/ip-addresses/.

Opciones

-h, --help   help for ip

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ip assign

Descripción

Asigna una dirección IP y una subred a un dispositivo especificado. Devuelve un ID de asignación.

metal ip assign -a <IP_address> -d <device_UUID> [flags]

Ejemplos

# Assigns an IP address to a server:
metal ip assign -d 060d1626-2481-475a-9789-c6f4bb927303  -a 198.51.100.3/31

Opciones

-a, --address string     IP address and CIDR you would like to assign.
-d, --device-id string   The UUID of the device.
-h, --help               help for assign

Opciones heredadas de los comandos padre

Véase Opciones comunes.

ip de metal disponible

Descripción

Lista las direcciones IP disponibles en una reserva especificada para el tamaño de subred deseado.

metal ip available -r <reservation_UUID> -c <size_of_subnet> [flags]

Ejemplos

# Lists available IP addresses in a reservation for a /31 subnet:
metal ip available --reservation-id da1bb048-ea6e-4911-8ab9-b95635ca127a --cidr 31

Opciones

-c, --cidr int                The size of the desired subnet in bits.
-h, --help                    help for available
-r, --reservation-id string   The UUID of the IP address reservation.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ip get

Descripción

Recupera información sobre las direcciones IP de un proyecto, las direcciones IP que están en una asignación especificada o las direcciones IP que están en una reserva especificada.

metal ip get -p <project-id> | -a <assignment-id> | -r <reservation-id> [flags]

Ejemplos

# Lists all IP addresses in a project:
metal ip get -p bb73aa19-c216-4ce2-a613-e5ca93732722 

# Gets information about the IP addresses from an assignment ID:
metal ip get -a bb526d47-8536-483c-b436-116a5fb72235

# Gets the IP addresses from a reservation ID:
metal ip get -r da1bb048-ea6e-4911-8ab9-b95635ca127a

Opciones

-a, --assignment-id string    UUID of an IP address assignment. When you assign an IP address to a server, it gets an assignment UUID.
-h, --help                    help for get
-p, --project-id string       A Project UUID (METAL_PROJECT_ID).
-r, --reservation-id string   UUID of an IP address reservation.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ip remove

Descripción

Elimina una reserva de dirección IP de un proyecto. Los dispositivos ya no podrán utilizar las subredes ni las direcciones IP de la reserva.

metal ip remove -i <reservation_UUID> [flags]

Ejemplos

# Removes an IP address reservation:
metal ip remove --id a9dfc9d5-ba1a-4d11-8cfc-6e30b9630876

Opciones

-h, --help        help for remove
-i, --id string   UUID of the reservation

Opciones heredadas de los comandos padre

Véase Opciones comunes.

solicitud ip de metal

Descripción

Solicita un bloque de direcciones IPv4 públicas o direcciones IPv4 globales para tu proyecto en un metro o instalación concretos.

metal ip request -p <project-id> -t <ip_address_type> -q <quantity> (-m <metro> | -f <facility>) [-f <flags>] [-c <comments>] [flags]

Ejemplos

# Requests a block of 4 public IPv4 addresses in Dallas:
metal ip request -p $METAL_PROJECT_ID -t public_ipv4 -q 4 -m da

metal ip request -v df18fbd8-2919-4104-a042-5d42a05b8eed -t vrf --cidr 24 -n 172.89.1.0 --tags foo --tags bar --customdata '{"my":"goodness"}' --details "i don't think VRF users need this or will see it after submitting the request"

Opciones

--cidr int            The size of the desired subnet in bits.
-c, --comments string     General comments or description.
--customdata string   customdata is to add to the reservation, in a comma-separated list.
--details string      VRF IP Reservation's details
-f, --facility string     Code of the facility where the IP Reservation will be created
-h, --help                help for request
-m, --metro string        Code of the metro where the IP Reservation will be created
-n, --network string      The starting address for this VRF IP Reservation's subnet
-p, --project-id string   The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-q, --quantity int        Number of IP addresses to reserve.
--tags strings        Adds the tags for the IP Reservations --tags "tag1,tag2" OR --tags "tag1" --tags "tag2"
-t, --type string         The type of IP Address, either public_ipv4 or global_ipv4.
-v, --vrf-id string       Specify the VRF UUID.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ip unassign

Descripción

Desasigna una asignación de subred y dirección IP de un dispositivo por su ID de asignación.

metal ip unassign -i <assignment_UUID>  [flags]

Ejemplos

# Unassigns an IP address assignment:
metal ip unassign --id abd8674b-96c4-4271-92f5-2eaf5944c86f

Opciones

-h, --help        help for unassign
-i, --id string   The UUID of the assignment.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metros de metal

Descripción

Infórmese sobre las ubicaciones de Metro. Más información en /metal/locations/metros/.

Opciones

-h, --help   help for metros

Opciones heredadas de los comandos padre

Véase Opciones comunes.

METALES DE METAL

Descripción

Recupera una lista de metros disponibles para el usuario actual.

metal metros get [flags]

Ejemplos

# Lists metros available to the current user:	
metal metros get

Opciones

-h, --help   help for get

Opciones heredadas de los comandos padre

Véase Opciones comunes.

sistemas operativos Metal

Descripción

Información sobre los sistemas operativos disponibles. Para obtener más información sobre los sistemas operativos que ofrece Equinix Metal, visite /metal/operating-systems/supported/.

Opciones

-h, --help   help for operating-systems

Opciones heredadas de los comandos padre

Véase Opciones comunes.

sistemas operativos metal get

Descripción

Obtiene una lista de los sistemas operativos disponibles para el usuario actual. La respuesta incluye el slug, la distribución, la versión y el nombre del sistema operativo.

metal operating-systems get [flags]

Ejemplos

# Lists the operating systems available to the current user:
metal operating-systems get

Opciones

-h, --help   help for get

Opciones heredadas de los comandos padre

Véase Opciones comunes.

organización del metal

Descripción

Información y gestión de la configuración a nivel de organización. La documentación sobre organizaciones se encuentra en /metal/identity-access-management/organizations/.

Opciones

-h, --help   help for organization

Opciones heredadas de los comandos padre

Véase Opciones comunes.

organización del metal crear

Descripción

Crea una nueva organización con el usuario actual como propietario de la organización.

metal organization create -n <name> [-d <description>] [-w <website_URL>] [-t <twitter_URL>] [-l <logo_URL>] [flags]

Ejemplos

# Creates a new organization named "it-backend-infra": 
metal organization create -n it-backend-infra

# Creates a new organization with name, website, and twitter:
metal organization create -n test-org -w www.metal.equinix.com -t https://twitter.com/equinixmetal 

Opciones

-d, --description string   Description of the organization.
-h, --help                 help for create
-l, --logo string          A Logo image URL.]
-n, --name string          Name of the organization.
-t, --twitter string       Twitter URL of the organization.
-w, --website string       Website URL of the organization.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

organización del metal suprimir

Descripción

Elimina una organización. No puede eliminar una organización que contenga proyectos o tenga cargos pendientes. Sólo los propietarios de una organización pueden eliminarla.

metal organization delete -i <organization_UUID> [flags]

Ejemplos

# Deletes an organization, with confirmation: 
metal organization delete -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8
>
✔ Are you sure you want to delete organization 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 [Y/N]: y

# Deletes an organization, skipping confirmation:
metal organization delete -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 -f

Opciones

-f, --force                    Skips confirmation for the removal of the organization.
-h, --help                     help for delete
-i, --organization-id string   The UUID of the organization.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

organización del metal get

Descripción

Recupera una lista de organizaciones o los detalles de la organización especificada. Los datos de una organización sólo están disponibles para sus miembros.

metal organization get -i <organization_UUID> [flags]

Ejemplos

# Retrieves list of the current user's organizations:
metal organization get

# Retrieves details of an organization:
metal organization get -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8

Opciones

-h, --help                     help for get
-i, --organization-id string   The UUID of an organization.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

organización del metal métodos de pago

Descripción

Recupera una lista de métodos de pago para la organización especificada si el usuario actual es un miembro con el rol apropiado.

metal organization payment-methods -i <organization_UUID> [flags]

Ejemplos

# Lists the payment methods for an organization:
metal organization payment-methods --id 3bd5bf07-6094-48ad-bd03-d94e8712fdc8

Opciones

-h, --help        help for payment-methods
-i, --id string   The UUID of the organization.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

actualización de la organización del metal

Descripción

Actualiza la organización especificada. Puedes actualizar el nombre, el sitio web, Twitter o el logotipo.

metal organization update -i <organization_UUID> [-n <name>] [-d <description>] [-w <website_URL>] [-t <twitter_URL>] [-l <logo_URL>] [flags]

Ejemplos

# Updates the name of an organization:
metal organization update -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 --name test-cluster02

Opciones

-d, --description string   User-friendly description of the organization.
-h, --help                 help for update
-i, --id string            An organization UUID.
-l, --logo string          A logo image URL for the organization.
-n, --name string          New name for the organization.
-t, --twitter string       A Twitter URL of the organization.
-w, --website string       A website URL for the organization.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

plan de metal

Descripción

Información sobre planes de servidores. Para obtener más información sobre los distintos servidores Equinix Metal, visite /metal/hardware/standard-servers/.

Opciones

-h, --help   help for plan

Opciones heredadas de los comandos padre

Véase Opciones comunes.

plan de metal get

Descripción

Recupera una lista de planes disponibles para el usuario actual. La respuesta incluye UUID, slug y nombre del plan.

metal plan get [flags]

Ejemplos

# Lists the plans available to the current user:
metal plans get

Opciones

-h, --help   help for get

Opciones heredadas de los comandos padre

Véase Opciones comunes.

puerto de metal

Descripción

Información y operaciones para convertir puertos entre modos de red y gestionar las asignaciones de VLAN a los puertos. Para obtener más información sobre los distintos modos, puertos y VLAN, visite /metal/layer2-networking/overview/.

Opciones

-h, --help   help for port

Opciones heredadas de los comandos padre

Véase Opciones comunes.

puerto de metal convertido

Descripción

Convierte una lista de puertos o los detalles del puerto especificado. Los detalles de un puerto sólo están disponibles para sus miembros.

metal port convert -i <port_UUID> [--bonded] [--bulk] --layer2 [--force] [--public-ipv4] [--public-ipv6] [flags]

Ejemplos

# Converts list of the current user's ports:
metal port convert -i <port_UUID> [--bonded] [--bulk] [--layer2] [--force] [--public-ipv4] [--public-ipv6]

# Converts port to layer-2 unbonded:
metal port convert -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 --layer2 --bonded=false

# Converts port to layer-2 bonded:
metal port convert -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 --layer2 --bonded

# Converts port to layer-3 bonded with public IPv4 and public IPv6:
metal port convert -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 -2=false -b -4 -6

Opciones

-b, --bonded           Convert to layer-2 bonded.
--bulk             Affect both ports in a bond.
-f, --force            Force conversion to layer-2 bonded.
-h, --help             help for convert
-2, --layer2           Convert to layer-2 unbonded.
-i, --port-id string   The UUID of a port.
-4, --public-ipv4      Convert to layer-2 bonded with public IPv4.
-6, --public-ipv6      Convert to layer-2 bonded with public IPv6.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

puerto de metal get

Descripción

Recupera los detalles del puerto especificado. Los detalles de un puerto sólo están disponibles para sus miembros.

metal port get -i <port_UUID> [flags]

Ejemplos

# Retrieves details of a port:
metal port get -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8

Opciones

-h, --help             help for get
-i, --port-id string   The UUID of a port.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal port vlan

Descripción

Modifica las VLAN del puerto especificado al estado deseado. El estado existente se puede restablecer sin error.

metal port vlan -i <port_UUID> [--native <vlan>] [--unassign <vlan>]... [--assign <vlan>]... [flags]

Ejemplos

# Assigns VLANs 1234 and 5678 to the port:
metal port vlans -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 -a 1234 -a 5678

# Unassigns VXLAN 1234 from the port:
metal port vlans -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 -u 1234

# Assigns VXLAN 1234 to the port and makes it the Native VLAN:
metal port vlans -i 3bd5bf07-6094-48ad-bd03-d94e8712fdc8 --native=1234

Opciones

-a, --assign strings     A VXLAN to assign to the port. May also be used to change a Native VLAN assignment to tagged (non-native).
-h, --help               help for vlan
-n, --native string      The VXLAN to make assign as the Native VLAN
-i, --port-id string     The UUID of a port.
-u, --unassign strings   A VXLAN to unassign from a port.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

proyecto Metal

Descripción

Información y gestión para Proyectos y BGP a nivel de Proyecto. La documentación sobre Proyectos está en /metal/projects/creating-a-project/, y la documentación sobre BGP está en /metal/bgp/bgp-on-equinix-metal/.

Opciones

-h, --help   help for project

Opciones heredadas de los comandos padre

Véase Opciones comunes.

proyecto metal bgp-config

Descripción

Obtiene la configuración BGP de un proyecto.

metal project bgp-config --project-id <project_UUID> [flags]

Ejemplos

metal project bgp-config --project-id 50693ba9-e4e4-4d8a-9eb2-4840b11e9375 -d 

Opciones

-h, --help                help for bgp-config
-p, --project-id string   Project ID (METAL_PROJECT_ID)

Opciones heredadas de los comandos padre

Véase Opciones comunes.

proyecto metal bgp-enable

Descripción

Activa BGP en un proyecto.

metal project bgp-enable --project-id <project_UUID> --deployment-type <deployment_type> [--asn <asn>] [--md5 <md5_secret>] [--use-case <use_case>] [flags]

Ejemplos

metal project bgp-enable --project-id 50693ba9-e4e4-4d8a-9eb2-4840b11e9375 --deployment-type local --asn 65000

Opciones

--asn int                  Local ASN (default 65000)
--deployment-type string   Deployment type (local, global)
-h, --help                     help for bgp-enable
--md5 string               BGP Password
-p, --project-id string        Project ID (METAL_PROJECT_ID)
--use-case string          Use case for BGP

Opciones heredadas de los comandos padre

Véase Opciones comunes.

proyecto Metal bgp-sessions

Descripción

Obtiene Sesiones BGP para un proyecto.

metal project bgp-sessions --project-id <project_UUID> [flags]

Ejemplos

metal project bgp-sessions --project-id 50693ba9-e4e4-4d8a-9eb2-4840b11e9375

Opciones

-h, --help                help for bgp-sessions
-p, --project-id string   Project ID (METAL_PROJECT_ID)

Opciones heredadas de los comandos padre

Véase Opciones comunes.

proyecto metal create

Descripción

Crea un proyecto con el nombre especificado. Si no se especifica ninguna organización, el proyecto se crea en la organización por defecto del usuario actual. Si no se especifica ningún método de pago, se utilizará el método de pago por defecto de la organización.

metal project create -n <project_name> [-O <organization_UUID>] [-m <payment_method_UUID>] [flags]

Ejemplos

# Creates a new project named dev-cluster02: 
metal project create --name dev-cluster02

# Creates a new project named dev-cluster03 in the specified organization with a payment method:
metal project create -n dev-cluster03 -O 814b09ca-0d0c-4656-9de0-4ce65c6faf70 -m ab1fbdaa-8b25-4c3e-8360-e283852e3747

Opciones

-h, --help                       help for create
-n, --name string                Name of the project
-O, --organization-id string     The UUID of the organization.
-m, --payment-method-id string   The UUID of the payment method.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

proyecto metal suprimir

Descripción

Elimina el proyecto especificado con un mensaje de confirmación. Para omitir la confirmación utilice --force. No puede eliminar un proyecto que tenga recursos activos. Tiene que desprovisionar todos los servidores y demás infraestructura de un proyecto para poder eliminarlo.

metal project delete --id <project_UUID> [--force] [flags]

Ejemplos

# Deletes project 50693ba9-e4e4-4d8a-9eb2-4840b11e9375:
metal project delete -i 50693ba9-e4e4-4d8a-9eb2-4840b11e9375
>
✔ Are you sure you want to delete project 50693ba9-e4e4-4d8a-9eb2-4840b11e9375 [Y/N]: y

# Deletes project 50693ba9-e4e4-4d8a-9eb2-4840b11e9375, skipping confirmation:
metal project delete -i 50693ba9-e4e4-4d8a-9eb2-4840b11e9375 -f

Opciones

-f, --force       Force removal of the project
-h, --help        help for delete
-i, --id string   The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

proyecto metal get

Descripción

Recupera todos los proyectos del usuario actual o los detalles de un proyecto especificado. Puede especificar qué proyecto por UUID o por nombre. Cuando se utilizan las banderas --json o --yaml, la bandera --include=members está implícita.

metal project get [-i <project_UUID> | -n <project_name>] [flags]

Ejemplos

# Retrieve all projects:
metal project get

# Retrieve a specific project by UUID: 
metal project get -i 2008f885-1aac-406b-8d99-e6963fd21333

# Retrieve a specific project by name:
metal project get -n dev-cluster03

Opciones

-h, --help             help for get
-i, --id string        The project's UUID, which can be specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-n, --project string   The name of the project.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

actualización del proyecto Metal

Descripción

Actualiza el proyecto especificado con un nuevo nombre, un nuevo método de pago o ambos.

metal project update -i <project_UUID> [-n <name>] [-m <payment_method_UUID>] [flags]

Ejemplos

# Updates the specified project with a new name:
metal project update -i $METAL_PROJECT_ID -n new-prod-cluster05

# Updates the specified project with a new payment method:
metal project update -i $METAL_PROJECT_ID -m e2fcdf91-b6dc-4d6a-97ad-b26a14b66839

Opciones

-h, --help                       help for update
-i, --id string                  The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-n, --name string                The new name for the project.
-m, --payment-method-id string   The UUID of the new payment method.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ssh-key

Descripción

Operaciones de claves SSH para gestionar claves SSH en cuentas de usuario y proyectos. Las claves añadidas a una cuenta o proyecto se añaden a los servidores en el momento de la provisión. La documentación está disponible en /metal/identity-access-management/ssh-keys/.

Opciones

-h, --help   help for ssh-key

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ssh-key create

Descripción

Añade una clave SSH para la cuenta del usuario actual. La clave se añadirá a los servidores del usuario en el momento de la provisión.

metal ssh-key create --key <public_key> --label <label> [flags]

Ejemplos

# Adds a key labled "example-key" to the current user account.
metal ssh-key create --key ssh-rsa AAAAB3N...user@domain.com --label example-key

Opciones

-h, --help           help for create
-k, --key string     User's full SSH public key string.
-l, --label string   Name or other user-friendly description of the SSH key.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ssh-key delete

Descripción

Elimina una clave SSH con un mensaje de confirmación. Para omitir la confirmación utilice --force. No elimina la clave SSH de los servidores existentes.

metal ssh-key delete --id <SSH-key_UUID> [--force] [flags]

Ejemplos

# Deletes an SSH key, with confirmation:
metal ssh-key delete -i 5cb96463-88fd-4d68-94ba-2c9505ff265e
>
✔ Are you sure you want to delete SSH Key 5cb96463-88fd-4d68-94ba-2c9505ff265e [Y/N]: y

# Deletes an SSH key, skipping confirmation:
metal ssh-key delete -i 5cb96463-88fd-4d68-94ba-2c9505ff265e -f

Opciones

-f, --force       Skips confirmation for the deletion of the SSH key.
-h, --help        help for delete
-i, --id string   The UUID of the SSH key.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ssh-key get

Descripción

Recupera una lista de claves SSH asociadas a la cuenta del usuario actual o los detalles de una única clave SSH.

metal ssh-key get [-i <SSH-key_UUID>] [-P] [-p <project_id>] [flags]

Ejemplos

# Retrieves the SSH keys of the current user: 
metal ssh-key get

# Returns the details of SSH key 5cb96463-88fd-4d68-94ba-2c9505ff265e:
metal ssh-key get --id 5cb96463-88fd-4d68-94ba-2c9505ff265e

# Retrieve all project SSH keys
metal ssh-key get --project-ssh-keys --project-id [project_UUID]

Opciones

-h, --help                help for get
-i, --id string           The UUID of an SSH key.
-p, --project-id string   List SSH Keys for the project identified by Project ID (ignored without -P)
-P, --project-ssh-keys    List SSH Keys for projects

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal ssh-key update

Descripción

Actualiza una clave SSH con una nueva clave pública, una nueva etiqueta o ambas.

metal ssh-key update -i <SSH-key_UUID> [-k <public_key>] [-l <label>] [flags]

Ejemplos

# Updates SSH key 5cb96463-88fd-4d68-94ba-2c9505ff265e with a new public key: 
metal ssh-key update -i 5cb96463-88fd-4d68-94ba-2c9505ff265e -k AAAAB3N...user@domain.com

# Updates SSH key 5cb96463-88fd-4d68-94ba-2c9505ff265e with a new label:
metal ssh-key update -i 5cb96463-88fd-4d68-94ba-2c9505ff265e -l test-machine-2

Opciones

-h, --help           help for update
-i, --id string      UUID of the SSH key
-k, --key string     Public SSH key string
-l, --label string   Name of the SSH key

Opciones heredadas de los comandos padre

Véase Opciones comunes.

usuario de Metal

Descripción

Añadir usuarios u obtener sus datos. Para obtener más información sobre la gestión de usuarios y cuentas, visite /metal/identity-access-management/users/ en la documentación de Equinix Metal.

Opciones

-h, --help   help for user

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal user add

Descripción

Añade un usuario, por correo electrónico, a la organización o proyecto especificado por la opción --organization-id o --project-id. Al usuario se le asignarán las funciones especificadas en la opción --roles.

metal user add --email <email> --roles <roles> [--organization-id <organization_id>] [--project-id <project_id>] [flags]

Ejemplos

# Adds a user to a project with admin role:
metal user add --email user@example.org --roles admin --project-id 3b0795ba-fd0b-4a9e-83a7-063e5e12409d

Opciones

--email string             Email of the user.
-h, --help                     help for add
--organization-id string   Organization to invite the user to.
-p, --project-id strings       Projects to invite the user to with the specified roles.
--roles strings            Roles to assign to the user.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal user get

Descripción

Devuelve información sobre el usuario actual o sobre un usuario especificado. La información del usuario especificado sólo está disponible si ese usuario comparte un proyecto con el usuario actual.

metal user get [-i <user_UUID>] [flags]

Ejemplos

# Retrieves the current user's information:
metal user get

# Returns information on user 3b0795ba-fd0b-4a9e-83a7-063e5e12409d:
metal user get --i 3b0795ba-fd0b-4a9e-83a7-063e5e12409d

Opciones

-h, --help        help for get
-i, --id string   UUID of the user.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

circuito virtual de metal

Descripción

Más información en /metal/interconnections.

Opciones

-h, --help   help for virtual-circuit

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal virtual-circuit create

Descripción

Crea un create-virtual-circuit para una interconexión específica

metal virtual-circuit create  [-c connection_id] [-p port_id] [-P <project_id> ] -n <name> [-d <description>] [--vnid <vnid> ] [-V <vlan> ] [-s <speed> ] [-t <tags> ] [flags]

Ejemplos

# Creates a new virtual-circuit named "interconnection": 
metal vc create [-c connection_id] [-p port_id] [-P <project_id> ] [-n <name>] [-d <description>] [--vnid <vnid> ] [-V <vlan> ] [-s <speed> ] [-t <tags> ]

metal vc create -c 81c9cb9e-b02f-4c73-9e04-06702f1380a0 -p 9c8f0c71-591d-42fe-9519-2f632761e2da -P b4673e33-0f48-4948-961a-c31d6edf64f8 -n test-inter  -d test-interconnection -v 15315810-2fda-48b8-b8cd-441ebab684b5 -V 1010 -s 100

metal vc create [-c connection_id] [-p port_id] [-P <project_id> ] [-n <name>] [-d <description>] [-v <vrf-id>] [-M <md5sum>] [-a <peer-asn>] [-S <subnet>] [-c <customer_ip>] [-m <metal_ip>]

Opciones

-c, --connection-id string   Specify the UUID of the interconnection.
--customer-ip string     An IP address from the subnet that will be used on the Customer side
-d, --description string     Description for a Virtual Circuit
-h, --help                   help for create
-M, --md5 string             The plaintext BGP peering password shared by neighbors as an MD5 checksum
-m, --metal-ip string        An IP address from the subnet that will be used on the Metal side. 
-n, --name string            Name of the Virtual Circuit
-a, --peer-asn int           The peer ASN that will be used with the VRF on the Virtual Circuit.
-p, --port-id string         Specify the UUID of the port.
-P, --project-id string      The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-s, --speed int              bps speed or string (e.g. 52 - '52m' or '100g' or '4 gbps')
-S, --subnet string          The /30 or /31 subnet of one of the VRF IP Blocks that will be used with the VRF for the Virtual Circuit. 
-t, --tags strings           Adds the tags for the virtual-circuit --tags "tag1,tag2" OR --tags "tag1" --tags "tag2"
-V, --vlan int               Adds or updates vlan  Must be between 2 and 4094
--vnid string            Specify the UUID  of the VLAN.
-v, --vrf-id string          The UUID of the VRF that will be associated with the Virtual Circuit.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal virtual-circuit delete

Descripción

Elimina el circuito virtual especificado.

metal virtual-circuit delete -i <virtual-circuit_id>  [flags]

Ejemplos

# Deletes the specified virtual-circuit:
metal vc delete -i 7ec86e23-8dcf-48ed-bd9b-c25c20958277

Opciones

-h, --help        help for delete
-i, --id string   Specify the UUID of the virtual-circuit.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal virtual-circuit get

Descripción

Recupera el circuito virtual para un Id de circuito específico.

metal virtual-circuit get -i <id> [flags]

Ejemplos

# Retrieve virtual circuit for a specific circuit::

# Retrieve the details of a specific virtual-circuit:
metal vc get -i e9a969b3-8911-4667-9d99-57cd3dd4ef6f

Opciones

-h, --help        help for get
-i, --id string   Specify UUID of the virtual-circuit

Opciones heredadas de los comandos padre

Véase Opciones comunes.

actualización del circuito virtual de Metal

Descripción

Actualiza un etiher virtualcircuit especificado de vlanID OR vrfID

metal virtual-circuit update -i <id> [-v <vlan UUID>] [-d <description>] [-n <name>] [-s <speed>] [-t <tags>] [flags]

Ejemplos

# Updates a specified virtualcircuit etiher of vlanID OR vrfID:

metal vc update [-i <id>] [-n <name>] [-d <description>] [-v <vnid> ] [-s <speed> ] [-t <tags> ]

metal vc update -i e2edb90b-a8ef-47cb-a577-63b0ba129c29 -d "test-inter-fri-dedicated"

metal vc update [-i <id>] [-n <name>] [-d <description>] [-M <md5sum>] [-a <peer-asn>] [-S <subnet>] [-c <customer-ip>] [-m <metal-ip>] [-t <tags> ]

Opciones

-c, --customer-ip string   An IP address from the subnet that will be used on the Customer side
-d, --description string   Description for a Virtual Circuit
-h, --help                 help for update
-i, --id string            Specify the UUID of the virtual-circuit.
-M, --md5 string           The plaintext BGP peering password shared by neighbors as an MD5 checksum
-m, --metal-ip string      An IP address from the subnet that will be used on the Metal side. 
-n, --name string          Name of the Virtual Circuit
-a, --peer-asn int         The peer ASN that will be used with the VRF on the Virtual Circuit.
-s, --speed string         Adds or updates Speed can be changed only if it is an interconnection on a Dedicated Port
-S, --subnet string        The /30 or /31 subnet of one of the VRF IP Blocks that will be used with the VRF for the Virtual Circuit. 
-t, --tags strings         updates the tags for the virtual circuit --tags "tag1,tag2" OR --tags "tag1" --tags "tag2" (NOTE: --tags "" will remove all tags from the virtual circuit
-v, --vnid string          A Virtual Network record UUID or the VNID of a Metro Virtual Network in your project.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

red virtual de metal

Descripción

Gestión de redes virtuales en un proyecto. La asignación de VLAN a los puertos de un servidor está disponible a través del comando ports. Para obtener más información sobre cómo funcionan las VLAN en Equinix Metal, visite /metal/layer2-networking/vlans/.

Opciones

-h, --help   help for virtual-network

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal virtual-network create

Descripción

Crea una VLAN en el proyecto especificado. Si crea una VLAN en un metro, puede especificar opcionalmente el ID de VXLAN; de lo contrario, se asigna automáticamente. Si crea una VLAN en una instalación, el ID de VXLAN se asigna automáticamente.

metal virtual-network create -p <project_UUID>  [-m <metro_code> -vxlan <vlan> | -f <facility_code>] [-d <description>] [flags]

Ejemplos

# Creates a VLAN with vxlan ID 1999 in the Dallas metro:
metal virtual-network create -p $METAL_PROJECT_ID -m da --vxlan 1999

# Creates a VLAN in the sjc1 facility
metal virtual-network create -p $METAL_PROJECT_ID -f sjc1

Opciones

-d, --description string   A user-friendly description of the virtual network.
-f, --facility string      Code of the facility.
-h, --help                 help for create
-m, --metro string         Code of the metro.
-p, --project-id string    The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
--vxlan int            Optional VXLAN ID. Must be between 2 and 3999 and can only be used with --metro.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal virtual-network delete

Descripción

Elimina la VLAN especificada con un mensaje de confirmación. Para omitir la confirmación, utilice --force. No es posible eliminar una VLAN que esté conectada a algún puerto.

metal virtual-network delete -i <virtual_network_UUID> [-f] [flags]

Ejemplos

# Deletes a VLAN, with confirmation.
metal virtual-network delete -i 77e6d57a-d7a4-4816-b451-cf9b043444e2
>
✔ Are you sure you want to delete virtual network 77e6d57a-d7a4-4816-b451-cf9b043444e2 [Y/N]: y

# Deletes a VLAN, skipping confirmation.
metal virtual-network delete -f -i 77e6d57a-d7a4-4816-b451-cf9b043444e2

Opciones

-f, --force       Skips confirmation for the removal of the virtual network.
-h, --help        help for delete
-i, --id string   UUID of the VLAN.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal red virtual get

Descripción

Obtiene una lista de todas las VLAN del proyecto especificado.

metal virtual-network get -p <project_UUID> [flags]

Ejemplos

# Lists virtual networks for project 3b0795ba-ec9a-4a9e-83a7-043e7e11407c:
metal virtual-network get -p 3b0795ba-ec9a-4a9e-83a7-043e7e11407c

Opciones

-h, --help                help for get
-p, --project-id string   The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

vrf de metal

Descripción

Operaciones VRF : Define una colección de bloques IP gestionados por el cliente que pueden utilizarse en peering BGP en una o más redes virtuales y operaciones básicas.

Opciones

-h, --help   help for vrf

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf create

Descripción

Crea un VRF (Virtual Routing and Forwarding) para un proyecto específico.

metal vrf create [-p <project_id] [-d <description>] [-m <metro>] [-n <name>] [-a <localASN>] [-r <IPranges>] [-t <tags> ] [flags]

Ejemplos

# Creates an Creates a Virtual Routing and Forwarding(VRF) for a specified project.

metal vrf create [-p <project_id] [-d <description>] [-m <metro>] [-n <name>] [-a <localASN>] [-r <ipranges>] [-t <tags> ]

Opciones

-d, --description string   Description of the Virtual Routing and Forwarding.
-h, --help                 help for create
-r, --ipranges strings     A list of CIDR network addresses. Like [10.0.0.0/16, 2001:d78::/56]. IPv4 blocks must be between /8 and /29 in size. IPv6 blocks must be between /56 and /64.
-a, --local-asn int        Local ASN for the VRF
-m, --metro string         The UUID (or metro code) for the Metro in which to create this Virtual Routing and Forwarding
-n, --name string          Name of the Virtual Routing and Forwarding
-p, --project-id string    The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-t, --tags strings         Adds the tags for the virtual-circuit --tags "tag1,tag2" OR --tags "tag1" --tags "tag2"

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf create-route

Descripción

Crear una ruta en una VRF. Actualmente sólo se admiten rutas estáticas por defecto.

metal vrf create-route [-i <VrfId>] [-p <Prefix>] [-n NextHop] [-t <tags> ] [flags]

Ejemplos

# Create a route in a VRF. Currently only static default routes are supported.

metal vrf create-route [-i <VrfID>] [-p <prefix>] [-n nextHop] [-t <tags> ]

Opciones

-h, --help             help for create-route
-i, --id string        Specify the VRF UUID activate route configurations
-n, --nextHop string   The IPv4 address within the VRF of the host that will handle this route
-p, --prefix string    The IPv4 prefix for the route, in CIDR-style notation. For a static default route, this will always be '0.0.0.0/0'
-t, --tags strings     Adds the tags for the connection --tags="tag1,tag2".

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf delete

Descripción

Elimina el VRF especificado con un mensaje de confirmación. Para omitir la confirmación, utilice --force.

metal vrf delete vrf -i <metal_vrf_UUID> [-f] [flags]

Ejemplos

# Deletes a VRF, with confirmation.
metal delete vrf -i 77e6d57a-d7a4-4816-b451-cf9b043444e2
>
✔ Are you sure you want to delete device 7ec86e23-8dcf-48ed-bd9b-c25c20958277 [Y/N]: y

# Deletes a VRF, skipping confirmation.
metal delete vrf -f -i 77e6d57a-d7a4-4816-b451-cf9b043444e2

Opciones

-f, --force       Skips confirmation for the removal of the VRF.
-h, --help        help for delete
-i, --id string   Specify the UUID of the VRF

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf delete-route

Descripción

Borrar una ruta VRF

metal vrf delete-route [-i <VrfRoute-Id>] [flags]

Ejemplos

# Delete a VRF Route
metal vrf delete-route -i 77e6d57a-d7a4-4816-b451-cf9b043444e2
>
✔ Are you sure you want to delete device 7ec86e23-8dcf-48ed-bd9b-c25c20958277 [Y/N]: y

# Deletes a VRF, skipping confirmation.
metal vrf delete-route -f -i 77e6d57a-d7a4-4816-b451-cf9b043444e2

Opciones

-f, --force       Skips confirmation for the removal of the VRF routes.
-h, --help        help for delete-route
-i, --id string   Specify the VRF UUID to delete the associated route configurations.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf get

Descripción

Recupera una lista de todos los VRF del proyecto especificado o los detalles del ID de VRF especificado. Se requiere un ID de proyecto o un ID de VRF.

metal vrf get -p <project_Id>  [flags]

Ejemplos

# Gets the details of the specified device
metal vrf get -v 3b0795ba-ec9a-4a9e-83a7-043e7e11407c

# Lists VRFs for project 3b0795ba-ec9a-4a9e-83a7-043e7e11407c:
metal vrf list -p 3b0795ba-ec9a-4a9e-83a7-043e7e11407c

Opciones

-h, --help                help for get
-m, --metro string        Filter by Metro ID (uuid) or Metro Code
-p, --project-id string   The project's UUID. This flag is required, unless specified in the config created by metal init or set as METAL_PROJECT_ID environment variable.
-v, --vrf-id string       Specify the VRF UUID.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf get-route

Descripción

Recuperar todas las rutas en la VRF

metal vrf get-route [-i <VrfRoute-Id>] [flags]

Ejemplos

# Retrieve all routes in the VRF
metal vrf get-route -i bb526d47-8536-483c-b436-116a5fb72235

Opciones

-h, --help        help for get-route
-i, --id string   Specify the VRF UUID to list its associated routes configurations

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf ips

Descripción

Recupera la lista de VRF IP Reservations para el VRF.

metal vrf ips [-v <vrf-id] [-i <ip-id>] [flags]

Ejemplos

# Retrieves the list of VRF IP Reservations for the VRF.
metal vrf ips [-v <vrf-id] 

# Retrieve a specific IP Reservation for a VRF
metal vrf ips [-v <vrf-id] [-i <ip-id>]

Opciones

-h, --help            help for ips
-i, --id string       Specify the IP UUID to retrieve the details of a VRF IP reservation.
-v, --vrf-id string   Specify the VRF UUID to list its associated IP reservations.

Opciones heredadas de los comandos padre

Véase Opciones comunes.

metal vrf update-route

Descripción

Solicita la redistribución/actualización de una ruta VRF en la red.

metal vrf update-route [-i <VrfRoute-Id>] [-p <Prefix>] [-n NextHop] [-t <tags> ] [flags]

Ejemplos

# Requests a VRF Route be redeployed/update across the network.
metal vrf update-route [-i <VrfID>] [-p <prefix>] [-n nextHop] [-t <tags> ]

Opciones

-h, --help             help for update-route
-i, --id string        Specify the VRF UUID to update the associated route configurations.
-n, --nextHop string   Name of the Virtual Routing and Forwarding
-p, --prefix string    The IPv4 prefix for the route, in CIDR-style notation. For a static default route, this will always be '0.0.0.0/0'
-t, --tags strings     updates the tags for the Virtual Routing and Forwarding --tags "tag1,tag2" OR --tags "tag1" --tags "tag2" (NOTE: --tags "" will remove all tags from the Virtual Routing and Forwarding

Opciones heredadas de los comandos padre

Véase Opciones comunes.