Check Configurations - Query

Başvuru

Service:: Approvals And Checks

API Version:: 7.1-preview.1

Kaynak türüne ve kimliğine göre birden çok kaynağın yapılandırmalarını denetleyin.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje Kimliği veya proje adı
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '7.1-preview.1' olarak ayarlanmalıdır.
$expand	query		CheckConfigurationExpandParameter	Denetim yapılandırmaları listesinde genişletilmesi gereken özellikler.

İstek Gövdesi

Name	Tür	Description
body	Resource[]	Kaynak listesi.

Yanıtlar

Name	Tür	Description
200 OK	CheckConfiguration[]	başarılı işlem

Güvenlik

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

Name	Description
vso.build	Derleme sonuçları, tanımlar ve istekler dahil olmak üzere derleme yapıtlarına erişme ve hizmet kancaları aracılığıyla derleme olayları hakkında bildirim alma olanağı verir.

Örnekler

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

Tanımlar

Name	Description
CheckConfiguration
CheckConfigurationExpandParameter	Denetim yapılandırmaları listesinde genişletilmesi gereken özellikler.
CheckIssue	Denetim yapılandırmasıyla ilişkili bir sorun (hata, uyarı).
CheckIssueType	Sorunun türü (hata, uyarı).
CheckType
IdentityRef
ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
Resource

CheckConfiguration

Name	Tür	Description
_links	ReferenceLinks	Başvuru bağlantıları.
createdBy	IdentityRef	Denetimi yapılandıran kişinin kimliği.
createdOn	string	Denetimin yapılandırıldığı zaman.
id	integer	Yapılandırma kimliğini denetleyin.
isDisabled	boolean	Denetim devre dışı bırakıldı.
issue	CheckIssue	Yapılandırmayı denetlemek için bağlı sorun.
modifiedBy	IdentityRef	Yapılandırılan denetimi değiştiren kişinin kimliği.
modifiedOn	string	Yapılandırılan denetimin değiştirildiği zaman.
resource	Resource	Denetimin yapılandırıldığı kaynak.
timeout	integer	Çek için dakika cinsinden zaman aşımı.
type	CheckType	Yapılandırma türünü denetleme
url	string	Yapılandırılan denetimi getirebileceği URL.

CheckConfigurationExpandParameter

Denetim yapılandırmaları listesinde genişletilmesi gereken özellikler.

Name	Tür	Description
none	string
settings	string

CheckIssue

Denetim yapılandırmasıyla ilişkili bir sorun (hata, uyarı).

Name	Tür	Description
description	string	Denetimin kısa özeti- adı ve kaynağı.
detailedMessage	string	Sorunun daha ayrıntılı bir açıklaması.
message	string	Sorunun açıklaması.
type	CheckIssueType	Sorunun türü (hata, uyarı).

CheckIssueType

Sorunun türü (hata, uyarı).

Name	Tür	Description
error	string
warning	string

CheckType

Name	Tür	Description
id	string	Denetim türü kimliğini alır veya ayarlar.
name	string	Denetim türünün adı.

IdentityRef

Name	Tür	Description
_links	ReferenceLinks	Bu alan, grafik konusuyla ilgili sıfır veya daha fazla ilgi çekici bağlantı içerir. Bu bağlantılar, bu grafik konusu hakkında ek ilişkiler veya daha ayrıntılı bilgi edinmek için çağrılabilir.
descriptor	string	Tanımlayıcı, sistem çalışırken graf konusuna başvurmanın birincil yoludur. Bu alan, hem Hesaplar hem de Kuruluşlar genelinde aynı graf konusunu benzersiz olarak tanımlar.
directoryAlias	string	Kullanım dışı - IdentityRef "_links" sözlüğündeki "self" girişinde başvuruda bulunılan Graph kullanıcısı sorgulanarak alınabilir
displayName	string	Bu, grafik konusunun benzersiz olmayan görünen adıdır. Bu alanı değiştirmek için kaynak sağlayıcıdaki değerini değiştirmeniz gerekir.
id	string
imageUrl	string	Kullanım dışı - IdentityRef "_links" sözlüğündeki "avatar" girişinde kullanılabilir
inactive	boolean	Kullanım dışı - GraphUser "_links" sözlüğündeki "membershipState" girdisinde başvurulan Graph üyelik durumu sorgulanarak alınabilir
isAadIdentity	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Kullanım dışı - Tanımlayıcının konu türünden çıkarılabilir (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Kullanım dışı - ToIdentityRef'in önceden var olan uygulamalarının çoğunda kullanımda değil
uniqueName	string	Kullanım dışı - bunun yerine Domain+PrincipalName kullanın
url	string	Bu URL, bu grafik konusunun kaynak kaynağına giden tam yoldur.

ReferenceLinks

REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

Resource

Name	Tür	Description
id	string	Kaynağın kimliği.
name	string	Kaynağın adı.
type	string	Kaynağın türü.

Aracılığıyla paylaş