Condividi tramite

Etichette

  • Articolo

La risorsa Etichetta è definita come segue:

{
      "name": [string]             // Name of the label
}

Supporta le operazioni seguenti:

  • List

Per tutte le operazioni name è un parametro di filtro facoltativo. Se omesso implica un'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.

Elencare le etichette

GET /labels?api-version={api-version} HTTP/1.1

Risposte:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.labelset+json; charset=utf-8"

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

Impaginazione

Il risultato viene impaginato se il numero di elementi restituiti supera il limite di risposta. Seguire le intestazioni di risposta facoltative Link e usare rel="next" per lo spostamento. In alternativa, il contenuto fornisce un collegamento successivo sotto forma di @nextLink proprietà . Il collegamento successivo contiene api-version il parametro .

GET /labels?api-version={api-version} HTTP/1.1

Risposta:

HTTP/1.1 OK
Content-Type: application/vnd.microsoft.appconfig.labelset+json; charset=utf-8
Accept-Ranges: items
Link: <{relative uri}>; rel="next"

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

Filtri

Il filtro in name base a è supportato.

GET /labels?name={label-name}&api-version={api-version}

Filtri supportati

Filtro etichette Effetto
name è omesso oppure name=* Corrisponde a qualsiasi etichetta
name=abc Corrisponde a un'etichetta denominata abc
name=abc* Trova la corrispondenza con i nomi delle etichette che iniziano con abc
name=abc,xyz Trova la corrispondenza con i nomi delle etichette abc o xyz (con un limite di 5 CSV)

Caratteri riservati

*, \, ,

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

Convalida filtro

Se si verifica un errore di convalida del filtro, la risposta è HTTP 400 con i dettagli dell'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 'name'",
  "name": "name",
  "detail": "name(2): Invalid character",
  "status": 400
}

Esempi

  • Tutte le date

    GET /labels?api-version={api-version}

  • Il nome dell'etichetta inizia con abc

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

  • Il nome dell'etichetta è abc o xyz

    GET /labels?name=abc,xyz&api-version={api-version}

Richiedi campi specifici

Usare il parametro facoltativo $select della stringa di query e fornire un elenco delimitato da virgole di campi richiesti. Se il $select parametro viene omesso, la risposta contiene il set predefinito.

GET /labels?$select=name&api-version={api-version} HTTP/1.1

Accesso basato sul tempo

Ottenere una rappresentazione del risultato come in passato. Vedere la sezione 2.1.1

GET /labels&api-version={api-version} HTTP/1.1
Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT

Risposta:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.labelset+json"
Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
Link: <{relative uri}>; rel="original"

{
    "items": [
        ....
    ]
}