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. Excluir uma implantação de modelo remove as operações de implantação associadas. Excluir uma implantação de modelo não afeta o estado do grupo de recursos. Essa é 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 Local 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 Local retorna um status de 202. Quando o processo é concluído, o URI no cabeçalho Local retorna um status de 204 com êxito. Se a solicitação assíncrona falhar, o URI no cabeçalho Local retornará um código de status no 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 de URI

Nome	Em	Obrigatório	Tipo	Description
deploymentName	path	True	string minLength: 1 maxLength: 64 pattern: ^[-\w\._]+$	O nome da implementaçã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 ser usada para esta operação.

Respostas

Nome	Tipo	Description
202 Accepted		Exclusão de recursos 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.

Nome

Tipo

Description

202 Accepted

Exclusão de recursos 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
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Definições

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

CloudError

Objeto

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

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

ErrorAdditionalInfo

Objeto

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.

ErrorResponse

Objeto

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

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
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.