Microsoft Azure File Storage Library for Go
Перейти к файлу
Sean McCullough 677cc4e82a
Merge pull request #71 from schoag-msft/patch-1
Add retirement notice to README.md
2023-09-27 10:37:08 -05:00
.github Add issue template. 2018-08-10 16:57:49 +08:00
azfile Release v0.8.0 2020-06-30 17:10:28 -07:00
swagger Typo 2019-12-18 17:28:46 -08:00
.gitignore Added support for UploadRangeFromURL (#24) 2019-09-15 21:56:15 -07:00
.travis.yml Support additional SMB properties (creation time, last write time, etc.) (#32) 2020-03-12 13:14:59 -07:00
BreakingChanges.md Update change logs for version 0.4.0. 2019-01-08 15:21:34 +08:00
ChangeLog.md Release v0.8.0 2020-06-30 17:10:28 -07:00
Gopkg.lock Update Gopkg to use latest pipeline package 2019-06-28 14:17:54 -07:00
Gopkg.toml Update Gopkg to use latest pipeline package 2019-06-28 14:17:54 -07:00
LICENSE Inital checkin 2018-02-06 16:42:59 -08:00
README.md Add retirement notice to README.md 2023-09-27 11:08:59 -04:00
SECURITY.md Microsoft mandatory file (#62) 2022-08-01 23:27:46 -07:00
go.mod Support SDDLs on Azure Files 2019-12-18 17:25:14 -08:00
go.sum Support SDDLs on Azure Files 2019-12-18 17:25:14 -08:00

README.md

Azure Storage File SDK for Go (Deprecated)

GoDoc Widget Build Status

This project will be in Community Support until 13 September 2024. After this date the project and associated client libraries will be retired permanently. For more details on the retirement and alternatives to using this project, visit Retirement notice: The legacy Azure Storage Go client libraries will be retired on 13 September 2024.


The Microsoft Azure Storage SDK for Go allows you to build applications that takes advantage of Azure's scalable cloud storage.

This repository contains the open source File SDK for Go.

Features

  • File Storage
    • Create/List/Delete Shares
    • Create/List/Delete Directories
    • Create/Read/List/Update/Delete Files

Getting Started

  • If you don't already have it, install the Go distribution
  • Get the SDK, with any method you prefer:
    • Go Get: go get github.com/Azure/azure-storage-file-go/azfile
    • Dep: add github.com/Azure/azure-storage-file-go to Gopkg.toml:
      [[constraint]]
        version = "0.4.1"
        name = "github.com/Azure/azure-storage-file-go"
      
    • Module: simply import the SDK and Go will download it for you
  • Use the SDK: import "github.com/Azure/azure-storage-file-go/azfile"

Version Table

  • If you are looking to use a specific version of the Storage Service, please refer to the following table:
Service Version Corresponding SDK Version Import Path
2017-07-29 0.3.0 github.com/Azure/azure-storage-file-go/2017-07-29/azfile
2018-03-28 0.4.1+ github.com/Azure/azure-storage-file-go/azfile

Note: the directory structure of the SDK has changed dramatically since 0.4.1. The different Service Versions are no longer sub-directories; the latest azfile is directly under the root directory. In the future, each new Service Version will be introduced with a new major semantic version.

SDK Architecture

  • The Azure Storage SDK for Go provides low-level and high-level APIs.
    • ServiceURL, ShareURL, DirectoryURL and FileURL objects provide the low-level API functionality and map one-to-one to the Azure Storage File REST APIs
    • The high-level APIs provide convenience abstractions such as uploading a large stream to an Azure file (using multiple PutRange requests in parallel) or downloading a large Azure file to local (using multiple Get requests in parallel).

Code Samples

License

This project is licensed under MIT.

Contributing

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 repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.