共用方式為


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 參數

名稱 位於 必要 類型 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)

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
keyName True

string

應該用於加密的金鑰名稱。

keyVaultPrivateEndpoints True

KeyVaultPrivateEndpoint[]

虛擬網路識別碼和私人端點標識碼的配對。 使用客戶自控金鑰加密的每個虛擬網路都需要自己的金鑰保存庫私人端點。

keyVaultUri True

string (uri)

應該用於加密的金鑰保存庫/受控 HSM 的 URI。

keyVaultResourceId

string (arm-id)

金鑰保存庫/受控 HSM 的 Azure 資源識別碼,應該用於加密。

回應

名稱 類型 Description
202 Accepted

已接受資源作業。

標題

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 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

定義

名稱 Description
ChangeKeyVault

變更金鑰保存庫要求

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

KeyVaultPrivateEndpoint

虛擬網路識別碼和私人端點標識碼的配對。 使用客戶自控金鑰加密的每個虛擬網路都需要自己的金鑰保存庫私人端點。

ChangeKeyVault

變更金鑰保存庫要求

名稱 類型 Description
keyName

string

應該用於加密的金鑰名稱。

keyVaultPrivateEndpoints

KeyVaultPrivateEndpoint[]

虛擬網路識別碼和私人端點標識碼的配對。 使用客戶自控金鑰加密的每個虛擬網路都需要自己的金鑰保存庫私人端點。

keyVaultResourceId

string (arm-id)

金鑰保存庫/受控 HSM 的 Azure 資源識別碼,應該用於加密。

keyVaultUri

string (uri)

應該用於加密的金鑰保存庫/受控 HSM 的 URI。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

附加資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

KeyVaultPrivateEndpoint

虛擬網路識別碼和私人端點標識碼的配對。 使用客戶自控金鑰加密的每個虛擬網路都需要自己的金鑰保存庫私人端點。

名稱 類型 Description
privateEndpointId

string (arm-id)

用於連線 Azure 金鑰保存庫的私人端點識別碼

virtualNetworkId

string (arm-id)

虛擬網路識別碼的識別碼