Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[ReleasePR azure-resourcemanager-synapse] Fix placeholder links causing 404s #28438

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 3 additions & 1 deletion sdk/synapse/azure-resourcemanager-synapse/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Release History

## 1.0.0-beta.6 (Unreleased)
## 1.0.0-beta.1 (2022-04-21)

- Azure Resource Manager Synapse client library for Java. This package contains Microsoft Azure SDK for Synapse Management SDK. Azure Synapse Analytics Management Client. Package tag package-composite-v2. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).

### Features Added

Expand Down
2 changes: 1 addition & 1 deletion sdk/synapse/azure-resourcemanager-synapse/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Various documentation is available to help you get started
<dependency>
<groupId>com.azure.resourcemanager</groupId>
<artifactId>azure-resourcemanager-synapse</artifactId>
<version>1.0.0-beta.5</version>
<version>1.0.0-beta.6</version>
</dependency>
```
[//]: # ({x-version-update-end})
Expand Down
85 changes: 85 additions & 0 deletions sdk/synapse/azure-resourcemanager-synapse/SAMPLE.md
Original file line number Diff line number Diff line change
Expand Up @@ -387,6 +387,12 @@
- [Get](#workspacemanagedsqlserverblobauditingpolicies_get)
- [ListByWorkspace](#workspacemanagedsqlserverblobauditingpolicies_listbyworkspace)

## WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings

- [Get](#workspacemanagedsqlserverdedicatedsqlminimaltlssettings_get)
- [List](#workspacemanagedsqlserverdedicatedsqlminimaltlssettings_list)
- [Update](#workspacemanagedsqlserverdedicatedsqlminimaltlssettings_update)

## WorkspaceManagedSqlServerEncryptionProtector

- [CreateOrUpdate](#workspacemanagedsqlserverencryptionprotector_createorupdate)
Expand Down Expand Up @@ -5986,6 +5992,85 @@ public final class WorkspaceManagedSqlServerBlobAuditingPoliciesListByWorkspaceS
}
```

### WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings_Get

```java
import com.azure.core.util.Context;

/** Samples for WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings Get. */
public final class WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettingsGetSamples {
/*
* x-ms-original-file: specification/synapse/resource-manager/Microsoft.Synapse/stable/2021-06-01/examples/GetWorkspaceManagedSqlServerDedicatedSQLminimalTlsSettings.json
*/
/**
* Sample code: Get workspace managed sql server dedicated sql minimal tls settings.
*
* @param manager Entry point to SynapseManager.
*/
public static void getWorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings(
com.azure.resourcemanager.synapse.SynapseManager manager) {
manager
.workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings()
.getWithResponse("workspace-6852", "workspace-2080", "default", Context.NONE);
}
}
```

### WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings_List

```java
import com.azure.core.util.Context;

/** Samples for WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings List. */
public final class WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettingsListSamples {
/*
* x-ms-original-file: specification/synapse/resource-manager/Microsoft.Synapse/stable/2021-06-01/examples/ListWorkspaceManagedSqlServerDedicatedSQLminimalTlsSettings.json
*/
/**
* Sample code: List dedicated sql minimal tls settings of the workspace managed sql server.
*
* @param manager Entry point to SynapseManager.
*/
public static void listDedicatedSqlMinimalTlsSettingsOfTheWorkspaceManagedSqlServer(
com.azure.resourcemanager.synapse.SynapseManager manager) {
manager
.workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings()
.list("workspace-6852", "workspace-2080", Context.NONE);
}
}
```

### WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings_Update

```java
import com.azure.core.util.Context;
import com.azure.resourcemanager.synapse.fluent.models.DedicatedSQLminimalTlsSettingsInner;
import com.azure.resourcemanager.synapse.models.DedicatedSqlMinimalTlsSettingsName;

/** Samples for WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings Update. */
public final class WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettingsUpdateSamples {
/*
* x-ms-original-file: specification/synapse/resource-manager/Microsoft.Synapse/stable/2021-06-01/examples/UpdateWorkspaceManagedSqlServerDedicatedSQLminimalTlsSettings.json
*/
/**
* Sample code: Update tls version of the workspace managed sql server.
*
* @param manager Entry point to SynapseManager.
*/
public static void updateTlsVersionOfTheWorkspaceManagedSqlServer(
com.azure.resourcemanager.synapse.SynapseManager manager) {
manager
.workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings()
.update(
"workspace-6852",
"workspace-2080",
DedicatedSqlMinimalTlsSettingsName.DEFAULT,
new DedicatedSQLminimalTlsSettingsInner().withMinimalTlsVersion("1.1"),
Context.NONE);
}
}
```

### WorkspaceManagedSqlServerEncryptionProtector_CreateOrUpdate

```java
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,13 @@
import com.azure.core.http.HttpPipelineBuilder;
import com.azure.core.http.HttpPipelinePosition;
import com.azure.core.http.policy.AddDatePolicy;
import com.azure.core.http.policy.AddHeadersFromContextPolicy;
import com.azure.core.http.policy.HttpLogOptions;
import com.azure.core.http.policy.HttpLoggingPolicy;
import com.azure.core.http.policy.HttpPipelinePolicy;
import com.azure.core.http.policy.HttpPolicyProviders;
import com.azure.core.http.policy.RequestIdPolicy;
import com.azure.core.http.policy.RetryOptions;
import com.azure.core.http.policy.RetryPolicy;
import com.azure.core.http.policy.UserAgentPolicy;
import com.azure.core.management.http.policy.ArmChallengeAuthenticationPolicy;
Expand Down Expand Up @@ -87,6 +89,7 @@
import com.azure.resourcemanager.synapse.implementation.WorkspaceAadAdminsImpl;
import com.azure.resourcemanager.synapse.implementation.WorkspaceManagedIdentitySqlControlSettingsImpl;
import com.azure.resourcemanager.synapse.implementation.WorkspaceManagedSqlServerBlobAuditingPoliciesImpl;
import com.azure.resourcemanager.synapse.implementation.WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettingsImpl;
import com.azure.resourcemanager.synapse.implementation.WorkspaceManagedSqlServerEncryptionProtectorsImpl;
import com.azure.resourcemanager.synapse.implementation.WorkspaceManagedSqlServerExtendedBlobAuditingPoliciesImpl;
import com.azure.resourcemanager.synapse.implementation.WorkspaceManagedSqlServerRecoverableSqlPoolsImpl;
Expand Down Expand Up @@ -159,6 +162,7 @@
import com.azure.resourcemanager.synapse.models.WorkspaceAadAdmins;
import com.azure.resourcemanager.synapse.models.WorkspaceManagedIdentitySqlControlSettings;
import com.azure.resourcemanager.synapse.models.WorkspaceManagedSqlServerBlobAuditingPolicies;
import com.azure.resourcemanager.synapse.models.WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings;
import com.azure.resourcemanager.synapse.models.WorkspaceManagedSqlServerEncryptionProtectors;
import com.azure.resourcemanager.synapse.models.WorkspaceManagedSqlServerExtendedBlobAuditingPolicies;
import com.azure.resourcemanager.synapse.models.WorkspaceManagedSqlServerRecoverableSqlPools;
Expand Down Expand Up @@ -266,6 +270,9 @@ public final class SynapseManager {

private WorkspaceManagedSqlServerRecoverableSqlPools workspaceManagedSqlServerRecoverableSqlPools;

private WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings
workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings;

private Workspaces workspaces;

private WorkspaceAadAdmins workspaceAadAdmins;
Expand Down Expand Up @@ -347,6 +354,19 @@ public static SynapseManager authenticate(TokenCredential credential, AzureProfi
return configure().authenticate(credential, profile);
}

/**
* Creates an instance of Synapse service API entry point.
*
* @param httpPipeline the {@link HttpPipeline} configured with Azure authentication credential.
* @param profile the Azure profile for client.
* @return the Synapse service API instance.
*/
public static SynapseManager authenticate(HttpPipeline httpPipeline, AzureProfile profile) {
Objects.requireNonNull(httpPipeline, "'httpPipeline' cannot be null.");
Objects.requireNonNull(profile, "'profile' cannot be null.");
return new SynapseManager(httpPipeline, profile, null);
}

/**
* Gets a Configurable instance that can be used to create SynapseManager with optional configuration.
*
Expand All @@ -358,13 +378,14 @@ public static Configurable configure() {

/** The Configurable allowing configurations to be set. */
public static final class Configurable {
private final ClientLogger logger = new ClientLogger(Configurable.class);
private static final ClientLogger LOGGER = new ClientLogger(Configurable.class);

private HttpClient httpClient;
private HttpLogOptions httpLogOptions;
private final List<HttpPipelinePolicy> policies = new ArrayList<>();
private final List<String> scopes = new ArrayList<>();
private RetryPolicy retryPolicy;
private RetryOptions retryOptions;
private Duration defaultPollInterval;

private Configurable() {
Expand Down Expand Up @@ -425,16 +446,31 @@ public Configurable withRetryPolicy(RetryPolicy retryPolicy) {
return this;
}

/**
* Sets the retry options for the HTTP pipeline retry policy.
*
* <p>This setting has no effect, if retry policy is set via {@link #withRetryPolicy(RetryPolicy)}.
*
* @param retryOptions the retry options for the HTTP pipeline retry policy.
* @return the configurable object itself.
*/
public Configurable withRetryOptions(RetryOptions retryOptions) {
this.retryOptions = Objects.requireNonNull(retryOptions, "'retryOptions' cannot be null.");
return this;
}

/**
* Sets the default poll interval, used when service does not provide "Retry-After" header.
*
* @param defaultPollInterval the default poll interval.
* @return the configurable object itself.
*/
public Configurable withDefaultPollInterval(Duration defaultPollInterval) {
this.defaultPollInterval = Objects.requireNonNull(defaultPollInterval, "'retryPolicy' cannot be null.");
this.defaultPollInterval =
Objects.requireNonNull(defaultPollInterval, "'defaultPollInterval' cannot be null.");
if (this.defaultPollInterval.isNegative()) {
throw logger.logExceptionAsError(new IllegalArgumentException("'httpPipeline' cannot be negative"));
throw LOGGER
.logExceptionAsError(new IllegalArgumentException("'defaultPollInterval' cannot be negative"));
}
return this;
}
Expand All @@ -456,7 +492,7 @@ public SynapseManager authenticate(TokenCredential credential, AzureProfile prof
.append("-")
.append("com.azure.resourcemanager.synapse")
.append("/")
.append("1.0.0-beta.5");
.append("1.0.0-beta.1");
if (!Configuration.getGlobalConfiguration().get("AZURE_TELEMETRY_DISABLED", false)) {
userAgentBuilder
.append(" (")
Expand All @@ -474,10 +510,15 @@ public SynapseManager authenticate(TokenCredential credential, AzureProfile prof
scopes.add(profile.getEnvironment().getManagementEndpoint() + "/.default");
}
if (retryPolicy == null) {
retryPolicy = new RetryPolicy("Retry-After", ChronoUnit.SECONDS);
if (retryOptions != null) {
retryPolicy = new RetryPolicy(retryOptions);
} else {
retryPolicy = new RetryPolicy("Retry-After", ChronoUnit.SECONDS);
}
}
List<HttpPipelinePolicy> policies = new ArrayList<>();
policies.add(new UserAgentPolicy(userAgentBuilder.toString()));
policies.add(new AddHeadersFromContextPolicy());
policies.add(new RequestIdPolicy());
policies
.addAll(
Expand Down Expand Up @@ -909,6 +950,17 @@ public WorkspaceManagedSqlServerRecoverableSqlPools workspaceManagedSqlServerRec
return workspaceManagedSqlServerRecoverableSqlPools;
}

/** @return Resource collection API of WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings. */
public WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings
workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings() {
if (this.workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings == null) {
this.workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings =
new WorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettingsImpl(
clientObject.getWorkspaceManagedSqlServerDedicatedSqlMinimalTlsSettings(), this);
}
return workspaceManagedSqlServerDedicatedSqlMinimalTlsSettings;
}

/** @return Resource collection API of Workspaces. */
public Workspaces workspaces() {
if (this.workspaces == null) {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@
import com.azure.core.util.polling.SyncPoller;
import com.azure.resourcemanager.synapse.fluent.models.AzureADOnlyAuthenticationInner;
import com.azure.resourcemanager.synapse.models.AzureADOnlyAuthenticationName;
import reactor.core.publisher.Mono;

/** An instance of this class provides access to all the operations defined in AzureADOnlyAuthenticationsClient. */
public interface AzureADOnlyAuthenticationsClient {
Expand Down Expand Up @@ -61,8 +60,7 @@ Response<AzureADOnlyAuthenticationInner> getWithResponse(
* @throws IllegalArgumentException thrown if parameters fail the validation.
* @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
* @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
* @return azure Active Directory Only Authentication Info along with {@link Response} on successful completion of
* {@link Mono}.
* @return the {@link SyncPoller} for polling of azure Active Directory Only Authentication Info.
*/
@ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION)
SyncPoller<PollResult<AzureADOnlyAuthenticationInner>, AzureADOnlyAuthenticationInner> beginCreate(
Expand All @@ -82,8 +80,7 @@ SyncPoller<PollResult<AzureADOnlyAuthenticationInner>, AzureADOnlyAuthentication
* @throws IllegalArgumentException thrown if parameters fail the validation.
* @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
* @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
* @return azure Active Directory Only Authentication Info along with {@link Response} on successful completion of
* {@link Mono}.
* @return the {@link SyncPoller} for polling of azure Active Directory Only Authentication Info.
*/
@ServiceMethod(returns = ReturnType.LONG_RUNNING_OPERATION)
SyncPoller<PollResult<AzureADOnlyAuthenticationInner>, AzureADOnlyAuthenticationInner> beginCreate(
Expand Down Expand Up @@ -141,7 +138,8 @@ AzureADOnlyAuthenticationInner create(
* @throws IllegalArgumentException thrown if parameters fail the validation.
* @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
* @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
* @return a list of Azure Active Directory only authentication property for a workspace.
* @return a list of Azure Active Directory only authentication property for a workspace as paginated response with
* {@link PagedIterable}.
*/
@ServiceMethod(returns = ReturnType.COLLECTION)
PagedIterable<AzureADOnlyAuthenticationInner> list(String resourceGroupName, String workspaceName);
Expand All @@ -155,7 +153,8 @@ AzureADOnlyAuthenticationInner create(
* @throws IllegalArgumentException thrown if parameters fail the validation.
* @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
* @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
* @return a list of Azure Active Directory only authentication property for a workspace.
* @return a list of Azure Active Directory only authentication property for a workspace as paginated response with
* {@link PagedIterable}.
*/
@ServiceMethod(returns = ReturnType.COLLECTION)
PagedIterable<AzureADOnlyAuthenticationInner> list(String resourceGroupName, String workspaceName, Context context);
Expand Down
Loading