Skip to content
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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Release History

## 1.0.0-beta.3 (Unreleased)
## 1.0.0-beta.1 (2022-11-17)

- Azure Resource Manager ServiceLinker client library for Java. This package contains Microsoft Azure SDK for ServiceLinker Management SDK. Microsoft.ServiceLinker provider. Package tag package-2022-05-01. 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
25 changes: 14 additions & 11 deletions sdk/servicelinker/azure-resourcemanager-servicelinker/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-servicelinker</artifactId>
<version>1.0.0-beta.2</version>
<version>1.0.0-beta.3</version>
</dependency>
```
[//]: # ({x-version-update-end})
Expand All @@ -41,19 +41,19 @@ Various documentation is available to help you get started

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.
[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation.

### Authentication

By default, Azure Active Directory token authentication depends on correct configure of following environment variables.
By default, Azure Active Directory token authentication depends on correct configuration of the 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`.
In addition, Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable.

With above configuration, `azure` client can be authenticated by following code:
With above configuration, `azure` client can be authenticated using the following code:

```java
AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
Expand Down Expand Up @@ -83,13 +83,13 @@ See [API design][design] for general introduction on design and key concepts on

## Contributing

For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
For details on contributing to this repository, see the [contributing guide][cg].

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
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit <https://cla.microsoft.com>.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][coc_faq] or contact <[email protected]> with any additional questions or comments.

<!-- LINKS -->
[survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS
Expand All @@ -100,3 +100,6 @@ For details on contributing to this repository, see the [contributing guide](htt
[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
[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md
[coc]: https://opensource.microsoft.com/codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
10 changes: 5 additions & 5 deletions sdk/servicelinker/azure-resourcemanager-servicelinker/SAMPLE.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,10 +46,7 @@ public final class LinkerCreateOrUpdateSamples {
.withId(
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"))
.withAuthInfo(new SecretAuthInfo())
.withSecretStore(
new SecretStore()
.withKeyVaultId(
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.KeyVault/vaults/test-kv"))
.withSecretStore(new SecretStore().withKeyVaultId("fakeTokenPlaceholder"))
.create();
}

Expand Down Expand Up @@ -245,7 +242,10 @@ public final class LinkerUpdateSamples {
.withId(
"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DocumentDb/databaseAccounts/test-acc/mongodbDatabases/test-db"))
.withAuthInfo(
new ServicePrincipalSecretAuthInfo().withClientId("name").withPrincipalId("id").withSecret("secret"))
new ServicePrincipalSecretAuthInfo()
.withClientId("name")
.withPrincipalId("id")
.withSecret("fakeTokenPlaceholder"))
.apply();
}
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -206,7 +206,7 @@ public ServiceLinkerManager authenticate(TokenCredential credential, AzureProfil
.append("-")
.append("com.azure.resourcemanager.servicelinker")
.append("/")
.append("1.0.0-beta.2");
.append("1.0.0-beta.1");
if (!Configuration.getGlobalConfiguration().get("AZURE_TELEMETRY_DISABLED", false)) {
userAgentBuilder
.append(" (")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,27 +48,27 @@ public interface LinkersClient {
*
* @param resourceUri The fully qualified Azure Resource manager identifier of the resource to be connected.
* @param linkerName The name Linker resource.
* @param context The context to associate with this operation.
* @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 linker of source and target resource.
* @return linker of source and target resource along with {@link Response}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
LinkerResourceInner get(String resourceUri, String linkerName);
Response<LinkerResourceInner> getWithResponse(String resourceUri, String linkerName, Context context);

/**
* Returns Linker resource for a given name.
*
* @param resourceUri The fully qualified Azure Resource manager identifier of the resource to be connected.
* @param linkerName The name Linker resource.
* @param context The context to associate with this operation.
* @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 linker of source and target resource along with {@link Response}.
* @return linker of source and target resource.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
Response<LinkerResourceInner> getWithResponse(String resourceUri, String linkerName, Context context);
LinkerResourceInner get(String resourceUri, String linkerName);

/**
* Create or update linker resource.
Expand Down Expand Up @@ -304,27 +304,27 @@ SyncPoller<PollResult<ValidateOperationResultInner>, ValidateOperationResultInne
*
* @param resourceUri The fully qualified Azure Resource manager identifier of the resource to be connected.
* @param linkerName The name Linker resource.
* @param context The context to associate with this operation.
* @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 configurations for source resource, include appSettings, connectionString and serviceBindings.
* @return configurations for source resource, include appSettings, connectionString and serviceBindings along with
* {@link Response}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
SourceConfigurationResultInner listConfigurations(String resourceUri, String linkerName);
Response<SourceConfigurationResultInner> listConfigurationsWithResponse(
String resourceUri, String linkerName, Context context);

/**
* list source configurations for a linker.
*
* @param resourceUri The fully qualified Azure Resource manager identifier of the resource to be connected.
* @param linkerName The name Linker resource.
* @param context The context to associate with this operation.
* @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 configurations for source resource, include appSettings, connectionString and serviceBindings along with
* {@link Response}.
* @return configurations for source resource, include appSettings, connectionString and serviceBindings.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
Response<SourceConfigurationResultInner> listConfigurationsWithResponse(
String resourceUri, String linkerName, Context context);
SourceConfigurationResultInner listConfigurations(String resourceUri, String linkerName);
}
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,10 @@ public final class LinkerProperties {
@JsonProperty(value = "scope")
private String scope;

/** Creates an instance of LinkerProperties class. */
public LinkerProperties() {
}

/**
* Get the targetService property: The target service properties.
*
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,10 @@ public final class LinkerResourceInner extends ProxyResource {
@JsonProperty(value = "systemData", access = JsonProperty.Access.WRITE_ONLY)
private SystemData systemData;

/** Creates an instance of LinkerResourceInner class. */
public LinkerResourceInner() {
}

/**
* Get the innerProperties property: The properties of the linker.
*
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,20 +10,23 @@
import com.azure.resourcemanager.servicelinker.models.Origin;
import com.fasterxml.jackson.annotation.JsonProperty;

/** REST API Operation Details of a REST API operation, returned from the Resource Provider Operations API. */
/**
* REST API Operation
*
* <p>Details of a REST API operation, returned from the Resource Provider Operations API.
*/
@Fluent
public final class OperationInner {
/*
* The name of the operation, as per Resource-Based Access Control (RBAC).
* Examples: "Microsoft.Compute/virtualMachines/write",
* "Microsoft.Compute/virtualMachines/capture/action"
* The name of the operation, as per Resource-Based Access Control (RBAC). Examples:
* "Microsoft.Compute/virtualMachines/write", "Microsoft.Compute/virtualMachines/capture/action"
*/
@JsonProperty(value = "name", access = JsonProperty.Access.WRITE_ONLY)
private String name;

/*
* Whether the operation applies to data-plane. This is "true" for
* data-plane operations and "false" for ARM/control-plane operations.
* Whether the operation applies to data-plane. This is "true" for data-plane operations and "false" for
* ARM/control-plane operations.
*/
@JsonProperty(value = "isDataAction", access = JsonProperty.Access.WRITE_ONLY)
private Boolean isDataAction;
Expand All @@ -35,19 +38,22 @@ public final class OperationInner {
private OperationDisplay display;

/*
* The intended executor of the operation; as in Resource Based Access
* Control (RBAC) and audit logs UX. Default value is "user,system"
* The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default
* value is "user,system"
*/
@JsonProperty(value = "origin", access = JsonProperty.Access.WRITE_ONLY)
private Origin origin;

/*
* Enum. Indicates the action type. "Internal" refers to actions that are
* for internal only APIs.
* Enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs.
*/
@JsonProperty(value = "actionType", access = JsonProperty.Access.WRITE_ONLY)
private ActionType actionType;

/** Creates an instance of OperationInner class. */
public OperationInner() {
}

/**
* Get the name property: The name of the operation, as per Resource-Based Access Control (RBAC). Examples:
* "Microsoft.Compute/virtualMachines/write", "Microsoft.Compute/virtualMachines/capture/action".
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,10 @@ public final class SourceConfigurationResultInner {
@JsonProperty(value = "configurations")
private List<SourceConfiguration> configurations;

/** Creates an instance of SourceConfigurationResultInner class. */
public SourceConfigurationResultInner() {
}

/**
* Get the configurations property: The configuration properties for source resource.
*
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,10 @@ public final class ValidateOperationResultInner {
@JsonProperty(value = "status")
private String status;

/** Creates an instance of ValidateOperationResultInner class. */
public ValidateOperationResultInner() {
}

/**
* Get the innerProperties property: The validation result detail.
*
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,10 @@ public final class ValidateResult {
@JsonProperty(value = "validationDetail")
private List<ValidationResultItem> validationDetail;

/** Creates an instance of ValidateResult class. */
public ValidateResult() {
}

/**
* Get the linkerName property: The linker name.
*
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -169,14 +169,14 @@ public ValidateOperationResult validate(Context context) {
return serviceManager.linkers().validate(resourceUri, linkerName, context);
}

public SourceConfigurationResult listConfigurations() {
return serviceManager.linkers().listConfigurations(resourceUri, linkerName);
}

public Response<SourceConfigurationResult> listConfigurationsWithResponse(Context context) {
return serviceManager.linkers().listConfigurationsWithResponse(resourceUri, linkerName, context);
}

public SourceConfigurationResult listConfigurations() {
return serviceManager.linkers().listConfigurations(resourceUri, linkerName);
}

public LinkerResourceImpl withTargetService(TargetServiceBase targetService) {
if (isInCreateMode()) {
this.innerModel().withTargetService(targetService);
Expand Down
Loading