Check Configurations - Query

Odwołanie

Service:: Approvals And Checks

API Version:: 7.1-preview.1

Uzyskaj konfiguracje dla wielu zasobów według typu i identyfikatora zasobu.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
project	path	True	string	Identyfikator projektu lub nazwa projektu
api-version	query	True	string	Wersja interfejsu API do użycia. Powinno to być ustawione na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.
$expand	query		CheckConfigurationExpandParameter	Właściwości, które powinny zostać rozwinięte na liście konfiguracji sprawdzania.

Treść żądania

Nazwa	Typ	Opis
body	Resource[]	Lista zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CheckConfiguration[]	operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa	Opis
vso.build	Umożliwia dostęp do artefaktów kompilacji, w tym wyników kompilacji, definicji i żądań oraz możliwość odbierania powiadomień o zdarzeniach kompilacji za pośrednictwem punktów zaczepienia usługi.

Przykłady

Sample Request

HTTP

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

Definicje

Nazwa	Opis
CheckConfiguration
CheckConfigurationExpandParameter	Właściwości, które powinny zostać rozwinięte na liście konfiguracji sprawdzania.
CheckIssue	Problem (błąd, ostrzeżenie) skojarzony z konfiguracją sprawdzania.
CheckIssueType	Typ (błąd, ostrzeżenie) problemu.
CheckType
IdentityRef
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.
Resource

CheckConfiguration

Nazwa	Typ	Opis
_links	ReferenceLinks	Linki referencyjne.
createdBy	IdentityRef	Tożsamość osoby, która skonfigurowała sprawdzanie.
createdOn	string	Godzina skonfigurowania sprawdzania.
id	integer	Sprawdź identyfikator konfiguracji.
isDisabled	boolean	Czy jest zaznaczone wyłączone.
issue	CheckIssue	Problem połączony z sprawdzeniem konfiguracji.
modifiedBy	IdentityRef	Tożsamość osoby, która zmodyfikowała skonfigurowane sprawdzanie.
modifiedOn	string	Godzina modyfikacji skonfigurowanego sprawdzania.
resource	Resource	Zasób, na którym skonfigurowano sprawdzanie.
timeout	integer	Limit czasu w minutach sprawdzania.
type	CheckType	Sprawdzanie typu konfiguracji
url	string	Adres URL, z którego można pobrać skonfigurowane sprawdzanie.

CheckConfigurationExpandParameter

Właściwości, które powinny zostać rozwinięte na liście konfiguracji sprawdzania.

Nazwa	Typ	Opis
none	string
settings	string

CheckIssue

Problem (błąd, ostrzeżenie) skojarzony z konfiguracją sprawdzania.

Nazwa	Typ	Opis
description	string	Krótkie podsumowanie sprawdzania — jego nazwa i zasób.
detailedMessage	string	Bardziej szczegółowy opis problemu.
message	string	Opis problemu.
type	CheckIssueType	Typ (błąd, ostrzeżenie) problemu.

CheckIssueType

Typ (błąd, ostrzeżenie) problemu.

Nazwa	Typ	Opis
error	string
warning	string

CheckType

Nazwa	Typ	Opis
id	string	Pobiera lub ustawia identyfikator typu sprawdzania.
name	string	Nazwa typu sprawdzania.

IdentityRef

Nazwa	Typ	Opis
_links	ReferenceLinks	To pole zawiera zero lub więcej interesujących linków dotyczących tematu grafu. Te linki mogą być wywoływane w celu uzyskania dodatkowych relacji lub bardziej szczegółowych informacji na temat tego tematu grafu.
descriptor	string	Deskryptor jest podstawowym sposobem odwołowania się do tematu grafu podczas działania systemu. To pole będzie jednoznacznie identyfikować ten sam temat grafu zarówno w ramach kont, jak i organizacji.
directoryAlias	string	Przestarzałe — można pobrać, wysyłając zapytanie do użytkownika programu Graph przywoływanego w wpisie "self" słownika IdentityRef "_links"
displayName	string	Jest to unikatowa nazwa wyświetlana tematu grafu. Aby zmienić to pole, musisz zmienić jego wartość u dostawcy źródłowego.
id	string
imageUrl	string	Przestarzałe — dostępne w wpisie "avatar" słownika IdentityRef "_links"
inactive	boolean	Przestarzałe — można pobrać, wysyłając zapytanie do stanu członkostwa programu Graph, do których odwołuje się wpis "membershipState" słownika GraphUser "_links"
isAadIdentity	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Przestarzałe — nie jest używane w większości istniejących implementacji toIdentityRef
uniqueName	string	Przestarzałe — zamiast tego użyj nazwy Domain+PrincipalName
url	string	Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Czytelny widok linków. Ponieważ linki referencyjne są czytelne, chcemy uwidocznić je tylko jako tylko do odczytu.

Resource

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
type	string	Typ zasobu.

Udostępnij za pośrednictwem