SDK de Java V2.0 (recomendado) - Alibaba Cloud SDK - Centro de documentación de Alibaba Cloud

Conozca los paquetes de dependencia comunes y las clases de configuración del SDK V2.0 para resolver errores rápidamente y mejorar la eficiencia del desarrollo.

Paquetes de dependencia comunes

La mayoría de los productos en la nube del SDK V2.0 requieren los siguientes paquetes de dependencia comunes. Obtenga las versiones más recientes desde el repositorio de Maven. Si encuentra conflictos entre paquetes, agregue manualmente las versiones más recientes a su proyecto.

Nota

Estos paquetes se instalan automáticamente con el SDK del producto en la nube. Si ocurre un error, agregue manualmente la versión más reciente.

Nombre del paquete	Dirección de Maven	Dirección del repositorio de código en GitHub
tea-util	Maven Central: com.aliyun:tea-util	tea-util
tea	Maven Central: com.aliyun:tea	tea-java
credentials-java	Maven Central: com.aliyun:credentials-java	credentials-java
credentials-api	Maven Central: com.aliyun:credentials-api	credentials-api
openapiutil	Maven Central: com.aliyun:openapiutil	openapiutil
alibabacloud-gateway-spi	Maven Central: com.aliyun:alibabacloud-gateway-spi	alibabacloud-gateway-spi
tea-xml	Maven Central: com.aliyun:tea-xml	tea-xml
tea-openapi	Maven Central: com.aliyun:tea-openapi	tea-openapi

Clases de configuración

com.aliyun.teaopenapi.models.Config

Use esta clase para configurar parámetros globales como credenciales, endpoints, configuraciones de proxy y tiempos de espera. A continuación se describen los parámetros.

Nota

No use parámetros que no aparezcan en la tabla. Es posible que estén obsoletos o que no surtan efecto.

Nombre del parámetro	Descripción
credential	El cliente de credenciales. En el SDK V2.0, la herramienta de credenciales gestiona la información de autenticación. Para obtener más información, consulte Manage access credentials.
accessKeyId	El ID de AccessKey. Establezca este parámetro o `credential`. Si configura tanto `credential` como `accessKeyId`, se usan las credenciales de `credential`.
accessKeySecret	El secreto de AccessKey. Establezca este parámetro o `credential`. Si configura tanto `credential` como `accessKeySecret`, se usan las credenciales de `credential`.
securityToken	El token de Security Token Service (STS). Establezca este parámetro o `credential`. Si configura tanto `credential` como `securityToken`, se usan las credenciales de `credential`.
bearerToken	El bearer token. Establezca este parámetro o `credential`. Si configura tanto `credential` como `bearerToken`, se usan las credenciales de `credential`.
endpoint	El endpoint del servicio correspondiente a la región donde residen sus recursos en la nube. Las llamadas a la API se enrutan a través de este endpoint. Para obtener más información, consulte Configure endpoints.
regionId	La región donde residen sus recursos en la nube. Si no establece `endpoint`, el SDK resuelve el endpoint del servicio a partir de este identificador de región. Para obtener más información, consulte Configure endpoints.
network	Cuando establece `regionId`, especifica el tipo de endpoint que se debe resolver. De forma predeterminada, se usa un endpoint de Internet. Valores válidos: `vpc`: resuelve un endpoint de VPC. Para el SDK de Simple Log Service (sls20201230), se usa un endpoint de Internet de forma predeterminada. Puede especificar un tipo de endpoint distinto: `intranet`: resuelve el endpoint de VPC para Simple Log Service. `accelerate`: resuelve el endpoint de aceleración de transferencia para Simple Log Service.
maxIdleConns	El número máximo de conexiones inactivas en el pool de conexiones. Las conexiones inactivas excedentes se cierran para liberar recursos. Valor predeterminado: 5. Para obtener más información, consulte Configure an HTTP connection pool.
protocol	El protocolo de la solicitud. Valores válidos: HTTPS y HTTP. Valor predeterminado: HTTPS. Para obtener más información, consulte Configure HTTPS requests.
readTimeout	El tiempo de espera de lectura. Valor predeterminado: 10000 milisegundos. Para obtener más información, consulte Timeout mechanism.
connectTimeout	El tiempo de espera de conexión. Valor predeterminado: 5000 milisegundos. Para obtener más información, consulte Timeout mechanism.
httpProxy	La dirección y el puerto del servidor proxy HTTP. Formato: `http://proxyServer:port`. Para obtener más información, consulte Configure a proxy.
httpsProxy	La dirección y el puerto del servidor proxy HTTPS. Formato: `https://username:password@proxyServer:port`. Si no se requiere autenticación de proxy, use `https://proxyServer:port`. Para obtener más información, consulte Configure a proxy.
noProxy	Una lista de direcciones separadas por comas que omiten el proxy. Se admiten nombres de dominio y direcciones IP. Para obtener más información, consulte Configure a proxy.

com.aliyun.teautil.models.RuntimeOptions

Use esta clase para configurar parámetros de ejecución por solicitud, como las opciones de proxy y los tiempos de espera. A continuación se describen los parámetros.

Nota

No use parámetros que no aparezcan en la tabla. Es posible que estén obsoletos o que no surtan efecto.

Nombre del parámetro	Descripción
autoretry	Especifica si se habilitan los reintentos automáticos ante errores de red. Valor predeterminado: `false` (deshabilitado). Para obtener más información, consulte Retry mechanism.
maxAttempts	El número máximo de intentos cuando los reintentos automáticos están habilitados. Valor predeterminado: 3. Para obtener más información, consulte Retry mechanism.
maxIdleConns	El número máximo de conexiones inactivas en el pool de conexiones. Las conexiones inactivas excedentes se cierran para liberar recursos. Valor predeterminado: 5. Para obtener más información, consulte Configure an HTTP connection pool.
ignoreSSL	Cuando establece `protocol` en HTTPS, el SDK valida los certificados SSL/TLS de forma predeterminada. Si su entorno carece de un certificado SSL/TLS, use este parámetro para omitir temporalmente la validación. Valor predeterminado: `false` (la validación es obligatoria). Para obtener más información, consulte Configure HTTPS requests. Nota Para garantizar la seguridad de las comunicaciones en su entorno de producción, habilite la validación de certificados.
readTimeout	El tiempo de espera de lectura. Valor predeterminado: 10000 milisegundos. Para obtener más información, consulte Timeout mechanism.
connectTimeout	El tiempo de espera de conexión. Valor predeterminado: 5000 milisegundos. Para obtener más información, consulte Timeout mechanism.
httpProxy	La dirección y el puerto del servidor proxy HTTP. Formato: `http://proxyServer:port`. Para obtener más información, consulte Configure a proxy.
httpsProxy	La dirección y el puerto del servidor proxy HTTPS. Formato: `https://username:password@proxyServer:port`. Si no se requiere autenticación de proxy, use `https://proxyServer:port`. Para obtener más información, consulte Configure a proxy.
noProxy	Una lista de direcciones separadas por comas que omiten el proxy. Se admiten nombres de dominio y direcciones IP. Para obtener más información, consulte Configure a proxy.