Utilice puntos finales en el AWS CLI - AWS Command Line Interface
Establecer punto de conexión para un solo comandoEstablezca un punto final global para todos AWS servicesEstá configurado para usar FIPs puntos finales para todos AWS servicesEstablecer para utilizar los puntos de conexión de doble pila para todos los AWS servicesEstablecer puntos de conexión específicos del servicioPrioridad de la configuración y los ajustes del punto de conexión

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilice puntos finales en el AWS CLI

Para conectarse mediante programación a un punto final AWS service, utilice un punto final. Un punto final es el punto URL de entrada de un servicio AWS web. El AWS Command Line Interface (AWS CLI) utiliza automáticamente el punto final predeterminado para cada servicio de un Región de AWS, pero puedes especificar un punto final alternativo para tus API solicitudes.

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 un punto de conexión Amazon S3 personalizadoURL.

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

Establezca un punto final global para todos AWS services

Para dirigir las solicitudes de todos los servicios a un punto final personalizadoURL, utilice una de las siguientes configuraciones:

  • Variables de entorno:

    • AWS_IGNORE_CONFIGURED_ENDPOINT_URLS- Ignore el punto final configuradoURLs.

      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- Establecer un punto final globalURL.

      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:

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.

Está configurado para usar FIPs puntos finales para todos AWS services

Para enrutar las solicitudes de todos los servicios para que utilicen FIPs puntos finales, 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 AWS servicios ofrecen terminales que, en algunos casos, son compatibles con la Norma Federal de Procesamiento de Información (FIPS) 140-2. Regiones de AWS Cuando el AWS servicio lo admiteFIPS, esta configuración especifica qué FIPS punto final AWS CLI debe usar. A diferencia de AWS los puntos finales estándar, los FIPS puntos finales utilizan una biblioteca de TLS software que cumple con FIPS la norma 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 FIPS punto final para el servicio en su servidor Región de AWS, es posible que se produzca un error en el AWS comando. 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 FIPS puntos de enlace por Región de AWS, consulte FIPSPuntos finales por servicio.

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

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 finales de doble pila para enviar solicitudes. AWS Para obtener más información sobre los puntos de enlace de doble pila, que admiten tanto como IPv4 el IPv6 tráfico, consulte Uso de los puntos de enlace 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 final de doble pila para el servicio o Región de AWS si la solicitud falla. Esta opción está deshabilitada de forma predeterminada.

Establecer puntos de conexión específicos del servicio

La configuración de punto final específico del servicio ofrece la opción de usar un punto final persistente de su elección para las solicitudes. AWS CLI Esta configuración proporciona flexibilidad para admitir puntos finales locales, puntos finales y entornos de VPC desarrollo locales de terceros. AWS Se pueden usar diferentes puntos de conexión para los entornos de prueba y producción. Puede especificar un punto final URL para una persona. AWS services

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 todos los terminales configuradosURLs, a menos que se especifique 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 final personalizado que se utiliza para un servicio específico, donde <SERVICE> se sustituye por el AWS service identificador. 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 Variables de entorno para configurar el 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 services sección para configurar un punto de enlace específico del servicio URL para Amazon S3 y un punto de enlace 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 el punto de enlace específico del servicio URLs 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 AWS service identificador se basa en el del API modelo, sustituyendo todos los espacios serviceId por guiones bajos y poniendo todas las letras en minúsculas.

En el siguiente ejemplo de identificador de servicio se utiliza. AWS Elastic Beanstalk AWS Elastic Beanstalk tiene un serviceId deElastic Beanstalk, por lo que la clave del identificador de servicio eselastic_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 del punto final se encuentran en varios lugares, como las variables de entorno del sistema o del usuario, los archivos de AWS configuración locales, o se declaran explícitamente en la línea de comandos como parámetros. 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 punto final predeterminado URL para el respectivo AWS service . Para obtener una lista de los puntos de enlace 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.