다음을 통해 공유


Azure Stack Hub 스토리지 개발 도구 시작

Microsoft Azure Stack Hub는 Blob, 테이블 및 큐 스토리지를 포함하는 스토리지 서비스 집합을 제공합니다.

이 문서를 가이드로 사용하여 Azure Stack Hub 스토리지 개발 도구 사용을 시작합니다. 해당 Azure Storage 자습서에서 자세한 정보 및 샘플 코드를 찾을 수 있습니다.

참고

각 플랫폼에 대한 특정 요구 사항을 포함하여 Azure Stack Hub 스토리지와 Azure Storage 간에는 차이가 있습니다. 예를 들어 Azure Stack Hub에 대한 특정 클라이언트 라이브러리 및 엔드포인트 접미사 요구 사항이 있습니다. 자세한 내용은 Azure Stack Hub 스토리지: 차이점 및 고려 사항을 참조하세요.

Azure 클라이언트 라이브러리

스토리지 클라이언트 라이브러리의 경우 REST API와 호환되는 버전을 알고 있어야 합니다. 또한 코드에서 Azure Stack Hub 엔드포인트를 지정해야 합니다.

2301 업데이트 이상

클라이언트 라이브러리 Azure Stack Hub 지원 버전 링크 엔드포인트 사양
.NET 일반: 12.9.0
Blob: 12.10.0
큐: 12.8.0
NuGet 패키지:
일반: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
큐: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

GitHub 릴리스:
일반: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.9.0/sdk/storage/Azure.Storage.Common
Blob: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.10.0/sdk/storage/Azure.Storage.Blobs
큐: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config 파일
Java 일반: 12.12.0
Blob: 12.14.3
큐: 12.11.3
Maven 패키지:
일반: https://mvnrepository.com/artifact/com.azure/azure-storage-common/12.12.0
Blob: https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.14.3
큐: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.11.3

GitHub 릴리스:
일반: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-common_12.12.0/sdk/storage/azure-storage-common
Blob: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-blob_12.14.3/sdk/storage/azure-storage-blob
큐: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.11.3/sdk/storage/azure-storage-queue
연결 문자열 설정
Node.js 2.8.3 NPM 링크:
https://www.npmjs.com/package/azure-storage
(실행: npm install azure-storage@2.8.3)

GitHub 릴리스:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
서비스 인스턴스 선언
C++ Blob: 12.2.0
큐: 12.0.0
GitHub 릴리스:
Blob: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-blobs_12.2.0
큐: https://github.com/Azure/azure-sdk-for-cpp/tree/azure-storage-queues_12.0.0
연결 문자열 설정
PHP 1.2.0 GitHub 릴리스:
일반: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-common
Blob: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-blob
큐:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
테이블: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Composer를 통해 설치(자세한 내용은 아래 세부 정보를 참조하세요.)
연결 문자열 설정
Python Blob: 12.9.0
큐: 12.1.6
GitHub 릴리스:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.9.0/sdk/storage/azure-storage-blob
큐:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
서비스 인스턴스 선언
Ruby 1.0.1 RubyGems 패키지:
일반:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
큐: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
테이블: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub 릴리스:
일반: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-common
Blob: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-blob
큐: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
테이블: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
연결 문자열 설정

참고

취약한 버전의 Jackson 패키지에 대한 종속성 때문에 이전 버전의 .NET 및 Java 클라이언트 라이브러리에는 심각도가 높은 취약성이 있습니다. 보안 문제를 방지하기 위해 지원되는 최신 버전의 .NET 및 Java 클라이언트 라이브러리를 사용하는 것이 좋습니다.

작성기를 통해 PHP 클라이언트 설치 - 현재

Composer를 통해 설치하려면: (예를 들어 Blob을 사용합니다.)

  1. 다음 코드를 사용하여 프로젝트 루트에 composer.json 이라는 파일을 만듭니다.

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. 프로젝트 루트에 composer.phar 를 다운로드합니다.

  3. php composer.phar install을 실행합니다.

API 버전 지정

.NET 클라이언트 라이브러리(일반: v12.9.0/ Blob: v12.10.0/ 큐: v12.8.0) 및 Java 클라이언트 라이브러리(일반: v12.12)를 사용하려면 .0 / Blob: v12.13.0 / Queue: v12.10.0), 각 클라이언트 클래스( BlobServiceClient, BlobContainerClient 포함)에서 serviceVersion을 명시적으로 지정해야 합니다. BlobClient, QueueServiceClientQueueClient) 클라이언트 클래스의 기본 버전은 현재 Azure Stack Hub에서 지원되지 않기 때문입니다.

예제

.NET
BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);
Java
BlobServiceVersion version = BlobServiceVersion.V2019_07_07; 
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
    .endpoint("<your_endpoint>")
    .sasToken("<your_SAS_token>")
    .serviceVersion(version)
    .buildClient();

2008년 업데이트 이상

클라이언트 라이브러리 Azure Stack Hub 지원 버전 링크 엔드포인트 사양
.NET 일반: 12.9.0
Blob: 12.10.0
큐: 12.8.0
NuGet 패키지:
일반: https://www.nuget.org/packages/Azure.Storage.common/12.9.0
Blob: https://www.nuget.org/packages/Azure.Storage.Blobs/12.10.0
큐: https://www.nuget.org/packages/Azure.Storage.queues/12.8.0

GitHub 릴리스:
일반: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Common_12.9.0/sdk/storage/Azure.Storage.Common
Blob: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Blobs_12.10.0/sdk/storage/Azure.Storage.Blobs
큐: https://github.com/Azure/azure-sdk-for-net/tree/Azure.Storage.Queues_12.8.0/sdk/storage/Azure.Storage.Queues
app.config 파일
Java 일반: 12.12.0
Blob: 12.13.0
큐: 12.10.0
Maven 패키지:
일반: https://mvnrepository.com/artifact/com.azure/azure-storage-common/12.12.0
Blob: https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.13.0
큐: https://mvnrepository.com/artifact/com.azure/azure-storage-queue/12.10.0

GitHub 릴리스:
일반: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-common_12.12.0/sdk/storage/azure-storage-common
Blob: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-blob_12.13.0/sdk/storage/azure-storage-blob
큐: https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-queue_12.10.0/sdk/storage/azure-storage-queue
연결 문자열 설정
Node.js 2.8.3 NPM 링크:
https://www.npmjs.com/package/azure-storage
(실행: npm install azure-storage@2.8.3)

GitHub 릴리스:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
서비스 인스턴스 선언
C++ 7.2.0 GitHub 릴리스:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.2.0
연결 문자열 설정
PHP 1.2.0 GitHub 릴리스:
일반: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-common
Blob: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-blob
큐:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
테이블: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Composer를 통해 설치(자세한 내용은 아래 세부 정보를 참조하세요.)
연결 문자열 설정
Python Blob: 12.3.1
큐: 12.1.6
GitHub 릴리스:
Blob:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.3.1/sdk/storage/azure-storage-blob
큐:
https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-queue_12.1.6/sdk/storage/azure-storage-queue
서비스 인스턴스 선언
Ruby 1.0.1 RubyGems 패키지:
일반:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
큐: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
테이블: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub 릴리스:
일반: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-common
Blob: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-blob
큐: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
테이블: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
연결 문자열 설정

작성기를 통해 PHP 클라이언트 설치 - 현재

Composer를 통해 설치하려면: (예를 들어 Blob을 사용합니다.)

  1. 다음 코드를 사용하여 프로젝트 루트에 composer.json 이라는 파일을 만듭니다.

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. 프로젝트 루트에 composer.phar 를 다운로드합니다.

  3. php composer.phar install을 실행합니다.

API 버전 지정

.NET 클라이언트 라이브러리(일반: v12.9.0/ Blob: v12.10.0/ 큐: v12.8.0) 및 Java 클라이언트 라이브러리(일반: v12.12)를 사용하려면 .0 / Blob: v12.13.0 / Queue: v12.10.0), 각 클라이언트 클래스( BlobServiceClient, BlobContainerClient 포함)에서 serviceVersion을 명시적으로 지정해야 합니다. BlobClient, QueueServiceClientQueueClient) 클라이언트 클래스의 기본 버전은 현재 Azure Stack Hub에서 지원되지 않기 때문입니다.

예제

.NET
BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);
Java
BlobServiceVersion version = BlobServiceVersion.V2019_07_07; 
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
    .endpoint("<your_endpoint>")
    .sasToken("<your_SAS_token>")
    .serviceVersion(version)
    .buildClient();

2005년 업데이트

클라이언트 라이브러리 Azure Stack Hub 지원 버전 링크 엔드포인트 사양
.NET 11.0.0 NuGet 패키지:
일반: https://www.nuget.org/packages/Microsoft.Azure.Storage.Common/11.0.0
Blob: https://www.nuget.org/packages/Microsoft.Azure.Storage.Blob/11.0.0
큐:
https://www.nuget.org/packages/Microsoft.Azure.Storage.Queue/11.0.0

GitHub 릴리스:
https://github.com/Azure/azure-storage-net/releases/tag/v11.0.0
app.config 파일
Java 12.0.0-preview.3 Maven 패키지:
https://mvnrepository.com/artifact/com.azure/azure-storage-blob/12.0.0-preview.3

GitHub 릴리스:
https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage
연결 문자열 설정
Node.js 2.8.3 NPM 링크:
https://www.npmjs.com/package/azure-storage
(실행: npm install azure-storage@2.8.3)

GitHub 릴리스:
https://github.com/Azure/azure-storage-node/releases/tag/v2.8.3
서비스 인스턴스 선언
C++ 7.1.0 GitHub 릴리스:
https://github.com/Azure/azure-storage-cpp/releases/tag/v7.1.0
연결 문자열 설정
PHP 1.2.0 GitHub 릴리스:
일반: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-common
Blob: https://github.com/Azure/azure-storage-php/releases/tag/v1.2.0-blob
큐:
https://github.com/Azure/azure-storage-php/releases/tag/v1.1.1-queue
테이블: https://github.com/Azure/azure-storage-php/releases/tag/v1.1.0-table

Composer를 통해 설치(자세한 내용은 아래 세부 정보를 참조하세요.)
연결 문자열 설정
Python 2.1.0 GitHub 릴리스:
일반:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-common
Blob:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-blob
큐:
https://github.com/Azure/azure-storage-python/releases/tag/v2.1.0-queue
서비스 인스턴스 선언
Ruby 1.0.1 RubyGems 패키지:
일반:
https://rubygems.org/gems/azure-storage-common/versions/1.0.1
Blob: https://rubygems.org/gems/azure-storage-blob/versions/1.0.1
큐: https://rubygems.org/gems/azure-storage-queue/versions/1.0.1
테이블: https://rubygems.org/gems/azure-storage-table/versions/1.0.1

GitHub 릴리스:
일반: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-common
Blob: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-blob
큐: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-queue
테이블: https://github.com/Azure/azure-storage-ruby/releases/tag/v1.0.1-table
연결 문자열 설정

작성기를 통해 PHP 클라이언트 설치 - 현재

Composer를 통해 설치하려면: (예를 들어 Blob을 사용합니다.)

  1. 다음 코드를 사용하여 프로젝트 루트에 composer.json 이라는 파일을 만듭니다.

    {
      "require": {
      "Microsoft/azure-storage-blob":"1.2.0"
      }
    }
    
  2. 프로젝트 루트에 composer.phar 를 다운로드합니다.

  3. php composer.phar install을 실행합니다.

엔드포인트 선언

Azure Stack Hub 엔드포인트에는 지역 이름과 Azure Stack Hub 도메인의 두 부분이 포함됩니다. Azure Stack Development Kit에서 기본 엔드포인트는 local.azurestack.external입니다. 엔드포인트에 대해 잘 모르는 경우 클라우드 관리자에게 문의하세요.

예제

.NET

Azure Stack Hub의 경우 엔드포인트 접미사는 app.config 파일에 지정됩니다.

<add key="StorageConnectionString"
value="DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=mykey;
EndpointSuffix=local.azurestack.external;" />

Java

Azure Stack Hub의 경우 엔드포인트 접미사는 연결 문자열 설정에 지정됩니다.

public static final String storageConnectionString =
    "DefaultEndpointsProtocol=http;" +
    "AccountName=your_storage_account;" +
    "AccountKey=your_storage_account_key;" +
    "EndpointSuffix=local.azurestack.external";

Node.js

Azure Stack Hub의 경우 엔드포인트 접미사는 선언 instance 지정됩니다.

var blobSvc = azure.createBlobService('myaccount', 'mykey',
'myaccount.blob.local.azurestack.external');

C++

Azure Stack Hub의 경우 엔드포인트 접미사는 연결 문자열 설정에 지정됩니다.

const utility::string_t storage_connection_string(U("DefaultEndpointsProtocol=https;
AccountName=your_storage_account;
AccountKey=your_storage_account_key;
EndpointSuffix=local.azurestack.external"));

PHP

Azure Stack Hub의 경우 엔드포인트 접미사는 연결 문자열 설정에 지정됩니다.

$connectionString = 'BlobEndpoint=https://<storage account name>.blob.local.azurestack.external/;
QueueEndpoint=https:// <storage account name>.queue.local.azurestack.external/;
TableEndpoint=https:// <storage account name>.table.local.azurestack.external/;
AccountName=<storage account name>;AccountKey=<storage account key>'

Python

Azure Stack Hub의 경우 엔드포인트 접미사는 선언 instance 지정됩니다.

block_blob_service = BlockBlobService(account_name='myaccount',
account_key='mykey',
endpoint_suffix='local.azurestack.external')

Ruby

Azure Stack Hub의 경우 엔드포인트 접미사는 연결 문자열 설정에 지정됩니다.

set
AZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;
AccountName=myaccount;
AccountKey=mykey;
EndpointSuffix=local.azurestack.external

Blob 스토리지

다음 Azure Blob Storage 자습서는 Azure Stack Hub에 적용할 수 있습니다. 이전 예제 섹션에서 설명한 Azure Stack Hub에 대한 특정 엔드포인트 접미사 요구 사항을 확인합니다 .

Queue Storage

다음 Azure Queue Storage 자습서는 Azure Stack Hub에 적용할 수 있습니다. 이전 예제 섹션에서 설명한 Azure Stack Hub에 대한 특정 엔드포인트 접미사 요구 사항을 확인합니다 .

Table Storage

다음 Azure Table Storage 자습서는 Azure Stack Hub에 적용할 수 있습니다. 이전 예제 섹션에서 설명한 Azure Stack Hub에 대한 특정 엔드포인트 접미사 요구 사항을 확인합니다 .

다음 단계