다음을 통해 공유


Storage Accounts - List Keys

지정된 스토리지 계정에 대한 액세스 키 또는 Kerberos 키(Active Directory를 사용하는 경우)를 나열합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/listKeys?api-version=2025-06-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/listKeys?api-version=2025-06-01&$expand=kerb

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

지정된 리소스 그룹 내의 스토리지 계정 이름입니다. Storage 계정 이름은 3자에서 24자 사이여야 하고 숫자 및 소문자만 사용해야 합니다.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

$expand
query

$expand

나열할 키의 유형을 지정합니다. 가능한 값은 연석입니다.

응답

Name 형식 Description
200 OK

StorageAccountListKeysResult

Azure 작업이 성공적으로 완료되었습니다.

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

StorageAccountListKeys

샘플 요청

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res418/providers/Microsoft.Storage/storageAccounts/sto2220/listKeys?api-version=2025-06-01&$expand=kerb

샘플 응답

{
  "keys": [
    {
      "keyName": "key1",
      "permissions": "Full",
      "value": "<value>"
    },
    {
      "keyName": "key2",
      "permissions": "Full",
      "value": "<value>"
    }
  ]
}

정의

Name Description
$expand

나열할 키의 유형을 지정합니다. 가능한 값은 연석입니다.

ErrorResponse

스토리지 리소스 공급자의 오류 응답입니다.

ErrorResponseBody

오류 응답 본문 계약입니다.

KeyPermission

키에 대한 권한 - 읽기 전용 또는 전체 권한입니다.

StorageAccountKey

스토리지 계정에 대한 액세스 키입니다.

StorageAccountListKeysResult

ListKeys 작업의 응답입니다.

$expand

나열할 키의 유형을 지정합니다. 가능한 값은 연석입니다.

Description
kerb

ErrorResponse

스토리지 리소스 공급자의 오류 응답입니다.

Name 형식 Description
error

ErrorResponseBody

Azure Storage 리소스 공급자 오류 응답 본문입니다.

ErrorResponseBody

오류 응답 본문 계약입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.

message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

KeyPermission

키에 대한 권한 - 읽기 전용 또는 전체 권한입니다.

Description
Read
Full

StorageAccountKey

스토리지 계정에 대한 액세스 키입니다.

Name 형식 Description
creationTime

string (date-time)

왕복 날짜 형식의 키 생성 시간입니다.

keyName

string

키의 이름입니다.

permissions

KeyPermission

키에 대한 권한 - 읽기 전용 또는 전체 권한입니다.

value

string

키의 기본 64로 인코딩된 값입니다.

StorageAccountListKeysResult

ListKeys 작업의 응답입니다.

Name 형식 Description
keys

StorageAccountKey[]

지정된 스토리지 계정에 대한 스토리지 계정 키 및 해당 속성 목록을 가져옵니다.