Az Azure Blob Storage és a Go használatának első lépései

• .NET
• Java
• JavaScript
• TypeScript
• Python
• Ugrás

Ez a cikk bemutatja, hogyan csatlakozhat az Azure Blob Storage-hoz a Go Azure Blob Storage ügyfélmoduljának használatával. A csatlakozás után a kód a Blob Storage szolgáltatás tárolóira, blobokra és funkcióira is képes.

API-referenciadokumentáció Kódtár forráskódcsomagja | (pkg.go.dev) |

Előfeltételek

• Azure-előfizetés – hozzon létre egyet ingyenesen
• Azure Storage-fiók – tárfiók létrehozása
• Go 1.18+

A projekt beállítása

Ez a szakasz végigvezeti egy projekt előkészítésén a Go-hoz készült Azure Blob Storage-ügyfélmodullal való együttműködéshez.

A GOPATH-ból telepítse az azblob modult a következő paranccsal:

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

A Microsoft Entra-azonosítóval való hitelesítéshez (ajánlott) telepítse a azidentity modult a következő paranccsal:

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

Ezután nyissa meg a kódfájlt, és adja hozzá a szükséges importálási útvonalakat. Ebben a példában a következőket adjuk hozzá a .go fájlhoz:

import (
    "github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)

A Blob-ügyfélmodul adatai:

• azblob: A szolgáltatáson, tárolókon és blobokon való működéshez használható módszereket tartalmazza.

Hozzáférés engedélyezése és csatlakozás a Blob Storage-hoz

Ha egy alkalmazást a Blob Storage-hoz szeretne csatlakoztatni, hozzon létre egy ügyfélobjektumot az azblob használatával . NewClient. Ez az objektum a kiindulási pont az adaterőforrások tárfiók szintjén való használatához. Használhatja a tárfiókon és annak tárolóin való működéshez.

Ha többet szeretne megtudni az ügyfélobjektumok létrehozásáról és kezeléséről, beleértve az ajánlott eljárásokat, olvassa el az adaterőforrásokat kezelő ügyfélobjektumok létrehozását és kezelését ismertető témakört.

Az ügyfélobjektumokat a Microsoft Entra engedélyezési jogkivonat (ajánlott), a fiókhozzáférési kulcs vagy a közös hozzáférésű jogosultságkód (SAS) használatával engedélyezheti.

Microsoft Entra-azonosító (ajánlott)

A Microsoft Entra-azonosítóval való engedélyezéshez biztonsági tagot kell használnia. A következő cikkek útmutatást nyújtanak a különböző hitelesítési forgatókönyvekhez:

• Hitelesítés fejlesztési környezetekben
• Hitelesítés az Azure által üzemeltetett alkalmazásokban
• Hitelesítés szolgáltatásnévvel

Hozzáférés engedélyezése a DefaultAzureCredential használatával

A Blob Storage-hoz való hozzáférés és csatlakozás engedélyezésének egyszerű és biztonságos módja egy OAuth-jogkivonat beszerzése DefaultAzureCredential-példány létrehozásával. Ezután a hitelesítő adatok használatával létrehozhatja az ügyfélobjektumot az azblob használatával . NewClient.

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

SAS-jogkivonat

Közös hozzáférésű jogosultságkód (SAS) jogkivonat használatához fűzze hozzá a jogkivonatot a fiók URL-sztringjéhez, és hozza létre az ügyfélobjektumot az azblob használatával . NewClientWithNoCredential.

func getServiceClientSAS(accountURL string, sasToken string) *azblob.Client {
    // Create a new service client with an existing SAS token

    // Append the SAS to the account URL with a "?" delimiter
    accountURLWithSAS := fmt.Sprintf("%s?%s", accountURL, sasToken)

    client, err := azblob.NewClientWithNoCredential(accountURLWithSAS, nil)
    handleError(err)

    return client
}

Feljegyzés

Olyan esetekben, amikor közös hozzáférésű jogosultságkódokat (SAS) használnak, a Microsoft egy felhasználói delegálási SAS használatát javasolja. A felhasználói delegálási SAS-t a fiókkulcs helyett a Microsoft Entra hitelesítő adatai védik. További információ: Korlátozott hozzáférés biztosítása megosztott hozzáférésű jogosultságkódokkal (SAS) rendelkező adatokhoz.

Fiókkulcs

Megosztott tárfiók használatához adja meg a kulcsot sztringként, és inicializáljon egy ügyfélobjektumot az azblob használatával . NewClientWithSharedKeyCredential.

func getServiceClientSharedKey(accountName string, accountKey string) *azblob.Client {
    // Create a new service client with shared key credential
    credential, err := azblob.NewSharedKeyCredential(accountName, accountKey)
    handleError(err)

    accountURL := fmt.Sprintf("https://%s.blob.core.windows.net", accountName)

    client, err := azblob.NewClientWithSharedKeyCredential(accountURL, credential, nil)
    handleError(err)

    return client
}

Ügyfélobjektumot kapcsolati sztring is létrehozhat.

func getServiceClientConnectionString(connectionString string) *azblob.Client {
    // Create a new service client with connection string
    client, err := azblob.NewClientFromConnectionString(connectionString, nil)
    handleError(err)

    return client
}

A fiókkulcsok beszerzéséről és a kulcsok megfelelő kezelésére és védelmére vonatkozó ajánlott eljárásokról további információt a tárfiók hozzáférési kulcsainak kezelése című témakörben talál.

Fontos

A fiók hozzáférési kulcsát körültekintően kell használni. Ha a fiók hozzáférési kulcsa elveszett vagy véletlenül nem biztonságos helyre került, a szolgáltatás sebezhetővé válhat. Bárki, aki rendelkezik a hozzáférési kulccsal, engedélyezheti a tárfiókra irányuló kérelmeket, és hatékonyan hozzáférhet az összes adathoz. DefaultAzureCredential továbbfejlesztett biztonsági funkciókat és előnyöket biztosít, és az Azure-szolgáltatásokhoz való engedélyezés kezelésének ajánlott megközelítése.

Az alkalmazás összeállítása

Amikor az Azure Blob Storage-ban adaterőforrásokat tartalmazó alkalmazásokat hoz létre, a kód elsősorban három erőforrástípussal dolgozik: tárfiókokkal, tárolókkal és blobokkal. Ha többet szeretne megtudni ezekről az erőforrástípusokról, az egymáshoz való viszonyukról és az alkalmazások erőforrásokkal való interakciójáról, olvassa el a Blob Storage-adaterőforrásokkal való interakciót ismertető témakört.

Az alábbi útmutatók bemutatják, hogyan dolgozhat adaterőforrásokkal, és hogyan hajthat végre konkrét műveleteket a Go Azure Blob Storage-ügyfélmoduljával:

Útmutató	Leírás
Tároló létrehozása	Tárolók létrehozása.
Tárolók törlése és visszaállítása	Tárolók törlése, és ha engedélyezve van a helyreállítható törlés, állítsa vissza a törölt tárolókat.
Tárolók listázása	Egy fiók tárolóinak listázása és a lista testreszabásához elérhető különféle lehetőségek.
Tulajdonságok és metaadatok (tárolók) kezelése	Tárolótulajdonságok és metaadatok kezelése.
Blobok feltöltése	Megtudhatja, hogyan tölthet fel blobokat sztringek, streamek, fájlelérési utak és egyéb módszerek használatával.
Blobok letöltése	Töltse le a blobokat sztringek, streamek és fájlelérési utak használatával.
Blobok listázása	Blobok listázása különböző módokon.
Blobok törlése és visszaállítása	Blobok törlése, és ha engedélyezve van a helyreállítható törlés, állítsa vissza a törölt blobokat.
Blobok keresése címkékkel	Címkék beállítása és lekérése, valamint címkék használata a blobok kereséséhez.
Tulajdonságok és metaadatok (blobok) kezelése	Tárolótulajdonságok és metaadatok kezelése.

Feljegyzés

Az útmutatóban szereplő kódminták az Azure Blob Storage és a Go használatának megkezdéséhez nyújtanak segítséget. Az alkalmazás igényeinek megfelelően módosítania kell a hibakezelést és Context az értékeket.