Standard Assignments - List

Ссылка

Служба:: Defender for Cloud

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

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

GET https://management.azure.com/{scope}/providers/Microsoft.Security/standardAssignments?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	StandardAssignmentsList	Стандартный список назначений по области
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции

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

azure_auth

Поток OAuth2 Azure Active Directory

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

Области

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

Примеры

List standard assignments

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


/**
 * Samples for StandardAssignments List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-08-01/examples/StandardAssignments/
     * ListStandardAssignments.json
     */
    /**
     * Sample code: List standard assignments.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listStandardAssignments(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.standardAssignments().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/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/standardAssignments",
      "properties": {
        "displayName": "ASC Default",
        "description": "Set of policies monitored by Azure Security Center for cross cloud",
        "assignedStandard": {
          "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
        },
        "effect": "Audit",
        "excludedScopes": [],
        "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/standardAssignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a9",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/standardAssignments",
      "properties": {
        "displayName": "Test exemption",
        "description": "Exemption description",
        "assignedStandard": {
          "id": "/providers/Microsoft.Security/securityStandards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
        },
        "effect": "Exempt",
        "expiresOn": "2022-05-01T19:50:47.083633Z",
        "exemptionData": {
          "exemptionCategory": "waiver",
          "assignedAssessment": {
            "assessmentKey": "1195afff-c881-495e-9bc5-1486211ae03f"
          }
        },
        "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"
        }
      }
    }
  ]
}

Определения

Имя	Описание
AssignedAssessmentItem	Описание свойств ссылки на объект оценки безопасности (по ключу)
AssignedStandardItem	Описание свойств ссылки на объект "Стандартные назначения"
attestationComplianceState	Аттестация категории этого назначения
AttestationData	Дополнительные данные о назначении с эффектом аттестации
AttestationEvidence	Описание свойств аттестации назначения
effect	Ожидаемый эффект этого назначения (аудит/исключение или аттестация)
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
exemptionCategory	Категория исключения этого назначения
ExemptionData	Дополнительные данные о назначении, которое имеет эффект исключения
StandardAssignment	Назначение безопасности для группы ресурсов по заданной области
StandardAssignmentMetadata	Стандартные метаданные назначения
StandardAssignmentsList	Страница стандартного списка назначений

AssignedAssessmentItem

Описание свойств ссылки на объект оценки безопасности (по ключу)

Имя	Тип	Описание
assessmentKey	string	Уникальный ключ для объекта оценки безопасности

AssignedStandardItem

Описание свойств ссылки на объект "Стандартные назначения"

Имя	Тип	Описание
id	string	Полный идентификатор ресурса объекта Microsoft.Security/standard

attestationComplianceState

Аттестация категории этого назначения

Имя	Тип	Описание
compliant	string
nonCompliant	string
unknown	string

AttestationData

Дополнительные данные о назначении с эффектом аттестации

Имя	Тип	Описание
assignedAssessment	AssignedAssessmentItem	Элемент компонента с ключом, примененным к этому стандартному назначению по заданной области
complianceDate	string	Дата соответствия аттестации
complianceState	attestationComplianceState	Аттестация категории этого назначения
evidence	AttestationEvidence[]	Массив ссылок на доказательства аттестации

AttestationEvidence

Описание свойств аттестации назначения

Имя	Тип	Описание
description	string	Описание доказательств
sourceUrl	string	Исходный URL-адрес доказательства

effect

Ожидаемый эффект этого назначения (аудит/исключение или аттестация)

Имя	Тип	Описание
Attest	string
Audit	string
Exempt	string

ErrorAdditionalInfo

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

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

ErrorDetail

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

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

ErrorResponse

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

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

exemptionCategory

Категория исключения этого назначения

Имя	Тип	Описание
mitigated	string
waiver	string

ExemptionData

Дополнительные данные о назначении, которое имеет эффект исключения

Имя	Тип	Описание
assignedAssessment	AssignedAssessmentItem	Элемент компонента с ключом, примененным к этому стандартному назначению по заданной области
exemptionCategory	exemptionCategory	Категория исключения этого назначения