storj.io/minio@v0.0.0-20230509071714-0cbc90f649b1/docs/gateway/azure.md (about)

     1  # MinIO Azure Gateway [![Slack](https://slack.min.io/slack?type=svg)](https://slack.min.io)
     2  MinIO Gateway adds Amazon S3 compatibility to Microsoft Azure Blob Storage.
     3  
     4  ## Run MinIO Gateway for Microsoft Azure Blob Storage
     5  ### Using Docker
     6  ```
     7  docker run -p 9000:9000 --name azure-s3 \
     8   -e "MINIO_ROOT_USER=azurestorageaccountname" \
     9   -e "MINIO_ROOT_PASSWORD=azurestorageaccountkey" \
    10   minio/minio gateway azure
    11  ```
    12  
    13  ### Using Binary
    14  ```
    15  export MINIO_ROOT_USER=azureaccountname
    16  export MINIO_ROOT_PASSWORD=azureaccountkey
    17  minio gateway azure
    18  ```
    19  ## Test using MinIO Browser
    20  MinIO Gateway comes with an embedded web based object browser. Point your web browser to http://127.0.0.1:9000 to ensure that your server has started successfully.
    21  
    22  ![Screenshot](https://github.com/minio/minio/blob/master/docs/screenshots/minio-browser-gateway.png?raw=true)
    23  ## Test using MinIO Client `mc`
    24  `mc` provides a modern alternative to UNIX commands such as ls, cat, cp, mirror, diff etc. It supports filesystems and Amazon S3 compatible cloud storage services.
    25  
    26  ### Configure `mc`
    27  ```
    28  mc alias set myazure http://gateway-ip:9000 azureaccountname azureaccountkey
    29  ```
    30  
    31  ### List containers on Microsoft Azure
    32  ```
    33  mc ls myazure
    34  [2017-02-22 01:50:43 PST]     0B ferenginar/
    35  [2017-02-26 21:43:51 PST]     0B my-container/
    36  [2017-02-26 22:10:11 PST]     0B test-container1/
    37  ```
    38  
    39  ### Use custom access/secret keys
    40  
    41  If you do not want to share the credentials of the Azure blob storage with your users/applications, you can set the original credentials in the shell environment using `AZURE_STORAGE_ACCOUNT` and `AZURE_STORAGE_KEY` variables and assign different access/secret keys to `MINIO_ROOT_USER` and `MINIO_ROOT_PASSWORD`.
    42  
    43  ### Known limitations
    44  Gateway inherits the following Azure limitations:
    45  
    46  - Only read-only bucket policy supported at bucket level, all other variations will return API Notimplemented error.
    47  - Bucket names with "." in the bucket name are not supported.
    48  - Non-empty buckets get removed on a DeleteBucket() call.
    49  - _List Multipart Uploads_ always returns empty list.
    50  
    51  Other limitations:
    52  
    53  - Bucket notification APIs are not supported.
    54  
    55  ## Explore Further
    56  - [`mc` command-line interface](https://docs.min.io/docs/minio-client-quickstart-guide)
    57  - [`aws` command-line interface](https://docs.min.io/docs/aws-cli-with-minio)
    58  - [`minio-go` Go SDK](https://docs.min.io/docs/golang-client-quickstart-guide)