Revisioni migliorate dei flag di funzionalità

Le revisioni delle feature flag migliorate non sono disponibili in questa versione API.

Una revisione del flag di feature migliorata definisce la rappresentazione storica di una risorsa di flag di feature migliorata. Le revisioni scadono dopo 7 giorni per i negozi di livello Free e Developer, oppure dopo 30 giorni per quelli di livello Standard e Premium. Le revisioni supportano l'operazione List .

Per tutte le operazioni, name è un parametro opzionale. Se omesso, implica qualsiasi nome di bandiera di caratteristica.

Per tutte le operazioni, label è un parametro opzionale. Se omesso, implica qualsiasi etichetta.

Prerequisiti

• Tutte le richieste HTTP devono essere autenticate. Vedere la sezione relativa all'autenticazione.
• Tutte le richieste HTTP devono fornire esplicitamente api-version. Vedere la sezione relativa al controllo delle versioni.

Revisioni della lista

Opzionale: name (Se non specificato, implica qualsiasi nome di flag di caratteristica.)

Facoltativo: label se non specificato, implica qualsiasi etichetta.

Facoltativo: tags se non specificato, implica eventuali tag.

Intestazione opzionale della richiesta: Sync-Token (Usata per garantire la coerenza in tempo reale tra le richieste.)

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

Risposte:

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}"
}

Revisioni della lista (condizionate)

Per migliorare la memorizzazione nella cache del client, usare If-Match o If-None-Match richiedere intestazioni. L'argomento etag fa parte del corpo della risposta della lista e dell'intestazione della lista. Se entrambe le intestazioni vengono omesse, l'operazione è incondizionata.

La seguente richiesta riceve revisioni solo se la rappresentazione attuale corrisponde a quella specificata etag:

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

Risposte:

HTTP/1.1 412 Precondition Failed

o

HTTP/1.1 200 OK

La seguente richiesta riceve revisioni solo se la rappresentazione attuale non corrisponde a quella specificata etag:

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

Risposte:

HTTP/1.1 304 Not Modified

o

HTTP/1.1 200 OK

Pagination

Il risultato viene impaginato se il numero di elementi restituiti supera il limite di risposta. Segui l'URI nella @nextLink proprietà per richiedere la pagina successiva. L'URI collegato include il After token di continuazione e l'argomento api-version . Non decodificare o costruire il After token.

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

Risposta:

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

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

Filtro

È supportata una combinazione di namefiltri , labele tags . Usare i parametri facoltativi namedella stringa di query , labele tags . È possibile specificare più filtri di tag come parametri della stringa di query nel tagName=tagValue formato . I filtri tag devono essere una corrispondenza esatta.

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

Filtri supportati

Personaggi riservati

I caratteri riservati sono:

*, \, ,

Se un carattere riservato fa parte del valore , deve essere preceduto da un carattere di escape tramite \{Reserved Character}. I caratteri non riservati possono anche essere preceduti da caratteri di escape.

Validazione del filtro

Se si verifica un errore di validazione del filtro, la risposta è HTTP 400 con dettagli sull'errore:

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
}

Examples

• Tutte le revisioni

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

• Revisioni in cui il nome della bandiera della caratteristica inizia con abc

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

• Revisioni in cui il nome della bandiera della caratteristica è abc o xyz, e le etichette contengono prod

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

Richiedi campi specifici

Usare il parametro facoltativo $select della stringa di query e specificare un elenco delimitato da virgole di campi richiesti. Se il $select parametro viene omesso, la risposta contiene il set predefinito. I campi supportati sono name, enabled, label, conditionsdescription, variantsallocation, , telemetry, tags, last_modified, e etag.

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

Per informazioni sulle intestazioni di richiesta e risposta condivise dalle operazioni del piano dati App Configuration, vedi Intestazioni comuni.