Share via

Azure Resource Manager Cosmos client library for Java - version 2.44.1

  • Article

Azure Resource Manager Cosmos client library for Java

For documentation on how to use this package, please see Azure Management Libraries for Java.

Getting started

Prerequisites

Adding the package to your product

<dependency>
    <groupId>com.azure.resourcemanager</groupId>
    <artifactId>azure-resourcemanager-cosmos</artifactId>
    <version>2.44.1</version>
</dependency>

Azure Management Libraries require a TokenCredential implementation for authentication and an HttpClient implementation for HTTP client.

Azure Identity package and Azure Core Netty HTTP package provide the default implementation.

Authentication

Microsoft Entra ID token authentication relies on the credential class from Azure Identity package.

Azure subscription ID can be configured via AZURE_SUBSCRIPTION_ID environment variable. Azure tenant ID can be configured via AZURE_TENANT_ID environment variable.

Assuming the use of the DefaultAzureCredential credential class, the client can be authenticated using the following code:

AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
TokenCredential credential = new DefaultAzureCredentialBuilder()
    .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
    .build();
CosmosManager manager = CosmosManager
    .authenticate(credential, profile);

The sample code assumes global Azure. Please change AzureEnvironment.AZURE variable if otherwise.

See Authentication for more options.

Key concepts

See API design for general introduction on design and key concepts on Azure Management Libraries.

Examples

See Samples for code snippets and samples.

Troubleshooting

Next steps

Contributing

For details on contributing to this repository, see the contributing guide.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request