Uso de puntos de conexión en la AWS CLI - AWS Command Line Interface
Establecer punto de conexión para un solo comandoEstablecer un punto de conexión global para todos los Servicios de AWSEstablecer para usar los puntos de conexión de FIPS para todos los Servicios de AWSEstablecer para utilizar los puntos de conexión de doble pila para todos los Servicios de AWSEstablecer puntos de conexión específicos del servicioPrioridad de la configuración y los ajustes del punto de conexión

Uso de puntos de conexión en la AWS CLI

Para conectarse mediante programación a un Servicio de AWS, utilice un punto de conexión. Un punto de conexión es la dirección URL del punto de entrada de un servicio web de AWS. AWS Command Line Interface (AWS CLI) usa automáticamente el punto de conexión predeterminado para cada servicio de una Región de AWS, pero puede especificar un punto de conexión alternativo para las solicitudes de la API.

Establecer punto de conexión para un solo comando

Para invalidar la configuración del punto de conexión o las variables de entorno de un solo comando, utilice la opción de línea de comandos --endpoint-url. El siguiente ejemplo de comando usa una URL de punto de conexión de Amazon S3 personalizada.

$ aws s3 ls --endpoint-url http://localhost:4567

Establecer un punto de conexión global para todos los Servicios de AWS

Para dirigir las solicitudes de todos los servicios a una URL de punto de conexión personalizada, utilice una de las siguientes configuraciones:

  • Variables de entorno:

    • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS: Ignore las URL de punto de conexión configuradas.

      Linux or macOS
      $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
      Windows Command Prompt

      Para configurar todas las sesiones

      C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true

      Para configurar solo la sesión actual

      C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
      PowerShell
      PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"

    • AWS_ENDPOINT_URL: Defina la URL del punto de conexión global.

      Linux or macOS
      $ export AWS_ENDPOINT_URL=http://localhost:4567
      Windows Command Prompt

      Para configurar todas las sesiones

      C:\> setx AWS_ENDPOINT_URL http://localhost:4567

      Para configurar solo la sesión actual

      C:\> set AWS_ENDPOINT_URL=http://localhost:4567
      PowerShell
      PS C:\> $Env:AWS_ENDPOINT_URL="http://localhost:4567"

  • El archivo config:

    • ignore_configure_endpoint_urls: Ignore las URL de punto de conexión configuradas.

      ignore_configure_endpoint_urls = true

    • endpoint_url: Defina la URL del punto de conexión global.

      endpoint_url = http://localhost:4567

Los puntos de conexión específicos del servicio y la opción de línea de comandos --endpoint-url invalidan cualquier punto de conexión global.

Establecer para usar los puntos de conexión de FIPS para todos los Servicios de AWS

Para dirigir las solicitudes de todos los servicios para usar puntos de conexión de FIPS, utilice una de las siguientes opciones:

  • AWS_USE_FIPS_ENDPOINT variable de entorno

    Linux or macOS
    $ export AWS_USE_FIPS_ENDPOINT=true
    Windows Command Prompt

    Para configurar todas las sesiones

    C:\> setx AWS_USE_FIPS_ENDPOINT true

    Para configurar solo la sesión actual

    C:\> set AWS_USE_FIPS_ENDPOINT=true
    PowerShell
    PS C:\> $Env:AWS_USE_FIPS_ENDPOINT="true"

  • Configuración de archivos use_fips_endpoint.

    use_fips_endpoint = true

Algunos servicios de AWS ofrecen puntos de conexión compatibles que admiten el Estándar de procesamiento de la información federal (FIPS) 140-2 en algunas Regiones de AWS. Cuando el servicio de AWS es compatible con FIPS, esta configuración establece qué punto de conexión FIPS debe utilizar la AWS CLI. A diferencia de los puntos de conexión de AWS estándar, los puntos de conexión FIPS utilizan una biblioteca de software TLS que cumple con FIPS 140-2. Las empresas que trabajan con el gobierno de los Estados Unidos pueden requerir estos puntos de conexión.

Si esta configuración está habilitada pero no existe un punto de conexión FIPS para el servicio en la Región de AWS, es posible que el comando AWS produzca un error. En este caso, especifique manualmente el punto de conexión que se va a utilizar en el comando mediante la opción --endpoint-url o utilice los puntos de conexión específicos del servicio.

Para obtener más información sobre cómo especificar los puntos de conexión de FIPS por Región de AWS, consulte Puntos de conexión de FIPS por servicio.

Establecer para utilizar los puntos de conexión de doble pila para todos los Servicios de AWS

Para dirigir las solicitudes de todos los servicios para usar puntos de conexión de doble pila cuando estén disponibles, utilice una de las siguientes configuraciones:

  • AWS_USE_DUALSTACK_ENDPOINT variable de entorno

    Linux or macOS
    $ export AWS_USE_DUALSTACK_ENDPOINT=true
    Windows Command Prompt

    Para configurar todas las sesiones

    C:\> setx AWS_USE_DUALSTACK_ENDPOINT true

    Para configurar solo la sesión actual

    C:\> set AWS_USE_DUALSTACK_ENDPOINT=true
    PowerShell
    PS C:\> $Env:AWS_USE_DUALSTACK_ENDPOINT="true"

  • Configuración de archivos use_dualstack_endpoint.

    use_dualstack_endpoint = true

Permite el uso de puntos de conexión de doble pila para enviar solicitudes de AWS. Para obtener más información sobre los puntos de conexión de doble pila, que admiten tráfico de IPv4 e IPv6, consulte Uso de puntos de conexión de doble pila de Amazon S3 en la Guía del usuario de Amazon Simple Storage Service. Los puntos de conexión de doble pila están disponibles para algunos servicios en algunas regiones. Si no existe un punto de conexión de doble pila para el servicio o Región de AWS, la solicitud produce un error. Esta opción está deshabilitada de forma predeterminada.

Establecer puntos de conexión específicos del servicio

La configuración del punto de conexión específico del servicio ofrece la opción de utilizar un punto de conexión persistente de su elección para las solicitudes de la AWS CLI. Estas configuraciones proporcionan flexibilidad para admitir puntos de conexión locales, puntos de conexión de VPC y entornos de desarrollo de AWS locales de terceros. Se pueden usar diferentes puntos de conexión para los entornos de prueba y producción. Puede especificar una URL de punto de conexión para Servicios de AWS individuales.

Los puntos de conexión específicos del servicio se pueden especificar de las siguientes maneras:

Puntos de conexión específicos del servicio: variables de entorno

Las variables de entorno invalidan la configuración del archivo de configuración, pero no invalidan las opciones especificadas en la línea de comandos. Use variables de entorno si quiere que todos los perfiles usen los mismos puntos de conexión en el dispositivo.

A continuación, se muestran variables de entorno específicas del servicio:

  • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS: Ignore todas las URL de punto de conexión configuradas, a menos que se especifiquen en la línea de comandos.

    Linux or macOS
    $ export AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
    Windows Command Prompt

    Para configurar todas las sesiones

    C:\> setx AWS_IGNORE_CONFIGURED_ENDPOINT_URLS true

    Para configurar solo la sesión actual

    C:\> set AWS_IGNORE_CONFIGURED_ENDPOINT_URLS=true
    PowerShell
    PS C:\> $Env:AWS_IGNORE_CONFIGURED_ENDPOINT_URLS="true"

  • AWS_ENDPOINT_URL_<SERVICE>: Especifica un punto de conexión personalizado que se utiliza para un servicio específico, donde <SERVICE> se sustituye por el identificador de Servicio de AWS. Para ver todas las variables específicas del servicio, consulte Puntos de conexión específicos del servicio: lista de identificadores específicos del servicio.

    Los siguientes ejemplos de variables de entorno establecen un punto de conexión para AWS Elastic Beanstalk:

    Linux or macOS
    $ export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
    Windows Command Prompt

    Para configurar todas las sesiones

    C:\> setx AWS_ENDPOINT_URL_ELASTIC_BEANSTALK http://localhost:4567

    Para configurar solo la sesión actual

    C:\> set AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:4567
    PowerShell
    PS C:\> $Env:AWS_ENDPOINT_URL_ELASTIC_BEANSTALK="http://localhost:4567"

Para obtener más información sobre la configuración de las variables de entorno, consulte Configuración de variables de entorno para la AWS CLI.

Puntos de conexión específicos del servicio: archivo config compartido

En el archivo compartido config, endpoint_url se usa en varias secciones. Para configurar un punto de conexión específico del servicio, use la configuración anidada endpoint_url en una clave de identificador de servicio dentro de una sección services. Para obtener más información sobre cómo definir una sección de services en el archivo compartido config, consulte Tipo de sección: services.

En el siguiente ejemplo, se utiliza una sección de services para configurar una URL de punto de conexión específica del servicio para Amazon S3 y un punto de conexión global personalizado que se utiliza para todos los demás servicios: 

[profile dev1]
endpoint_url = http://localhost:1234
services = s3-specific

[services testing-s3]
s3 = 
  endpoint_url = http://localhost:4567

Un único perfil puede configurar puntos de conexión para varios servicios. El siguiente ejemplo establece las URL de punto de conexión específicas del servicio para Amazon S3 y AWS Elastic Beanstalk en el mismo perfil.

Para obtener una lista de todas las claves de identificación de servicio que se van a utilizar en la sección de services, consulte Lista de identificadores específicos del servicio. 

[profile dev1]
services = testing-s3-and-eb

[services testing-s3-and-eb]
s3 = 
  endpoint_url = http://localhost:4567
elastic_beanstalk = 
  endpoint_url = http://localhost:8000

La sección de configuración de servicios se puede utilizar en varios perfiles. En el siguiente ejemplo, dos perfiles utilizan la misma definición de services: 

[profile dev1]
output = json
services = testing-s3

[profile dev2]
output = text
services = testing-s3

[services testing-s3]
s3 = 
  endpoint_url = https://localhost:4567

Puntos de conexión específicos del servicio: lista de identificadores específicos del servicio

El identificador de Servicio de AWS se basa en serviceId del modelo de la API, sustituyendo todos los espacios por guiones bajos y poniendo en minúsculas todas las letras.

En el siguiente ejemplo de identificador de servicio se utiliza AWS Elastic Beanstalk. AWS Elastic Beanstalk tiene un serviceId de Elastic Beanstalk, por lo que la clave del identificador de servicio es elastic_beanstalk.

La siguiente tabla muestra todos los identificadores específicos del servicio, las claves de archivo config y las variables de entorno.

Prioridad de la configuración y los ajustes del punto de conexión

Los ajustes de configuración de punto de conexión se encuentran en varios lugares, como las variables de entorno del sistema o del usuario, los archivos de configuración de AWS locales o declarados explícitamente en la línea de comandos como un parámetro. Los ajustes de configuración del punto de conexión de la AWS CLI tienen prioridad en el siguiente orden:

  1. La opción de línea de comandos --endpoint-url.

  2. Si está habilitada, la variable de entorno del punto de conexión AWS_IGNORE_CONFIGURED_ENDPOINT_URLS global o la configuración del perfil ignore_configure_endpoint_urls para ignorar los puntos de conexión personalizados.

  3. El valor proporcionado por una variable de entorno específica del servicio AWS_ENDPOINT_URL_<SERVICE>, como AWS_ENDPOINT_URL_DYNAMODB.

  4. Los valores proporcionados por las variables de entorno AWS_USE_DUALSTACK_ENDPOINT, AWS_USE_FIPS_ENDPOINT y AWS_ENDPOINT_URL.

  5. El valor de punto de conexión específico del servicio proporcionado por la configuración endpoint_url de una sección de services del archivo compartido config.

  6. El valor proporcionado por la configuración endpoint_url en un profile de un archivo compartido config.

  7. Configuración de use_dualstack_endpoint, use_fips_endpoint y endpoint_url.

  8. En último lugar, se utiliza cualquier URL de punto de conexión predeterminada para el Servicio de AWS respectivo. Para obtener una lista de los puntos de conexión de servicio estándar disponibles en cada región, consulte Regiones y puntos de enlace de AWS en la Referencia general de Amazon Web Services.