**Esta documentación es para la versión 1 de AWS CLI.** Anunciamos el próximo fin del soporte para la versión 1 de AWS CLI. Recomendamos migrarse a la versión 2 de AWS CLI. Para ver las fechas, los detalles adicionales y la información sobre cómo realizar la migración, consulte el [anuncio](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la [Guía del usuario de la versión 2](https://docs.aws.amazon.com/cli/latest/userguide/). # 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. **Contents** + [Establecer punto de conexión para un solo comando](#endpoints-command) + [Establecer un punto de conexión global para todos los Servicios de AWS](#endpoints-global) + [Establecer para usar los puntos de conexión de FIPS para todos los Servicios de AWS](#endpoints-fips) + [Establecer para utilizar los puntos de conexión de doble pila para todos los Servicios de AWS](#endpoints-dual-stack) + [Establecer puntos de conexión específicos del servicio](#endpoints-service-specific) + [Variables de entorno](#endpoints-service-specific-envvars) + [Archivo `config` compartido](#endpoints-service-specific-config) + [Lista de identificadores específicos del servicio](#endpoints-service-specific-table) + [Puntos de conexión basados en cuentas](#endpoints-accountid) + [Prioridad de la configuración y los ajustes del punto de conexión](#endpoints-precedence) ## 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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`: 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\$1ENDPOINT\$1URL`: 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\$1configure\$1endpoint\$1urls`: Ignore las URL de punto de conexión configuradas. ``` ignore_configure_endpoint_urls = true ``` + `endpoint\$1url`: 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\$1USE\$1FIPS\$1ENDPOINT` 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\$1fips\$1endpoint`. ``` 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](https://aws.amazon.com/compliance/fips/) 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](#endpoints-service-specific). 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](https://aws.amazon.com/compliance/fips/). ## 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\$1USE\$1DUALSTACK\$1ENDPOINT` 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\$1dualstack\$1endpoint`. ``` 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html) 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: + La opción de línea de comandos `--endpoint-url` para un solo comando. + Variables de entorno: + `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`: Ignore todas las URL de punto de conexión configuradas, a menos que se especifiquen en la línea de comandos. + `AWS\$1ENDPOINT\$1URL\$1`: Especifica un punto de conexión personalizado que se utiliza para un servicio específico, donde `` 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](#endpoints-service-specific-table). + Archivo `config`: + `ignore\$1configure\$1endpoint\$1urls`: Ignore todas las URL de punto de conexión configuradas, a menos que se especifique el uso de variables de entorno o en la línea de comandos. + La sección [`services`](cli-configure-files.md#cli-configure-files-format-services) del archivo `config` combinada con la configuración del archivo `endpoint\$1url`. **Topics** + [Variables de entorno](#endpoints-service-specific-envvars) + [Archivo `config` compartido](#endpoints-service-specific-config) + [Lista de identificadores específicos del servicio](#endpoints-service-specific-table) ### 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\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS`: 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\$1ENDPOINT\$1URL\$1`: Especifica un punto de conexión personalizado que se utiliza para un servicio específico, donde `` 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](#endpoints-service-specific-table). 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](cli-configure-envvars.md). ### 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`](cli-configure-files.md#cli-configure-files-format-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](#endpoints-service-specific-table). ``` [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. La siguiente tabla muestra todos los identificadores específicos del servicio, las claves de archivo `config` y las variables de entorno. ## Puntos de conexión basados en cuentas Los puntos de conexión basados en cuentas se pueden especificar de las siguientes maneras: + Variables de entorno + `AWS\$1ACCOUNT\$1ID`: especifica el ID del punto de conexión basado en la cuenta de AWS que se utilizará para las llamadas a los Servicios de AWS compatibles. ------ #### [ Linux or macOS ] ``` $ export AWS_ACCOUNT_ID= ``` ------ #### [ Windows Command Prompt ] **Para configurar todas las sesiones** ``` C:\> setx AWS_ACCOUNT_ID ``` **Para configurar solo la sesión actual** ``` C:\> set AWS_ACCOUNT_ID= ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ACCOUNT_ID="" ``` ------ + `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE`: especifica si se deben utilizar los ID de punto de conexión basados en cuentas de AWS para las llamadas a los Servicios de AWS compatibles. Se puede establecer en `preferred`, `disabled` o `required`. El valor predeterminado es `preferred`. ------ #### [ Linux or macOS ] ``` $ export AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred ``` ------ #### [ Windows Command Prompt ] **Para configurar todas las sesiones** ``` C:\> setx AWS_ACCOUNT_ID_ENDPOINT_MODE preferred ``` **Para configurar solo la sesión actual** ``` C:\> set AWS_ACCOUNT_ID_ENDPOINT_MODE=preferred ``` ------ #### [ PowerShell ] ``` PS C:\> $Env:AWS_ACCOUNT_ID_ENDPOINT_MODE="preferred" ``` ------ + El archivo `config`: + `aws\$1account\$1id`: especifica el ID del punto de conexión basado en la cuenta de AWS que se utilizará para las llamadas a los Servicios de AWS compatibles. ``` aws_account_id = ``` + `account\$1id\$1endpoint\$1mode`: especifica si se deben utilizar los ID de punto de conexión basados en cuentas de AWS para las llamadas a los Servicios de AWS compatibles. Se puede establecer en `preferred`, `disabled` o `required`. El valor predeterminado es el preferido. ``` account_id_endpoint_mode = preferred ``` Los puntos de conexión basados en cuentas ayudan a garantizar un alto rendimiento y escalabilidad, ya que utilizan el ID de cuenta de AWS para agilizar el enrutamiento de las solicitudes de Servicio de AWS para los servicios compatibles con esta característica. Cuando utiliza un proveedor de credenciales y un servicio que admite puntos de conexión basados en cuentas, la AWS CLI crea y utiliza automáticamente un punto de conexión basado en una cuenta en lugar de un punto de conexión regional. Los puntos de conexión basados en cuentas utilizan el siguiente formato, donde `` se sustituye por el ID de cuenta de AWS y `` se sustituye por la Región de AWS: ``` https://.myservice..amazonaws.com ``` De forma predeterminada en la AWS CLI, el modo de punto de conexión basado en la cuenta está configurado en `preferred`. ## 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`. 1. Si está habilitada, la variable de entorno del punto de conexión `AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS` global o la configuración del perfil `ignore\$1configure\$1endpoint\$1urls` para ignorar los puntos de conexión personalizados. 1. El valor proporcionado por una variable de entorno específica del servicio `AWS\$1ENDPOINT\$1URL\$1`, como `AWS_ENDPOINT_URL_DYNAMODB`. 1. Los valores proporcionados por las variables de entorno `AWS\$1USE\$1DUALSTACK\$1ENDPOINT`, `AWS\$1USE\$1FIPS\$1ENDPOINT` y `AWS\$1ENDPOINT\$1URL`. 1. La variable de entorno `AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE` se establece en `preferred` o `required` mediante el ID de cuenta en la variable de entorno `AWS\$1ACCOUNT\$1ID` o la configuración de `aws\$1account\$1id`. 1. El valor de punto de conexión específico del servicio proporcionado por la configuración `endpoint\$1url` de una sección de `services` del archivo compartido `config`. 1. El valor proporcionado por la configuración `endpoint\$1url` en un `profile` de un archivo compartido `config`. 1. Configuración de `use\$1dualstack\$1endpoint`, `use\$1fips\$1endpoint` y `endpoint\$1url`. 1. La configuración `account\$1id\$1endpoint\$1mode` se establece en `preferred` o `required` mediante el ID de cuenta en la variable de entorno `AWS\$1ACCOUNT\$1ID` o la configuración de `aws\$1account\$1id`. 1. 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](https://docs.aws.amazon.com/general/latest/gr/rande.html) en la *Referencia general de Amazon Web Services*.