Este repositorio está destinado al desarrollo activo del SDK de Azure para Java. Para los consumidores del SDK, recomendamos visitar nuestros documentos públicos para desarrolladores o nuestros documentos para desarrolladores versionados.
Para comenzar con una biblioteca de servicios específica, consulte el archivo README.md ubicado en la carpeta del proyecto de la biblioteca. Puede encontrar bibliotecas de servicios en el directorio /sdk
. Para obtener una lista de todos los servicios que admitimos, acceda a nuestra lista de todas las bibliotecas existentes.
Para tutoriales, ejemplos, inicios rápidos y otra documentación, visite Azure para desarrolladores de Java.
Todas las bibliotecas están basadas en Java 8, con pruebas y soporte avanzado hasta la última versión de soporte a largo plazo de Java (actualmente Java 17).
Cada servicio puede tener bibliotecas tanto de "cliente" como de "administración". Las bibliotecas de "cliente" se utilizan para consumir el servicio, mientras que las bibliotecas de "administración" se utilizan para configurar y administrar el servicio.
Nuestras bibliotecas cliente siguen las pautas de diseño del SDK de Azure para Java y comparten una serie de características principales, como reintentos HTTP, registros, protocolos de transporte, protocolos de autenticación, etc., de modo que una vez que aprenda a usar estas características en una biblioteca cliente, sabrá cómo utilizarlos en otras bibliotecas cliente. Puede obtener más información sobre estas funciones compartidas aquí. Estas bibliotecas se pueden identificar fácilmente por nombres de carpetas, paquetes y espacios de nombres que comienzan con azure-
, por ejemplo, azure-keyvault
.
Puede encontrar la lista más actualizada de todos los nuevos paquetes en nuestra página . Esta lista incluye las versiones más recientes: tanto estables como beta.
NOTA: Si necesita asegurarse de que su código esté listo para producción, utilice una de las bibliotecas estables no beta.
Al igual que nuestras bibliotecas cliente, las bibliotecas de administración siguen las pautas de diseño del SDK de Azure para Java. Estas bibliotecas proporcionan una API orientada a objetos de alto nivel para administrar recursos de Azure, que están optimizadas para ser fáciles de usar, concisas y coherentes. Puede encontrar la lista de bibliotecas de gestión en esta página .
Para obtener documentación general sobre cómo usar las nuevas bibliotecas para Azure Resource Management, visite aquí . También hemos preparado muchos ejemplos de código , así como una guía de migración en caso de que esté actualizando desde versiones anteriores.
Las bibliotecas de administración se pueden identificar mediante espacios de nombres que comienzan con azure-resourcemanager
, por ejemplo, azure-resourcemanager-compute
.
Tenga en cuenta que las bibliotecas más recientes de Microsoft se encuentran en el ID de grupo com.azure
Maven y tienen el patrón de nomenclatura de paquetes que comienza con com.azure
. Si usa bibliotecas que están en el ID de grupo com.microsoft.azure
Maven o tiene esta como estructura del paquete, considere migrar a las bibliotecas más recientes. Puede encontrar una tabla de mapeo de estos lanzamientos históricos a su equivalente aquí.
azure-java-sdk
. La rama principal tiene el código más reciente con nuevas funciones y correcciones de errores. No representa el último SDK estable lanzado.
Para cada paquete que publiquemos, se creará una etiqueta git única que contiene el nombre y la versión del paquete para marcar la confirmación del código que produjo el paquete. Esta etiqueta se utilizará para el servicio a través de ramas de revisión, así como para depurar el código para una versión beta o estable en particular. El formato de las etiquetas de lanzamiento es <package-name>_<package-version>
. Para obtener más información, consulte nuestra estrategia de sucursales.
Para obtener detalles sobre cómo contribuir a este repositorio, consulte la guía de contribución.
Este proyecto agradece contribuciones y sugerencias. La mayoría de las contribuciones requieren que usted acepte un Acuerdo de licencia de colaborador (CLA) que declara que tiene derecho a otorgarnos, y de hecho lo hace, los derechos para usar su contribución. Para obtener más información, consulte CLA de Microsoft.
Cuando envía una solicitud de extracción, un CLA-bot determinará automáticamente si necesita proporcionar un CLA y decorar el PR de manera adecuada (por ejemplo, etiqueta, comentario). Simplemente siga las instrucciones proporcionadas por el bot. Sólo necesitarás hacer esto una vez en todos los repositorios que utilicen nuestro CLA.
Este proyecto ha adoptado el Código de conducta de código abierto de Microsoft. Para obtener más información, consulte las preguntas frecuentes sobre el Código de conducta o comuníquese con [email protected] si tiene alguna pregunta o comentario adicional.
Muchas personas en todo el mundo han ayudado a mejorar este proyecto. Querrás ver:
Los problemas y errores de seguridad deben informarse de forma privada, por correo electrónico, al Centro de respuesta de seguridad de Microsoft (MSRC) [email protected]. Debería recibir una respuesta dentro de las 24 horas. Si por alguna razón no lo hace, envíe un correo electrónico para asegurarse de que hayamos recibido su mensaje original. Puede encontrar más información, incluida la clave MSRC PGP, en Security TechCenter.
Azure SDK para Java tiene la licencia MIT.