Integrate with Azure Blob Storage

​

Before you begin

• A Pinecone account
• An Azure Blob Storage container

​

1. Create an app registration and service principal

1. Create an app registration for your Pinecone integration. This automatically creates a service principal. When creating your app registration:
   • Do not specify a Redirect URI.
   • Copy the Application (client) ID and the Directory (tenant) ID. You’ll use these values when adding a storage integration in Pinecone.
2. Create a client secret for the service principal. Copy the secret’s Value (not its ID). You’ll use this when creating a storage integration in Pinecone.

​

2. Grant access to the storage account

1. In the Azure portal, navigate to the subscription associated with your storage account.
2. Select Access control (IAM).
3. Click Add > Add role assignment.
4. Select Storage Blob Data Reader or another role that has permission to list and read blobs in a container.
5. Click Next.
6. Select User, group, or service principal and click Select members.
7. Select the app you created in the previous step.
8. Click Review + assign (you may need to click this twice).

​

3. In Pinecone, add a storage integration

​

Use the console

1. Select your project.
2. Go to Manage > Storage integrations.
3. Click Add integration.
4. Enter a unique integration name.
5. Select Azure Blob Storage.
6. For Tenant ID, Client ID, and Client secret, enter the values you copied from Azure.
7. Click Add integration.

​

Use the API

curl -sS -X POST "https://api.pinecone.io/storage-integrations" \
    -H "Api-Key: ${PINECONE_API_KEY}" \
    -H "X-Pinecone-Api-Version: unstable" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "my-azure-integration",
      "provider": "azure_blob",
      "azure_app_credentials": {
        "tenant_id": "TENANT_ID",
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET"
      }
    }'

​

Next steps