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 de su elección para las solicitudes de la API y de hacer que esa opción persista. 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 individuales Servicios de AWS.

Configuración de puntos de conexión mediante variables de entorno

Para dirigir las solicitudes de todos los servicios a una URL de punto de conexión personalizada, establezca la variable de entorno global de AWS_ENDPOINT_URL.

export AWS_ENDPOINT_URL=http://localhost:4567

Para enrutar las solicitudes de una URL de punto de conexión específico de Servicio de AWS a una URL de punto de conexión personalizada, utilice la variable de entorno de AWS_ENDPOINT_URL_<SERVICE>. Amazon DynamoDB tiene un serviceId DynamoDB. Para este servicio, la variable de entorno de la URL del punto de conexión es AWS_ENDPOINT_URL_DYNAMODB. Este punto de conexión tiene prioridad sobre el punto de conexión global establecido en AWS_ENDPOINT_URL para este servicio.

export AWS_ENDPOINT_URL_DYNAMODB=http://localhost:5678

Como otro ejemplo, AWS Elastic Beanstalk tiene un serviceId Elastic Beanstalk. El identificador de Servicio de AWS se basa en el modelo de la API de serviceId al sustituir todos los espacios por guiones bajos y poniendo en minúsculas todas las letras. Para este servicio, la variable de entorno de la URL del punto de conexión es AWS_ENDPOINT_URL_ELASTIC_BEANSTALK. Para obtener una lista de todas las variables de entorno específicas del servicio, consulte Identificadores de punto de conexión específicos del servicio.

export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:5567

Configure los puntos de conexión mediante el archivo compartido config

En el archivo compartido config, endpoint_url se usa en diferentes lugares para diferentes funciones.

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

[profile dev-s3-specific-and-global]
endpoint_url = http://localhost:1234
services = s3-specific

[services s3-specific]
s3 = 
  endpoint_url = https://play.min.io:9000

Un único perfil puede configurar puntos de conexión para varios servicios. Este ejemplo muestra cómo establecer las URL de punto de conexión específicas del servicio para Amazon S3 y AWS Elastic Beanstalk en el mismo perfil. AWS Elastic Beanstalk tiene un serviceId Elastic Beanstalk. 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. Por lo tanto, la clave identificadora del servicio pasa a ser elastic_beanstalk y la configuración de este servicio comienza en la línea elastic_beanstalk = . 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 Identificadores de punto de conexión específicos del servicio.

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

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

La sección de configuración de servicios se puede utilizar en varios perfiles. Por ejemplo, dos perfiles pueden usar la misma definición de services y, al mismo tiempo, modificar otras propiedades del perfil:

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

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

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

Configure los puntos de conexión de los perfiles mediante credenciales basadas en roles

Si el perfil tiene credenciales basadas en roles configuradas mediante un parámetro source_profile para la funcionalidad de asumir roles de IAM, el SDK solo usa configuraciones de servicio para el perfil especificado. No utiliza perfiles que estén vinculados a él por roles. Por ejemplo, mediante el siguiente archivo config compartido:

[profile A]
credential_source = Ec2InstanceMetadata
endpoint_url = https://profile-a-endpoint.aws/

[profile B]
source_profile = A
role_arn = arn:aws:iam::123456789012:role/roleB
services = profileB

[services profileB]
ec2 = 
  endpoint_url = https://profile-b-ec2-endpoint.aws

Si usa el perfil B y realiza una llamada en el código a Amazon EC2, el punto de conexión se resuelve como https://profile-b-ec2-endpoint.aws. Si el código realiza una solicitud a cualquier otro servicio, la resolución del punto de conexión no seguirá ninguna lógica personalizada. El punto de conexión no se convierte en el punto de conexión global definido en el perfil A. Para que un punto de conexión global surta efecto en el perfil B, tendrá que configurar endpoint_url directamente dentro del perfil B. Para obtener más información sobre la configuración de source_profile, consulte Asumir el rol de proveedor de credenciales.

Precedencia de configuración

La configuración de esta característica se puede usar al mismo tiempo, pero solo tendrá prioridad un valor por servicio. Para las llamadas a la API realizadas a un Servicio de AWS determinado, se utiliza el siguiente orden para seleccionar un valor:

Soporte mediante SKD y herramientas de AWS

Los siguientes SDK admiten las características y los ajustes descritos en este tema. Se anotan todas las excepciones parciales. Todos los ajustes de propiedades del sistema JVM son compatibles con AWS SDK para Java y AWS SDK para Kotlin únicamente.