Skip to content

Commit 1e8c0be

Browse files
author
SDKAuto
committed
CodeGen from PR 19389 in Azure/azure-rest-api-specs
Merge a3e44e3b559225047402a24b10fba1bc5a7d9737 into 4124b7c2773a714303299f0cfd742b0d26d3bb5d
1 parent 1340cb6 commit 1e8c0be

File tree

54 files changed

+6237
-0
lines changed

Some content is hidden

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

54 files changed

+6237
-0
lines changed

‎eng/versioning/version_client.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -350,6 +350,7 @@ com.azure.resourcemanager:azure-resourcemanager-dynatrace;1.0.0-beta.1;1.0.0-bet
350350
com.azure.resourcemanager:azure-resourcemanager-deviceupdate;1.0.0-beta.1;1.0.0-beta.2
351351
com.azure.resourcemanager:azure-resourcemanager-machinelearning;1.0.0-beta.2;1.0.0-beta.3
352352
com.azure.resourcemanager:azure-resourcemanager-education;1.0.0-beta.1;1.0.0-beta.2
353+
com.azure.resourcemanager:azure-resourcemanager-resourceconnector;1.0.0-beta.1;1.0.0-beta.1
353354
com.azure.tools:azure-sdk-archetype;1.0.0;1.2.0-beta.1
354355
com.azure.tools:azure-sdk-build-tool;1.0.0-beta.1;1.0.0-beta.2
355356

‎pom.xml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -957,6 +957,7 @@
957957
<module>sdk/redisenterprise</module>
958958
<module>sdk/relay</module>
959959
<module>sdk/remoterendering</module>
960+
<module>sdk/resourceconnector</module>
960961
<module>sdk/resourcegraph</module>
961962
<module>sdk/resourcehealth</module>
962963
<module>sdk/resourcemanager</module>

‎sdk/resourceconnector/azure-resourcemanager-resourceconnector/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 (2022-06-10)
4+
5+
- Azure Resource Manager Appliances client library for Java. This package contains Microsoft Azure SDK for Appliances Management SDK. The appliances Rest API spec. Package tag package-2021-10-31-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).

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

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
# Azure Resource Manager Appliances client library for Java
2+
3+
Azure Resource Manager Appliances client library for Java.
4+
5+
This package contains Microsoft Azure SDK for Appliances Management SDK. The appliances Rest API spec. Package tag package-2021-10-31-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-resourceconnector;current})
31+
```xml
32+
<dependency>
33+
<groupId>com.azure.resourcemanager</groupId>
34+
<artifactId>azure-resourcemanager-resourceconnector</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+
AppliancesManager manager = AppliancesManager
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/resourceconnector/azure-resourcemanager-resourceconnector/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/resourceconnector/azure-resourcemanager-resourceconnector/SAMPLE.md

Lines changed: 214 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,214 @@
1+
# Code snippets and samples
2+
3+
4+
## Appliances
5+
6+
- [CreateOrUpdate](#appliances_createorupdate)
7+
- [Delete](#appliances_delete)
8+
- [GetByResourceGroup](#appliances_getbyresourcegroup)
9+
- [List](#appliances_list)
10+
- [ListByResourceGroup](#appliances_listbyresourcegroup)
11+
- [ListClusterUserCredential](#appliances_listclusterusercredential)
12+
- [ListOperations](#appliances_listoperations)
13+
- [Update](#appliances_update)
14+
### Appliances_CreateOrUpdate
15+
16+
```java
17+
import com.azure.resourcemanager.resourceconnector.models.AppliancePropertiesInfrastructureConfig;
18+
import com.azure.resourcemanager.resourceconnector.models.Distro;
19+
import com.azure.resourcemanager.resourceconnector.models.Provider;
20+
21+
/** Samples for Appliances CreateOrUpdate. */
22+
public final class AppliancesCreateOrUpdateSamples {
23+
/*
24+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesCreate_Update.json
25+
*/
26+
/**
27+
* Sample code: Create/Update Appliance.
28+
*
29+
* @param manager Entry point to AppliancesManager.
30+
*/
31+
public static void createUpdateAppliance(com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
32+
manager
33+
.appliances()
34+
.define("appliance01")
35+
.withRegion("West US")
36+
.withExistingResourceGroup("testresourcegroup")
37+
.withDistro(Distro.AKSEDGE)
38+
.withInfrastructureConfig(new AppliancePropertiesInfrastructureConfig().withProvider(Provider.VMWARE))
39+
.create();
40+
}
41+
}
42+
```
43+
44+
### Appliances_Delete
45+
46+
```java
47+
import com.azure.core.util.Context;
48+
49+
/** Samples for Appliances Delete. */
50+
public final class AppliancesDeleteSamples {
51+
/*
52+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesDelete.json
53+
*/
54+
/**
55+
* Sample code: Delete Appliance.
56+
*
57+
* @param manager Entry point to AppliancesManager.
58+
*/
59+
public static void deleteAppliance(com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
60+
manager.appliances().delete("testresourcegroup", "appliance01", Context.NONE);
61+
}
62+
}
63+
```
64+
65+
### Appliances_GetByResourceGroup
66+
67+
```java
68+
import com.azure.core.util.Context;
69+
70+
/** Samples for Appliances GetByResourceGroup. */
71+
public final class AppliancesGetByResourceGroupSamples {
72+
/*
73+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesGet.json
74+
*/
75+
/**
76+
* Sample code: Get Appliance.
77+
*
78+
* @param manager Entry point to AppliancesManager.
79+
*/
80+
public static void getAppliance(com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
81+
manager.appliances().getByResourceGroupWithResponse("testresourcegroup", "appliance01", Context.NONE);
82+
}
83+
}
84+
```
85+
86+
### Appliances_List
87+
88+
```java
89+
import com.azure.core.util.Context;
90+
91+
/** Samples for Appliances List. */
92+
public final class AppliancesListSamples {
93+
/*
94+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesListBySubscription.json
95+
*/
96+
/**
97+
* Sample code: List Appliances by subscription.
98+
*
99+
* @param manager Entry point to AppliancesManager.
100+
*/
101+
public static void listAppliancesBySubscription(
102+
com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
103+
manager.appliances().list(Context.NONE);
104+
}
105+
}
106+
```
107+
108+
### Appliances_ListByResourceGroup
109+
110+
```java
111+
import com.azure.core.util.Context;
112+
113+
/** Samples for Appliances ListByResourceGroup. */
114+
public final class AppliancesListByResourceGroupSamples {
115+
/*
116+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesListByResourceGroup.json
117+
*/
118+
/**
119+
* Sample code: List Appliances by resource group.
120+
*
121+
* @param manager Entry point to AppliancesManager.
122+
*/
123+
public static void listAppliancesByResourceGroup(
124+
com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
125+
manager.appliances().listByResourceGroup("testresourcegroup", Context.NONE);
126+
}
127+
}
128+
```
129+
130+
### Appliances_ListClusterUserCredential
131+
132+
```java
133+
import com.azure.core.util.Context;
134+
135+
/** Samples for Appliances ListClusterUserCredential. */
136+
public final class AppliancesListClusterUserCredentialSamples {
137+
/*
138+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesListClusterUserCredential.json
139+
*/
140+
/**
141+
* Sample code: ListClusterUserCredentialAppliance.
142+
*
143+
* @param manager Entry point to AppliancesManager.
144+
*/
145+
public static void listClusterUserCredentialAppliance(
146+
com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
147+
manager
148+
.appliances()
149+
.listClusterUserCredentialWithResponse("testresourcegroup", "testresourcename", Context.NONE);
150+
}
151+
}
152+
```
153+
154+
### Appliances_ListOperations
155+
156+
```java
157+
import com.azure.core.util.Context;
158+
159+
/** Samples for Appliances ListOperations. */
160+
public final class AppliancesListOperationsSamples {
161+
/*
162+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesListOperations.json
163+
*/
164+
/**
165+
* Sample code: List Appliances operations.
166+
*
167+
* @param manager Entry point to AppliancesManager.
168+
*/
169+
public static void listAppliancesOperations(com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
170+
manager.appliances().listOperations(Context.NONE);
171+
}
172+
}
173+
```
174+
175+
### Appliances_Update
176+
177+
```java
178+
import com.azure.core.util.Context;
179+
import com.azure.resourcemanager.resourceconnector.models.Appliance;
180+
import java.util.HashMap;
181+
import java.util.Map;
182+
183+
/** Samples for Appliances Update. */
184+
public final class AppliancesUpdateSamples {
185+
/*
186+
* x-ms-original-file: specification/resourceconnector/resource-manager/Microsoft.ResourceConnector/preview/2021-10-31-preview/examples/AppliancesPatch.json
187+
*/
188+
/**
189+
* Sample code: Update Appliance.
190+
*
191+
* @param manager Entry point to AppliancesManager.
192+
*/
193+
public static void updateAppliance(com.azure.resourcemanager.resourceconnector.AppliancesManager manager) {
194+
Appliance resource =
195+
manager
196+
.appliances()
197+
.getByResourceGroupWithResponse("testresourcegroup", "appliance01", Context.NONE)
198+
.getValue();
199+
resource.update().withTags(mapOf("key", "value")).apply();
200+
}
201+
202+
@SuppressWarnings("unchecked")
203+
private static <T> Map<String, T> mapOf(Object... inputs) {
204+
Map<String, T> map = new HashMap<>();
205+
for (int i = 0; i < inputs.length; i += 2) {
206+
String key = (String) inputs[i];
207+
T value = (T) inputs[i + 1];
208+
map.put(key, value);
209+
}
210+
return map;
211+
}
212+
}
213+
```
214+

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

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
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-resourceconnector</artifactId>
12+
<version>1.0.0-beta.1</version> <!-- {x-version-update;com.azure.resourcemanager:azure-resourcemanager-resourceconnector;current} -->
13+
<packaging>jar</packaging>
14+
15+
<name>Microsoft Azure SDK for Appliances Management</name>
16+
<description>This package contains Microsoft Azure SDK for Appliances Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. The appliances Rest API spec. Package tag package-2021-10-31-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:[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+
<jacoco.skip>true</jacoco.skip>
42+
</properties>
43+
<dependencies>
44+
<dependency>
45+
<groupId>com.azure</groupId>
46+
<artifactId>azure-core</artifactId>
47+
<version>1.29.1</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
48+
</dependency>
49+
<dependency>
50+
<groupId>com.azure</groupId>
51+
<artifactId>azure-core-management</artifactId>
52+
<version>1.6.2</version> <!-- {x-version-update;com.azure:azure-core-management;dependency} -->
53+
</dependency>
54+
</dependencies>
55+
</project>

0 commit comments

Comments
 (0)