Dapr Subscriptions - Create Or Update

Referência

Serviço:: Azure Container Apps

Versão da API:: 2025-02-02-preview

Cria ou atualiza uma assinatura daPr em um Ambiente Gerenciado.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/managedEnvironments/{environmentName}/daprSubscriptions/{name}?api-version=2025-02-02-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
environmentName	path	True	string pattern: ^[-\w\._]+$	Nome do Ambiente Gerenciado.
name	path	True	string	Nome da assinatura do Dapr.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
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.

Corpo da solicitação

Nome	Tipo	Description
properties.bulkSubscribe	DaprSubscriptionBulkSubscribeOptions	Opções de assinatura em massa
properties.deadLetterTopic	string	Nome do tópico deadletter
properties.metadata	object	Metadados de assinatura
properties.pubsubName	string	Nome do componente Dapr PubSub
properties.routes	DaprSubscriptionRoutes	Rotas de assinatura
properties.scopes	string[]	Escopos de aplicativo para restringir a assinatura a aplicativos específicos.
properties.topic	string	Nome do tópico

Respostas

Nome	Tipo	Description
200 OK	DaprSubscription	OKEY
201 Created	DaprSubscription	Criado
Other Status Codes	DefaultErrorResponse	Resposta de erro comum.

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

Exemplos

Create or update dapr subscription with bulk subscribe configuration and scopes

Create or update dapr subscription with default route only

Create or update dapr subscription with route rules and metadata

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription?api-version=2025-02-02-preview

{
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "default": "/products"
    },
    "scopes": [
      "warehouseapp",
      "customersupportapp"
    ],
    "bulkSubscribe": {
      "enabled": true,
      "maxMessagesCount": 123,
      "maxAwaitDurationMs": 500
    }
  }
}

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription",
  "name": "mysubscription",
  "type": "Microsoft.App/managedEnvironments/daprSubscriptions",
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "rules": [],
      "default": "/products"
    },
    "scopes": [
      "warehouseapp",
      "customersupportapp"
    ],
    "bulkSubscribe": {
      "enabled": true,
      "maxMessagesCount": 123,
      "maxAwaitDurationMs": 500
    }
  }
}

Código de status:: 201

{
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription",
  "name": "mysubscription",
  "type": "Microsoft.App/managedEnvironments/daprSubscriptions",
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "rules": [],
      "default": "/products"
    },
    "scopes": [
      "warehouseapp",
      "customersupportapp"
    ],
    "bulkSubscribe": {
      "enabled": true,
      "maxMessagesCount": 123,
      "maxAwaitDurationMs": 500
    }
  }
}

Create or update dapr subscription with default route only

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription?api-version=2025-02-02-preview

{
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "default": "/products"
    }
  }
}

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription",
  "name": "mysubscription",
  "type": "Microsoft.App/managedEnvironments/daprSubscriptions",
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "rules": [],
      "default": "/products"
    }
  }
}

Código de status:: 201

{
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription",
  "name": "mysubscription",
  "type": "Microsoft.App/managedEnvironments/daprSubscriptions",
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "rules": [],
      "default": "/products"
    }
  }
}

Create or update dapr subscription with route rules and metadata

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription?api-version=2025-02-02-preview

{
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "metadata": {
      "foo": "bar",
      "hello": "world"
    },
    "routes": {
      "rules": [
        {
          "match": "event.type == 'widget'",
          "path": "/widgets"
        },
        {
          "match": "event.type == 'gadget'",
          "path": "/gadgets"
        }
      ],
      "default": "/products"
    }
  }
}

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription",
  "name": "mysubscription",
  "type": "Microsoft.App/managedEnvironments/daprSubscriptions",
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "rules": [
        {
          "match": "event.type == 'widget'",
          "path": "/widgets"
        },
        {
          "match": "event.type == 'gadget'",
          "path": "/gadgets"
        }
      ],
      "default": "/products"
    },
    "metadata": {
      "foo": "bar",
      "hello": "world"
    }
  }
}

Código de status:: 201

{
  "id": "/subscriptions/8efdecc5-919e-44eb-b179-915dca89ebf9/resourceGroups/examplerg/providers/Microsoft.App/managedEnvironments/myenvironment/daprSubscriptions/mysubscription",
  "name": "mysubscription",
  "type": "Microsoft.App/managedEnvironments/daprSubscriptions",
  "properties": {
    "pubsubName": "mypubsubcomponent",
    "topic": "inventory",
    "routes": {
      "rules": [
        {
          "match": "event.type == 'widget'",
          "path": "/widgets"
        },
        {
          "match": "event.type == 'gadget'",
          "path": "/gadgets"
        }
      ],
      "default": "/products"
    },
    "metadata": {
      "foo": "bar",
      "hello": "world"
    }
  }
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
DaprSubscription	Assinatura de evento do Dapr PubSub.
DaprSubscriptionBulkSubscribeOptions	Opções de assinatura em massa do Dapr PubSub.
DaprSubscriptionRouteRule	A Regra de Rota da Assinatura de Evento do Dapr Pubsub é usada para especificar a condição para enviar uma mensagem para um caminho específico.
DaprSubscriptionRoutes	Configuração de rotas de assinatura de evento do Dapr PubSub.
DefaultErrorResponse	Resposta de erro do Serviço de Aplicativo.
Details	Detalhes ou o erro
Error	Modelo de erro.
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

DaprSubscription

Objeto

Assinatura de evento do Dapr PubSub.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.bulkSubscribe	DaprSubscriptionBulkSubscribeOptions	Opções de assinatura em massa
properties.deadLetterTopic	string	Nome do tópico deadletter
properties.metadata	object	Metadados de assinatura
properties.pubsubName	string	Nome do componente Dapr PubSub
properties.routes	DaprSubscriptionRoutes	Rotas de assinatura
properties.scopes	string[]	Escopos de aplicativo para restringir a assinatura a aplicativos específicos.
properties.topic	string	Nome do tópico
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DaprSubscriptionBulkSubscribeOptions

Objeto

Opções de assinatura em massa do Dapr PubSub.

Nome	Tipo	Valor padrão	Description
enabled	boolean	False	Habilitar assinatura em massa
maxAwaitDurationMs	integer (int32)		Duração máxima em milissegundos para aguardar antes que uma mensagem em massa seja enviada ao aplicativo.
maxMessagesCount	integer (int32)		Número máximo de mensagens a serem entregues em uma mensagem em massa.

DaprSubscriptionRouteRule

Objeto

A Regra de Rota da Assinatura de Evento do Dapr Pubsub é usada para especificar a condição para enviar uma mensagem para um caminho específico.

Nome	Tipo	Description
match	string	A expressão CEL opcional usada para corresponder ao evento. Se a correspondência não for especificada, a rota será considerada o padrão. As regras são testadas na ordem especificada, portanto, elas devem ser definidas da mais para a menos específica. A rota padrão deve aparecer por último na lista.
path	string	O caminho para eventos que correspondem a essa regra

DaprSubscriptionRoutes

Objeto

Configuração de rotas de assinatura de evento do Dapr PubSub.

Nome	Tipo	Description
default	string	O caminho padrão para entregar eventos que não correspondem a nenhuma das regras.
rules	DaprSubscriptionRouteRule[]	A lista de regras de rota de assinatura de evento do Dapr PubSub.

DefaultErrorResponse

Objeto

Resposta de erro do Serviço de Aplicativo.

Nome	Tipo	Description
error	Error	Modelo de erro.

Details

Objeto

Detalhes ou o erro

Nome	Tipo	Description
code	string	Cadeia de caracteres padronizada para identificar programaticamente o erro.
message	string	Informações detalhadas de descrição e depuração de erros.
target	string	Informações detalhadas de descrição e depuração de erros.

Error

Objeto

Modelo de erro.

Nome	Tipo	Description
code	string	Cadeia de caracteres padronizada para identificar programaticamente o erro.
details	Details[]	Detalhes ou o erro
innererror	string	Mais informações para depurar o erro.
message	string	Informações detalhadas de descrição e depuração de erros.
target	string	Informações detalhadas de descrição e depuração de erros.

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via

Dapr Subscriptions - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Create or update dapr subscription with bulk subscribe configuration and scopes

Solicitação de exemplo

Resposta de exemplo

Create or update dapr subscription with default route only

Solicitação de exemplo

Resposta de exemplo

Create or update dapr subscription with route rules and metadata

Solicitação de exemplo

Resposta de exemplo

Definições

createdByType

DaprSubscription

DaprSubscriptionBulkSubscribeOptions

DaprSubscriptionRouteRule

DaprSubscriptionRoutes

DefaultErrorResponse

Details

Error

systemData