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.

Puntos de conexión específicos del servicio

La configuración del punto final específico del servicio ofrece la opción de utilizar el punto final que elija para API las solicitudes y mantener esa opción. Esta configuración proporciona la flexibilidad necesaria para admitir puntos de conexión locales, puntos de conexión y puntos de conexión VPC locales de terceros AWS entornos de desarrollo. Se pueden usar diferentes puntos de conexión para los entornos de prueba y producción. Puede especificar un punto final URL para cada usuario Servicios de AWS.

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

Para dirigir las solicitudes de todos los servicios a un punto final personalizadoURL, defina la variable de entorno AWS_ENDPOINT_URL global.

export AWS_ENDPOINT_URL=http://localhost:4567

Para enrutar las solicitudes de un determinado Servicio de AWS a un punto final personalizadoURL, utilice la variable de AWS_ENDPOINT_URL_<SERVICE> entorno. Amazon DynamoDB tiene un serviceId de DynamoDB. Para este servicio, la variable de URL entorno del punto final esAWS_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 de Elastic Beanstalk. La Servicio de AWS el identificador se basa en el API modelo sustituyendo todos los espacios serviceId por guiones bajos y mayúsculas en 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 services definición para configurar un punto de enlace específico del servicio URL que se utilizará para Amazon S3 y un punto de enlace 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. En este ejemplo se muestra cómo configurar el punto final específico del servicio URLs para Amazon S3 y AWS Elastic Beanstalk en el mismo perfil. AWS Elastic Beanstalk tiene un serviceId de Elastic Beanstalk. La Servicio de AWS el identificador se basa en el API modelo sustituyendo todos los espacios serviceId por guiones bajos y 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 su perfil tiene credenciales basadas en funciones configuradas mediante un source_profile parámetro para la funcionalidad de IAM asumir funciones, SDK solo utilizará 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 utilizas el perfil B y haces una llamada en tu código a AmazonEC2, el punto final se resuelve comohttps://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 API llamadas realizadas a una persona determinada Servicio de AWS, se utiliza el siguiente orden para seleccionar un valor:

Compatibilidad con AWS SDKs

Las siguientes opciones SDKs son compatibles con las funciones y configuraciones descritas en este tema. Se anotan todas las excepciones parciales. Cualquier configuración de propiedades del JVM sistema es compatible con la AWS SDK for Java y el AWS SDK para Kotlin únicamente.