Skip to content

Commit cfc374b

Browse files
committed
fix blocking issue. add new steps. ms.date
1 parent 95c864d commit cfc374b

6 files changed

Lines changed: 67 additions & 32 deletions

File tree

articles/azure-netapp-files/object-rest-api-access-configure.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.date: 08/26/2025
8+
ms.date: 10/13/2025
99
ms.author: anfdocs
1010
---
1111

@@ -21,9 +21,7 @@ Azure NetApp Files supports access to S3 objects with the [object REST API](obje
2121

2222
The object REST API access feature in Azure NetApp Files is currently in preview. You need to register the feature before using it for the first time. Feature registration can take up to 60 minutes to complete.
2323

24-
<!-- confirm link -->
25-
You must submit a [waitlist request](https://forms.office.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR2Qj2eZL0mZPv1iKUrDGvc9URURJNEpXSVc0SzZLOEw0VFRSUUFURFBSTSQlQCN0PWcu&b2b=true) to use the object REST API feature.
26-
24+
You must submit a [waitlist request](https://forms.office.com/r/pTpTESUSZb) to use the object REST API feature.
2725

2826
You can check the status of the feature registration with the command:
2927

articles/azure-netapp-files/object-rest-api-browser.md

Lines changed: 59 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,23 +5,39 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.date: 07/31/2025
8+
ms.date: 10/13/2025
99
ms.author: anfdocs
1010
---
11-
1211
# Access an Azure NetApp Files object REST API-enabled volume with S3-compatible clients
1312

1413
You can use Azure NetApp Files' object REST API with an S3-compatible client, taking advantage of secure SSL communication and seamless data management.
1514

16-
## Connect to the S3 browser
15+
You must install a certificate on your machine before accessing the bucket with S3-compatible clients. This document covers accessing the bucket with the S3 Browser and AWS CLI.
16+
17+
## Install the certificate in the Trusted Root Certification Authorities
18+
19+
Before accessing your object REST API-enabled volume with an S3-compatible client, you must install the certificate.
20+
21+
1. Open the Edge browser on your client system and navigate your bucket's URL: `https://<your-bucket-endpoint-IP-or-FQDN>`.
22+
1. Select the lock icon in the address bar the select **Certificate (Valid)**.
23+
1. In the certificate dialog, select the **Detail tab** then **Copy to file (or Export**). Follow the steps in the export wizard, ensuring you choose the DER encoded binary X.509 (.CER) format. Save the .CER file to your local machine.
24+
1. To install the certificate, select the .CER file on your local machine.
25+
1. In the Certificate window, select **Install Certificate**. In the installation wizard, choose **Local machine** as your installation destination. Note that this requires administrator privileges.
26+
In the Certificate Store screen, select **Place all certificates in the following store** then **Browse** and choose **Trusted Root Certification Authorities**
27+
1. When you complete the steps in the installation wizard, a dialog confirms the certificate was installed successfully.
1728

18-
1. Open the Edge browser on your client system.
19-
1. Enter the IP address of your object REST API-enabled Azure NetApp Files volumes in the browser.
20-
1. The browser should display a certificate error. Select the certificate to view details.
21-
1. Download and install the certificate.
22-
During installation, select **Trusted Root Certification Authorities** as the destination.
23-
Connect S3 Browser to Your Object REST API-Enabled Volume
24-
1. After the installation completes successfully, configure your S3 browser connection Download the S3 compatible browser, add the bucket, then provide the name of the bucket (`https:<domain-name>`), the access key, and the secret key.
29+
## Access files with S3 Browser
30+
31+
1. Download and install [S3 Browser](https://s3browser.com/download.aspx).
32+
2. Add a [new account for S3-compatible storage](https://s3browser.com/s3-compatible-storage.aspx).
33+
When adding the new account, follow these guidelines:
34+
35+
* **REST Endpoint**: Enter the endpoint URL for your volume: `https://<your-bucket-endpoint-IP-or-FQDN>`.
36+
* **Access Key ID**: Use the access key created when you generated the bucket on the NFS volume.
37+
* **Secret access key**: Use corresponding secret key from when you generated the bucket.
38+
* Select **Encrypt Access Keys with a Password** and **Use secure transfer (SSL/TLS)**.
39+
40+
1. After adding the account, verify the connection. In the S3 Browser, select your newly added account in the **Accounts** menu. If the connection was succesful, you see your buckets and can manage the objects.
2541

2642
## Access files with the AWS CLI
2743

@@ -36,6 +52,39 @@ You can use Azure NetApp Files' object REST API with an S3-compatible client, ta
3652

3753
Refer to the [AWS CLI command reference](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) for more information about this command.
3854

55+
1. Download the AWS CLI:
56+
* For Windows, [download the Microsoft Software Installer and run it]( https://aws.amazon.com/cli/).
57+
* For Linux, install the AWS CLI with CURL:
58+
```curl
59+
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
60+
unzip awscliv2.zip
61+
sudo ./aws/install
62+
```
63+
1. Verify the installation succeeded with the command `aws -version`. The expected output is:
64+
```
65+
aws-cli/2.x.x Python/3.x.x Linux/…
66+
```
67+
1. Configure the AWS CLI with the command `aws configure`.
68+
When prompted, provide:
69+
* **AWS access key ID** - Use the access key created when you generated the bucket on the NFS volume.
70+
* **AWS secret access key** - The corresponding secret key from when you generated the bucket.
71+
* **Default region name**: us-east-1
72+
* **Ouptut**: JSON
73+
>[!NOTE]
74+
>When using AWS CLI with Azure NetApp Files buckets, always use us-east-1 as the default region name.
75+
1. List the buckets:
76+
```
77+
aws s3 ls -—endpoint-url https://<your-bucket-endpoint-IP-or-FQDN> -—no-verify-ssl
78+
```
79+
1. List the objects in a bucket:
80+
```
81+
aws s3 ls -—endpoint-url [https://<your bucket endpoint IP or FQDN>](https://<your-bucket-endpoint-IP-or-FQDN>) s3://<bucket-name>/ —-no-verify-ssl
82+
```
83+
1. Copy an object from a bucket to your local workstation:
84+
```
85+
aws s3 cp -—endpoint-url https://<your-bucket-endpoint-IP-or-FQDN> s3://<bucket-name>/<object-name> ./<local-object-name> -—no-verify-ssl
86+
```
87+
3988
## More information
4089
4190
* [Configure object REST API](object-rest-api-access-configure.md)

articles/azure-netapp-files/object-rest-api-databricks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.date: 08/25/2025
8+
ms.date: 10/13/2025
99
ms.author: anfdocs
1010
---
1111

articles/azure-netapp-files/object-rest-api-introduction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: conceptual
8-
ms.date: 10/08/2025
8+
ms.date: 10/13/2025
99
ms.author: anfdocs
1010
---
1111
# Understand Azure NetApp Files object REST API (preview)

articles/azure-netapp-files/object-rest-api-onelake.md

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: azure-netapp-files
55
author: b-ahibbard
66
ms.service: azure-netapp-files
77
ms.topic: how-to
8-
ms.date: 07/31/2025
8+
ms.date: 10/13/2025
99
ms.author: anfdocs
1010
---
1111
# Connect OneLake to an Azure NetApp Files volume using object REST API
@@ -26,27 +26,15 @@ Sensitive information is protected through Microsoft Virtual Networks and Azure
2626
1. Create a workspace in [OneLake](/fabric/onelake/create-lakehouse-onelake).
2727
1. In OneLake, right-click the workspace then select
2828
**Create new lakehouse**.
29-
1. After the lakehouse is successfully created, select **New shortcut**. Follow the instructions to [Create an Amazon S3 compatible shortcut](/fabric/onelake/create-on-premises-shortcut).
29+
1. After the lakehouse is successfully created, select **New shortcut**. Follow the instructions to [Create a OneLake shortcut](/fabric/onelake/create-onelake-shortcut).
3030

3131
The endpoint must be a URL with the volume's IP address, for example `http://0.0.0.0` or a fully qualified domain name, such as https://myanfendpoint.contoso.com.
3232
1. Select your on-premises data gateway in the **Data Gateway** field. After you provide the access key and secret key, the Azure NetApp Files data appears in your OneLake workspace.
3333

3434

3535
## Connect to Azure AI Search
3636

37-
After connecint to OneLake, you can connect a volume to [Azure AI Search](/azure/search/search-what-is-azure-search) to create a search service. For additional information, see [How to index OneLake files](/azure/search/search-how-to-index-onelake-files).
38-
39-
## Steps
40-
41-
1. In the Azure portal, access the Azure AI Search service. If this is your first time accessing the service, see [Create an Azure AI Search service](/azure/search/search-create-service-portal).
42-
1. In the search management section, navigate to **Data Sources**. Select **Add Data Source**.
43-
1. In the data source dropdown, select **Fabric OneLake files**.
44-
1. Provide a name for the data source.
45-
1. Enter the Lakehouse URL that was configured in the OneLake setup.
46-
1. Validate the connection once your OneLake data appears.
47-
1. Select **Add Indexer**, then provide your details by selecting your dataset and OneLake details.
48-
1. Navigate to the 'Index' section and select your data source name.
49-
1. In the search field, enter the information you want to query or use '*' to view the complete indexing details.
37+
After connecting to OneLake, you can connect a volume to [Azure AI Search](/azure/search/search-what-is-azure-search) to create a search service. For additional information, see [How to index OneLake files](/azure/search/search-how-to-index-onelake-files).
5038

5139
## More information
5240

articles/azure-netapp-files/whats-new.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.custom:
88
- linux-related-content
99
- build-2025
1010
ms.topic: overview
11-
ms.date: 10/07/2025
11+
ms.date: 10/13/2025
1212
ms.author: anfdocs
1313
# Customer intent: As a cloud administrator, I want to learn about the latest enhancements in Azure NetApp Files, so that I can effectively utilize new features for improved data security, resilience, and operational efficiency in my organization's cloud storage solutions.
1414
---

0 commit comments

Comments
 (0)