Azure Functions runtime 1.x legacy reference

Dit artikel bewaart belangrijke historische informatie en verwijst naar gedetailleerde referenties voor functie-apps die nog runtime 1.x gebruiken. Gebruik Runtime 1.x niet voor nieuwe functie-apps.

Runtime 1.x scope

Azure Functions runtime 1.x eindigde op 14 september 2026 en wordt niet ondersteund voor nieuwe of bestaande functie-apps. Runtime 1.x had de volgende kenmerken:

  • Het draaide alleen op Windows.
  • Het ondersteunde C#-apps die gericht waren op .NET Framework en JavaScript-apps.
  • C#-apps draaiden in behandeling. Runtime 1.x ondersteunde het geïsoleerde werkermodel niet.
  • Het gebruikte versie 1.x van Azure Functions Core Tools voor lokale ontwikkeling. Core Tools 1.x draait alleen op Windows.
  • De speelduur omvatte de ondersteunde bindingen. Latere runtime-versies gebruiken afzonderlijk versiegewijze bindingsextensies of extensiebundels.

Runtime-, extensie- en programmeermodelversies

De Azure Functions runtime-versie is niet dezelfde als de versies die worden gebruikt door het binden van extensies, extensiebundels of programmeermodellen voor taal. Een versielabel op een andere component geeft niet aan dat een app Azure Functions runtime 1.x gebruikt. Voorbeeld:

  • De Python v1 en v2 programmeermodellen draaien op runtime 4.x.
  • De Node.js v3 en v4 programmeermodellen draaien op runtime 4.x.
  • Versies van extensiebundels en bindingsuitbreidingspakketten zijn onafhankelijk van de runtime-versie.

Migreren naar runtime 4.x

Om een app terug te brengen naar volledige ondersteuning, migreer je deze van runtime 1.x naar runtime 4.x. De migratiegids behandelt deze taken:

  • Identificeer apps die runtime 1.x targeten.
  • Kies een ondersteund doel voor C# of JavaScript.
  • Werk het project, bindings, app-instellingen en host.json bestand bij.
  • Test de app lokaal en werk de functie-app bij in Azure.

Verander niet alleen de FUNCTIONS_EXTENSION_VERSION app-instellingen. Runtime-upgrades kunnen project-, code-, binding- en configuratiewijzigingen vereisen.

App-instellingen specifiek voor runtime 1.x

De verouderde AzureWebJobsDashboard instelling wordt alleen ondersteund door runtime 1.x. Het bevat een optionele algemene opslagaccount-verbindingsreeks die wordt gebruikt om logs op te slaan en deze weer te geven in het tabblad Monitor in het Azure-portaal.

Sleutel Voorbeeldwaarde
AzureWebJobsDashboard DefaultEndpointsProtocol=https;AccountName=...

Runtime 1.x ondersteunt de AZURE_FUNCTIONS_ENVIRONMENT app-instelling niet.

De FUNCTIONS_EXTENSION_VERSION waarde ~1 pint een functie-app aan runtime 1.x. Bestandssysteemsleutelopslag (AzureWebJobsSecretStorageType=files) is de standaard.

De functionsRuntimeAdminIsolationEnabled site-eigenschap is niet beschikbaar in runtime 1.x. De FUNCTIONS_V2_COMPATIBILITY_MODE instelling geldt niet voor runtime 1.x-apps.

Project- en taalverschillen

Runtime 1.x C#-klasse bibliotheekprojecten richtten zich op het .NET Framework en gebruikten de 1.x-versie van het Microsoft.NET.Sdk.Functions pakket. Ze zouden het kunnen gebruiken TraceWriter voor houtkap. Voor het huidige C#-projectmodel en migratieoverwegingen, zie de ontwikkelaarsgids voor .NET-klassenbibliotheken en de runtime 1.x-migratiegids.

C#-klas bibliotheekprojecten

Het volgende voorbeeld toont de relevante delen van een runtime 1.x projectbestand:

<PropertyGroup>
  <TargetFramework>net48</TargetFramework>
</PropertyGroup>
<ItemGroup>
  <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="1.0.24" />
</ItemGroup>

De Microsoft.NET.Sdk.Functions pakketafhankelijkheden omvatten triggers en bindings. Een 1.x-project verwijst naar 1.x-triggers en bindings omdat ze zich richten op het .NET Framework. Het pakket hangt ook af van Newtonsoft.Json en indirect van WindowsAzure.Storage. Deze afhankelijkheden zorgen ervoor dat het project versies gebruikt die compatibel zijn met de beoogde Functions-runtime. Bijvoorbeeld, de Functions-runtime die zich richt op .NET Framework 4.6.1 is compatibel met 9.0.1, niet met Newtonsoft.Json versie 11.

Runtime 1.x wordt gebruikt TraceWriter voor Application Insights-logging. TraceWriter Ondersteunt geen gestructureerde logging.

Het volgende voorbeeld creëert een TelemetryClient en gebruikt TrackEvent, TrackMetric, en TrackDependency om aangepaste telemetrie op te nemen. Het gebruikt ook de uitvoeringscontext van de functie om de aangepaste telemetrie te correleren met de huidige aanroep.

Voorbeeld van aangepaste telemetrie

using System;
using System.Linq;
using System.Net.Http;
using System.Threading.Tasks;
using Microsoft.ApplicationInsights;
using Microsoft.ApplicationInsights.DataContracts;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Extensions.Logging;

namespace functionapp0915
{
	public static class HttpTrigger2
	{
		private static string key = TelemetryConfiguration.Active.InstrumentationKey =
			Environment.GetEnvironmentVariable(
				"APPINSIGHTS_INSTRUMENTATIONKEY", EnvironmentVariableTarget.Process);

		private static TelemetryClient telemetryClient =
			new TelemetryClient() { InstrumentationKey = key };

		[FunctionName("HttpTrigger2")]
		public static async Task<HttpResponseMessage> Run(
			[HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)]
			HttpRequestMessage req, ExecutionContext context, ILogger log)
		{
			log.LogInformation("C# HTTP trigger function processed a request.");
			DateTime start = DateTime.UtcNow;
			string name = req.GetQueryNameValuePairs()
				.FirstOrDefault(q => string.Compare(q.Key, "name", true) == 0)
				.Value;
			dynamic data = await req.Content.ReadAsAsync<object>();
			name = name ?? data?.name;

			var evt = new EventTelemetry("Function called");
			UpdateTelemetryContext(evt.Context, context, name);
			telemetryClient.TrackEvent(evt);

			var metric = new MetricTelemetry("Test Metric", DateTime.Now.Millisecond);
			UpdateTelemetryContext(metric.Context, context, name);
			telemetryClient.TrackMetric(metric);

			var dependency = new DependencyTelemetry
			{
				Name = "GET api/planets/1/",
				Target = "swapi.co",
				Data = "https://swapi.co/api/planets/1/",
				Timestamp = start,
				Duration = DateTime.UtcNow - start,
				Success = true
			};
			UpdateTelemetryContext(dependency.Context, context, name);
			telemetryClient.TrackDependency(dependency);
		}

		private static void UpdateTelemetryContext(
			TelemetryContext context,
			ExecutionContext functionContext,
			string userName)
		{
			context.Operation.Id = functionContext.InvocationId.ToString();
			context.Operation.ParentId = functionContext.InvocationId.ToString();
			context.Operation.Name = functionContext.FunctionName;
			context.User.Id = userName;
		}
	}
}

Runtime 1.x ondersteunde ook C#-script (.csx) en JavaScript-functies. Het C#-script is niet specifiek voor runtime 1.x, dus gebruik de C#-script ontwikkelaarsreferentie voor algemene scriptbegeleiding. Gebruik de migratiegids voor runtime-specifieke wijzigingen.

Voor voorbeelden van de eerdere C#-syntaxis, zie de runtime 1.x-functietemplates.

C# scriptassemblies en -pakketten

In runtime 1.x C#-scriptfuncties kon je de volgende assemblies eenvoudig noemen:

  • Newtonsoft.Json
  • Microsoft.WindowsAzure.Storage
  • Microsoft.ServiceBus
  • Microsoft.AspNet.WebHooks.Receivers
  • Microsoft.AspNet.WebHooks.Common

Runtime 1.x gebruikte een project.json bestand om afhankelijkheden te definiëren. Het volgende voorbeeld voegt het Microsoft.ProjectOxford.Face NuGet-pakket toe:

{
	"frameworks": {
		"net46": {
			"dependencies": {
				"Microsoft.ProjectOxford.Face": "1.1.0"
			}
		}
	}
}

Extensiebundels worden niet ondersteund door runtime 1.x. Om een aangepaste NuGet-feed te gebruiken, specificeer je de feed in een NuGet.Config-bestand in de hoofdmap van de functieapp. Zie NuGet-gedrag configureren voor meer informatie.

Lokale ontwikkeling met Core Tools 1.x

Versie 1.x van Azure Functions Core Tools wordt gekoppeld aan runtime 1.x en draait alleen op Windows. Om de looptijd te starten, rende func host startje . Voor actuele lokale ontwikkelingsrichtlijnen, zie Ontwikkel Azure Functions lokaal met Core Tools.

Visual Studio sloeg runtime 1.x Core Tools-versies op %USERPROFILE%\AppData\Local\Azure.Functions.Cli en gebruikte de nieuwste versie die daar was opgeslagen. Je kon de geselecteerde versie in de console-uitvoer zien tijdens het uitvoeren van het project:

[3/1/2018 9:59:53 AM] Starting Host (HostId=contoso2-1518597420, Version=2.0.11353.0, ProcessId=22020, Debug=False, Attempt=0, FunctionsExtensionVersion=)

Runtime 1.x host.json referentie

Het host.json schema en de instellingen veranderden na runtime 1.x. Bekijk de runtime 1.x host.json referentie bij het bekijken van een bestaande configuratie en vergelijk deze met de huidige host.json referentie tijdens migratie.

Monitor runtime 1.x-apps met Application Insights

Runtime 1.x gebruikt de volgende logcategorieën van Application Insights:

Categorie Table Description
Function Sporen Door de gebruiker gegenereerde logboeken, die elk niveau van logboek kunnen hebben.
Host.Aggregator customMetrics Tellingen en gemiddelden van functie-aanroepen over een configureerbare periode. De standaard is 30 seconden of 1.000 resultaten, afhankelijk van wat het eerst komt. Deze logboeken worden op het Information niveau geschreven.
Host.Executor Sporen Logs van functie gestart en voltooid. Succesvolle runs gebruiken Information, uitzonderingen gebruiken Error, en voorwaarden zoals poison-queue berichten gebruiken Warning.
Host.Results Verzoeken Succes of falen van functie-uitvoeringen. Deze logboeken worden op het Information niveau geschreven.

Logboekniveaus configureren

Runtime 1.x configureert log-levels onder logger.categoryFilter inhost.json:

{
	"logger": {
		"categoryFilter": {
			"defaultLevel": "Warning",
			"categoryLevels": {
				"Host.Results": "Information",
				"Host.Aggregator": "Trace",
				"Function": "Information"
			}
		}
	}
}

Wanneer meerdere categorienamen met dezelfde string beginnen, wordt eerst de meer specifieke categorie gematcht. Het volgende voorbeeld registreert alles behalve Host.Aggregator op het niveau Error :

{
	"logger": {
		"categoryFilter": {
			"defaultLevel": "Information",
			"categoryLevels": {
				"Host": "Error",
				"Function": "Error",
				"Host.Aggregator": "Information"
			}
		}
	}
}

Steekproeven configureren

De standaard maximale telemetriesnelheid is vijf items per seconde. Runtime 1.x configureert sampling onder applicationInsights.sampling:

{
	"applicationInsights": {
		"sampling": {
			"isEnabled": true,
			"maxTelemetryItemsPerSecond": 5
		}
	}
}

Het volgende voorbeeld combineert categoriefiltering en steekproefneming:

{
	"logger": {
		"categoryFilter": {
			"defaultLevel": "Warning",
			"categoryLevels": {
				"Function": "Error",
				"Host.Aggregator": "Error",
				"Host.Results": "Information",
				"Host.Executor": "Warning"
			}
		}
	},
	"applicationInsights": {
		"sampling": {
			"isEnabled": true,
			"maxTelemetryItemsPerSecond": 5
		}
	}
}

Runtime 1.x ondersteunt geen configuratie per functie.

Application Insights-mogelijkheden

Runtime 1.x verzamelde automatisch verzoeken, uitzonderingen en prestatietellers. Het verzamelde niet automatisch HTTP-, Service Bus-, Event Hub- of SQL-afhankelijkheden. Het ondersteunde QuickPulse/Live Metrics zonder een beveiligd controlekanaal en ondersteunde sampling, maar het ondersteunde geen hartslagen, Service Bus- of Event Hubs-correlatie, of volledig configureerbare telemetrieverzameling.

Niet-ondersteunde functies en gedrag in runtime 1.x

  • Beleid voor herhaling wordt niet ondersteund.
  • Dynamische schaalmonitoring van virtuele netwerktriggers wordt niet ondersteund.
  • Bij Premium- en Dedicated plannen is de standaard timeout voor de uitvoering van functies onbegrensd. Op het consumptieplan is de standaardtijd vijf minuten en het maximum 10 minuten.
  • Een functionele app die een remote deployment-pakket gebruikt, kan niet draaien zonder een Azure Files-share.

Bindingen inbegrepen in runtime 1.x

Azure Functions runtime 1.x is buiten gebruik gesteld. Wanneer je naar runtime 4.x migreert, gebruik dan current binding-extensies of een extensiebundel en bekijk elke binding op configuratie- en typewijzigingen.

De volgende bindings werden meegeleverd met runtime 1.x. De C#-attribuutkolom toont de korte namen die in de code worden gebruikt. De bijbehorende klassennamen hebben een Attribute achtervoegsel, zoals BlobTriggerAttribute. C#-scriptfuncties definiëren in plaats daarvan bindings in het function.json-bestand .

Type Trigger Invoer Uitvoer C#-attributen
Blob Storage Yes Yes Yes [BlobTrigger] (trigger)
[Blob] (invoer/uitvoer)
Azure Cosmos DB Yes Yes Yes [CosmosDBTrigger] (trigger)
[DocumentDB] (invoer/uitvoer)
Event Grid Yes Nee. Nee. [EventGridTrigger]
Event Hubs Yes Nee. Yes [EventHubTrigger] (trigger)
[EventHub] (uitvoer)
HTTP en webhooks Yes Nee. Yes [HttpTrigger]
IoT Hub Yes Nee. Nee. [EventHubTrigger]
Mobiele apps Nee. Yes Yes [MobileTable]
Meldingshubs Nee. Nee. Yes [NotificationHub]
Wachtrij Opslag Yes Nee. Yes [QueueTrigger] (trigger)
[Queue] (uitvoer)
SendGrid Nee. Nee. Yes [SendGrid]
Service Bus Yes Nee. Yes [ServiceBusTrigger] (trigger)
[ServiceBus] (uitvoer)
Tafelopslag Nee. Yes Yes [Table]
Timer Yes Nee. Nee. [TimerTrigger]
Twilio Nee. Nee. Yes [TwilioSms]

Functie-apps die runtime 1.x gebruiken, verwijzen automatisch naar het Microsoft.Azure. WebJobs NuGet-pakket (versie 2.x).

De triggers en bindings voor Blob Storage, Queue Storage en Table Storage gebruiken versie 7.2.1 van het WindowsAzure.Storage NuGet-pakket. Als je een andere versie van de Storage SDK verwijst en bindt aan een Storage SDK-type in je functiehandtekening, kan de Functions-runtime rapporteren dat het niet aan dat type kan binden. Zorg ervoor dat je project WindowsAzure.Storage 7.2.1 verwijst.

Blob Storage-bindings in runtime 1.x

Runtime 1.x exposeerde types van het verouderde Microsoft. WindowsAzure.Storage naamruimte. Nieuwere types van Azure. Storage. Blobs vereisen een latere extensie en runtime 4.x.

Queue Storage bindings in runtime 1.x

Runtime 1.x exposeerde types van het verouderde Microsoft. WindowsAzure.Storage naamruimte. Nieuwere types van Azure. Storage. Wachtrijen vereisen een latere extensie en runtime 4.x.

Voor Queue Storage binding-instellingen, zie het sectie wachtrijen van de runtime 1.x host.json referentie. In runtime 1.x wordt de maxPollingInterval instelling uitgedrukt in milliseconden. In latere runtimeversies is TimeSpanhet datatype .

Table Storage bindings in runtime 1.x

Runtime 1.x exposeerde types van het verouderde Microsoft. WindowsAzure.Storage.Table naamruimte. Nieuwere types van Azure. Data. Tables vereisen de Azure Tables-extensie en runtime 4.x.

Invoervoorbeelden

De volgende C#-functie leest een enkele tabelrij. Voor elk bericht dat naar de wachtrij wordt gestuurd, wordt de functie geactiveerd. De rijsleutelwaarde {queueTrigger} verbindt de rijsleutel met de metagegevens van het bericht. Dit is de berichttekenreeks.

public class TableStorage
{
	public class MyPoco
	{
		public string PartitionKey { get; set; }
		public string RowKey { get; set; }
		public string Text { get; set; }
	}

	[FunctionName("TableInput")]
	public static void TableInput(
		[QueueTrigger("table-items")] string input,
		[Table("MyTable", "MyPartition", "{queueTrigger}")] MyPoco poco,
		ILogger log)
	{
		log.LogInformation($"PK={poco.PartitionKey}, RK={poco.RowKey}, Text={poco.Text}");
	}
}

De volgende C#-functie leest meerdere tabelrijen waarbij de MyPoco klasse is afgeleid van TableEntity.

public class TableStorage
{
	public class MyPoco : TableEntity
	{
		public string Text { get; set; }
	}

	[FunctionName("TableInput")]
	public static void TableInput(
		[QueueTrigger("table-items")] string input,
		[Table("MyTable", "MyPartition")] IQueryable<MyPoco> pocos,
		ILogger log)
	{
		foreach (MyPoco poco in pocos)
		{
			log.LogInformation($"PK={poco.PartitionKey}, RK={poco.RowKey}, Text={poco.Text}");
		}
	}
}

Invoergebruik

Als u een specifieke entiteit per sleutel wilt retourneren, gebruikt u een bindingsparameter die is afgeleid van TableEntity. De specifieke TableName, PartitionKey, en RowKey worden gebruikt om te proberen een specifieke entiteit uit de tabel te halen.

Als u query's wilt uitvoeren die meerdere entiteiten retourneren, bindt u aan een IQueryable<T> type dat wordt overgenomen van TableEntity.

Uitgangsgebruik

De volgende typen worden ondersteund voor out parameters en retourtypen:

  • Een eenvoudig oud CLR-object (POCO) dat de PartitionKey en RowKey eigenschappen bevat. U kunt deze eigenschappen bijbehoren door deze te implementeren ITableEntity of over te TableEntitynemen.
  • ICollector<T> of IAsyncCollector<T> waar T de PartitionKey en RowKey eigenschappen zijn opgenomen. U kunt deze eigenschappen bijbehoren door deze te implementeren ITableEntity of over te TableEntitynemen.

U kunt ook verbinding maken CloudTablemet de Storage SDK als methodeparameter. Vervolgens kunt u dat object gebruiken om naar de tabel te schrijven.

Event Hubs-bindings in runtime 1.x

Runtime 1.x bevatte de Event Hubs-binding en vereiste geen aparte extensie. Het bracht het verouderde Microsoft.Azure naar voren. Type EventHubs.EventData. Event Hubs-triggers ondersteunden EventData, JSON-serialiseerbare types, string, en byte[] voor een enkel event, en EventData[] en string[] voor een batch. Uitvoerbindingen ondersteunden EventData, JSON-serialiseerbare typen, string, en byte[].

Voor een Event Hubs-trigger of outputbinding in function.jsongebruikt runtime 1.x de path eigenschap voor de naam van de event hub. Latere runtime-versies gebruiken eventHubName. Wanneer de naam van de event hub ook aanwezig is in de verbindingsreeks, overschrijft die waarde de eigenschap tijdens runtime.

Het runtime 1.x host.json bestand gebruikt een topniveau-object eventHub :

{
	"eventHub": {
		"maxBatchSize": 64,
		"prefetchCount": 256,
		"batchCheckpointFrequency": 1
	}
}
Property Default Description
maxBatchSize 64 Het maximale gebeurtenisaantal dat per ontvangstlus wordt ontvangen.
prefetchCount 300 Het standaardaantal prefetchs dat wordt gebruikt door de onderliggende EventProcessorHostwaarde.
batchCheckpointFrequency 1 Het aantal gebeurtenisbatches dat moet worden verwerkt voordat u een Event Hubs-cursorcontrolepunt maakt.

Voor de volledige configuratiereferentie, zie het eventHub gedeelte van de runtime 1.x host.json referentie.

Event Grid-bindings in runtime 1.x

Versies van Event Grid-extensies van vóór 3.x ondersteunen het CloudEvents-schema niet. Om dit schema te gebruiken, gebruik je een HTTP-trigger of migreer je naar runtime 4.x en Event Grid-extensie 3.x.

De Event Grid-uitvoerbinding is alleen beschikbaar voor runtime 2.x en later.

Bindingstypen

De runtime 1.x-extensie ondersteunt de volgende parametertypen. Het ondersteunt het CloudEvents-schema niet, dat Event Grid-extensie 3.x vereist.

Verbindend Parametertypen
Trigger voor Event Grid Newtonsoft.Json.Linq.JObject
string

Triggergebruik

In-process C#-klassebibliotheekfuncties ondersteunen de volgende Event Grid-triggertypes:

  • Newtonsoft.Json.Linq.JObject
  • System.String

Webhook-eindpunt en systeemsleutel

Het gehoste webhook-eindpunt voor een runtime 1.x Event Grid-trigger gebruikt het volgende URL-patroon:

https://{functionappname}.azurewebsites.net/admin/extensions/EventGridExtensionConfig?functionName={functionname}&code={systemkey}

Om de Event Grid-systeemsleutel van de beheer-API te verkrijgen, gebruikt u de functie app masterkey in het volgende verzoek:

https://{functionappname}.azurewebsites.net/admin/host/systemkeys/eventgridextensionconfig_extension?code={masterkey}

Voor lokaal testen gebruikt het Event Grid trigger-eindpunt het volgende URL-patroon:

http://localhost:7071/admin/extensions/EventGridExtensionConfig?functionName={FUNCTION_NAME}

Service Bus-bindings in runtime 1.x

Runtime 1.x exposeerde types van het verouderde Microsoft. ServiceBus.Messaging naamruimte. Nieuwere types van Azure. Messaging. ServiceBus vereist Service Bus-extensie 5.x of hoger en runtime 4.x.

Op 30 september 2026 werden de Azure Service Bus SDK-bibliotheken WindowsAzure.ServiceBus, Microsoft.Azure. ServiceBus en com.microsoft.azure. Servicebus met pensioen gestuurd. Deze bibliotheken voldoen niet aan de richtlijnen van Azure SDK. Ondersteuning voor het Service Bus Messaging Protocol (SBMP) stopt eveneens. Hoewel je de oudere bibliotheken na je pensioen kunt blijven gebruiken, krijgen ze geen officiële ondersteuning en updates meer van Microsoft. Voor meer informatie, zie de aankondiging over het beëindigen van ondersteuning.

Triggergebruik

De queue- of topic-berichttrigger ondersteunt de volgende parametertypen:

In C#-klassebibliotheken neemt de constructor van het attribuut de naam van de wachtrij of het onderwerp en het abonnement. Je kunt ook de toegangsrechten van de verbinding specificeren. Als u geen toegangsrechten opgeeft, is de standaardwaarde Manage.

Service Bus-accountselectie

Gebruik het ServiceBusAccountAttribute om het Service Bus-account aan te geven. De constructor gebruikt de naam van een app-instelling die een Service Bus verbindingsreeks bevat. Pas het attribuut toe op parameter-, methode- of klasseniveau. Het volgende voorbeeld toont attributen op klasse- en methodeniveau:

[ServiceBusAccount("ClassLevelServiceBusAppSetting")]
public static class AzureFunctions
{
	[ServiceBusAccount("MethodLevelServiceBusAppSetting")]
	[FunctionName("ServiceBusQueueTriggerCSharp")]
	public static void Run(
		[ServiceBusTrigger("myqueue", AccessRights.Manage)]
		string myQueueItem, ILogger log)
	{
		// ...
	}
}

De volgende volgorde bepaalt welk Service Bus-account gebruikt moet worden:

  1. De eigenschap van ServiceBusTrigger het Connection kenmerk.
  2. Het ServiceBusAccount kenmerk dat is toegepast op dezelfde parameter als het ServiceBusTrigger kenmerk.
  3. Het ServiceBusAccount kenmerk dat is toegepast op de functie.
  4. Het ServiceBusAccount kenmerk dat is toegepast op de klasse.
  5. De AzureWebJobsServiceBus app-instelling.

Berichtmetagegevens

De volgende eigenschappen zijn leden van de klassen BrokeredMessage en MessageReceiver .

Property Type Description
ContentType string Een inhoudstype-identificatie die door de zender en ontvanger wordt gebruikt voor applicatiespecifieke logica.
CorrelationId string De correlatie-id.
DeadLetterSource string De dode bron.
DeliveryCount Int32 Het aantal leveringen.
EnqueuedTimeUtc DateTime De gequeuede tijd in de gecoördineerde universele tijd (UTC).
ExpiresAtUtc DateTime De verlooptijd in UTC.
Label string Het toepassingsspecifieke label.
MessageId string Een door de gebruiker gedefinieerde waarde die Service Bus kan gebruiken om dubbele berichten te identificeren, indien ingeschakeld.
MessageReceiver MessageReceiver Service Bus berichtontvanger. Kan worden gebruikt om het bericht te verlaten, af te maken of te laten vallen.
MessageSession MessageSession Een berichtontvanger specifiek voor wachtrijen en onderwerpen met sessie-functionaliteit.
ReplyTo string Het antwoord-op-wachtrijadres.
SequenceNumber long Het unieke nummer dat is toegewezen aan een bericht door Service Bus.
To string Het afstuuradres.
UserProperties IDictionary<string, object> Eigenschappen die zijn ingesteld door de afzender.

Uitgangsgebruik

Gebruik het type BrokeredMessage bij het verzenden van berichten met metagegevens. Definieer parameters als return typeattributen. Als de parameterwaarde nul is wanneer de functie wordt afgesloten, maakt Functions geen bericht aan.

Voor function.json bindings, accessRights accepteert manage or listen en standaard op manage. Als de verbindingsreeks geen Beheer-perspectief heeft, zet accessRights dan op listen om te voorkomen dat de runtime een beheerspoging uitvoert.

De runtime maakt de wachtrij aan als die niet bestaat en je zet accessRights op manage.

Hostinstellingen

Voor Service Bus binding-instellingen, zie de runtime 1.x host.json referentie.

HTTP- en webhook-bindings in runtime 1.x

Een HTTP-getriggerde functie keert standaard terug HTTP 200 OK met een leeg lichaam. Latere runtime-versies keren terug.HTTP 204 No Content

Voor een HTTP-trigger in function.json, gebruik de webHookType eigenschap om de trigger te configureren zodat deze fungeert als webhook-ontvanger voor de opgegeven provider. Deze eigenschap is specifiek voor runtime 1.x.

Runtime 1.x ondersteunt geen toegang tot geauthenticeerde clientinformatie.

Webhook-modus

Webhook-templates bieden extra validatie voor webhook-payloads. De webHookType binding-eigenschap toont de webhook-provider en beheert de ondersteunde payload:

Typewaarde Description
genericJson Een webhookeindpunt voor algemeen gebruik zonder logica voor een specifieke provider. Deze instelling beperkt verzoeken tot HTTP POST met het application/json inhoudstype.
github De functie reageert op GitHub-webhooks. Gebruik de authLevel eigenschap niet met GitHub-webhooks.
slack De functie reageert op Slack-webhooks. Gebruik de authLevel eigenschap niet met Slack-webhooks.

Wanneer je stelt webHookType, stel dan de methods eigenschap niet in.

Om te reageren op GitHub-webhooks, maak je de functie aan met een HTTP-trigger, zet webHookType je het op github, en kopieer je de URL en API-sleutel naar de pagina Webhook toevoegen van de GitHub-repository.

De Slack-webhook genereert een token, dus configureer een functie-specifieke sleutel met dat token.

De webhook-ontvangercomponent verzorgt webhook-autorisatie. Het mechanisme varieert per type webhook, maar elk mechanisme is afhankelijk van een sleutel. Standaard wordt de functietoets default gebruikt. Om een andere sleutel te gebruiken, configureer je de webhook-provider zo dat deze de sleutelnaam op een van de volgende manieren verzendt:

  • In de clientid querystringparameter, zoals https://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>?clientid=<KEY_NAME>.
  • In de x-functions-clientid verzoekheader.

Voor HTTP-bindingsinstellingen, zie het HTTP-gedeelte van de runtime 1.x host.json referentie.

Warm-up trigger in runtime 1.x

Runtime 1.x ondersteunt de warming-up trigger niet.

SendGrid-binding in runtime 1.x

Voeg de extensie toe aan uw project door het NuGet-pakket, versie 2.x, te installeren.

Voor SendGrid-bindingsinstellingen, zie de SendGrid-sectie van de runtime 1.x host.json referentie.

Twilio-binding in runtime 1.x

Voeg de extensie toe aan uw project door het NuGet-pakket versie 1.x te installeren.

Voor runtime 1.x gebruikt u de volgende bindingsconfiguratie-eigenschappen in het function.json-bestand :

function.json-eigenschap Description
type Ingesteld op twilioSms.
direction Ingesteld op out.
name Variabelenaam die wordt gebruikt in functiecode voor het sms-bericht van Twilio.
accountSid Stel in op de naam van een app-instelling die je Twilio-account Sid (TwilioAccountSid) bevat. Als deze instelling niet is ingesteld, is AzureWebJobsTwilioAccountSidde standaardnaam van de app-instelling.
authToken Stel in op de naam van een app-instelling die je Twilio-authenticatietoken bevat (TwilioAccountAuthToken). Als deze instelling niet is ingesteld, is AzureWebJobsTwilioAuthTokende standaardnaam van de app-instelling.
to Stel het telefoonnummer in waar de sms naartoe wordt gestuurd.
van Stel het telefoonnummer in waar de sms van wordt verzonden.
body Gebruik het hardcoderen van het SMS-bericht als je het niet dynamisch hoeft in te stellen in de code van je functie.

Gebruik de bewaarde bindingsinformatie in dit artikel alleen om een bestaande app te begrijpen. Volg de runtime-migratiegids en de huidige bindingsdocumentatie wanneer je de app bijwerkt.

Veelgestelde vragen

Wordt Azure Functions runtime 1.x nog steeds ondersteund?

No. De ondersteuning voor Azure Functions runtime 1.x eindigde op 14 september 2026. Migreer getroffen apps naar runtime 4.x voor volledige ondersteuning.

Gebruikt een Python v1 of Node.js v4 programmeermodel runtime 1.x?

No. Versies van taalprogrammeermodellen zijn onafhankelijk van de runtime-versie. De Python v1 en v2 programmeermodellen en de Node.js v3 en v4 programmeermodellen draaien op runtime 4.x.