Set Storage Account - Set Storage Account

Service:

Key Vault

API Version:

7.4

新しいストレージ アカウントを作成または更新します。 この操作には、ストレージ/設定のアクセス許可が必要です。

PUT {vaultBaseUrl}/storage/{storage-account-name}?api-version=7.4

URI パラメーター

名前	/	必須	型	説明
storage-account-name	path	True	string	ストレージ アカウントの名前。 指定した値は、サービスを実行するためにグローバルにコピーされる場合があります。 指定する値には、個人を特定できる情報や機密情報を含めてはなりません。 Regex pattern: ^[0-9a-zA-Z]+$
vaultBaseUrl	path	True	string	コンテナー名 (例: https://myvault.vault.azure.net)。
api-version	query	True	string	クライアント API バージョン。

要求本文

名前	必須	型	説明
activeKeyName	True	string	現在アクティブなストレージ アカウント のキー名。
autoRegenerateKey	True	boolean	keyvault がユーザーのストレージ アカウントを管理する必要があるかどうか。
resourceId	True	string	ストレージ アカウントのリソース ID。
attributes		StorageAccountAttributes	ストレージ アカウントの属性。
regenerationPeriod		string	ISO-8601 形式で指定されたキーの再生成時間。
tags		object	キーと値のペアの形式による、アプリケーション固有のメタデータ。

応答

名前	型	説明
200 OK	StorageBundle	作成されたストレージ アカウント。
Other Status Codes	KeyVaultError	操作Key Vault失敗した理由を説明するエラー応答です。

例

Set Storage account

Sample Request

HTTP

PUT https://myvault.vault.azure.net//storage/setStrg01?api-version=7.4

{
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key2",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P15D",
  "attributes": {
    "enabled": true
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

Sample Response

Status code:

200

{
  "id": "https://myvault.vault.azure.net/storage/setStrg01",
  "resourceId": "/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Storage/storageAccounts/kvstorageacc",
  "activeKeyName": "key2",
  "autoRegenerateKey": true,
  "regenerationPeriod": "P15D",
  "attributes": {
    "enabled": true,
    "created": 1490738386,
    "updated": 1490738386,
    "recoveryLevel": "Recoverable+Purgeable"
  },
  "tags": {
    "tag1": "val1",
    "tag2": "val2"
  }
}

定義

名前	説明
DeletionRecoveryLevel	現在のコンテナー内のストレージ アカウントに対して現在有効になっている削除回復レベルを反映します。 "Purgeable" が含まれている場合、ストレージ アカウントは特権ユーザーによって完全に削除できます。それ以外の場合は、保持間隔の最後にストレージ アカウントを消去できるのはシステムだけです。
Error	キー コンテナー サーバー エラー。
KeyVaultError	キー コンテナーのエラー例外。
StorageAccountAttributes	ストレージ アカウント管理属性。
StorageAccountCreateParameters	ストレージ アカウントはパラメーターを作成します。
StorageBundle	ストレージ アカウント バンドルは、キー コンテナーのストレージ アカウントの詳細とその属性で構成されます。

DeletionRecoveryLevel

現在のコンテナー内のストレージ アカウントに対して現在有効になっている削除回復レベルを反映します。 "Purgeable" が含まれている場合、ストレージ アカウントは特権ユーザーによって完全に削除できます。それ以外の場合は、保持間隔の最後にストレージ アカウントを消去できるのはシステムだけです。

名前	型	説明
CustomizedRecoverable	string	即時および永続的な削除を行わずに削除を回復できるコンテナーの状態を示します (つまり、7<= SoftDeleteRetentionInDays < 90 の場合は消去)。このレベルでは、保持期間中およびサブスクリプションが引き続き使用できる間に、削除されたエンティティの回復可能性が保証されます。
CustomizedRecoverable+ProtectedSubscription	string	7<= SoftDeleteRetentionInDays < 90 の場合に、削除が回復可能、即時および完全削除 (消去) が許可されず、サブスクリプション自体を完全に取り消すことができないコンテナーとサブスクリプションの状態を示します。 このレベルでは、保持期間中に削除されたエンティティの回復可能性が保証され、サブスクリプション自体を取り消すことができないという事実も反映されます。
CustomizedRecoverable+Purgeable	string	削除が回復可能であり、即時および永続的な削除も許可されるコンテナーの状態を示します (つまり、7< = SoftDeleteRetentionInDays < 90 の場合の消去)。 このレベルでは、消去操作が要求されるか、サブスクリプションが取り消されない限り、保持期間中に削除されたエンティティの回復可能性が保証されます。
Purgeable	string	復旧の可能性のない、削除が元に戻せない操作であるコンテナーの状態を示します。 このレベルは、Delete 操作に対して使用できる保護に対応しません。エンティティ レベル以上 (コンテナー、リソース グループ、サブスクリプションなど) で Delete 操作を受け入れると、データが回復不能に失われます。
Recoverable	string	即時および永続的な削除 (消去) を行わずに削除を復旧できるコンテナーの状態を示します。 このレベルでは、リテンション期間 (90 日間) の間、およびサブスクリプションが引き続き使用できる間に、削除されたエンティティの回復可能性が保証されます。 回復されていない場合、システムは90日後にそれを完全に削除します
Recoverable+ProtectedSubscription	string	コンテナーとサブスクリプションの状態を示します。この状態では、保持期間内 (90 日間)、即時削除と完全削除 (消去) が許可されず、サブスクリプション自体を完全に取り消すことができない状態を示します。 回復されていない場合、システムは90日後にそれを完全に削除します
Recoverable+Purgeable	string	削除が回復可能であり、即時および永続的な削除 (消去) も許可されるコンテナーの状態を示します。 このレベルでは、消去操作が要求されるか、サブスクリプションが取り消されない限り、保持期間中 (90 日間) に削除されたエンティティの回復可能性が保証されます。 回復されていない場合、システムは90日後にそれを完全に削除します

Error

キー コンテナー サーバー エラー。

名前	型	説明
code	string	エラー コード。
innererror	Error	キー コンテナー サーバー エラー。
message	string	エラー メッセージ。

KeyVaultError

キー コンテナーのエラー例外。

名前	型	説明
error	Error	キー コンテナー サーバー エラー。

StorageAccountAttributes

ストレージ アカウント管理属性。

名前	型	説明
created	integer	UTC での作成時刻。
enabled	boolean	オブジェクトの有効な状態。
recoverableDays	integer	softDelete data retention days。 softDelete が有効な場合は 、値は >=7、 <=90 である必要があります。それ以外の場合は 0 です。
recoveryLevel	DeletionRecoveryLevel	現在のコンテナー内のストレージ アカウントに対して現在有効になっている削除回復レベルを反映します。 "Purgeable" が含まれている場合、ストレージ アカウントは特権ユーザーによって完全に削除できます。それ以外の場合は、保持間隔の最後にストレージ アカウントを消去できるのはシステムだけです。
updated	integer	UTC の最終更新時刻。

StorageAccountCreateParameters

ストレージ アカウントはパラメーターを作成します。

名前	型	説明
activeKeyName	string	現在アクティブなストレージ アカウント のキー名。
attributes	StorageAccountAttributes	ストレージ アカウントの属性。
autoRegenerateKey	boolean	keyvault がユーザーのストレージ アカウントを管理する必要があるかどうか。
regenerationPeriod	string	ISO-8601 形式で指定されたキーの再生成時間。
resourceId	string	ストレージ アカウントのリソース ID。
tags	object	キーと値のペアの形式による、アプリケーション固有のメタデータ。

StorageBundle

ストレージ アカウント バンドルは、キー コンテナーのストレージ アカウントの詳細とその属性で構成されます。

名前	型	説明
activeKeyName	string	現在アクティブなストレージ アカウント キー名。
attributes	StorageAccountAttributes	ストレージ アカウントの属性。
autoRegenerateKey	boolean	keyvault がユーザーのストレージ アカウントを管理する必要があるかどうか。
id	string	ストレージ アカウント ID。
regenerationPeriod	string	ISO-8601 形式で指定されたキーの再生成時間。
resourceId	string	ストレージ アカウントのリソース ID。
tags	object	キーと値のペアの形式のアプリケーション固有のメタデータ