Skip to content
Merged
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
52 changes: 49 additions & 3 deletions sdk/batch/Azure.Compute.Batch/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,60 @@
# Release History

## 1.0.0-beta.4 (Unreleased)
## 1.0.0-beta.4 (2025-09-01)

### Features Added

Added Models:
- Added `BatchJobDefaultOrder`
- Added `BatchPoolIdentityReference`
- Added `DiskCustomerManagedKey`
- Added `DiskEncryptionSetParameters`
- Added `HostEndpointSettings`
- Added `HostEndpointSettingsModeTypes`
- Added `IPFamily`
- Added `IpTag`
- Added `ProxyAgentSettings`

Added Properties:
- Added `ipv6Address` to `BatchNode`
- Added `Ipv6RemoteLoginIpAddress` and `Ipv6RemoteLoginPort` to `BatchNodeRemoteLoginSettings`
- Added `IpFamilies` and `IpTags` to `BatchPublicAddressConfiguration`
- Added `JobDefaultOder` to `BatchTaskSchedulingPolicy`
- Added `ManagedDisk` to `DataDisk`
- Added `CustomerManagedKey` to `DiskEncryptionConfiguration`
- Added `DiskEncryptionSet` to `ManagedDisk`
- Added `DiskWithVMGuestStateValue` to `SecurityEncryptionTypes`
- Added `ProxyAgentSetting` to `SecurityProfile`


### Breaking Changes

### Bugs Fixed
Removed Certificate API's:
- Removed `BatchClient.CreateCertificate`
- Removed `BatchClient.CancelCertificateDeletion`
- Removed `BatchClient.DeleteCertificate`
- Removed `BatchClient.GetCertificate`
- Removed `BatchClient.GetCertificates`

Removed Modes:
- Removed `BatchCertificate`
- Removed `BatchCertificateDeleteError`
- Removed `BatchCertificateFormat`
- Removed `BatchCertificateReference`
- Removed `BatchCertificateState`
- Removed `BatchCertificateStoreLocation`
- Removed `BatchCertificateVisibility`
- Removed `BatchNodeCommunicationMode`

Removed Properties:
- Removed `CertificateReferences` from `BatchNode`
- Removed `ResourceTags` and `CertificateReferences` from `BatchPool`
- Removed `CertificateReferences`, `ResourceTags`, and `TargetNodeCommunicationMode` from `BatchPoolCreateOptions`
- Removed `CertificateReferences` and `TargetNodeCommunicationMode` from `BatchPoolReplaceOptions`
- Removed `CertificateReferences`, `ResourceTags`, and `TargetNodeCommunicationMode` from `BatchPoolSpecifications`
- Removed `CertificateReferences`, `ResourceTags`, and `TargetNodeCommunicationMode` from `BatchPoolUpdateOptions`
- Removed `CertificateReferences`, `ResourceTags`, and `TargetNodeCommunicationMode` from `ComputeBatchModelFactory`

### Other Changes

## 1.0.0-beta.3 (2025-06-19)

Expand Down
152 changes: 1 addition & 151 deletions sdk/batch/Azure.Compute.Batch/MigrationGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,13 +72,6 @@ Familiarity with the legacy client library is assumed. For those new to the Azur
- [File Properties](#get-node-file-properties)
- [GetRemoteLoginSettings](#getremoteloginsettings)
- [UploadComputeNodeBatchServiceLogs](#uploadcomputenodebatchservicelogs)
- [Certificate Operations](#certificate-operations)
- [CreateCertificateFromCer](#createcertificatefromcer)
- [CreateCertificateFromPfx](#createcertificatefrompfx)
- [GetCertificate](#getcertificate)
- [ListCertificates](#listcertificates)
- [DeleteCertificate](#deletecertificate)
- [CancelDeleteCertificate](#canceldeletecertificate)
- [Application Operations](#application-operations)
- [GetApplicationSummary](#getapplicationsummary)
- [ListApplicationSummaries](#listapplicationsummaries)
Expand Down Expand Up @@ -522,15 +515,7 @@ BatchApplicationPackageReference[] batchApplicationPackageReferences = new Batch
}
};

BatchCertificateReference[] certificateReferences = new BatchCertificateReference[] {
new BatchCertificateReference("thumbprint","thumbprintAlgorithm")
{
StoreLocation = "storeLocation",
StoreName = "storeName"
}
};

BatchPoolReplaceOptions replaceOptions = new BatchPoolReplaceOptions(certificateReferences, batchApplicationPackageReferences, metadataItems);
BatchPoolReplaceOptions replaceOptions = new BatchPoolReplaceOptions(batchApplicationPackageReferences, metadataItems);
batchClient.ReplacePoolProperties("poolID", replaceOptions);
```
#### ResizePool
Expand Down Expand Up @@ -1658,141 +1643,6 @@ UploadBatchServiceLogsOptions uploadBatchServiceLogsOptions = new UploadBatchSer
UploadBatchServiceLogsResult uploadBatchServiceLogsResult = batchClient.UploadNodeLogs("poolId", "computeNodeId", uploadBatchServiceLogsOptions);
```

### Certificate Operations

> Note: Certificates has been [deprecated].

#### CreateCertificateFromCer

Previously in `Microsoft.Azure.Batch` to create a Certificate from an existing cert you could call the `CreateCertificateFromCer` method with the path to the cert.

``` C#
Certificate cerCertificate = batchClient.CertificateOperations.CreateCertificateFromCer("cerFilePath");
```

With `Azure.Compute.Batch` call `CreateCertificate` with a `BatchCertificate` param to create a cert

```C# Snippet:Batch_Migration_CreateCerCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());
byte[] certData = File.ReadAllBytes("certPath");
BatchCertificate cerCertificate = new BatchCertificate("Thumbprint", "ThumbprintAlgorithm", BinaryData.FromBytes(certData))
{
CertificateFormat = BatchCertificateFormat.Cer,
Password = "",
};

Response response = batchClient.CreateCertificate(cerCertificate);
```

#### CreateCertificateFromPfx

Previously in `Microsoft.Azure.Batch` to create a Certificate from an existing pfx cert you could call the `CreateCertificateFromPfx` method with the path to the cert.

``` C#
Certificate pfxCertificate = batchClient.CertificateOperations.CreateCertificateFromPfx("pfxFilePath", "CertificatePassword");
```

With `Azure.Compute.Batch` call `CreateCertificate` with a `BatchCertificate` param to create a cert

```C# Snippet:Batch_Migration_CreatePfxCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

byte[] certData = File.ReadAllBytes("certPath");
BatchCertificate cerCertificate = new BatchCertificate("Thumbprint", "ThumbprintAlgorithm", BinaryData.FromBytes(certData))
{
CertificateFormat = BatchCertificateFormat.Pfx,
Password = "password",
};

Response response = batchClient.CreateCertificate(cerCertificate);
```

#### GetCertificate

Previously in `Microsoft.Azure.Batch` to get a Certificate you could call the `GetCertificate` method from `CertificateOperations`.

``` C#
Certificate boundCert = batchClient.CertificateOperations.GetCertificate( "ThumbprintAlgorithm", "Thumbprint")
```

With `Azure.Compute.Batch` call `GetCertificate` to get the certificate which will return a `GetCertificateResponse`.

```C# Snippet:Batch_Migration_GetCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

BatchCertificate cerCertificateResponse = batchClient.GetCertificate("ThumbprintAlgorithm", "Thumbprint");
```

#### ListCertificates

Previously in `Microsoft.Azure.Batch` to get a list of Certificates you could call the `ListCertificates` method from `CertificateOperations`.

``` C#
foreach (Certificate curCert in batchClient.CertificateOperations.ListCertificates())
{
// do something
}
```

With `Azure.Compute.Batch` call `GetCertificates` to get a list of certificates.

```C# Snippet:Batch_Migration_ListCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

foreach (BatchCertificate item in batchClient.GetCertificates())
{
// do something
}
```

#### DeleteCertificate

Previously in `Microsoft.Azure.Batch` to delete a Certificate you could call the `DeleteCertificate` method from `CertificateOperations`.

``` C#
batchClient.CertificateOperations.DeleteCertificate("ThumbprintAlgorithm", "Thumbprint");
```

With `Azure.Compute.Batch` call `DeleteCertificate` to delete a certificate.

```C# Snippet:Batch_Migration_DeleteCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

batchClient.DeleteCertificate("ThumbprintAlgorithm", "Thumbprint");
```
Optionally you can use the returned `DeleteCertificateOperation` object to wait for the operation to complete.

```C# Snippet:Batch_Migration_DeleteCertificate_Operation
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

DeleteCertificateOperation operation = batchClient.DeleteCertificate("ThumbprintAlgorithm", "Thumbprint");

// Optional, wait for operation to complete
operation.WaitForCompletion();
```
#### CancelDeleteCertificate

Previously in `Microsoft.Azure.Batch` to cancel a delete of a Certificate you could call the `CancelDeleteCertificate` method from `CertificateOperations`.

``` C#
batchClient.CertificateOperations.CancelDeleteCertificate("ThumbprintAlgorithm", "Thumbprint");
```

With `Azure.Compute.Batch` call `CancelCertificateDeletion` to cancel a delete of a certificate.

```C# Snippet:Batch_Migration_CancelDeleteCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

batchClient.CancelCertificateDeletion("ThumbprintAlgorithm", "Thumbprint");
```

### Application Operations

#### GetApplicationSummary
Expand Down
95 changes: 1 addition & 94 deletions sdk/batch/Azure.Compute.Batch/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -147,12 +147,6 @@ The following section provides several synchronous code snippets covering some o
* [Node File Properties](#get-node-file-properties)
* [Get Remote Login Settings](#getremoteloginsettings)
* [Upload Compute Node BatchService Logs](#uploadcomputenodebatchservicelogs)
* [Certificate Operations](#certificate-operations)
* [Create a Certificate](#createcertificate)
* [Get a Certificatec](#getcertificate)
* [List Certificates](#listcertificates)
* [Delete Certificate](#deletecertificate)
* [Cancel Delete Certificate](#canceldeletecertificate)
* [Application Operations](#application-operations)
* [Get Application](#get-application)
* [List Applications](#list-application)
Expand Down Expand Up @@ -330,15 +324,7 @@ BatchApplicationPackageReference[] batchApplicationPackageReferences = new Batch
}
};

BatchCertificateReference[] certificateReferences = new BatchCertificateReference[] {
new BatchCertificateReference("thumbprint","thumbprintAlgorithm")
{
StoreLocation = "storeLocation",
StoreName = "storeName"
}
};

BatchPoolReplaceOptions replaceOptions = new BatchPoolReplaceOptions(certificateReferences, batchApplicationPackageReferences, metadataItems);
BatchPoolReplaceOptions replaceOptions = new BatchPoolReplaceOptions(batchApplicationPackageReferences, metadataItems);
batchClient.ReplacePoolProperties("poolID", replaceOptions);
```
#### Resize Pool
Expand Down Expand Up @@ -1159,85 +1145,6 @@ UploadBatchServiceLogsOptions uploadBatchServiceLogsOptions = new UploadBatchSer
UploadBatchServiceLogsResult uploadBatchServiceLogsResult = batchClient.UploadNodeLogs("poolId", "computeNodeId", uploadBatchServiceLogsOptions);
```

### Certificate Operations

> Note: Certificates has been [deprecated].

#### CreateCertificate

Call `CreateCertificate` with a `BatchCertificate` param to create a Certificate.

```C# Snippet:Batch_Migration_CreateCerCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());
byte[] certData = File.ReadAllBytes("certPath");
BatchCertificate cerCertificate = new BatchCertificate("Thumbprint", "ThumbprintAlgorithm", BinaryData.FromBytes(certData))
{
CertificateFormat = BatchCertificateFormat.Cer,
Password = "",
};

Response response = batchClient.CreateCertificate(cerCertificate);
```

#### GetCertificate

Call `GetCertificate` to get the certificate which will return a `GetCertificateResponse`.

```C# Snippet:Batch_Migration_GetCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

BatchCertificate cerCertificateResponse = batchClient.GetCertificate("ThumbprintAlgorithm", "Thumbprint");
```

#### ListCertificates

Call `GetCertificates` to get a list of certificates.

```C# Snippet:Batch_Migration_ListCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

foreach (BatchCertificate item in batchClient.GetCertificates())
{
// do something
}
```

#### DeleteCertificate

Call `DeleteCertificate` to delete a Certificate.

```C# Snippet:Batch_Migration_DeleteCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

batchClient.DeleteCertificate("ThumbprintAlgorithm", "Thumbprint");
```
Optionally you can use the returned `DeleteCertificateOperation` object to wait for the operation to complete.

```C# Snippet:Batch_Migration_DeleteCertificate_Operation
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

DeleteCertificateOperation operation = batchClient.DeleteCertificate("ThumbprintAlgorithm", "Thumbprint");

// Optional, wait for operation to complete
operation.WaitForCompletion();
```

#### CancelDeleteCertificate

Call `CancelCertificateDeletion` to cancel a delete of a certificate.

```C# Snippet:Batch_Migration_CancelDeleteCertificate
BatchClient batchClient = new BatchClient(
new Uri("https://<your account>.eastus.batch.azure.com"), new DefaultAzureCredential());

batchClient.CancelCertificateDeletion("ThumbprintAlgorithm", "Thumbprint");
```

### Application Operations

#### Get Application
Expand Down
Loading