Deployments - Delete

Serviço:: Resource Management

Versão da API:: 2025-04-01

Exclui uma implantação do histórico de implantação.
Uma implantação de modelo que está em execução no momento não pode ser excluída. A exclusão de uma implantação de modelo remove as operações de implantação associadas. A exclusão de uma implantação de modelo não afeta o estado do grupo de recursos. Esta é uma operação assíncrona que retorna um status de 202 até que a implantação do modelo seja excluída com êxito. O cabeçalho de resposta Location contém o URI usado para obter o status do processo. Enquanto o processo está em execução, uma chamada para o URI no cabeçalho Location retorna um status de 202. Quando o processo termina, o URI no cabeçalho Location retorna um status de 204 no êxito. Se a solicitação assíncrona falhar, o URI no cabeçalho Location retornará um código de status de nível de erro.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2025-04-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
deploymentName	path	True	string minLength: 1 maxLength: 64 pattern: ^[-\w\._]+$	O nome da implantação.
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
202 Accepted		Exclusão de recurso aceita. Cabeçalhos Location: string Retry-After: integer
204 No Content		O recurso não existe.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Name

Tipo

Description

202 Accepted

Exclusão de recurso aceita.

Cabeçalhos

Location: string
Retry-After: integer

204 No Content

O recurso não existe.

Other Status Codes

CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Definições

Name	Description
CloudError	Uma resposta de erro para uma solicitação de gerenciamento de recursos.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorResponse	Resposta de erro comum para todas as APIs do Azure Resource Manager devolver detalhes de erro para operações falhadas. (Isso também segue o formato de resposta de erro OData.)

CloudError

Object

Uma resposta de erro para uma solicitação de gerenciamento de recursos.

Name	Tipo	Description
error	ErrorResponse	Resposta de erro comum para todas as APIs do Azure Resource Manager devolver detalhes de erro para operações falhadas. (Isso também segue o formato de resposta de erro OData.)

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorResponse

Object

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

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorResponse[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.