Security Standards - List

Служба:

Defender for Cloud

Версия API:

2024-08-01

Получение списка всех соответствующих стандартов безопасности по области

GET https://management.azure.com/{scope}/providers/Microsoft.Security/securityStandards?api-version=2024-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
scope	path	True	string	Область действия стандарта безопасности. Допустимые области: группа управления (формат :providers/Microsoft.Management/managementGroups/{managementGroup}), подписка (формат :subscriptions/{subscriptionId}) или соединитель безопасности (формат "subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName})"
api-version	query	True	string	Версия API, используемая для этой операции.

Ответы

Имя	Тип	Описание
200 OK	SecurityStandardList	Список стандартов безопасности по области
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции

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

azure_auth

Поток OAuth2 Azure Active Directory

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

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

List security standards by management group scope

List security standards by security connector scope

List security standards by subscription scope

List security standards by management group scope

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

HTTP

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * ListByManagementGroupSecurityStandards_example.json
     */
    /**
     * Sample code: List security standards by management group scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        listSecurityStandardsByManagementGroupScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().list("providers/Microsoft.Management/managementGroups/contoso",
            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

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

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

200

{
  "value": [
    {
      "id": "providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 1",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    },
    {
      "id": "providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/155afdf9-d239-4a5c-847f-89da613e7143",
      "name": "155afdf9-d239-4a5c-847f-89da613e7143",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 2",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    }
  ]
}

List security standards by security connector scope

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

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/securityStandards?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * ListBySecurityConnectorSecurityStandards_example.json
     */
    /**
     * Sample code: List security standards by security connector scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        listSecurityStandardsBySecurityConnectorScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().list(
            "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector",
            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

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

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

200

{
  "value": [
    {
      "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 1",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    },
    {
      "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/providers/Microsoft.Security/securityStandards/155afdf9-d239-4a5c-847f-89da613e7143",
      "name": "155afdf9-d239-4a5c-847f-89da613e7143",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 2",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    }
  ]
}

List security standards by subscription scope

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

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * ListBySubscriptionSecurityStandards_example.json
     */
    /**
     * Sample code: List security standards by subscription scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        listSecurityStandardsBySubscriptionScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().list("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23",
            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

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

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

200

{
  "value": [
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 1",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    },
    {
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/155afdf9-d239-4a5c-847f-89da613e7143",
      "name": "155afdf9-d239-4a5c-847f-89da613e7143",
      "type": "Microsoft.Security/securityStandards",
      "properties": {
        "displayName": "Cross cloud standard 2",
        "standardType": "Custom",
        "description": "Controls and security data implementing security recommendations defined in Azure Security",
        "assessments": [
          {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          },
          {
            "assessmentKey": "dbd0cb49-b563-45e7-9724-889e799fa648"
          }
        ],
        "cloudProviders": [
          "GCP"
        ],
        "policySetDefinitionId": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Authorization/policySetDefinitions/patchorchestration-applicationversions",
        "metadata": {
          "createdBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "createdOn": "2022-11-10T08:31:26.7993124Z",
          "lastUpdatedBy": "c23b5354-ff0a-4b2a-9f92-6f144effd936",
          "lastUpdatedOn": "2022-11-10T08:31:26.7993124Z"
        }
      }
    }
  ]
}

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
PartialAssessmentProperties	Описание свойств оценки, связанных со стандартом
SecurityStandard	Безопасность уровня "Стандартный" для ресурса
SecurityStandardList	Страница стандартного списка
StandardMetadata	Стандартные метаданные
StandardSupportedCloud	Облако, в которое поддерживается стандарт.
standardType	Стандартный тип (пользовательская или стандартная версия или соответствие только в настоящее время)

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

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

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

PartialAssessmentProperties

Описание свойств оценки, связанных со стандартом

Имя	Тип	Описание
assessmentKey	string	Ключ оценки

SecurityStandard

Безопасность уровня "Стандартный" для ресурса

Имя	Тип	Описание
id	string	Идентификатор ресурса
name	string	Имя ресурса
properties.assessments	PartialAssessmentProperties[]	Список ключей оценки, применяемых к стандартной области.
properties.cloudProviders	StandardSupportedCloud[]	Список всех стандартных поддерживаемых облаков.
properties.description	string	Описание стандарта
properties.displayName	string	Отображаемое имя стандарта, эквивалентно стандартному идентификатору
properties.metadata	StandardMetadata	Стандартные метаданные безопасности.
properties.policySetDefinitionId	string	Идентификатор определения набора политик, связанный со стандартом.
properties.standardType	standardType	Стандартный тип (пользовательская или стандартная версия или соответствие только в настоящее время)
type	string	Тип ресурса

SecurityStandardList

Страница стандартного списка

Имя	Тип	Описание
nextLink	string	Универсальный код ресурса (URI) для получения следующей страницы
value	SecurityStandard[]	Коллекция стандартов на этой странице

StandardMetadata

Стандартные метаданные

Имя	Тип	Описание
createdBy	string	Standard Created by object id (GUID)
createdOn	string	Дата создания категории "Стандартный"
lastUpdatedBy	string	Стандарт последнее обновление по идентификатору объекта (GUID)
lastUpdatedOn	string	Стандартная дата последнего обновления

StandardSupportedCloud

Облако, в которое поддерживается стандарт.

Имя	Тип	Описание
AWS	string
Azure	string
GCP	string

standardType

Стандартный тип (пользовательская или стандартная версия или соответствие только в настоящее время)

Имя	Тип	Описание
Compliance	string
Custom	string
Default	string