Compartilhar via


Assignments - List

Obter uma lista de todos os standardAssignments relevantes disponíveis para escopo

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/assignments?api-version=2021-08-01-preview

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos na assinatura do usuário. O nome diferencia maiúsculas de minúsculas.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

ID de assinatura do Azure

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

Versão da API para a operação

Respostas

Nome Tipo Description
200 OK

AssignmentList

OK

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

List security standardAssignments by subscriptionId and resourceGroup scope

Sample Request

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.Security/assignments?api-version=2021-08-01-preview

Sample Response

{
  "value": [
    {
      "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.Security/assignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/assignments",
      "location": "East US",
      "etag": "etag value",
      "properties": {
        "displayName": "ASC Default",
        "description": "Set of policies monitored by Azure Security Center for cross cloud",
        "assignedStandard": {
          "id": "/providers/Microsoft.Security/Standards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
        },
        "effect": "Exempt",
        "expiresOn": "2022-05-01T19:50:47.083633Z",
        "additionalData": {
          "exemptionCategory": "waiver"
        },
        "metadata": {
          "ticketId": 12345
        },
        "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/ResourceGroup/rg"
      },
      "systemData": {
        "createdBy": "user@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-08-31T13:47:50.328Z",
        "lastModifiedBy": "user@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-08-31T13:47:50.328Z"
      }
    },
    {
      "id": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myResourceGroup/providers/Microsoft.Security/assignments/1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "name": "1f3afdf9-d0c9-4c3d-847f-89da613e70a8",
      "type": "Microsoft.Security/assignment",
      "location": "East US",
      "etag": "etag value",
      "properties": {
        "displayName": "ASC Default",
        "description": "Set of policies monitored by Azure Security Center for cross cloud",
        "assignedStandard": {
          "id": "/providers/Microsoft.Security/Standards/1f3afdf9-d0c9-4c3d-847f-89da613e70a8"
        },
        "effect": "Exempt",
        "expiresOn": "2022-05-01T19:50:47.083633Z",
        "additionalData": {
          "exemptionCategory": "waiver"
        },
        "metadata": {
          "ticketId": 12345
        },
        "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/ResourceGroup/rg"
      },
      "systemData": {
        "createdBy": "user@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-08-31T13:47:50.328Z",
        "lastModifiedBy": "user@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-08-31T13:47:50.328Z"
      }
    }
  ]
}

Definições

Nome Description
AdditionalData

Dados adicionais sobre a atribuição

AssignedComponentItem

descrever as propriedades de uma referência de objeto de avaliação de segurança (por chave)

AssignedStandardItem

descrever as propriedades de uma referência de objeto padrão de segurança

Assignment

Atribuição de segurança em um grupo de recursos em um determinado escopo

AssignmentList

Página de uma lista de atribuições padrão

CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.).

CloudErrorBody

O detalhe do erro.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

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

systemData

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

AdditionalData

Dados adicionais sobre a atribuição

Nome Tipo Description
exemptionCategory

string

Categoria de isenção desta atribuição

AssignedComponentItem

descrever as propriedades de uma referência de objeto de avaliação de segurança (por chave)

Nome Tipo Description
key

string

chave exclusiva para um objeto de avaliação de segurança

AssignedStandardItem

descrever as propriedades de uma referência de objeto padrão de segurança

Nome Tipo Description
id

string

full resourceId do objeto Microsoft.Security/standard

Assignment

Atribuição de segurança em um grupo de recursos em um determinado escopo

Nome Tipo Description
etag

string

A marca de entidade é usada para comparar duas ou mais entidades do mesmo recurso solicitado.

id

string

ID do recurso

kind

string

Tipo de recurso

location

string

Local em que o recurso é armazenado

name

string

Nome do recurso

properties.additionalData

AdditionalData

Dados adicionais sobre a atribuição

properties.assignedComponent

AssignedComponentItem

Item de componente com chave conforme aplicado a essa atribuição padrão no escopo especificado

properties.assignedStandard

AssignedStandardItem

Item padrão com chave conforme aplicado a essa atribuição padrão no escopo especificado

properties.description

string

descrição do standardAssignment

properties.displayName

string

nome de exibição do standardAssignment

properties.effect

string

efeito esperado dessa atribuição (Desabilitar/Isentar/etc)

properties.expiresOn

string

Data de validade dessa atribuição como uma data de ISO completa

properties.metadata

object

Os metadados de atribuição. Metadados é um objeto aberto encerrado e normalmente é uma coleção de pares de valores de chave.

properties.scope

string

Escopo ao qual o standardAssignment se aplica – pode ser um caminho de assinatura ou um grupo de recursos nessa assinatura

systemData

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

tags

object

Uma lista de pares de chave e valor que descrevem o recurso.

type

string

Tipo de recurso

AssignmentList

Página de uma lista de atribuições padrão

Nome Tipo Description
nextLink

string

O URI a ser buscado na próxima página

value

Assignment[]

Coleção de standardAssignments nesta página

CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro de operações com falha. (Isso também segue o formato de resposta de erro OData.).

Nome Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

error.code

string

O código de erro.

error.details

CloudErrorBody[]

Os detalhes do erro.

error.message

string

A mensagem de erro.

error.target

string

O destino do erro.

CloudErrorBody

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

CloudErrorBody[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

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.

systemData

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

Nome Tipo Description
createdAt

string

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

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.