Popisky

Prostředek Label je definován takto:

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

Podporuje následující operace:

• List

Pro všechny operace name je volitelný parametr filtru. Pokud tento popisek vynecháte, znamená to jakýkoli popisek.

Požadavky

• Všechny požadavky HTTP musí být ověřeny. Viz část ověřování.
• Všechny požadavky HTTP musí poskytovat explicitní api-version. Viz část správa verzí.

Popisky seznamu

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

Odpovědi:

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

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

Stránkování

Výsledek se stránkuje, pokud počet vrácených položek překročí limit odpovědi. Postupujte podle volitelných Link hlaviček odpovědí a použijte rel="next" k navigaci. Případně obsah poskytuje další odkaz ve formě @nextLink vlastnosti. Další odkaz obsahuje api-version parametr.

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

Odpověď:

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

Filtrování

Filtrování podle name je podporováno.

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

Podporované filtry

Filtr popisků	Účinnost
name je vynechán nebo name=*	Odpovídá jakémukoli popisku.
name=abc	Odpovídá popisku s názvem abc.
name=abc*	Odpovídá názvům popisků, které začínají na abc.
name=abc,xyz	Odpovídá názvům popisků abc nebo xyz (omezeno na 5 CSV)

Rezervované znaky

*, , \,

Pokud je vyhrazený znak součástí hodnoty, musí být řídicí znak použit .\{Reserved Character} Neplacené znaky mohou být také řídicí znaky.

Ověření filtru

Pokud dojde k chybě ověření filtru, odpověď je HTTP 400 s podrobnostmi o chybě:

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
}

Příklady

• Všechny

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

• Název popisku začíná abc

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

• Název popisku je abc nebo xyz

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

Zadání konkrétních polí

Použijte volitelný $select parametr řetězce dotazu a zadejte seznam požadovaných polí oddělených čárkami. $select Pokud parametr vynecháte, odpověď obsahuje výchozí sadu.

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

Přístup založený na čase

Získá reprezentaci výsledku, protože byl v minulosti. Viz oddíl 2.1.1

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

Odpověď:

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": [
        ....
    ]
}