Obter uma atividade de correção por IdGet one remediation activity by Id

Aplica-se a:Applies to:

Deseja experimentar o Microsoft Defender para Ponto de Extremidade?Want to experience Microsoft Defender for Endpoint? Inscreva-se para uma avaliação gratuita.Sign up for a free trial.

Importante

Algumas informações estão relacionadas a produtos pré-lançados que podem ser substancialmente modificados antes de seu lançamento comercial.Some information relates to prereleased product which may be substantially modified before it's commercially released. A Microsoft não faz garantias, expressas ou implícitas, quanto às informações fornecidas aqui.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Observação

Se você for um cliente do Governo dos EUA, use os URIs listados no Microsoft Defender for Endpoint para clientes do Governo dos EUA.If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

Dica

Para melhorar o desempenho, você pode usar o servidor mais próximo de sua localização geográfica:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

Descrição da APIAPI description

Retorna informações para a atividade de correção especificada.Returns information for the specified remediation activity. Apresenta as mesmas colunas que Obter todas as atividades de correção", mas retorna resultados apenas para a atividade de correção especificada.Presents the same columns as Get all remediation activity", but returns results only for the one specified remediation activity.

Saiba mais sobre atividades de correção.Learn more about remediation activities.

Listar uma atividade de correção especificada para (id)List a specified remediation activity for (id)

URL: GET: /api/remediationTasks/id {}URL: GET: /api/remediationTasks/{id}

PermissõesPermissions

Uma das seguintes permissões é necessária para chamar essa API.One of the following permissions is required to call this API. Para saber mais, incluindo como escolher permissões, consulte Use Microsoft Defender for Endpoint APIs para obter detalhes.To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

Tipo de permissãoPermission type PermissãoPermission Nome de exibição de permissãoPermission display name
AplicativoApplication RemediationTask.Read.AllRemediationTask.Read.All 'Ler informações de vulnerabilidade de Gerenciamento de Ameaças e Vulnerabilidades''Read Threat and Vulnerability Management vulnerability information'
Delegado (conta corporativa ou de estudante)Delegated (work or school account) RemediationTask.Read.ReadRemediationTask.Read.Read 'Ler informações de vulnerabilidade de Gerenciamento de Ameaças e Vulnerabilidades''Read Threat and Vulnerability Management vulnerability information'

PropriedadesProperties

Propriedade (id)Property (id) Tipo de dadosData type DescriçãoDescription Exemplo de um valor retornadoExample of a returned value
categorycategory Cadeia de caracteresString Categoria da atividade de correção (Configuração de software/segurança)Category of the remediation activity (Software/Security configuration) SoftwareSoftware
completerEmailcompleterEmail Cadeia de caracteresString Se a atividade de correção foi concluída manualmente por alguém, esta coluna contém seus emailsIf the remediation activity was manually completed by someone, this column contains their email nullnull
completerIdcompleterId Cadeia de caracteresString Se a atividade de correção foi concluída manualmente por alguém, esta coluna contém sua id de objetoIf the remediation activity was manually completed by someone, this column contains their object id nullnull
completionMethodcompletionMethod Cadeia de caracteresString Uma atividade de correção pode ser concluída "automaticamente" (se todos os dispositivos são remendados) ou "manualmente" por uma pessoa que seleciona "marcar como concluída"A remediation activity can be completed “automatically” (if all the devices are patched) or “manually” by a person who selects “mark as completed” AutomáticoAutomatic
createdOncreatedOn DateTimeDateTime Hora em que essa atividade de correção foi criadaTime this remediation activity was created 2021-01-12T18:54:11.5499478Z2021-01-12T18:54:11.5499478Z
descriçãodescription Cadeia de caracteresString Descrição dessa atividade de correçãoDescription of this remediation activity Atualize o Microsoft Silverlight para uma versão posterior para atenuar vulnerabilidades conhecidas que afetam seus dispositivos.Update Microsoft Silverlight  to a later version to mitigate known vulnerabilities affecting your devices.
dueOndueOn DateTimeDateTime Data de vencimento do conjunto de criadores para essa atividade de correçãoDue date the creator set for this remediation activity 2021-01-13T00:00:00Z2021-01-13T00:00:00Z
fixedDevicesfixedDevices O número de dispositivos que foram corrigidosThe number of devices that have been fixed 22
idid Cadeia de caracteresString ID dessa atividade de correçãoID of this remediation activity 097d9735-5479-4899-b1b7-77398899df92097d9735-5479-4899-b1b7-77398899df92
nameIdnameId Cadeia de caracteresString Nome do produto relacionadoRelated product name Microsoft SilverlightMicrosoft Silverlight
prioridadepriority Cadeia de caracteresString Prioridade do conjunto de criadores para essa atividade de correção (High\Medium\Low)Priority the creator set for this remediation activity (High\Medium\Low) AltoHigh
productIdproductId Cadeia de caracteresString ID do produto relacionadoRelated product ID microsoft--silverlightmicrosoft--silverlight
productivityImpactRemediationTypeproductivityImpactRemediationType Cadeia de caracteresString Algumas alterações de configuração só podem ser solicitadas para dispositivos sem impacto do usuário.A few configuration changes could be requested only for devices with no user impact. Esse valor indica a seleção entre "todos os dispositivos expostos" ou "somente dispositivos sem impacto do usuário".This value indicate the selection between “all exposed devices” or “only devices with no user impact.” AllExposedAssetsAllExposedAssets
rbacGroupNamesrbacGroupNames Cadeia de caracteresString Nomes de grupo de dispositivos relacionadosRelated device group names [ "Windows Servidores", "Windows 10" ][ "Windows Servers", "Windows 10" ]
recommendedProgramrecommendedProgram Cadeia de caracteresString Programa recomendado para atualizar paraRecommended program to upgrade to nullnull
recommendedVendorrecommendedVendor Cadeia de caracteresString Fornecedor recomendado para atualizar paraRecommended vendor to upgrade to nullnull
recommendedVersionrecommendedVersion Cadeia de caracteresString Versão recomendada para atualização/atualização paraRecommended version to update/upgrade to nullnull
relatedComponentrelatedComponent Cadeia de caracteresString Componente relacionado dessa atividade de correção (semelhante ao componente relacionado para uma recomendação de segurança)Related component of this remediation activity (similar to the related component for a security recommendation) Microsoft Microsoft SilverlightMicrosoft Microsoft Silverlight
requesterEmailrequesterEmail Cadeia de caracteresString Endereço de email do criadorCreator email address globaladmin@UserName.contoso.comglobaladmin@UserName.contoso.com
requesterIdrequesterId Cadeia de caracteresString ID do objeto CreatorCreator object id r647211f-2e16-43f2-a480-16ar3a2a796rr647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotesrequesterNotes Cadeia de caracteresString As anotações (texto livre) que o criador adicionou para essa atividade de correçãoThe notes (free text) the creator added for this remediation activity nullnull
scidscid Cadeia de caracteresString SCID da recomendação de segurança relacionadaSCID of the related security recommendation nullnull
statusstatus Cadeia de caracteresString Status da atividade de correção (Ativo/Concluído)Remediation activity status (Active/Completed) AtivoActive
statusLastModifiedOnstatusLastModifiedOn DateTimeDateTime Data em que o campo de status foi atualizadoDate when the status field was updated 2021-01-12T18:54:11.5499487Z2021-01-12T18:54:11.5499487Z
targetDevicestargetDevices LongoLong Número de dispositivos expostos a que essa correção é aplicávelNumber of exposed devices that this remediation is applicable to 4343
titletitle Cadeia de caracteresString Título dessa atividade de correçãoTitle of this remediation activity Microsoft SilverlightMicrosoft Silverlight
tipotype Cadeia de caracteresString Tipo de correçãoRemediation type AtualizarUpdate
vendorIdvendorId Cadeia de caracteresString Nome do fornecedor relacionadoRelated vendor name MicrosoftMicrosoft

ExemploExample

Exemplo de solicitaçãoRequest example

GET https://api-luna.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c

Exemplo de respostaResponse example

{ 
    "@odata.context": "https://wpatdadi-luna-stg.cloudapp.net/api/$metadata#RemediationTasks/$entity", 
    "id": "03942ef5-aecb-4c6e-b555-d6a97013844c", 
    "title": "Update Microsoft Silverlight", 
    "createdOn": "2021-02-10T13:20:36.4718166Z", 
    "requesterId": "65548a1d-efo0-4a7a-8d19-1b967b5c36f4", 
    "requesterEmail": "user1@contoso.com", 
    "status": "Active", 
    "statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z", 
    "description": "Update Silverlight to a later version to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.  ", 
    "relatedComponent": "Microsoft Silverlight", 
    "targetDevices": 18511, 
    "rbacGroupNames": [ 
        "UnassignedGroup", 
        "hhh" 
    ], 
    "fixedDevices": 2866, 
    "requesterNotes": "test", 
    "dueOn": "2021-02-11T00:00:00Z", 
    "category": "Software", 
    "productivityImpactRemediationType": null, 
    "priority": "Medium", 
    "completionMethod": null, 
    "completerId": null, 
    "completerEmail": null, 
    "scid": null, 
    "type": "Update", 
    "productId": "microsoft-_-silverlight", 
    "vendorId": "microsoft", 
    "nameId": "silverlight", 
    "recommendedVersion": null, 
    "recommendedVendor": null, 
    "recommendedProgram": null 
} 

Confira tambémSee also