Compartilhar via

Check Configurations - Query

  • Referência
Service:
Approvals And Checks
API Version:
7.1-preview.1

Obtenha marcar configurações para vários recursos por tipo de recurso e ID.

POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/checks/queryconfigurations?api-version=7.1-preview.1
With optional parameters: 
POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/checks/queryconfigurations?$expand={$expand}&api-version=7.1-preview.1

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
 path True

string

O nome da organização do Azure DevOps.
project
 path True

string

ID do projeto ou nome do projeto
api-version
 query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1-preview.1' para usar essa versão da API.
$expand
 query

CheckConfigurationExpandParameter

As propriedades que devem ser expandidas na lista de configurações de marcar.

Corpo da solicitação

Nome Tipo Description
body

Resource[]

Lista de recursos.

Respostas

Nome Tipo Description
200 OK

CheckConfiguration[]

operação bem-sucedida

Segurança

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Nome Description
vso.build Concede a capacidade de acessar artefatos de build, incluindo resultados de build, definições e solicitações e a capacidade de receber notificações sobre eventos de build por meio de ganchos de serviço.

Exemplos

Sample Request

POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/checks/queryconfigurations?api-version=7.1-preview.1

[
  {
    "type": "queue",
    "id": "1",
    "name": "Default"
  },
  {
    "type": "environment",
    "id": "1",
    "name": "SampleEnv"
  }
]

Sample Response

Status code:
200 
request-Context: appId=cid-v1:a892bfef-0287-4640-9f5e-cffc90fbcf94
access-Control-Expose-Headers: Request-Context
Response Body
{
  "count": 12,
  "value": [
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T11:21:11.1408948Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T11:21:11.1408948Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/22"
        }
      },
      "id": 22,
      "type": {
        "id": "8c6f20a7-a545-4486-9777-f762fafe0d4d",
        "name": "Approval"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/22",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T11:21:11.312742Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T11:52:52.3335458Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/23"
        }
      },
      "id": 23,
      "type": {
        "id": "fe1de3ee-a436-41b4-bb20-f6eb4cb879a7",
        "name": "Task Check"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/23",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T11:42:31.1912383Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T11:42:31.1912383Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/24"
        }
      },
      "id": 24,
      "type": {
        "id": "8c6f20a7-a545-4486-9777-f762fafe0d4d",
        "name": "Approval"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/24",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T11:50:29.2550665Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T12:26:25.7610862Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/27"
        }
      },
      "id": 27,
      "type": {
        "id": "fe1de3ee-a436-41b4-bb20-f6eb4cb879a7",
        "name": "Task Check"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/27",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T11:52:03.1146399Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T11:52:03.1146399Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/28"
        }
      },
      "id": 28,
      "type": {
        "id": "8c6f20a7-a545-4486-9777-f762fafe0d4d",
        "name": "Approval"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/28",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T11:53:33.1149141Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T11:53:33.1149141Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/30"
        }
      },
      "id": 30,
      "type": {
        "id": "8c6f20a7-a545-4486-9777-f762fafe0d4d",
        "name": "Approval"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/30",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T11:53:33.2555259Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T11:53:33.2555259Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/31"
        }
      },
      "id": 31,
      "type": {
        "id": "fe1de3ee-a436-41b4-bb20-f6eb4cb879a7",
        "name": "Task Check"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/31",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T12:26:25.3548409Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T12:26:25.3548409Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/32"
        }
      },
      "id": 32,
      "type": {
        "id": "8c6f20a7-a545-4486-9777-f762fafe0d4d",
        "name": "Approval"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/32",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T12:26:25.5267095Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T12:26:25.5267095Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/33"
        }
      },
      "id": 33,
      "type": {
        "id": "fe1de3ee-a436-41b4-bb20-f6eb4cb879a7",
        "name": "Task Check"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/33",
      "resource": {
        "type": "queue",
        "id": "1",
        "name": "Default"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-09-21T07:29:09.749198Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T12:23:28.1356019Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/12"
        }
      },
      "id": 12,
      "type": {
        "id": "fe1de3ee-a436-41b4-bb20-f6eb4cb879a7",
        "name": "Task Check"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/12",
      "resource": {
        "type": "environment",
        "id": "1",
        "name": "SampleEnv"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-09-30T12:46:12.6159149Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T08:12:49.2665218Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/14"
        }
      },
      "id": 14,
      "type": {
        "id": "8c6f20a7-a545-4486-9777-f762fafe0d4d",
        "name": "Approval"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/14",
      "resource": {
        "type": "environment",
        "id": "1",
        "name": "SampleEnv"
      }
    },
    {
      "createdBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "createdOn": "2020-11-19T10:28:46.4136508Z",
      "modifiedBy": {
        "displayName": "User Name",
        "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
        "uniqueName": "uniqueName",
        "descriptor": "Descriptor"
      },
      "modifiedOn": "2020-11-19T10:28:46.4136508Z",
      "timeout": 43200,
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/16"
        }
      },
      "id": 16,
      "type": {
        "id": "fe1de3ee-a436-41b4-bb20-f6eb4cb879a7",
        "name": "Task Check"
      },
      "url": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/checks/configurations/16",
      "resource": {
        "type": "environment",
        "id": "1",
        "name": "SampleEnv"
      }
    }
  ]
}

Definições

Nome Description
CheckConfiguration
CheckConfigurationExpandParameter

As propriedades que devem ser expandidas na lista de configurações de marcar.
CheckIssue

Um problema (erro, aviso) associado a uma configuração de marcar.
CheckIssueType

O tipo (erro, aviso) do problema.
CheckType
IdentityRef
ReferenceLinks

A classe para representar uma coleção de links de referência REST.
Resource

CheckConfiguration

Nome Tipo Description
_links

ReferenceLinks

Links de referência.
createdBy

IdentityRef

Identidade da pessoa que configurou marcar.
createdOn

string

Hora em que marcar foi configurado.
id

integer

Verifique a ID de configuração.
isDisabled

boolean

Está marcar desabilitado.
issue

CheckIssue

Problema conectado à configuração de marcar.
modifiedBy

IdentityRef

Identidade da pessoa que modificou o marcar configurado.
modifiedOn

string

Hora em que o marcar configurado foi modificado.
resource

Resource

Recurso no qual marcar ser configurado.
timeout

integer

Tempo limite em minutos para o marcar.
type

CheckType

Verificar tipo de configuração
url

string

A URL da qual é possível buscar o marcar configurado.

CheckConfigurationExpandParameter

As propriedades que devem ser expandidas na lista de configurações de marcar.

Nome Tipo Description
none

string

settings

string

CheckIssue

Um problema (erro, aviso) associado a uma configuração de marcar.

Nome Tipo Description
description

string

Breve resumo do marcar - seu nome e recurso.
detailedMessage

string

Uma descrição mais detalhada do problema.
message

string

Uma descrição do problema.
type

CheckIssueType

O tipo (erro, aviso) do problema.

CheckIssueType

O tipo (erro, aviso) do problema.

Nome Tipo Description
error

string

warning

string

CheckType

Nome Tipo Description
id

string

Obtém ou define marcar id do tipo.
name

string

Nome do tipo marcar.

IdentityRef

Nome Tipo Description
_links

ReferenceLinks

Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor

string

O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto do grafo entre contas e organizações.
directoryAlias

string

Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef
displayName

string

Este é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id

string

imageUrl

string

Preterido - Disponível na entrada "avatar" do dicionário "_links" IdentityRef
inactive

boolean

Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser
isAadIdentity

boolean

Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer

boolean

Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType)
isDeletedInOrigin

boolean

profileUrl

string

Preterido – não em uso na maioria das implementações preexistidas de ToIdentityRef
uniqueName

string

Preterido – use Domain+PrincipalName
url

string

Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

Resource

Nome Tipo Description
id

string

ID do recurso.
name

string

Nome do recurso.
type

string

Tipo do recurso.