Security Standards - Get

Служба:

Defender for Cloud

Версия API:

2024-08-01

Получение определенного стандарта безопасности для запрошенной области по standardId

GET https://management.azure.com/{scope}/providers/Microsoft.Security/securityStandards/{standardId}?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})"
standardId	path	True	string	Ключ уровня "Стандартный" — уникальный ключ для стандартного типа Шаблон регулярного выражения: [{]?[0-9a-fA-F]{8}-(?:[0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$
api-version	query	True	string	Версия API, используемая для этой операции.

Ответы

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

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

azure_auth

Поток OAuth2 Azure Active Directory

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

Области

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

Примеры

Get a security standard over management group scope

Get a security standard over security connector scope

Get a security standard over subscription scope

Get a security standard over management group scope

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

HTTP

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/contoso/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * GetByManagementGroupSecurityStandard_example.json
     */
    /**
     * Sample code: Get a security standard over management group scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        getASecurityStandardOverManagementGroupScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().getWithResponse("providers/Microsoft.Management/managementGroups/contoso",
            "1f3afdf9-d0c9-4c3d-847f-89da613e70a8", 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

{
  "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"
    }
  }
}

Get a security standard over 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/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * GetBySecurityConnectorSecurityStandard_example.json
     */
    /**
     * Sample code: Get a security standard over security connector scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        getASecurityStandardOverSecurityConnectorScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().getWithResponse(
            "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector",
            "1f3afdf9-d0c9-4c3d-847f-89da613e70a8", 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

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/gcpResourceGroup/providers/Microsoft.Security/securityConnectors/gcpconnector/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"
    }
  }
}

Get a security standard over subscription scope

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

HTTP

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8?api-version=2024-08-01

Java

/**
 * Samples for SecurityStandards Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/SecurityStandards/
     * GetBySubscriptionSecurityStandard_example.json
     */
    /**
     * Sample code: Get a security standard over subscription scope.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        getASecurityStandardOverSubscriptionScope(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.securityStandards().getWithResponse("subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23",
            "1f3afdf9-d0c9-4c3d-847f-89da613e70a8", 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

{
  "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"
    }
  }
}

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
PartialAssessmentProperties	Описание свойств оценки, связанных со стандартом
SecurityStandard	Безопасность уровня "Стандартный" для ресурса
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	Тип ресурса

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