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 os 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 alcançar 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.
• Personalize 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 através do estabelecimento de um contrato entre o Azure e um endpoint. Este contrato define uma lista de novos recursos e ações através 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 personalizado, pontos de extremidade e recursos personalizados.

Como criar provedores de recursos personalizados

Os provedores de recursos customizados representam uma lista de contratos entre o Azure e pontos de extremidade. Esses contratos descrevem como o Azure deve interagir com os seus endpoints. Os provedores de recursos agem como um proxy e encaminham solicitações e respostas de e para seu ponto de extremidade especificado. Um provedor de recursos pode especificar dois tipos de contratos: resourceTypes e actions. Eles são habilitados por meio de definições de endpoint. Uma definição de ponto de extremidade é composta por três campos: name, routingType e endpoint.

Ponto de extremidade de exemplo:

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

Criação de recursos personalizados

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

Provedor de recursos personalizado de exemplo com resourceTypes:

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

APIs adicionadas ao Azure para o exemplo acima:

Criação de ações personalizadas

As ações descrevem novas ações que são adicionadas ao Azure. Eles podem ser expostos sobre o provedor de recursos ou aninhados em um resourceType. Veja mais sobre como criar ações personalizadas

Provedor de recursos personalizado de exemplo com ações:

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

APIs adicionadas ao Azure para o exemplo acima:

À procura de ajuda

Se tiveres dúvidas sobre o desenvolvimento do Provedor de Recursos Personalizados do Azure, tenta perguntar no Stack Overflow. Uma pergunta semelhante pode já ter sido feita e respondida, portanto, verifique primeiro antes de postar. Adicione a tag azure-custom-providers para obter uma resposta rápida!

Próximos passos

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

• Guia de início rápido: criar o Provedor de Recursos Personalizados 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