Skip to content

Commit 9c570ed

Browse files
author
SDKAuto
committed
CodeGen from PR 17002 in Azure/azure-rest-api-specs
Merge abaf8f142d1187d2d9e8f691894ff2804f64a953 into 52f9379c7709eb53f15b875b7de9b1abfa17f298
1 parent 4ef8007 commit 9c570ed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+5586
-0
lines changed

‎eng/versioning/version_client.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -324,6 +324,7 @@ com.azure.resourcemanager:azure-resourcemanager-storagepool;1.0.0-beta.1;1.0.0-b
324324
com.azure.resourcemanager:azure-resourcemanager-dataprotection;1.0.0-beta.1;1.0.0-beta.2
325325
com.azure.resourcemanager:azure-resourcemanager-desktopvirtualization;1.0.0-beta.1;1.0.0-beta.2
326326
com.azure.resourcemanager:azure-resourcemanager-loadtestservice;1.0.0-beta.1;1.0.0-beta.2
327+
com.azure.resourcemanager:azure-resourcemanager-windowsesu;1.0.0-beta.1;1.0.0-beta.1
327328
com.azure.tools:azure-sdk-archetype;1.0.0;1.0.0
328329

329330
# Unreleased dependencies: Copy the entry from above, prepend "unreleased_" and remove the current

‎pom.xml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -842,6 +842,7 @@
842842
<module>sdk/videoanalyzer</module>
843843
<module>sdk/vmwarecloudsimple</module>
844844
<module>sdk/webpubsub</module>
845+
<module>sdk/windowsesu</module>
845846
</modules>
846847
</profile>
847848
</profiles>

‎sdk/windowsesu/azure-resourcemanager-windowsesu/CHANGELOG.md‎

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 (2021-12-10)
4+
5+
- Azure Resource Manager Windowsesu client library for Java. This package contains Microsoft Azure SDK for Windowsesu Management SDK. Manage Multi-Access Keys (MAK) that enable Windows Extended Security Updates (ESU). Package tag package-2019-09-16-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).

‎sdk/windowsesu/azure-resourcemanager-windowsesu/README.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
# Azure Resource Manager Windowsesu client library for Java
2+
3+
Azure Resource Manager Windowsesu client library for Java.
4+
5+
This package contains Microsoft Azure SDK for Windowsesu Management SDK. Manage Multi-Access Keys (MAK) that enable Windows Extended Security Updates (ESU). Package tag package-2019-09-16-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
6+
7+
## We'd love to hear your feedback
8+
9+
We're always working on improving our products and the way we communicate with our users. So we'd love to learn what's working and how we can do better.
10+
11+
If you haven't already, please take a few minutes to [complete this short survey][survey] we have put together.
12+
13+
Thank you in advance for your collaboration. We really appreciate your time!
14+
15+
## Documentation
16+
17+
Various documentation is available to help you get started
18+
19+
- [API reference documentation][docs]
20+
21+
## Getting started
22+
23+
### Prerequisites
24+
25+
- [Java Development Kit (JDK)][jdk] with version 8 or above
26+
- [Azure Subscription][azure_subscription]
27+
28+
### Adding the package to your product
29+
30+
[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-windowsesu;current})
31+
```xml
32+
<dependency>
33+
<groupId>com.azure.resourcemanager</groupId>
34+
<artifactId>azure-resourcemanager-windowsesu</artifactId>
35+
<version>1.0.0-beta.1</version>
36+
</dependency>
37+
```
38+
[//]: # ({x-version-update-end})
39+
40+
### Include the recommended packages
41+
42+
Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client.
43+
44+
[Azure Identity][azure_identity] package and [Azure Core Netty HTTP][azure_core_http_netty] package provide the default implementation.
45+
46+
### Authentication
47+
48+
By default, Azure Active Directory token authentication depends on correct configure of following environment variables.
49+
50+
- `AZURE_CLIENT_ID` for Azure client ID.
51+
- `AZURE_TENANT_ID` for Azure tenant ID.
52+
- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate.
53+
54+
In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`.
55+
56+
With above configuration, `azure` client can be authenticated by following code:
57+
58+
```java
59+
AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
60+
TokenCredential credential = new DefaultAzureCredentialBuilder()
61+
.authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
62+
.build();
63+
WindowsesuManager manager = WindowsesuManager
64+
.authenticate(credential, profile);
65+
```
66+
67+
The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise.
68+
69+
See [Authentication][authenticate] for more options.
70+
71+
## Key concepts
72+
73+
See [API design][design] for general introduction on design and key concepts on Azure Management Libraries.
74+
75+
## Examples
76+
77+
[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/windowsesu/azure-resourcemanager-windowsesu/SAMPLE.md)
78+
79+
80+
## Troubleshooting
81+
82+
## Next steps
83+
84+
## Contributing
85+
86+
For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
87+
88+
1. Fork it
89+
1. Create your feature branch (`git checkout -b my-new-feature`)
90+
1. Commit your changes (`git commit -am 'Add some feature'`)
91+
1. Push to the branch (`git push origin my-new-feature`)
92+
1. Create new Pull Request
93+
94+
<!-- LINKS -->
95+
[survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS
96+
[docs]: https://azure.github.io/azure-sdk-for-java/
97+
[jdk]: https://docs.microsoft.com/java/azure/jdk/
98+
[azure_subscription]: https://azure.microsoft.com/free/
99+
[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
100+
[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty
101+
[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
102+
[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md

‎sdk/windowsesu/azure-resourcemanager-windowsesu/SAMPLE.md‎

Lines changed: 192 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,192 @@
1+
# Code snippets and samples
2+
3+
4+
## MultipleActivationKeys
5+
6+
- [Create](#multipleactivationkeys_create)
7+
- [Delete](#multipleactivationkeys_delete)
8+
- [GetByResourceGroup](#multipleactivationkeys_getbyresourcegroup)
9+
- [List](#multipleactivationkeys_list)
10+
- [ListByResourceGroup](#multipleactivationkeys_listbyresourcegroup)
11+
- [Update](#multipleactivationkeys_update)
12+
13+
## Operations
14+
15+
- [List](#operations_list)
16+
### MultipleActivationKeys_Create
17+
18+
```java
19+
import com.azure.resourcemanager.windowsesu.models.OsType;
20+
import com.azure.resourcemanager.windowsesu.models.SupportType;
21+
22+
/** Samples for MultipleActivationKeys Create. */
23+
public final class MultipleActivationKeysCreateSamples {
24+
/*
25+
* x-ms-original-file: specification/windowsesu/resource-manager/Microsoft.WindowsESU/preview/2019-09-16-preview/examples/CreateMultipleActivationKey.json
26+
*/
27+
/**
28+
* Sample code: CreateMultipleActivationKey.
29+
*
30+
* @param manager Entry point to WindowsesuManager.
31+
*/
32+
public static void createMultipleActivationKey(com.azure.resourcemanager.windowsesu.WindowsesuManager manager) {
33+
manager
34+
.multipleActivationKeys()
35+
.define("server08-key-2019")
36+
.withRegion("East US")
37+
.withExistingResourceGroup("testgr1")
38+
.withOsType(OsType.WINDOWS_SERVER2008)
39+
.withSupportType(SupportType.SUPPLEMENTAL_SERVICING)
40+
.withInstalledServerNumber(100)
41+
.withAgreementNumber("1a2b45ag")
42+
.withIsEligible(true)
43+
.create();
44+
}
45+
}
46+
```
47+
48+
### MultipleActivationKeys_Delete
49+
50+
```java
51+
import com.azure.core.util.Context;
52+
53+
/** Samples for MultipleActivationKeys Delete. */
54+
public final class MultipleActivationKeysDeleteSamples {
55+
/*
56+
* x-ms-original-file: specification/windowsesu/resource-manager/Microsoft.WindowsESU/preview/2019-09-16-preview/examples/DeleteMultipleActivationKey.json
57+
*/
58+
/**
59+
* Sample code: DeleteMultipleActivationKey.
60+
*
61+
* @param manager Entry point to WindowsesuManager.
62+
*/
63+
public static void deleteMultipleActivationKey(com.azure.resourcemanager.windowsesu.WindowsesuManager manager) {
64+
manager.multipleActivationKeys().deleteWithResponse("testgr1", "server08-key-2019", Context.NONE);
65+
}
66+
}
67+
```
68+
69+
### MultipleActivationKeys_GetByResourceGroup
70+
71+
```java
72+
import com.azure.core.util.Context;
73+
74+
/** Samples for MultipleActivationKeys GetByResourceGroup. */
75+
public final class MultipleActivationKeysGetByResourceGroupSamples {
76+
/*
77+
* x-ms-original-file: specification/windowsesu/resource-manager/Microsoft.WindowsESU/preview/2019-09-16-preview/examples/GetMultipleActivationKey.json
78+
*/
79+
/**
80+
* Sample code: GetMultipleActivationKey.
81+
*
82+
* @param manager Entry point to WindowsesuManager.
83+
*/
84+
public static void getMultipleActivationKey(com.azure.resourcemanager.windowsesu.WindowsesuManager manager) {
85+
manager.multipleActivationKeys().getByResourceGroupWithResponse("testgr1", "server08-key-2019", Context.NONE);
86+
}
87+
}
88+
```
89+
90+
### MultipleActivationKeys_List
91+
92+
```java
93+
import com.azure.core.util.Context;
94+
95+
/** Samples for MultipleActivationKeys List. */
96+
public final class MultipleActivationKeysListSamples {
97+
/*
98+
* x-ms-original-file: specification/windowsesu/resource-manager/Microsoft.WindowsESU/preview/2019-09-16-preview/examples/ListMultipleActivationKeys.json
99+
*/
100+
/**
101+
* Sample code: ListMultipleActivationKeys.
102+
*
103+
* @param manager Entry point to WindowsesuManager.
104+
*/
105+
public static void listMultipleActivationKeys(com.azure.resourcemanager.windowsesu.WindowsesuManager manager) {
106+
manager.multipleActivationKeys().list(Context.NONE);
107+
}
108+
}
109+
```
110+
111+
### MultipleActivationKeys_ListByResourceGroup
112+
113+
```java
114+
import com.azure.core.util.Context;
115+
116+
/** Samples for MultipleActivationKeys ListByResourceGroup. */
117+
public final class MultipleActivationKeysListByResourceGroupSamples {
118+
/*
119+
* x-ms-original-file: specification/windowsesu/resource-manager/Microsoft.WindowsESU/preview/2019-09-16-preview/examples/ListMultipleActivationKeysByResourceGroup.json
120+
*/
121+
/**
122+
* Sample code: ListMultipleActivationKeys.
123+
*
124+
* @param manager Entry point to WindowsesuManager.
125+
*/
126+
public static void listMultipleActivationKeys(com.azure.resourcemanager.windowsesu.WindowsesuManager manager) {
127+
manager.multipleActivationKeys().listByResourceGroup("testrg1", Context.NONE);
128+
}
129+
}
130+
```
131+
132+
### MultipleActivationKeys_Update
133+
134+
```java
135+
import com.azure.core.util.Context;
136+
import com.azure.resourcemanager.windowsesu.models.MultipleActivationKey;
137+
import java.util.HashMap;
138+
import java.util.Map;
139+
140+
/** Samples for MultipleActivationKeys Update. */
141+
public final class MultipleActivationKeysUpdateSamples {
142+
/*
143+
* x-ms-original-file: specification/windowsesu/resource-manager/Microsoft.WindowsESU/preview/2019-09-16-preview/examples/UpdateMultipleActivationKey.json
144+
*/
145+
/**
146+
* Sample code: UpdateMultipleActivationKey.
147+
*
148+
* @param manager Entry point to WindowsesuManager.
149+
*/
150+
public static void updateMultipleActivationKey(com.azure.resourcemanager.windowsesu.WindowsesuManager manager) {
151+
MultipleActivationKey resource =
152+
manager
153+
.multipleActivationKeys()
154+
.getByResourceGroupWithResponse("testgr1", "server08-key-2019", Context.NONE)
155+
.getValue();
156+
resource.update().withTags(mapOf("tag1", "value1", "tag2", "value2")).apply();
157+
}
158+
159+
@SuppressWarnings("unchecked")
160+
private static <T> Map<String, T> mapOf(Object... inputs) {
161+
Map<String, T> map = new HashMap<>();
162+
for (int i = 0; i < inputs.length; i += 2) {
163+
String key = (String) inputs[i];
164+
T value = (T) inputs[i + 1];
165+
map.put(key, value);
166+
}
167+
return map;
168+
}
169+
}
170+
```
171+
172+
### Operations_List
173+
174+
```java
175+
import com.azure.core.util.Context;
176+
177+
/** Samples for Operations List. */
178+
public final class OperationsListSamples {
179+
/*
180+
* x-ms-original-file: specification/windowsesu/resource-manager/Microsoft.WindowsESU/preview/2019-09-16-preview/examples/ListOperations.json
181+
*/
182+
/**
183+
* Sample code: ListOperations.
184+
*
185+
* @param manager Entry point to WindowsesuManager.
186+
*/
187+
public static void listOperations(com.azure.resourcemanager.windowsesu.WindowsesuManager manager) {
188+
manager.operations().list(Context.NONE);
189+
}
190+
}
191+
```
192+

‎sdk/windowsesu/azure-resourcemanager-windowsesu/pom.xml‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
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-windowsesu</artifactId>
12+
<version>1.0.0-beta.1</version> <!-- {x-version-update;com.azure.resourcemanager:azure-resourcemanager-windowsesu;current} -->
13+
<packaging>jar</packaging>
14+
15+
<name>Microsoft Azure SDK for Windowsesu Management</name>
16+
<description>This package contains Microsoft Azure SDK for Windowsesu Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. Manage Multi-Access Keys (MAK) that enable Windows Extended Security Updates (ESU). Package tag package-2019-09-16-preview.</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:git@github.com:Azure/azure-sdk-for-java.git</connection>
30+
<developerConnection>scm:git:git@github.com: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+
<jacoco.skip>true</jacoco.skip>
42+
<codesnippet.skip>false</codesnippet.skip>
43+
<javadocDoclet></javadocDoclet>
44+
<javadocDocletOptions></javadocDocletOptions>
45+
</properties>
46+
<dependencies>
47+
<dependency>
48+
<groupId>com.azure</groupId>
49+
<artifactId>azure-core</artifactId>
50+
<version>1.23.1</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
51+
</dependency>
52+
<dependency>
53+
<groupId>com.azure</groupId>
54+
<artifactId>azure-core-management</artifactId>
55+
<version>1.4.4</version> <!-- {x-version-update;com.azure:azure-core-management;dependency} -->
56+
</dependency>
57+
</dependencies>
58+
<build>
59+
<plugins>
60+
<plugin>
61+
<groupId>org.revapi</groupId>
62+
<artifactId>revapi-maven-plugin</artifactId>
63+
<version>0.11.2</version> <!-- {x-version-update;org.revapi:revapi-maven-plugin;external_dependency} -->
64+
<configuration>
65+
<analysisConfiguration>
66+
<revapi.ignore>
67+
<item>
68+
<code>java.method.addedToInterface</code>
69+
</item>
70+
<item>
71+
<regex>true</regex>
72+
<code>.*</code>
73+
<package>com\.azure\.resourcemanager(\.[^.]+)+\.fluent(\.[^.]+)*</package>
74+
</item>
75+
</revapi.ignore>
76+
</analysisConfiguration>
77+
</configuration>
78+
</plugin>
79+
</plugins>
80+
</build>
81+
</project>

0 commit comments

Comments
 (0)