Get Sas Definitions - Get Sas Definitions

リファレンス

Service:: Key Vault

API Version:: 7.4

指定されたストレージアカウントのストレージ SAS 定義を一覧表示します。この操作には、ストレージ/リストのアクセス許可が必要です。

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

With optional parameters:

GET {vaultBaseUrl}/storage/{storage-account-name}/sas?maxresults={maxresults}&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 バージョン。
maxresults	query		integer int32	ページに返される結果の最大数。指定しない場合、サービスは最大 25 件の結果を返します。

応答

名前	型	説明
200 OK	SasDefinitionListResult	SAS 定義の一覧と SAS 定義の次のページへのリンクを含む応答メッセージ。
Other Status Codes	KeyVaultError	操作Key Vault失敗した理由を説明するエラー応答です。

例

List Storage Sas Definition

Sample Request

HTTP

GET https://myvault.vault.azure.net//storage/listsas01/sas?api-version=7.4

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listStrgSasDef01",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listStrgSasDef01",
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    },
    {
      "id": "https://myvault.vault.azure.net/storage/listsas01/sas/listStrgSasDef02",
      "sid": "https://myvault.vault.azure.net/secrets/listsas01-listStrgSasDef02",
      "attributes": {
        "enabled": true,
        "created": 1490738438,
        "updated": 1490738438,
        "recoveryLevel": "Recoverable"
      }
    }
  ],
  "nextLink": "https://{BaseUri}/storage/listsas01/sas?api-version=7.2&%24skiptoken=<token>"
}

定義

名前	説明
DeletionRecoveryLevel	現在のコンテナー内のストレージアカウントに対して現在有効になっている削除回復レベルを反映します。 "Purgeable" が含まれている場合、ストレージアカウントは特権ユーザーによって完全に削除できます。それ以外の場合は、保持間隔の最後にストレージアカウントを消去できるのはシステムだけです。
Error	キーコンテナーサーバーエラー。
KeyVaultError	キーコンテナーのエラー例外。
SasDefinitionAttributes	SAS 定義管理属性。
SasDefinitionItem	ストレージ SAS 定義メタデータを含む SAS 定義項目。
SasDefinitionListResult	ストレージアカウントの SAS 定義リストの結果。

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	キーコンテナーサーバーエラー。

SasDefinitionAttributes

SAS 定義管理属性。

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

SasDefinitionItem

ストレージ SAS 定義メタデータを含む SAS 定義項目。

名前	型	説明
attributes	SasDefinitionAttributes	SAS 定義管理属性。
id	string	ストレージ SAS 識別子。
sid	string	ストレージアカウント SAS 定義のシークレット ID。
tags	object	キーと値のペアの形式による、アプリケーション固有のメタデータ。

SasDefinitionListResult

ストレージアカウントの SAS 定義リストの結果。

名前	型	説明
nextLink	string	SAS 定義の次のセットを取得する URL。
value	SasDefinitionItem[]	SAS 定義の一覧と SAS 定義の次のページへのリンクを含む応答メッセージ。