Visão geral dos Provedores de Recursos Personalizados do Azure

Os Provedores de Recursos Personalizados do Azure são uma plataforma de extensibilidade para o Azure. Ele permite que você defina APIs personalizadas que podem ser usadas para enriquecer a experiência padrão do Azure. Esta documentação descreve:

• Como criar e implantar um Provedor de Recursos Personalizados do Azure.
• Como utilizar provedores de recursos personalizados do Azure para estender fluxos de trabalho existentes.
• Onde encontrar guias e exemplos de código para começar.

O que os provedores de recursos personalizados podem fazer

Aqui estão alguns exemplos do que você pode obter com os Provedores de Recursos Personalizados do Azure:

• Estenda a API REST do Azure Resource Manager para incluir serviços internos e externos.
• Habilite cenários personalizados sobre fluxos de trabalho existentes do Azure.
• Personalizar o controle e o efeito dos Modelos do Azure Resource Manager.

O que é um provedor de recursos personalizado

Os Provedores de Recursos Personalizados do Azure são criados por meio de um contrato entre o Azure e um endpoint. Esse contrato define uma lista de novos recursos e ações por meio de um novo recurso, Microsoft.CustomProviders/resourceProviders. O provedor de recursos personalizado exporá essas novas APIs no Azure. Os Provedores de Recursos Personalizados do Azure são compostos por três partes: provedor de recursos personalizados, pontos de extremidade e recursos personalizados.

Como criar provedores de recursos personalizados

Os provedores de recursos personalizados são uma lista de contratos entre o Azure e os endpoints. Esses contratos descrevem como o Azure deve interagir com seus pontos de extremidade. Os provedores de recursos atuam como um proxy e encaminharão solicitações e respostas para e a partir do endpoint especificado. Um provedor de recursos pode especificar dois tipos de contratos: resourceTypes e ações. Elas são habilitadas por meio de definições de endpoint. Uma definição de ponto de extremidade é composta por três campos: nome, routingType e ponto de extremidade.

Endpoint de exemplo:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}

Criando recursos personalizados

Os ResourceTypes descrevem novos recursos personalizados que são adicionados ao Azure. Eles expõem métodos CRUD RESTful básicos. Veja mais sobre como criar recursos personalizados

Exemplo de Provedor de Recursos Personalizado com resourceTypes:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

APIs adicionadas ao Azure para o exemplo acima:

Criando ações personalizadas

As ações descrevem novas ações adicionadas ao Azure. Elas podem ser expostas acima do fornecedor de recursos ou aninhadas sob um resourceType. Veja mais sobre como criar ações personalizadas

Exemplo de Provedor de Recursos Personalizados com ações:

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

APIs adicionadas ao Azure para o exemplo acima:

Procurando ajuda

Se você tiver dúvidas sobre o desenvolvimento do Provedor de Recursos Personalizados do Azure, tente perguntar sobre o Stack Overflow. Uma pergunta semelhante pode já ter sido feita e respondida, portanto, verifique primeiro antes da postagem. Adicione a marca azure-custom-providers para obter uma resposta rápida!

Próximas etapas

Neste artigo, você aprendeu sobre provedores de recursos personalizados. Vá para o próximo artigo para criar um provedor de recursos personalizado.

• Início rápido: criar um Provedor de Recursos Personalizado do Azure e implantar recursos personalizados
• Tutorial: Criar ações e recursos personalizados no Azure
• Como adicionar ações personalizadas à API REST do Azure
• Como adicionar recursos personalizados à API REST do Azure