Backup Vaults - Get In Resource Group

Serviço:: Data Protection

Versão da API:: 2026-03-01

Retorna a coleção de recursos pertencente a um grupo de recursos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults?api-version=2026-03-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	BackupVaultResourceList	Operação do Azure concluída com sucesso.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Get BackupVaults in ResourceGroup

Solicitação de exemplo

HTTP

GET https://management.azure.com/subscriptions/0b352192-dcac-4cc7-992e-a96190ccc68c/resourceGroups/SampleResourceGroup/providers/Microsoft.DataProtection/backupVaults?api-version=2026-03-01

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "name": "ExampleVault1",
      "type": "Microsoft.DataProtection/BackupVaults",
      "id": "/subscriptions/0b352192-dcac-4cc7-992e-a96190ccc68c/resourceGroups/SampleResourceGroup/providers/Microsoft.DataProtection/BackupVaults/ExampleVault1",
      "location": "WestUS",
      "properties": {
        "bcdrSecurityLevel": "Good",
        "featureSettings": {
          "crossRegionRestoreSettings": {
            "state": "Enabled"
          }
        },
        "provisioningState": "Succeeded",
        "secureScore": "Adequate",
        "securitySettings": {
          "softDeleteSettings": {
            "retentionDurationInDays": 14,
            "state": "Enabled"
          }
        },
        "storageSettings": [
          {
            "type": "LocallyRedundant",
            "datastoreType": "VaultStore"
          }
        ]
      },
      "tags": {
        "key1": "val1"
      }
    },
    {
      "name": "ExampleVault2",
      "type": "Microsoft.DataProtection/BackupVaults",
      "id": "/subscriptions/0b352192-dcac-4cc7-992e-a96190ccc68c/resourceGroups/SampleResourceGroup/providers/Microsoft.DataProtection/BackupVaults/ExampleVault2",
      "location": "WestUS",
      "properties": {
        "bcdrSecurityLevel": "Good",
        "featureSettings": {
          "crossRegionRestoreSettings": {
            "state": "Enabled"
          }
        },
        "monitoringSettings": {
          "azureMonitorAlertSettings": {
            "alertsForAllJobFailures": "Enabled"
          }
        },
        "provisioningState": "Succeeded",
        "secureScore": "Adequate",
        "securitySettings": {
          "softDeleteSettings": {
            "retentionDurationInDays": 14,
            "state": "Enabled"
          }
        },
        "storageSettings": [
          {
            "type": "LocallyRedundant",
            "datastoreType": "VaultStore"
          }
        ]
      },
      "tags": {
        "key1": "val1"
      }
    }
  ]
}

Definições

Nome	Description
AlertsState
AzureMonitorAlertSettings	Configurações para alertas baseados no Azure Monitor
BackupVault	Cofre de backup
BackupVaultResource	Recurso do Cofre de Backup
BackupVaultResourceList	Lista de recursos do BackupVault
BCDRSecurityLevel	Nível de segurança do Cofre de Backup
CloudError	Uma resposta de erro do Backup do Azure.
CmkKekIdentity	Os detalhes da identidade gerenciada usada para o CMK
CmkKeyVaultProperties	As propriedades do Key Vault que hospeda o CMK
createdByType	O tipo de identidade que criou o recurso.
CrossRegionRestoreSettings
CrossRegionRestoreState	Estado CrossRegionRestore
CrossSubscriptionRestoreSettings	Configurações de CrossSubscriptionRestore
CrossSubscriptionRestoreState	Estado CrossSubscriptionRestore
DppIdentityDetails	Detalhes da identidade
encryptionSettings	Detalhes da Chave Gerenciada do Cliente do recurso.
EncryptionState	Estado de criptografia do Cofre de Backup.
Error	A resposta de erro de gerenciamento de recursos.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
FeatureSettings	Classe que contém as configurações de recurso do cofre
IdentityType	O tipo de identidade. 'SystemAssigned' e 'UserAssigned' são mutuamente exclusivos. 'SystemAssigned' usará a identidade gerenciada criada implicitamente.
ImmutabilitySettings	Configurações de Imutabilidade no nível do cofre
ImmutabilityState	Estado de imutabilidade
InfrastructureEncryptionState	Habilitando/desabilitando o estado de Criptografia Dupla
MonitoringSettings	Configurações de monitoramento
ProvisioningState	Estado de provisionamento do recurso BackupVault
ResourceMoveDetails	ResourceMoveDetails será retornado em resposta à chamada GetResource do ARM
ResourceMoveState	Estado de movimentação de recursos para o cofre de backup
SecureScoreLevel	Classificação segura do Cofre de Backup
SecuritySettings	Classe que contém configurações de segurança do cofre
SoftDeleteSettings	Configurações relacionadas à exclusão reversível
SoftDeleteState	Estado da exclusão reversível
StorageSetting	Configuração de armazenamento
StorageSettingStoreTypes	Obtém ou define o tipo do armazenamento de dados.
StorageSettingTypes	Obtém ou define o tipo.
systemData	Metadados relativos à criação e última modificação do recurso.
UserAssignedIdentity	Propriedades de identidade atribuídas pelo usuário

AlertsState

Enumeração

Valor	Description
Enabled
Disabled

AzureMonitorAlertSettings

Objeto

Configurações para alertas baseados no Azure Monitor

Nome	Tipo	Description
alertsForAllJobFailures	AlertsState

BackupVault

Objeto

Cofre de backup

Nome	Tipo	Description
bcdrSecurityLevel	BCDRSecurityLevel	Nível de segurança do Cofre de Backup
featureSettings	FeatureSettings	Configurações de recurso
isVaultProtectedByResourceGuard	boolean	É o cofre protegido pelo resource guard
monitoringSettings	MonitoringSettings	Configurações de monitoramento
provisioningState	ProvisioningState	Estado de provisionamento do recurso BackupVault
replicatedRegions	string[]	Lista de regiões replicadas para o Cofre de Backup
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests no qual a verificação LAC será executada
resourceMoveDetails	ResourceMoveDetails	Detalhes de movimentação de recursos para o cofre de backup
resourceMoveState	ResourceMoveState	Estado de movimentação de recursos para o cofre de backup
secureScore	SecureScoreLevel	Classificação segura do Cofre de Backup
securitySettings	SecuritySettings	Configurações de segurança
storageSettings	StorageSetting[]	Configurações de armazenamento

BackupVaultResource

Objeto

Recurso do Cofre de Backup

Nome	Tipo	Description
eTag	string	ETag opcional.
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	DppIdentityDetails	Detalhes da identidade gerenciada de entrada
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties	BackupVault	Propriedades de BackupVaultResource
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

BackupVaultResourceList

Objeto

Lista de recursos do BackupVault

Nome	Tipo	Description
nextLink	string	O uri para buscar a próxima página de recursos. A chamada ListNext() busca a próxima página de recursos.
value	BackupVaultResource[]	Lista de recursos.

BCDRSecurityLevel

Enumeração

Nível de segurança do Cofre de Backup

Valor	Description
Poor
Fair
Good
Excellent
NotSupported

CloudError

Objeto

Uma resposta de erro do Backup do Azure.

Nome	Tipo	Description
error	Error	A resposta de erro de gerenciamento de recursos.

CmkKekIdentity

Objeto

Os detalhes da identidade gerenciada usada para o CMK

Nome	Tipo	Description
identityId	string	A identidade gerenciada a ser usada que tem permissões de acesso para o Key Vault. Forneça um valor aqui no caso de tipos de identidade: somente "UserAssigned".
identityType	IdentityType	O tipo de identidade. 'SystemAssigned' e 'UserAssigned' são mutuamente exclusivos. 'SystemAssigned' usará a identidade gerenciada criada implicitamente.

CmkKeyVaultProperties

Objeto

As propriedades do Key Vault que hospeda o CMK

Nome	Tipo	Description
keyUri	string	O uri de chave da chave gerenciada pelo cliente

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

CrossRegionRestoreSettings

Objeto

Nome	Tipo	Description
state	CrossRegionRestoreState	Estado CrossRegionRestore

CrossRegionRestoreState

Enumeração

Estado CrossRegionRestore

Valor	Description
Disabled
Enabled

CrossSubscriptionRestoreSettings

Objeto

Configurações de CrossSubscriptionRestore

Nome	Tipo	Description
state	CrossSubscriptionRestoreState	Estado CrossSubscriptionRestore

CrossSubscriptionRestoreState

Enumeração

Estado CrossSubscriptionRestore

Valor	Description
Disabled
PermanentlyDisabled
Enabled

DppIdentityDetails

Objeto

Detalhes da identidade

Nome	Tipo	Description
principalId	string	A ID do objeto da entidade de serviço para a identidade gerenciada que é usada para conceder acesso baseado em função a um recurso do Azure.
tenantId	string	Um GUID (Identificador Global exclusivo) que representa o locatário do Azure AD em que o recurso agora é membro.
type	string	O identityType que pode ser SystemAssigned, UserAssigned, 'SystemAssigned,UserAssigned' ou None
userAssignedIdentities	<string, UserAssignedIdentity>	Obtém ou define as identidades atribuídas pelo usuário.

encryptionSettings

Objeto

Detalhes da Chave Gerenciada do Cliente do recurso.

Nome	Tipo	Description
infrastructureEncryption	InfrastructureEncryptionState	Habilitando/desabilitando o estado de Criptografia Dupla
kekIdentity	CmkKekIdentity	Os detalhes da identidade gerenciada usada para o CMK
keyVaultProperties	CmkKeyVaultProperties	As propriedades do Key Vault que hospeda o CMK
state	EncryptionState	Estado de criptografia do Cofre de Backup.

EncryptionState

Enumeração

Estado de criptografia do Cofre de Backup.

Valor	Description
Enabled	A criptografia cmk está habilitada no Cofre de Backup
Disabled	A criptografia cmk está desabilitada no Cofre de Backup. O usuário não poderá definir esse estado depois que o Estado de Criptografia estiver "Habilitado".
Inconsistent	A criptografia cmk está em estado inconsistente no Cofre de Backup. Esse estado indica que o usuário precisa repetir a operação de configurações de criptografia imediatamente para corrigir o estado.

Error

Objeto

A resposta de erro de gerenciamento de recursos.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	Error[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

FeatureSettings

Objeto

Classe que contém as configurações de recurso do cofre

Nome	Tipo	Description
crossRegionRestoreSettings	CrossRegionRestoreSettings
crossSubscriptionRestoreSettings	CrossSubscriptionRestoreSettings	Configurações de CrossSubscriptionRestore

IdentityType

Enumeração

O tipo de identidade. 'SystemAssigned' e 'UserAssigned' são mutuamente exclusivos. 'SystemAssigned' usará a identidade gerenciada criada implicitamente.

Valor	Description
SystemAssigned
UserAssigned

ImmutabilitySettings

Objeto

Configurações de Imutabilidade no nível do cofre

Nome	Tipo	Description
state	ImmutabilityState	Estado de imutabilidade

ImmutabilityState

Enumeração

Estado de imutabilidade

Valor	Description
Disabled
Unlocked
Locked

InfrastructureEncryptionState

Enumeração

Habilitando/desabilitando o estado de Criptografia Dupla

Valor	Description
Enabled
Disabled

MonitoringSettings

Objeto

Configurações de monitoramento

Nome	Tipo	Description
azureMonitorAlertSettings	AzureMonitorAlertSettings	Configurações para alertas baseados no Azure Monitor

ProvisioningState

Enumeração

Estado de provisionamento do recurso BackupVault

Valor	Description
Failed
Provisioning
Succeeded
Unknown
Updating

ResourceMoveDetails

Objeto

ResourceMoveDetails será retornado em resposta à chamada GetResource do ARM

Nome	Tipo	Description
completionTimeUtc	string	Tempo de conclusão em UTC da operação mais recente do ResourceMove tentada. Formato ISO 8601.
operationId	string	CorrelationId da última operação ResourceMove tentada
sourceResourcePath	string	Caminho de recurso do ARM do recurso de origem
startTimeUtc	string	Hora de início em UTC da operação mais recente do ResourceMove tentada. Formato ISO 8601.
targetResourcePath	string	Caminho de recurso do ARM do recurso de destino usado na operação ResourceMove mais recente

ResourceMoveState

Enumeração

Estado de movimentação de recursos para o cofre de backup

Valor	Description
Unknown
InProgress
PrepareFailed
CommitFailed
Failed
PrepareTimedout
CommitTimedout
CriticalFailure
PartialSuccess
MoveSucceeded

SecureScoreLevel

Enumeração

Classificação segura do Cofre de Backup

Valor	Description
None
Minimum
Adequate
Maximum
NotSupported

SecuritySettings

Objeto

Classe que contém configurações de segurança do cofre

Nome	Tipo	Description
encryptionSettings	encryptionSettings	Detalhes da Chave Gerenciada do Cliente do recurso.
immutabilitySettings	ImmutabilitySettings	Configurações de Imutabilidade no nível do cofre
softDeleteSettings	SoftDeleteSettings	Configurações relacionadas à exclusão reversível

SoftDeleteSettings

Objeto

Configurações relacionadas à exclusão reversível

Nome	Tipo	Description
retentionDurationInDays	number (double)	Duração da retenção de exclusão reversível
state	SoftDeleteState	Estado da exclusão reversível

SoftDeleteState

Enumeração

Estado da exclusão reversível

Valor	Description
Off	A exclusão reversível está desativada para o BackupVault
On	A Exclusão Reversível está habilitada para o BackupVault, mas pode ser desativada
AlwaysOn	A Exclusão Reversível está habilitada permanentemente para o BackupVault e a configuração não pode ser alterada

StorageSetting

Objeto

Configuração de armazenamento

Nome	Tipo	Description
datastoreType	StorageSettingStoreTypes	Obtém ou define o tipo do armazenamento de dados.
type	StorageSettingTypes	Obtém ou define o tipo.

StorageSettingStoreTypes

Enumeração

Obtém ou define o tipo do armazenamento de dados.

Valor	Description
ArchiveStore
OperationalStore
VaultStore

StorageSettingTypes

Enumeração

Obtém ou define o tipo.

Valor	Description
GeoRedundant
LocallyRedundant
ZoneRedundant

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

UserAssignedIdentity

Objeto

Propriedades de identidade atribuídas pelo usuário

Nome	Tipo	Description
clientId	string (uuid)	A ID do cliente da identidade atribuída.
principalId	string (uuid)	A ID da entidade de segurança da identidade atribuída.

Compartilhar via

Backup Vaults - Get In Resource Group

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

Get BackupVaults in ResourceGroup

Solicitação de exemplo

Resposta de exemplo

Definições

AlertsState

AzureMonitorAlertSettings

BackupVault

BackupVaultResource

BackupVaultResourceList

BCDRSecurityLevel

CloudError

CmkKekIdentity

CmkKeyVaultProperties

createdByType

CrossRegionRestoreSettings

CrossRegionRestoreState

CrossSubscriptionRestoreSettings

CrossSubscriptionRestoreState

DppIdentityDetails

encryptionSettings

EncryptionState

Error

ErrorAdditionalInfo

FeatureSettings

IdentityType

ImmutabilitySettings

ImmutabilityState

InfrastructureEncryptionState

MonitoringSettings

ProvisioningState

ResourceMoveDetails

ResourceMoveState

SecureScoreLevel

SecuritySettings

SoftDeleteSettings

SoftDeleteState

StorageSetting

StorageSettingStoreTypes

StorageSettingTypes

systemData

UserAssignedIdentity