Erweiterte Feature-Flag-Revisionen

Erweiterte Feature-Flag-Revisionen sind in dieser API-Version nicht verfügbar.

Eine erweiterte Feature-Flag-Revision definiert die historische Darstellung einer erweiterten Feature-Flag-Ressource. Revisionen laufen nach 7 Tagen für Gratis- und Entwickler-Stores oder 30 Tage für Standard- und Premium-Stores ab. Revisionen unterstützen die List Operation.

Für alle Operationen name ist ein optionaler Parameter. Wenn es weggelassen wird, impliziert es einen beliebigen Feature-Flag-Namen.

Für alle Operationen label ist ein optionaler Parameter. Wenn es weggelassen wird, impliziert es ein beliebiges Label.

Voraussetzungen

• Alle HTTP-Anforderungen müssen authentifiziert werden. Informationen dazu erhalten Sie im Abschnitt Authentifizierung.
• Alle HTTP-Anforderungen müssen explizit die api-version angeben. Informationen dazu erhalten Sie im Abschnitt Versionsverwaltung.

Listenüberarbeitungen

Optional: name (Falls nicht angegeben, impliziert es einen beliebigen Feature-Flag-Namen.)

Optional: label (ohne Angabe ist eine beliebige Bezeichnung gemeint).

Optional: tags (Falls nicht angegeben, impliziert es Tags.)

Optionaler Request-Header: Sync-Token (Verwendet, um Echtzeitkonsistenz zwischen Anfragen zu garantieren.)

GET /ff-revisions?name={name}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version} HTTP/1.1

Antworten:

HTTP/1.1 200 OK
Content-Type: application/json; profile="https://azconfig.io/mime-profiles/ffset"; charset=utf-8
ETag: "1PlB48ET4VAlB9068ft6fKMyA3m"
Sync-Token: zAJw6V16=NjotMSM3ODk3NjM=;sn=789763

{
  "items": [
    {
      "etag": "0BGYCoQ6iNdp5NtQ7N8shrobo6s",
      "name": "{name}",
      "enabled": false,
      "label": "{label}",
      "tags": {
        "t1": "value1"
      },
      "last_modified": "2026-04-30T16:52:32Z"
    },
    ...
  ],
  "@nextLink": "{relative uri}"
}

Listenüberarbeitungen (bedingt)

Verwenden Sie If-Match- oder If-None-Match-Anforderungsheader, um das Zwischenspeichern auf dem Client zu verbessern. Das Argument etag ist Teil des Listen-Antwortkörpers und des Headers. Wenn beide Header weggelassen werden, ist die Operation bedingungslos.

Der folgende Antrag erhält nur Überarbeitungen, wenn die aktuelle Darstellung der angegebenen etagentspricht:

GET /ff-revisions?name={name}&label={label}&api-version={api-version} HTTP/1.1
If-Match: "{etag}"

Antworten:

HTTP/1.1 412 Precondition Failed

oder

HTTP/1.1 200 OK

Die folgende Anfrage erhält nur dann Überarbeitungen, wenn die aktuelle Darstellung nicht mit der angegebenen etagVariante übereinstimmt:

GET /ff-revisions?name={name}&label={label}&api-version={api-version} HTTP/1.1
If-None-Match: "{etag}"

Antworten:

HTTP/1.1 304 Not Modified

oder

HTTP/1.1 200 OK

Paginierung

Das Ergebnis ist paginiert, wenn die Anzahl der zurückgegebenen Elemente das Antwortlimit überschreitet. Folgen Sie der URI in der @nextLink Immobilie, um die nächste Seite anzufordern. Die verknüpfte URI enthält das After Fortsetzungstoken und das Argument api-version . Entschlüsseln oder konstruieren Sie den Token After nicht.

GET /ff-revisions?api-version={api-version} HTTP/1.1

Antwort:

HTTP/1.1 200 OK
Content-Type: application/json; profile="https://azconfig.io/mime-profiles/ffset"; charset=utf-8

{
  "items": [
    ...
  ],
  "@nextLink": "{relative uri}"
}

Filterung

Es wird eine Kombination aus name, labelund tags Filtern unterstützt. Verwenden Sie die optionalen name, labelund tags Abfragezeichenfolgenparameter. Mehrere Tagfilter können als Abfragezeichenfolgenparameter im tagName=tagValue Format bereitgestellt werden. Tagfilter müssen eine genaue Übereinstimmung sein.

GET /ff-revisions?name={name}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version}

Unterstützte Filter

Reservierte Charaktere

Die reservierten Charaktere sind:

*, \, ,

Wenn ein Wert ein reserviertes Zeichen enthält, muss dieses mit einem Escapezeichen versehen werden: \{Reserved Character}. Nicht reservierten Zeichen können ebenfalls mit Escapezeichen versehen werden.

Filtervalidierung

Tritt ein Filtervalidierungsfehler auf, lautet die Antwort HTTP mit Fehlerangaben 400 :

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://azconfig.io/errors/invalid-argument",
  "title": "Invalid request parameter '{filter}'",
  "name": "{filter}",
  "detail": "{filter}(2): Invalid character",
  "status": 400
}

Beispiele

• Alle Überarbeitungen

  GET /ff-revisions?api-version={api-version}
  

• Revisionen, bei denen der Name der Feature-Flagge mit abc beginnt

  GET /ff-revisions?name=abc*&api-version={api-version}
  

• Revisionen, bei denen der Feature-Flag-Name entweder abc oder xyz ist und Labels prod enthalten

  GET /ff-revisions?name=abc,xyz&label=*prod*&api-version={api-version}
  

Anfordern bestimmter Felder

Verwenden Sie den optionalen Abfragezeichenfolgenparameter $select, und geben Sie eine durch Trennzeichen getrennte Liste der angeforderten Felder an. Wenn der Parameter $select ausgelassen wird, enthält die Antwort die Standardgruppe von Feldern. Unterstützte Felder sind , , , , , conditionsvariants, telemetrytagsallocationlast_modifiedund .etagdescriptionlabelenabledname

GET /ff-revisions?$select=enabled,label,last_modified&api-version={api-version} HTTP/1.1

Informationen zu Anfrage- und Antwortheadern, die von App Configuration Data-Plane-Operationen geteilt werden, finden Sie unter Common Headers.