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 Servicio de AWS, 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.
Temas sobre puntos de conexión
- Establecer punto de conexión para un solo comando
- Establezca un punto final global para todos Servicios de AWS
- Está configurado para usar FIPs puntos finales para todos Servicios de AWS
- Establecer para utilizar los puntos de conexión de doble pila para todos los Servicios de AWS
- Establecer puntos de conexión específicos del servicio
- Prioridad de la configuración y los ajustes del punto de conexión
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 Servicios de AWS
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. -
AWS_ENDPOINT_URL
- Establecer un punto final globalURL.
-
-
El archivo
config
:-
ignore_configure_endpoint_urls
- Ignore el punto final configuradoURLs.ignore_configure_endpoint_urls = true
-
endpoint_url
- Establecer un punto final globalURL.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.
Está configurado para usar FIPs puntos finales para todos Servicios de AWS
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 -
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
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 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 -
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. Servicios de AWS
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_IGNORE_CONFIGURED_ENDPOINT_URLS
- Ignore todos los puntos finales configuradosURLs, a menos que se especifique en la línea de comandos. -
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.
-
-
Archivo
config
:-
ignore_configure_endpoint_urls
- Ignore todos los puntos finales configuradosURLs, a menos que se especifique mediante variables de entorno o en la línea de comandos. -
La sección services del archivo
config
combinada con la configuración del archivoendpoint_url
.
-
Temas de puntos de conexión específicos del servicio:
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. -
AWS_ENDPOINT_URL_<SERVICE>
- Especifica un punto final personalizado que se utiliza para un servicio específico, donde<SERVICE>
se sustituye por el Servicio de AWS 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:
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
[servicestesting-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
[servicestesting-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
[profiledev2
] output = text services =testing-s3
[servicestesting-s3
] s3 = endpoint_url =https://localhost:4567
Puntos de conexión específicos del servicio: lista de identificadores específicos del servicio
El Servicio de AWS 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:
-
La opción de línea de comandos
--endpoint-url
. -
Si está habilitada, la variable de entorno del punto de conexión
AWS_IGNORE_CONFIGURED_ENDPOINT_URLS
global o la configuración del perfilignore_configure_endpoint_urls
para ignorar los puntos de conexión personalizados. -
El valor proporcionado por una variable de entorno específica del servicio
AWS_ENDPOINT_URL_<SERVICE>
, comoAWS_ENDPOINT_URL_DYNAMODB
. -
Los valores proporcionados por las variables de entorno
AWS_USE_DUALSTACK_ENDPOINT
,AWS_USE_FIPS_ENDPOINT
yAWS_ENDPOINT_URL
. -
El valor de punto de conexión específico del servicio proporcionado por la configuración
endpoint_url
de una sección deservices
del archivo compartidoconfig
. -
El valor proporcionado por la configuración
endpoint_url
en unprofile
de un archivo compartidoconfig
. -
Configuración de
use_dualstack_endpoint
,use_fips_endpoint
yendpoint_url
. -
En último lugar se utiliza cualquier punto final predeterminado URL para el respectivo Servicio de AWS . 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.