CodeGen from PR 17667 in Azure/azure-rest-api-specs

Add Swagger spec of MICROSOFT.DASHBOARD for Public Preview (Azure#17667) * Add Swagger spec of MICROSOFT.DASHBOARD for Public Preview * Add sdk files * Use ErrorResponse from common-types * Update GrafanaResource to follow TrackedResources from common-types * Update specification/dashboard/resource-manager/readme.typescript.md Co-authored-by: Wei Dong <40835867+dw511214992@users.noreply.github.com> * Update specification/dashboard/resource-manager/readme.typescript.md Co-authored-by: Wei Dong <40835867+dw511214992@users.noreply.github.com> * Update specification/dashboard/resource-manager/readme.csharp.md Co-authored-by: Wei Dong <40835867+dw511214992@users.noreply.github.com> * Remove location from PATCH * Refer to OperationList from common types * Fix Swagger ModelValidation error * Remove GrafanaResourcePropertiesUpdateParameters * Update specification/dashboard/resource-manager/readme.md Co-authored-by: Wei Dong <40835867+dw511214992@users.noreply.github.com> * Update readme.python.md * Update specification/dashboard/resource-manager/readme.go.md * Update specification/dashboard/resource-manager/readme.md * Update readme.python.md * Update readme.md * Update specification/dashboard/resource-manager/readme.csharp.md Co-authored-by: Wei Dong <40835867+dw511214992@users.noreply.github.com> Co-authored-by: Jiefeng Chen <51037443+BigCat20196@users.noreply.github.com> Co-authored-by: Yuchao Yan <yuchaoyan@microsoft.com>
AzureSDKAutomation · Feb 17, 2022 · a75279e · a75279e
1 parent 6bafa1d
commit a75279e
Show file tree

Hide file tree

Showing 53 changed files with 5,943 additions and 0 deletions.
diff --git a/eng/versioning/version_client.txt b/eng/versioning/version_client.txt
@@ -335,6 +335,7 @@ com.azure.resourcemanager:azure-resourcemanager-automanage;1.0.0-beta.1;1.0.0-be
 com.azure.resourcemanager:azure-resourcemanager-edgeorder;1.0.0-beta.1;1.0.0-beta.2
 com.azure.resourcemanager:azure-resourcemanager-securityinsights;1.0.0-beta.1;1.0.0-beta.2
 com.azure.resourcemanager:azure-resourcemanager-oep;1.0.0-beta.1;1.0.0-beta.2
+com.azure.resourcemanager:azure-resourcemanager-dashboard;1.0.0-beta.1;1.0.0-beta.1
 com.azure.tools:azure-sdk-archetype;1.0.0;1.0.0
 
 # Unreleased dependencies: Copy the entry from above, prepend "unreleased_" and remove the current

diff --git a/pom.xml b/pom.xml
@@ -871,6 +871,7 @@
         <module>sdk/cosmos</module>
         <module>sdk/costmanagement</module>
         <module>sdk/customerinsights</module>
+        <module>sdk/dashboard</module>
         <module>sdk/databox</module>
         <module>sdk/databoxedge</module>
         <module>sdk/databricks</module>

diff --git a/sdk/dashboard/azure-resourcemanager-dashboard/CHANGELOG.md b/sdk/dashboard/azure-resourcemanager-dashboard/CHANGELOG.md
@@ -0,0 +1,5 @@
+# Release History
+
+## 1.0.0-beta.1 (2022-02-17)
+
+- 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).
diff --git a/sdk/dashboard/azure-resourcemanager-dashboard/README.md b/sdk/dashboard/azure-resourcemanager-dashboard/README.md
@@ -0,0 +1,102 @@
+# Azure Resource Manager Dashboard client library for Java
+
+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).
+
+## We'd love to hear your feedback
+
+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.
+
+If you haven't already, please take a few minutes to [complete this short survey][survey] we have put together.
+
+Thank you in advance for your collaboration. We really appreciate your time!
+
+## Documentation
+
+Various documentation is available to help you get started
+
+- [API reference documentation][docs]
+
+## Getting started
+
+### Prerequisites
+
+- [Java Development Kit (JDK)][jdk] with version 8 or above
+- [Azure Subscription][azure_subscription]
+
+### Adding the package to your product
+
+[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-dashboard;current})
+```xml
+<dependency>
+    <groupId>com.azure.resourcemanager</groupId>
+    <artifactId>azure-resourcemanager-dashboard</artifactId>
+    <version>1.0.0-beta.1</version>
+</dependency>
+```
+[//]: # ({x-version-update-end})
+
+### Include the recommended packages
+
+Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client.
+
+[Azure Identity][azure_identity] package and [Azure Core Netty HTTP][azure_core_http_netty] package provide the default implementation.
+
+### Authentication
+
+By default, Azure Active Directory token authentication depends on correct configure of following environment variables.
+
+- `AZURE_CLIENT_ID` for Azure client ID.
+- `AZURE_TENANT_ID` for Azure tenant ID.
+- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate.
+
+In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`.
+
+With above configuration, `azure` client can be authenticated by following code:
+
+```java
+AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
+TokenCredential credential = new DefaultAzureCredentialBuilder()
+    .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
+    .build();
+DashboardManager manager = DashboardManager
+    .authenticate(credential, profile);
+```
+
+The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise.
+
+See [Authentication][authenticate] for more options.
+
+## Key concepts
+
+See [API design][design] for general introduction on design and key concepts on Azure Management Libraries.
+
+## Examples
+
+[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/dashboard/azure-resourcemanager-dashboard/SAMPLE.md)
+
+
+## Troubleshooting
+
+## Next steps
+
+## Contributing
+
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
+
+1. Fork it
+1. Create your feature branch (`git checkout -b my-new-feature`)
+1. Commit your changes (`git commit -am 'Add some feature'`)
+1. Push to the branch (`git push origin my-new-feature`)
+1. Create new Pull Request
+
+<!-- LINKS -->
+[survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS
+[docs]: https://azure.github.io/azure-sdk-for-java/
+[jdk]: https://docs.microsoft.com/java/azure/jdk/
+[azure_subscription]: https://azure.microsoft.com/free/
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
+[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty
+[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md
+[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md
diff --git a/sdk/dashboard/azure-resourcemanager-dashboard/SAMPLE.md b/sdk/dashboard/azure-resourcemanager-dashboard/SAMPLE.md
@@ -0,0 +1,177 @@
+# Code snippets and samples
+
+
+## Grafana
+
+- [Create](#grafana_create)
+- [Delete](#grafana_delete)
+- [GetByResourceGroup](#grafana_getbyresourcegroup)
+- [List](#grafana_list)
+- [ListByResourceGroup](#grafana_listbyresourcegroup)
+- [Update](#grafana_update)
+
+## Operations
+
+- [List](#operations_list)
+### Grafana_Create
+
+```java
+/** Samples for Grafana Create. */
+public final class GrafanaCreateSamples {
+    /*
+     * x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Create.json
+     */
+    /**
+     * Sample code: Grafana_Create.
+     *
+     * @param manager Entry point to DashboardManager.
+     */
+    public static void grafanaCreate(com.azure.resourcemanager.dashboard.DashboardManager manager) {
+        manager
+            .grafanas()
+            .define("myWorkspace")
+            .withRegion((String) null)
+            .withExistingResourceGroup("00000000-0000-0000-0000-000000000000", "myResourceGroup")
+            .create();
+    }
+}
+```
+
+### Grafana_Delete
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Grafana Delete. */
+public final class GrafanaDeleteSamples {
+    /*
+     * x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Delete.json
+     */
+    /**
+     * Sample code: Grafana_Delete.
+     *
+     * @param manager Entry point to DashboardManager.
+     */
+    public static void grafanaDelete(com.azure.resourcemanager.dashboard.DashboardManager manager) {
+        manager
+            .grafanas()
+            .delete("00000000-0000-0000-0000-000000000000", "myResourceGroup", "myWorkspace", Context.NONE);
+    }
+}
+```
+
+### Grafana_GetByResourceGroup
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Grafana GetByResourceGroup. */
+public final class GrafanaGetByResourceGroupSamples {
+    /*
+     * x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Get.json
+     */
+    /**
+     * Sample code: Grafana_Get.
+     *
+     * @param manager Entry point to DashboardManager.
+     */
+    public static void grafanaGet(com.azure.resourcemanager.dashboard.DashboardManager manager) {
+        manager
+            .grafanas()
+            .getByResourceGroupWithResponse(
+                "00000000-0000-0000-0000-000000000000", "myResourceGroup", "myWorkspace", Context.NONE);
+    }
+}
+```
+
+### Grafana_List
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Grafana List. */
+public final class GrafanaListSamples {
+    /*
+     * x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_List.json
+     */
+    /**
+     * Sample code: Grafana_List.
+     *
+     * @param manager Entry point to DashboardManager.
+     */
+    public static void grafanaList(com.azure.resourcemanager.dashboard.DashboardManager manager) {
+        manager.grafanas().list("00000000-0000-0000-0000-000000000000", Context.NONE);
+    }
+}
+```
+
+### Grafana_ListByResourceGroup
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Grafana ListByResourceGroup. */
+public final class GrafanaListByResourceGroupSamples {
+    /*
+     * x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_ListByResourceGroup.json
+     */
+    /**
+     * Sample code: Grafana_ListByResourceGroup.
+     *
+     * @param manager Entry point to DashboardManager.
+     */
+    public static void grafanaListByResourceGroup(com.azure.resourcemanager.dashboard.DashboardManager manager) {
+        manager.grafanas().listByResourceGroup("00000000-0000-0000-0000-000000000000", "myResourceGroup", Context.NONE);
+    }
+}
+```
+
+### Grafana_Update
+
+```java
+import com.azure.core.util.Context;
+import com.azure.resourcemanager.dashboard.models.GrafanaResource;
+
+/** Samples for Grafana Update. */
+public final class GrafanaUpdateSamples {
+    /*
+     * x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Grafana_Update.json
+     */
+    /**
+     * Sample code: Grafana_Update.
+     *
+     * @param manager Entry point to DashboardManager.
+     */
+    public static void grafanaUpdate(com.azure.resourcemanager.dashboard.DashboardManager manager) {
+        GrafanaResource resource =
+            manager
+                .grafanas()
+                .getByResourceGroupWithResponse(
+                    "00000000-0000-0000-0000-000000000000", "myResourceGroup", "myWorkspace", Context.NONE)
+                .getValue();
+        resource.update().apply();
+    }
+}
+```
+
+### Operations_List
+
+```java
+import com.azure.core.util.Context;
+
+/** Samples for Operations List. */
+public final class OperationsListSamples {
+    /*
+     * x-ms-original-file: specification/dashboard/resource-manager/Microsoft.Dashboard/preview/2021-09-01-preview/examples/Operations_List.json
+     */
+    /**
+     * Sample code: Operations_List.
+     *
+     * @param manager Entry point to DashboardManager.
+     */
+    public static void operationsList(com.azure.resourcemanager.dashboard.DashboardManager manager) {
+        manager.operations().list(Context.NONE);
+    }
+}
+```
+
diff --git a/sdk/dashboard/azure-resourcemanager-dashboard/pom.xml b/sdk/dashboard/azure-resourcemanager-dashboard/pom.xml
@@ -0,0 +1,55 @@
+<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">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.azure</groupId>
+    <artifactId>azure-client-sdk-parent</artifactId>
+    <version>1.7.0</version> <!-- {x-version-update;com.azure:azure-client-sdk-parent;current} -->
+    <relativePath>../../parents/azure-client-sdk-parent</relativePath>
+  </parent>
+
+  <groupId>com.azure.resourcemanager</groupId>
+  <artifactId>azure-resourcemanager-dashboard</artifactId>
+  <version>1.0.0-beta.1</version> <!-- {x-version-update;com.azure.resourcemanager:azure-resourcemanager-dashboard;current} -->
+  <packaging>jar</packaging>
+
+  <name>Microsoft Azure SDK for Dashboard Management</name>
+  <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>
+  <url>https://github.com/Azure/azure-sdk-for-java</url>
+
+  <licenses>
+    <license>
+      <name>The MIT License (MIT)</name>
+      <url>http://opensource.org/licenses/MIT</url>
+      <distribution>repo</distribution>
+    </license>
+  </licenses>
+
+  <scm>
+    <url>https://github.com/Azure/azure-sdk-for-java</url>
+    <connection>scm:git:git@github.com:Azure/azure-sdk-for-java.git</connection>
+    <developerConnection>scm:git:git@github.com:Azure/azure-sdk-for-java.git</developerConnection>
+    <tag>HEAD</tag>
+  </scm>
+  <developers>
+    <developer>
+      <id>microsoft</id>
+      <name>Microsoft</name>
+    </developer>
+  </developers>
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <jacoco.skip>true</jacoco.skip>
+  </properties>
+  <dependencies>
+    <dependency>
+      <groupId>com.azure</groupId>
+      <artifactId>azure-core</artifactId>
+      <version>1.25.0</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
+    </dependency>
+    <dependency>
+      <groupId>com.azure</groupId>
+      <artifactId>azure-core-management</artifactId>
+      <version>1.5.2</version> <!-- {x-version-update;com.azure:azure-core-management;dependency} -->
+    </dependency>
+  </dependencies>
+</project>