Updates - List Parent

Serviço:: Maintenance

Versão da API:: 2023-09-01-preview

Obtenha atualizações dos recursos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
providerName	path	True	string	Nome do provedor de recursos
resourceGroupName	path	True	string	Nome do grupo de recursos
resourceName	path	True	string	Identificador de recurso
resourceParentName	path	True	string	Identificador pai do recurso
resourceParentType	path	True	string	Tipo pai de recurso
resourceType	path	True	string	Tipo de recurso
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version	query	True	string	Versão da API a ser usada com a solicitação do cliente.

Respostas

Name	Tipo	Description
200 OK	ListUpdatesResult	OK
Other Status Codes	MaintenanceError	Pedido Inválido

Exemplos

Updates_ListParent

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

Resposta da amostra

Código de estado:: 200

{
  "value": [
    {
      "maintenanceScope": "Resource",
      "status": "Pending",
      "impactType": "Reboot",
      "impactDurationInSec": 1440,
      "notBefore": "2018-10-09T06:17:44.235Z",
      "properties": {
        "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1"
      }
    }
  ]
}

Definições

Name	Description
ErrorDetails	Um detalhe de resposta de erro recebido do serviço de Manutenção do Azure.
ImpactType	O tipo de impacto
ListUpdatesResult	Lista de respostas para atualizações
MaintenanceError	Uma resposta de erro recebida do serviço de Manutenção do Azure.
MaintenanceScope	Obtém ou define manutençãoEscopo da configuração
Update	Atualização de manutenção em um recurso
UpdateStatus	O estatuto

ErrorDetails

Object

Um detalhe de resposta de erro recebido do serviço de Manutenção do Azure.

Name	Tipo	Description
code	string	Código de erro definido pelo serviço. Esse código serve como um substatus para o código de erro HTTP especificado na resposta.
message	string	Representação legível por humanos do erro.

ImpactType

Enumeração

O tipo de impacto

Valor	Description
None	As atualizações pendentes não têm impacto nos recursos.
Freeze	As atualizações pendentes podem congelar a operação de rede ou de disco no recurso.
Restart	As atualizações pendentes podem fazer com que o recurso seja reiniciado.
Redeploy	As atualizações pendentes podem reimplantar o recurso.

ListUpdatesResult

Object

Lista de respostas para atualizações

Name	Tipo	Description
value	Update[]	As atualizações pendentes

MaintenanceError

Object

Uma resposta de erro recebida do serviço de Manutenção do Azure.

Name	Tipo	Description
error	ErrorDetails	Detalhes do erro

MaintenanceScope

Enumeração

Obtém ou define manutençãoEscopo da configuração

Valor	Description
Host	Esse escopo de manutenção controla a instalação de atualizações da plataforma azure, ou seja, serviços em nós físicos que hospedam VMs de clientes.
Resource	Este escopo de manutenção controla a manutenção de atualização padrão do Recurso do Azure
OSImage	Este escopo de manutenção controla a instalação da imagem no VM/VMSS
Extension	Este escopo de manutenção controla a instalação de extensão em VM/VMSS
InGuestPatch	Este escopo de manutenção controla a instalação de pacotes windows e linux em VM/VMSS
SQLDB	Esse escopo de manutenção controla a instalação de atualizações da plataforma do SQL Server.
SQLManagedInstance	Esse escopo de manutenção controla a instalação da atualização da plataforma de instância gerenciada SQL.

Update

Object

Atualização de manutenção em um recurso

Name	Tipo	Description
impactDurationInSec	integer (int32)	Duração do impacto em segundos
impactType	ImpactType	O tipo de impacto
maintenanceScope	MaintenanceScope	A área de impacto
notBefore	string (date-time)	Hora em que o Azure iniciará atualizações forçadas se não for autoatualizado pelo cliente antes desse período
properties.resourceId	string	O resourceId
status	UpdateStatus	O estatuto

UpdateStatus

Enumeração

O estatuto

Valor	Description
Pending	Há atualizações pendentes a serem instaladas.
InProgress	A instalação das atualizações está em andamento.
Completed	Todas as atualizações são aplicadas com êxito.
RetryNow	A instalação das atualizações falhou, mas está pronta para tentar novamente.
RetryLater	A instalação das atualizações falhou e deve ser repetida mais tarde.
NoUpdatesPending	Nenhuma atualização está pendente.
Cancel	Cancele o agendamento e pare de criar PMR para parte de recursos dele. Aplicável apenas ao tipo de recurso Configuração de Manutenção.
Cancelled	Envie a resposta Cancelada para o usuário se vier a solicitação para cancelar o agendamento. Aplicável apenas ao tipo de recurso Configuração de Manutenção.