Skip to content

Commit e5a708f

Browse files
author
SDKAuto
committed
CodeGen from PR 12243 in Azure/azure-rest-api-specs
Merge 5aaa4b3e04507d31e01c163295e20daa5024e8a7 into dab488ef4572b30dee885044331326f8d1c8d329
1 parent 34a28f2 commit e5a708f

28 files changed

+5270
-0
lines changed

eng/versioning/version_client.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -187,6 +187,7 @@ com.azure.resourcemanager:azure-resourcemanager-recoveryservices;1.0.0-beta.1;1.
187187
com.azure.resourcemanager:azure-resourcemanager-kusto;1.0.0-beta.1;1.0.0-beta.2
188188
com.azure.resourcemanager:azure-resourcemanager-loganalytics;1.0.0-beta.1;1.0.0-beta.2
189189
com.azure.resourcemanager:azure-resourcemanager-eventgrid;1.0.0-beta.1;1.0.0-beta.2
190+
com.azure.resourcemanager:azure-resourcemanager-authorization-generated;1.0.0-beta.1;1.0.0-beta.1
190191
com.microsoft:microsoft-opentelemetry-exporter-azuremonitor;1.0.0-beta.1;1.0.0-beta.2
191192

192193

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Release History
2+
3+
## 1.0.0-beta.1 (2020-12-29)
4+
5+
- Azure Resource Manager Authorization client library for Java. This package contains Microsoft Azure SDK for Authorization Management SDK. Role based access control provides you a way to apply granular level policy administration down to individual resources or resource groups. These operations enable you to manage role assignments. A role assignment grants access to Azure Active Directory users. Package tag package-2020-04-01-preview-only. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# Azure Resource Manager Authorization client library for Java
2+
3+
Azure Resource Manager Authorization client library for Java.
4+
5+
This package contains Microsoft Azure SDK for Authorization Management SDK. Role based access control provides you a way to apply granular level policy administration down to individual resources or resource groups. These operations enable you to manage role assignments. A role assignment grants access to Azure Active Directory users. Package tag package-2020-04-01-preview-only. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
6+
7+
## Getting started
8+
9+
### Prerequisites
10+
11+
- [Java Development Kit (JDK)][jdk] with version 8 or above
12+
- [Azure Subscription][azure_subscription]
13+
14+
### Adding the package to your product
15+
16+
[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-authorization-generated;current})
17+
```xml
18+
<dependency>
19+
<groupId>com.azure.resourcemanager</groupId>
20+
<artifactId>azure-resourcemanager-authorization-generated</artifactId>
21+
<version>1.0.0-beta.1</version>
22+
</dependency>
23+
```
24+
[//]: # ({x-version-update-end})
25+
26+
### Include the recommended packages
27+
28+
Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client.
29+
30+
[Azure Identity][azure_identity] package and [Azure Core Netty HTTP][azure_core_http_netty] package provide the default implementation.
31+
32+
### Authentication
33+
34+
By default, Azure Active Directory token authentication depends on correct configure of following environment variables.
35+
36+
- `AZURE_CLIENT_ID` for Azure client ID.
37+
- `AZURE_TENANT_ID` for Azure tenant ID.
38+
- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate.
39+
40+
In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`.
41+
42+
With above configuration, `azure` client can be authenticated by following code:
43+
44+
```java
45+
AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
46+
TokenCredential credential = new DefaultAzureCredentialBuilder()
47+
.authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
48+
.build();
49+
AuthorizationManager manager = AuthorizationManager
50+
.authenticate(credential, profile);
51+
```
52+
53+
The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise.
54+
55+
See [Authentication][authenticate] for more options.
56+
57+
## Key concepts
58+
59+
See [API design][design] for general introduction on design and key concepts on Azure Management Libraries.
60+
61+
## Examples
62+
63+
## Troubleshooting
64+
65+
## Next steps
66+
67+
## Contributing
68+
69+
For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/master/CONTRIBUTING.md).
70+
71+
1. Fork it
72+
1. Create your feature branch (`git checkout -b my-new-feature`)
73+
1. Commit your changes (`git commit -am 'Add some feature'`)
74+
1. Push to the branch (`git push origin my-new-feature`)
75+
1. Create new Pull Request
76+
77+
<!-- LINKS -->
78+
[jdk]: https://docs.microsoft.com/java/azure/jdk/
79+
[azure_subscription]: https://azure.microsoft.com/free/
80+
[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/identity/azure-identity
81+
[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/core/azure-core-http-netty
82+
[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/resourcemanager/docs/AUTH.md
83+
[design]: https://github.com/Azure/azure-sdk-for-java/blob/master/sdk/resourcemanager/docs/DESIGN.md
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
<project xmlns="http://maven.apache.org/POM/4.0.0" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
2+
<modelVersion>4.0.0</modelVersion>
3+
<parent>
4+
<groupId>com.azure</groupId>
5+
<artifactId>azure-client-sdk-parent</artifactId>
6+
<version>1.7.0</version> <!-- {x-version-update;com.azure:azure-client-sdk-parent;current} -->
7+
<relativePath>../../parents/azure-client-sdk-parent</relativePath>
8+
</parent>
9+
10+
<groupId>com.azure.resourcemanager</groupId>
11+
<artifactId>azure-resourcemanager-authorization-generated</artifactId>
12+
<version>1.0.0-beta.1</version> <!-- {x-version-update;com.azure.resourcemanager:azure-resourcemanager-authorization-generated;current} -->
13+
<packaging>jar</packaging>
14+
15+
<name>Microsoft Azure SDK for Authorization Management</name>
16+
<description>This package contains Microsoft Azure SDK for Authorization Management SDK. Role based access control provides you a way to apply granular level policy administration down to individual resources or resource groups. These operations enable you to manage role assignments. A role assignment grants access to Azure Active Directory users. Package tag package-2020-04-01-preview-only. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt</description>
17+
<url>https://github.com/Azure/azure-sdk-for-java</url>
18+
19+
<licenses>
20+
<license>
21+
<name>The MIT License (MIT)</name>
22+
<url>http://opensource.org/licenses/MIT</url>
23+
<distribution>repo</distribution>
24+
</license>
25+
</licenses>
26+
27+
<scm>
28+
<url>https://github.com/Azure/azure-sdk-for-java</url>
29+
<connection>scm:git:[email protected]:Azure/azure-sdk-for-java.git</connection>
30+
<developerConnection>scm:git:[email protected]:Azure/azure-sdk-for-java.git</developerConnection>
31+
<tag>HEAD</tag>
32+
</scm>
33+
<developers>
34+
<developer>
35+
<id>microsoft</id>
36+
<name>Microsoft</name>
37+
</developer>
38+
</developers>
39+
<properties>
40+
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
41+
<legal><![CDATA[[INFO] Any downloads listed may be third party software. Microsoft grants you no rights for third party software.]]></legal>
42+
</properties>
43+
<dependencies>
44+
<dependency>
45+
<groupId>com.azure</groupId>
46+
<artifactId>azure-core-management</artifactId>
47+
<version>1.0.0</version> <!-- {x-version-update;com.azure:azure-core-management;dependency} -->
48+
</dependency>
49+
</dependencies>
50+
<build>
51+
<plugins>
52+
<plugin>
53+
<groupId>org.jacoco</groupId>
54+
<artifactId>jacoco-maven-plugin</artifactId>
55+
<version>0.8.5</version> <!-- {x-version-update;org.jacoco:jacoco-maven-plugin;external_dependency} -->
56+
<configuration>
57+
<skip>true</skip>
58+
</configuration>
59+
</plugin>
60+
</plugins>
61+
</build>
62+
</project>
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,204 @@
1+
// Copyright (c) Microsoft Corporation. All rights reserved.
2+
// Licensed under the MIT License.
3+
// Code generated by Microsoft (R) AutoRest Code Generator.
4+
5+
package com.azure.resourcemanager.authorization.generated;
6+
7+
import com.azure.core.credential.TokenCredential;
8+
import com.azure.core.http.HttpClient;
9+
import com.azure.core.http.HttpPipeline;
10+
import com.azure.core.http.HttpPipelineBuilder;
11+
import com.azure.core.http.policy.AddDatePolicy;
12+
import com.azure.core.http.policy.BearerTokenAuthenticationPolicy;
13+
import com.azure.core.http.policy.HttpLogOptions;
14+
import com.azure.core.http.policy.HttpLoggingPolicy;
15+
import com.azure.core.http.policy.HttpPipelinePolicy;
16+
import com.azure.core.http.policy.HttpPolicyProviders;
17+
import com.azure.core.http.policy.RequestIdPolicy;
18+
import com.azure.core.http.policy.RetryPolicy;
19+
import com.azure.core.http.policy.UserAgentPolicy;
20+
import com.azure.core.management.profile.AzureProfile;
21+
import com.azure.core.util.Configuration;
22+
import com.azure.core.util.logging.ClientLogger;
23+
import com.azure.resourcemanager.authorization.generated.fluent.AuthorizationManagementClient;
24+
import com.azure.resourcemanager.authorization.generated.implementation.AuthorizationManagementClientBuilder;
25+
import com.azure.resourcemanager.authorization.generated.implementation.RoleAssignmentsImpl;
26+
import com.azure.resourcemanager.authorization.generated.models.RoleAssignments;
27+
import java.time.Duration;
28+
import java.time.temporal.ChronoUnit;
29+
import java.util.ArrayList;
30+
import java.util.List;
31+
import java.util.Objects;
32+
33+
/**
34+
* Entry point to AuthorizationManager. Role based access control provides you a way to apply granular level policy
35+
* administration down to individual resources or resource groups. These operations enable you to manage role
36+
* assignments. A role assignment grants access to Azure Active Directory users.
37+
*/
38+
public final class AuthorizationManager {
39+
private RoleAssignments roleAssignments;
40+
41+
private final AuthorizationManagementClient clientObject;
42+
43+
private AuthorizationManager(HttpPipeline httpPipeline, AzureProfile profile, Duration defaultPollInterval) {
44+
Objects.requireNonNull(httpPipeline, "'httpPipeline' cannot be null.");
45+
Objects.requireNonNull(profile, "'profile' cannot be null.");
46+
this.clientObject =
47+
new AuthorizationManagementClientBuilder()
48+
.pipeline(httpPipeline)
49+
.endpoint(profile.getEnvironment().getResourceManagerEndpoint())
50+
.subscriptionId(profile.getSubscriptionId())
51+
.defaultPollInterval(defaultPollInterval)
52+
.buildClient();
53+
}
54+
55+
/**
56+
* Creates an instance of Authorization service API entry point.
57+
*
58+
* @param credential the credential to use.
59+
* @param profile the Azure profile for client.
60+
* @return the Authorization service API instance.
61+
*/
62+
public static AuthorizationManager authenticate(TokenCredential credential, AzureProfile profile) {
63+
Objects.requireNonNull(credential, "'credential' cannot be null.");
64+
Objects.requireNonNull(profile, "'profile' cannot be null.");
65+
return configure().authenticate(credential, profile);
66+
}
67+
68+
/**
69+
* Gets a Configurable instance that can be used to create AuthorizationManager with optional configuration.
70+
*
71+
* @return the Configurable instance allowing configurations.
72+
*/
73+
public static Configurable configure() {
74+
return new AuthorizationManager.Configurable();
75+
}
76+
77+
/** The Configurable allowing configurations to be set. */
78+
public static final class Configurable {
79+
private final ClientLogger logger = new ClientLogger(Configurable.class);
80+
81+
private HttpClient httpClient;
82+
private HttpLogOptions httpLogOptions;
83+
private final List<HttpPipelinePolicy> policies = new ArrayList<>();
84+
private RetryPolicy retryPolicy;
85+
private Duration defaultPollInterval;
86+
87+
private Configurable() {
88+
}
89+
90+
/**
91+
* Sets the http client.
92+
*
93+
* @param httpClient the HTTP client.
94+
* @return the configurable object itself.
95+
*/
96+
public Configurable withHttpClient(HttpClient httpClient) {
97+
this.httpClient = Objects.requireNonNull(httpClient, "'httpClient' cannot be null.");
98+
return this;
99+
}
100+
101+
/**
102+
* Sets the logging options to the HTTP pipeline.
103+
*
104+
* @param httpLogOptions the HTTP log options.
105+
* @return the configurable object itself.
106+
*/
107+
public Configurable withLogOptions(HttpLogOptions httpLogOptions) {
108+
this.httpLogOptions = Objects.requireNonNull(httpLogOptions, "'httpLogOptions' cannot be null.");
109+
return this;
110+
}
111+
112+
/**
113+
* Adds the pipeline policy to the HTTP pipeline.
114+
*
115+
* @param policy the HTTP pipeline policy.
116+
* @return the configurable object itself.
117+
*/
118+
public Configurable withPolicy(HttpPipelinePolicy policy) {
119+
this.policies.add(Objects.requireNonNull(policy, "'policy' cannot be null."));
120+
return this;
121+
}
122+
123+
/**
124+
* Sets the retry policy to the HTTP pipeline.
125+
*
126+
* @param retryPolicy the HTTP pipeline retry policy.
127+
* @return the configurable object itself.
128+
*/
129+
public Configurable withRetryPolicy(RetryPolicy retryPolicy) {
130+
this.retryPolicy = Objects.requireNonNull(retryPolicy, "'retryPolicy' cannot be null.");
131+
return this;
132+
}
133+
134+
/**
135+
* Sets the default poll interval, used when service does not provide "Retry-After" header.
136+
*
137+
* @param defaultPollInterval the default poll interval.
138+
* @return the configurable object itself.
139+
*/
140+
public Configurable withDefaultPollInterval(Duration defaultPollInterval) {
141+
this.defaultPollInterval = Objects.requireNonNull(defaultPollInterval, "'retryPolicy' cannot be null.");
142+
if (this.defaultPollInterval.isNegative()) {
143+
throw logger.logExceptionAsError(new IllegalArgumentException("'httpPipeline' cannot be negative"));
144+
}
145+
return this;
146+
}
147+
148+
/**
149+
* Creates an instance of Authorization service API entry point.
150+
*
151+
* @param credential the credential to use.
152+
* @param profile the Azure profile for client.
153+
* @return the Authorization service API instance.
154+
*/
155+
public AuthorizationManager authenticate(TokenCredential credential, AzureProfile profile) {
156+
Objects.requireNonNull(credential, "'credential' cannot be null.");
157+
Objects.requireNonNull(profile, "'profile' cannot be null.");
158+
159+
if (retryPolicy == null) {
160+
retryPolicy = new RetryPolicy("Retry-After", ChronoUnit.SECONDS);
161+
}
162+
List<HttpPipelinePolicy> policies = new ArrayList<>();
163+
policies
164+
.add(
165+
new UserAgentPolicy(
166+
null,
167+
"com.azure.resourcemanager.authorization.generated",
168+
"1.0.0-beta.1",
169+
Configuration.getGlobalConfiguration()));
170+
policies.add(new RequestIdPolicy());
171+
HttpPolicyProviders.addBeforeRetryPolicies(policies);
172+
policies.add(retryPolicy);
173+
policies.add(new AddDatePolicy());
174+
policies
175+
.add(
176+
new BearerTokenAuthenticationPolicy(
177+
credential, profile.getEnvironment().getManagementEndpoint() + "/.default"));
178+
HttpPolicyProviders.addAfterRetryPolicies(policies);
179+
policies.add(new HttpLoggingPolicy(httpLogOptions));
180+
HttpPipeline httpPipeline =
181+
new HttpPipelineBuilder()
182+
.httpClient(httpClient)
183+
.policies(policies.toArray(new HttpPipelinePolicy[0]))
184+
.build();
185+
return new AuthorizationManager(httpPipeline, profile, defaultPollInterval);
186+
}
187+
}
188+
189+
/** @return Resource collection API of RoleAssignments. */
190+
public RoleAssignments roleAssignments() {
191+
if (this.roleAssignments == null) {
192+
this.roleAssignments = new RoleAssignmentsImpl(clientObject.getRoleAssignments(), this);
193+
}
194+
return roleAssignments;
195+
}
196+
197+
/**
198+
* @return Wrapped service client AuthorizationManagementClient providing direct access to the underlying
199+
* auto-generated API implementation, based on Azure REST API.
200+
*/
201+
public AuthorizationManagementClient serviceClient() {
202+
return this.clientObject;
203+
}
204+
}

0 commit comments

Comments
 (0)