Compartilhar via


Check Configurations - Get

Obter Configuração de verificação por ID

GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/checks/configurations/{id}?api-version=7.1-preview.1
GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/checks/configurations/{id}?$expand={$expand}&api-version=7.1-preview.1

Parâmetros de URI

Nome Em Obrigatório Tipo Description
id
path True

integer

int32
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

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

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

Sample Response

request-Context: appId=cid-v1:a892bfef-0287-4640-9f5e-cffc90fbcf94
access-Control-Expose-Headers: Request-Context
{
  "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
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

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.