Etiquetas

O recurso Label é definido da seguinte forma:

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

Suporta as seguintes operações:

• Listagem

Para todas as operações name é um parâmetro de filtro opcional. Se omitido, implica qualquer rótulo.

Pré-requisitos

• Todas as solicitações HTTP devem ser autenticadas. Consulte a seção de autenticação .
• Todas as solicitações HTTP devem fornecer arquivos .api-version Consulte a seção de controle de versão.

Listar rótulos

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

Respostas:

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

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

Paginação

O resultado será paginado se o número de itens retornados exceder o limite de resposta. Siga os cabeçalhos de resposta opcionais Link e use rel="next" para navegação. Como alternativa, o conteúdo fornece um próximo link na forma da @nextLink propriedade. O próximo link contém api-version parâmetro.

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

Resposta:

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

Filtragem

A filtragem por name é suportada.

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

Filtros suportados

Filtro de etiquetas	Efeito
name for omitida ou name=*	Corresponde a qualquer rótulo
name=abc	Corresponde a um rótulo chamado abc
name=abc*	Corresponde a nomes de rótulos que começam com abc
name=abc,xyz	Corresponde aos nomes dos rótulos abc ou xyz (limitado a 5 CSV)

Caracteres reservados

*, \, ,

Se um caractere reservado fizer parte do valor, ele deverá ser escapado usando \{Reserved Character}. Caracteres não reservados também podem ser escapados.

Validação de Filtros

Se ocorrer um erro de validação de filtro, a resposta será HTTP 400 com detalhes do erro:

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
}

Exemplos

• Todos

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

• O nome do rótulo começa com abc

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

• O nome do rótulo é abc ou xyz

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

Solicitar campos específicos

Use o parâmetro opcional $select de cadeia de caracteres de consulta e forneça uma lista separada por vírgulas dos campos solicitados. Se o $select parâmetro for omitido, a resposta conterá o conjunto padrão.

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

Acesso baseado no tempo

Obter uma representação do resultado como era em um momento passado. Ver secção 2.1.1.

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

Resposta:

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