Skip to content

Commit a52aac7

Browse files
author
SDKAuto
committed
CodeGen from PR 17667 in Azure/azure-rest-api-specs
Merge 7a6f63393a3d70a61ee2253e62ec2b4e3866a52f into 18a4efa19a1e7c3709397b6ff33c69b63e4927a8
1 parent 6bafa1d commit a52aac7

Some content is hidden

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

53 files changed

+5943
-0
lines changed

eng/versioning/version_client.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -335,6 +335,7 @@ com.azure.resourcemanager:azure-resourcemanager-automanage;1.0.0-beta.1;1.0.0-be
335335
com.azure.resourcemanager:azure-resourcemanager-edgeorder;1.0.0-beta.1;1.0.0-beta.2
336336
com.azure.resourcemanager:azure-resourcemanager-securityinsights;1.0.0-beta.1;1.0.0-beta.2
337337
com.azure.resourcemanager:azure-resourcemanager-oep;1.0.0-beta.1;1.0.0-beta.2
338+
com.azure.resourcemanager:azure-resourcemanager-dashboard;1.0.0-beta.1;1.0.0-beta.1
338339
com.azure.tools:azure-sdk-archetype;1.0.0;1.0.0
339340

340341
# 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
@@ -871,6 +871,7 @@
871871
<module>sdk/cosmos</module>
872872
<module>sdk/costmanagement</module>
873873
<module>sdk/customerinsights</module>
874+
<module>sdk/dashboard</module>
874875
<module>sdk/databox</module>
875876
<module>sdk/databoxedge</module>
876877
<module>sdk/databricks</module>
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-02-17)
4+
5+
- Azure Resource Manager Dashboard client library for Java. This package contains Microsoft Azure SDK for Dashboard Management SDK. The Microsoft.Dashboard Rest API spec. Package tag package-2021-09-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
# Azure Resource Manager Dashboard client library for Java
2+
3+
Azure Resource Manager Dashboard client library for Java.
4+
5+
This package contains Microsoft Azure SDK for Dashboard Management SDK. The Microsoft.Dashboard Rest API spec. Package tag package-2021-09-01-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-dashboard;current})
31+
```xml
32+
<dependency>
33+
<groupId>com.azure.resourcemanager</groupId>
34+
<artifactId>azure-resourcemanager-dashboard</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+
DashboardManager manager = DashboardManager
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/dashboard/azure-resourcemanager-dashboard/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
Lines changed: 177 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,177 @@
1+
# Code snippets and samples
2+
3+
4+
## Grafana
5+
6+
- [Create](#grafana_create)
7+
- [Delete](#grafana_delete)
8+
- [GetByResourceGroup](#grafana_getbyresourcegroup)
9+
- [List](#grafana_list)
10+
- [ListByResourceGroup](#grafana_listbyresourcegroup)
11+
- [Update](#grafana_update)
12+
13+
## Operations
14+
15+
- [List](#operations_list)
16+
### Grafana_Create
17+
18+
```java
19+
/** Samples for Grafana Create. */
20+
public final class GrafanaCreateSamples {
21+
/*
22+
* x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Create.json
23+
*/
24+
/**
25+
* Sample code: Grafana_Create.
26+
*
27+
* @param manager Entry point to DashboardManager.
28+
*/
29+
public static void grafanaCreate(com.azure.resourcemanager.dashboard.DashboardManager manager) {
30+
manager
31+
.grafanas()
32+
.define("myWorkspace")
33+
.withRegion((String) null)
34+
.withExistingResourceGroup("00000000-0000-0000-0000-000000000000", "myResourceGroup")
35+
.create();
36+
}
37+
}
38+
```
39+
40+
### Grafana_Delete
41+
42+
```java
43+
import com.azure.core.util.Context;
44+
45+
/** Samples for Grafana Delete. */
46+
public final class GrafanaDeleteSamples {
47+
/*
48+
* x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Delete.json
49+
*/
50+
/**
51+
* Sample code: Grafana_Delete.
52+
*
53+
* @param manager Entry point to DashboardManager.
54+
*/
55+
public static void grafanaDelete(com.azure.resourcemanager.dashboard.DashboardManager manager) {
56+
manager
57+
.grafanas()
58+
.delete("00000000-0000-0000-0000-000000000000", "myResourceGroup", "myWorkspace", Context.NONE);
59+
}
60+
}
61+
```
62+
63+
### Grafana_GetByResourceGroup
64+
65+
```java
66+
import com.azure.core.util.Context;
67+
68+
/** Samples for Grafana GetByResourceGroup. */
69+
public final class GrafanaGetByResourceGroupSamples {
70+
/*
71+
* x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Get.json
72+
*/
73+
/**
74+
* Sample code: Grafana_Get.
75+
*
76+
* @param manager Entry point to DashboardManager.
77+
*/
78+
public static void grafanaGet(com.azure.resourcemanager.dashboard.DashboardManager manager) {
79+
manager
80+
.grafanas()
81+
.getByResourceGroupWithResponse(
82+
"00000000-0000-0000-0000-000000000000", "myResourceGroup", "myWorkspace", Context.NONE);
83+
}
84+
}
85+
```
86+
87+
### Grafana_List
88+
89+
```java
90+
import com.azure.core.util.Context;
91+
92+
/** Samples for Grafana List. */
93+
public final class GrafanaListSamples {
94+
/*
95+
* x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_List.json
96+
*/
97+
/**
98+
* Sample code: Grafana_List.
99+
*
100+
* @param manager Entry point to DashboardManager.
101+
*/
102+
public static void grafanaList(com.azure.resourcemanager.dashboard.DashboardManager manager) {
103+
manager.grafanas().list("00000000-0000-0000-0000-000000000000", Context.NONE);
104+
}
105+
}
106+
```
107+
108+
### Grafana_ListByResourceGroup
109+
110+
```java
111+
import com.azure.core.util.Context;
112+
113+
/** Samples for Grafana ListByResourceGroup. */
114+
public final class GrafanaListByResourceGroupSamples {
115+
/*
116+
* x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_ListByResourceGroup.json
117+
*/
118+
/**
119+
* Sample code: Grafana_ListByResourceGroup.
120+
*
121+
* @param manager Entry point to DashboardManager.
122+
*/
123+
public static void grafanaListByResourceGroup(com.azure.resourcemanager.dashboard.DashboardManager manager) {
124+
manager.grafanas().listByResourceGroup("00000000-0000-0000-0000-000000000000", "myResourceGroup", Context.NONE);
125+
}
126+
}
127+
```
128+
129+
### Grafana_Update
130+
131+
```java
132+
import com.azure.core.util.Context;
133+
import com.azure.resourcemanager.dashboard.models.GrafanaResource;
134+
135+
/** Samples for Grafana Update. */
136+
public final class GrafanaUpdateSamples {
137+
/*
138+
* x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Update.json
139+
*/
140+
/**
141+
* Sample code: Grafana_Update.
142+
*
143+
* @param manager Entry point to DashboardManager.
144+
*/
145+
public static void grafanaUpdate(com.azure.resourcemanager.dashboard.DashboardManager manager) {
146+
GrafanaResource resource =
147+
manager
148+
.grafanas()
149+
.getByResourceGroupWithResponse(
150+
"00000000-0000-0000-0000-000000000000", "myResourceGroup", "myWorkspace", Context.NONE)
151+
.getValue();
152+
resource.update().apply();
153+
}
154+
}
155+
```
156+
157+
### Operations_List
158+
159+
```java
160+
import com.azure.core.util.Context;
161+
162+
/** Samples for Operations List. */
163+
public final class OperationsListSamples {
164+
/*
165+
* x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Operations_List.json
166+
*/
167+
/**
168+
* Sample code: Operations_List.
169+
*
170+
* @param manager Entry point to DashboardManager.
171+
*/
172+
public static void operationsList(com.azure.resourcemanager.dashboard.DashboardManager manager) {
173+
manager.operations().list(Context.NONE);
174+
}
175+
}
176+
```
177+
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-dashboard</artifactId>
12+
<version>1.0.0-beta.1</version> <!-- {x-version-update;com.azure.resourcemanager:azure-resourcemanager-dashboard;current} -->
13+
<packaging>jar</packaging>
14+
15+
<name>Microsoft Azure SDK for Dashboard Management</name>
16+
<description>This package contains Microsoft Azure SDK for Dashboard Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. The Microsoft.Dashboard Rest API spec. Package tag package-2021-09-01-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+
</properties>
43+
<dependencies>
44+
<dependency>
45+
<groupId>com.azure</groupId>
46+
<artifactId>azure-core</artifactId>
47+
<version>1.25.0</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.5.2</version> <!-- {x-version-update;com.azure:azure-core-management;dependency} -->
53+
</dependency>
54+
</dependencies>
55+
</project>

0 commit comments

Comments
 (0)