Compartilhar via

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

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

O nome do grupo de recursos com a implantação a ser excluída. O nome não diferencia maiúsculas de minúsculas.
subscriptionId
 path True

string

A ID da assinatura do Microsoft Azure.
api-version
 query True

string

A versão da API a ser usada para esta operação.

Respostas

Nome Tipo Description
202 Accepted

Aceito – retorna esse status até que a operação assíncrona seja concluída.
204 No Content

Sem conteúdo
Other Status Codes

CloudError

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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 de erro

CloudError

Objeto

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

Nome Tipo Description
error

ErrorResponse

Resposta de erro
Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (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 de erro

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.