다음을 통해 공유


Accounts - Change Key Vault

Key Vault/관리형 HSM 및 새 볼륨으로 암호화된 기존 볼륨에 영향을 줍니다. HSM에서 Key Vault로, Key Vault에서 HSM으로, HSM에서 HSM으로, Key Vault에서 Key Vault로 지원합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/changeKeyVault?api-version=2025-12-01

URI 매개 변수

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

string

pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$

NetApp 계정의 이름

resourceGroupName
path True

string

minLength: 1
maxLength: 90

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

subscriptionId
path True

string (uuid)

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

api-version
query True

string

minLength: 1

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

요청 본문

Name 필수 형식 Description
keyName True

string

암호화에 사용해야 하는 키의 이름입니다.

keyVaultPrivateEndpoints True

KeyVaultPrivateEndpoint[]

가상 네트워크 ID 및 프라이빗 엔드포인트 ID 쌍입니다. 고객 관리형 키로 암호화된 볼륨이 있는 모든 가상 네트워크에는 자체 키 자격 증명 모음 프라이빗 엔드포인트가 필요합니다.

keyVaultUri True

string (uri)

암호화에 사용해야 하는 키 자격 증명 모음/관리형 HSM의 URI입니다.

keyVaultResourceId

string (arm-id)

암호화에 사용해야 하는 키 자격 증명 모음/관리형 HSM의 Azure 리소스 ID입니다.

응답

Name 형식 Description
202 Accepted

리소스 작업이 수락되었습니다.

헤더

  • Location: string
  • Retry-After: integer
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 사용자 계정 가장

예제

Accounts_ChangeKeyVault

샘플 요청

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/changeKeyVault?api-version=2025-12-01

{
  "keyName": "rsakey",
  "keyVaultPrivateEndpoints": [
    {
      "privateEndpointId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Network/privateEndpoints/privip1",
      "virtualNetworkId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Network/virtualNetworks/vnet1"
    }
  ],
  "keyVaultResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.KeyVault/managedHSMs/my-hsm",
  "keyVaultUri": "https://my-key-vault.managedhsm.azure.net"
}

샘플 응답

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.NetApp/locations/eastus/operationResults/a0216c17-f9d6-4b99-9faf-9ebd4883d0e4?api-version=2025-12-01&operationResultResponseType=Location

정의

Name Description
ChangeKeyVault

키 자격 증명 모음 요청 변경

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

KeyVaultPrivateEndpoint

가상 네트워크 ID 및 프라이빗 엔드포인트 ID 쌍입니다. 고객 관리형 키로 암호화된 볼륨이 있는 모든 가상 네트워크에는 자체 키 자격 증명 모음 프라이빗 엔드포인트가 필요합니다.

ChangeKeyVault

키 자격 증명 모음 요청 변경

Name 형식 Description
keyName

string

암호화에 사용해야 하는 키의 이름입니다.

keyVaultPrivateEndpoints

KeyVaultPrivateEndpoint[]

가상 네트워크 ID 및 프라이빗 엔드포인트 ID 쌍입니다. 고객 관리형 키로 암호화된 볼륨이 있는 모든 가상 네트워크에는 자체 키 자격 증명 모음 프라이빗 엔드포인트가 필요합니다.

keyVaultResourceId

string (arm-id)

암호화에 사용해야 하는 키 자격 증명 모음/관리형 HSM의 Azure 리소스 ID입니다.

keyVaultUri

string (uri)

암호화에 사용해야 하는 키 자격 증명 모음/관리형 HSM의 URI입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

KeyVaultPrivateEndpoint

가상 네트워크 ID 및 프라이빗 엔드포인트 ID 쌍입니다. 고객 관리형 키로 암호화된 볼륨이 있는 모든 가상 네트워크에는 자체 키 자격 증명 모음 프라이빗 엔드포인트가 필요합니다.

Name 형식 Description
privateEndpointId

string (arm-id)

Azure Key Vault에 도달하기 위한 프라이빗 엔드포인트의 식별자

virtualNetworkId

string (arm-id)

가상 네트워크 ID에 대한 식별자