Configuration
Most of Azure SDKs could be divided into two categories by transport type, HTTP-based and AMQP-based. There are properties that are common to all SDKs such as authentication principals and Azure environment settings. Or common to HTTP-based clients, such as logging level to log HTTP requests and responses. Spring Cloud Azure 4.0 provides five common categories of configuration properties, which could be specified to each Azure service.
Property | Description |
---|---|
spring.cloud.azure.<azure-service>.client |
To configure the transport clients underneath one Azure service SDK. |
spring.cloud.azure.<azure-service>.credential |
To configure how to authenticate with Azure Active Directory for one Azure service SDK. |
spring.cloud.azure.<azure-service>.profile |
To configure the Azure cloud environment for one Azure service SDK. |
spring.cloud.azure.<azure-service>.proxy |
To configure the proxy options for one Azure service SDK. |
spring.cloud.azure.<azure-service>.retry |
To configure the retry options apply to one Azure service SDK. The retry options has supported part of the SDKs, there’s no |
There are some properties that could be shared among different Azure services, for example using the same service principal to access Azure Cosmos DB and Azure Event Hubs. Spring Cloud Azure 4.0 allows application developers to specify properties that apply to all Azure SDKs with the prefix spring.cloud.azure
.
Property | Description |
---|---|
spring.cloud.azure.client |
To configure the transport clients apply to all Azure SDKs by default. |
spring.cloud.azure.credential |
To configure how to authenticate with Azure Active Directory for all Azure SDKs by default. |
spring.cloud.azure.profile |
To configure the Azure cloud environment for all Azure SDKs by default. |
spring.cloud.azure.proxy |
To configure the proxy options apply to all Azure SDK clients by default. |
spring.cloud.azure.retry |
To configure the retry options apply to all Azure SDK clients by default. |
Properties configured under each Azure service will override the global configurations. |
Spring Cloud Azure unifies configuration properties' prefixes to spring.cloud.azure
since 4.0, which will make configuration properties more consistent and more intuitive. Here’s a quick review of the serivce specific properties.
Azure Service | Configuration Property Prefix | Configuration Properties Link |
---|---|---|
Azure App Configuration |
spring.cloud.azure.appconfiguration |
|
Azure Cosmos DB |
spring.cloud.azure.cosmos |
|
Azure Event Hubs |
spring.cloud.azure.eventhubs |
|
Azure Key Vault Certificates |
spring.cloud.azure.keyvault.certificate |
|
Azure Key Vault Secrets |
spring.cloud.azure.keyvault.secret |
|
Azure Service Bus |
spring.cloud.azure.servicebus |
|
Azure Storage Blob |
spring.cloud.azure.storage.blob |
|
Azure Storage File Share |
spring.cloud.azure.storage.fileshare |
|
Azure Storage Queue |
spring.cloud.azure.storage.queue |