Protection Containers - Inquire

Служба:: Recovery Services - Backup

Версия API:: 2026-08-01

Это асинхронная операция, и результаты следует отслеживать с помощью заголовка локации или Azure-async-url.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/inquire?api-version=2026-08-01

С использованием необязательных параметров:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/inquire?api-version=2026-08-01&$filter={$filter}

Параметры URI

Имя.	В	Обязательно	Тип	Описание
containerName	path	True	string	Имя контейнера, данные которого необходимо получить.
fabricName	path	True	string	Имя ресурса BackupFabricResource
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя нечувствительно к регистру.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
vaultName	path	True	string	Имя ресурса VaultResource
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
$filter	query		string	Параметры фильтра OData.

Ответы

Имя.	Тип	Описание
202 Accepted		Заявка принята в обработку, но обработка еще не завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя.	Описание
user_impersonation	выдать себя за учетную запись пользователя

Примеры

Inquire Azure Storage Protection Containers

Образец запроса

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.RecoveryServices/vaults/testvault/backupFabrics/Azure/protectionContainers/storagecontainer;Storage;test-rg;teststorage/inquire?api-version=2026-08-01


/**
 * Samples for ProtectionContainers Inquire.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-08-01/AzureStorage/ProtectionContainers_Inquire.json
     */
    /**
     * Sample code: Inquire Azure Storage Protection Containers.
     * 
     * @param manager Entry point to RecoveryServicesBackupManager.
     */
    public static void inquireAzureStorageProtectionContainers(
        com.azure.resourcemanager.recoveryservicesbackup.RecoveryServicesBackupManager manager) {
        manager.protectionContainers().inquireWithResponse("testvault", "test-rg", "Azure",
            "storagecontainer;Storage;test-rg;teststorage", null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservicesbackup import RecoveryServicesBackupClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-recoveryservicesbackup
# USAGE
    python protection_containers_inquire.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = RecoveryServicesBackupClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    client.protection_containers.inquire(
        vault_name="testvault",
        resource_group_name="test-rg",
        fabric_name="Azure",
        container_name="storagecontainer;Storage;test-rg;teststorage",
    )


# x-ms-original-file: 2026-08-01/AzureStorage/ProtectionContainers_Inquire.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armrecoveryservicesbackup_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/recoveryservices/armrecoveryservicesbackup/v5"
)

// Generated from example definition: 2026-08-01/AzureStorage/ProtectionContainers_Inquire.json
func ExampleProtectionContainersClient_Inquire() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicesbackup.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	_, err = clientFactory.NewProtectionContainersClient().Inquire(ctx, "testvault", "test-rg", "Azure", "storagecontainer;Storage;test-rg;teststorage", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { RecoveryServicesBackupClient } = require("@azure/arm-recoveryservicesbackup");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to this is an async operation and the results should be tracked using location header or Azure-async-url.
 *
 * @summary this is an async operation and the results should be tracked using location header or Azure-async-url.
 * x-ms-original-file: 2026-08-01/AzureStorage/ProtectionContainers_Inquire.json
 */
async function inquireAzureStorageProtectionContainers() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new RecoveryServicesBackupClient(credential, subscriptionId);
  await client.protectionContainers.inquire(
    "testvault",
    "test-rg",
    "Azure",
    "storagecontainer;Storage;test-rg;teststorage",
  );
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:: 202

Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.RecoveryServices/vaults/testvault/backupFabrics/Azure/protectionContainers/storagecontainer;Storage;test-rg;teststorage/operationsStatus/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.RecoveryServices/vaults/testvault/backupFabrics/Azure/protectionContainers/storagecontainer;Storage;test-rg;teststorage/operationResults/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Retry-After: 60

Определения

Имя.	Описание
ErrorDetail	Класс Сведений об ошибках, который инкапсулирует код, сообщение и рекомендации.
ErrorResponse	Ответ на ошибку

ErrorDetail

Объект

Класс Сведений об ошибках, который инкапсулирует код, сообщение и рекомендации.

Имя.	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, связанное с кодом.
recommendations	string[]	Список строк рекомендаций.

ErrorResponse

Объект

Ответ на ошибку

Имя.	Тип	Описание
error	ErrorDetail	Объект ошибки.