Azure DevOps Projects - List

Layanan:: Defender for Cloud

Versi API:: 2024-04-01

Mengembalikan daftar proyek Azure DevOps yang di-onboard ke konektor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects?api-version=2024-04-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
orgName	path	True	string	Nama organisasi Azure DevOps.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.
securityConnectorName	path	True	string	Nama konektor keamanan.
subscriptionId	path	True	string minLength: 1	ID langganan target.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	AzureDevOpsProjectListResponse	Menyediakan daftar detail proyek Azure DevOps
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

List_AzureDevOpsProjects

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects?api-version=2024-04-01

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "properties": {
        "parentOrgName": "myAzDevOpsOrg",
        "projectId": "9ebbed8f-a9cc-405f-a647-b235e22179de",
        "onboardingState": "Onboarded",
        "actionableRemediation": {
          "state": "Enabled"
        },
        "provisioningState": "Succeeded"
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject",
      "name": "myAzDevOpsProject",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects"
    }
  ]
}

Definisi

Nama	Deskripsi
ActionableRemediation	Payload konfigurasi untuk Anotasi PR.
ActionableRemediationState	Pengaturan ActionableRemediation. Tidak ada - pengaturan tidak pernah diatur. Diaktifkan - ActionableRemediation diaktifkan. Dinonaktifkan - ActionableRemediation dinonaktifkan.
AnnotateDefaultBranchState	Konfigurasi Anotasi PR pada cabang default. Diaktifkan - Anotasi PR diaktifkan pada cabang default sumber daya. Dinonaktifkan - Anotasi PR dinonaktifkan pada cabang default sumber daya.
AzureDevOpsProject	Sumber daya Proyek Azure DevOps.
AzureDevOpsProjectListResponse	Daftar sumber daya RP yang mendukung penomoran halaman.
AzureDevOpsProjectProperties	Properti Proyek Azure DevOps.
CategoryConfiguration	Tingkat keparahan per konfigurasi kategori untuk Anotasi PR.
createdByType	Jenis identitas yang membuat sumber daya.
DevOpsProvisioningState	Status provisi sumber daya. Tertunda - Provisi tertunda. Gagal - Penyediaan gagal. Berhasil - Provisi berhasil. Dibatalkan - Provisi dibatalkan. PendingDeletion - Penghapusan tertunda. DeletionSuccess - Penghapusan berhasil. DeletionFailure - Kegagalan penghapusan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
InheritFromParentState	Perbarui Pengaturan. Diaktifkan - Sumber daya harus mewarisi konfigurasi dari induk. Dinonaktifkan - Sumber daya tidak boleh mewarisi konfigurasi dari induk.
OnboardingState	Detail tentang status onboarding sumber daya di semua konektor. OnboardedByOtherConnector - sumber daya ini telah di-onboard ke konektor lain. Ini hanya berlaku untuk sumber daya tingkat atas. Onboarded - sumber daya ini telah di-onboard oleh konektor yang ditentukan. NotOnboarded - sumber daya ini belum di-onboard ke konektor apa pun. NotApplicable - status onboarding tidak berlaku untuk titik akhir saat ini.
RuleCategory	Kategori aturan. Kode - hasil pemindaian kode. Hasil pemindaian artefak. Hasil pemindaian dependensi. Hasil IaC. Hasil pemindaian rahasia. Hasil pemindaian kontainer.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
TargetBranchConfiguration	Konfigurasi cabang repositori untuk Anotasi PR.

ActionableRemediation

Objek

Payload konfigurasi untuk Anotasi PR.

Nama	Jenis	Deskripsi
branchConfiguration	TargetBranchConfiguration	Konfigurasi cabang repositori untuk Anotasi PR.
categoryConfigurations	CategoryConfiguration[]	Mendapatkan atau menetapkan daftar kategori dan tingkat keparahan.
inheritFromParentState	InheritFromParentState	Perbarui Pengaturan. Diaktifkan - Sumber daya harus mewarisi konfigurasi dari induk. Dinonaktifkan - Sumber daya tidak boleh mewarisi konfigurasi dari induk.
state	ActionableRemediationState	Pengaturan ActionableRemediation. Tidak ada - pengaturan tidak pernah diatur. Diaktifkan - ActionableRemediation diaktifkan. Dinonaktifkan - ActionableRemediation dinonaktifkan.

ActionableRemediationState

Enumerasi

Pengaturan ActionableRemediation. Tidak ada - pengaturan tidak pernah diatur. Diaktifkan - ActionableRemediation diaktifkan. Dinonaktifkan - ActionableRemediation dinonaktifkan.

Nilai	Deskripsi
None
Disabled
Enabled

AnnotateDefaultBranchState

Enumerasi

Konfigurasi Anotasi PR pada cabang default.

Diaktifkan - Anotasi PR diaktifkan pada cabang default sumber daya. Dinonaktifkan - Anotasi PR dinonaktifkan pada cabang default sumber daya.

Nilai	Deskripsi
Disabled
Enabled

AzureDevOpsProject

Objek

Sumber daya Proyek Azure DevOps.

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya
properties	AzureDevOpsProjectProperties	Properti Proyek Azure DevOps.
systemData	systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

AzureDevOpsProjectListResponse

Objek

Daftar sumber daya RP yang mendukung penomoran halaman.

Nama	Jenis	Deskripsi
nextLink	string	Mendapatkan atau mengatur tautan berikutnya untuk menggulir hasil.
value	AzureDevOpsProject[]	Mendapatkan atau menetapkan daftar sumber daya.

AzureDevOpsProjectProperties

Objek

Properti Proyek Azure DevOps.

Nama	Jenis	Deskripsi
actionableRemediation	ActionableRemediation	Payload konfigurasi untuk Anotasi PR.
onboardingState	OnboardingState	Detail tentang status onboarding sumber daya di semua konektor. OnboardedByOtherConnector - sumber daya ini telah di-onboard ke konektor lain. Ini hanya berlaku untuk sumber daya tingkat atas. Onboarded - sumber daya ini telah di-onboard oleh konektor yang ditentukan. NotOnboarded - sumber daya ini belum di-onboard ke konektor apa pun. NotApplicable - status onboarding tidak berlaku untuk titik akhir saat ini.
parentOrgName	string	Mendapatkan atau mengatur nama Organisasi Azure DevOps induk.
projectId	string	Mendapatkan atau mengatur id Proyek Azure DevOps.
provisioningState	DevOpsProvisioningState	Status provisi sumber daya. Tertunda - Provisi tertunda. Gagal - Penyediaan gagal. Berhasil - Provisi berhasil. Dibatalkan - Provisi dibatalkan. PendingDeletion - Penghapusan tertunda. DeletionSuccess - Penghapusan berhasil. DeletionFailure - Kegagalan penghapusan.
provisioningStatusMessage	string	Mendapatkan atau mengatur pesan status sumber daya.
provisioningStatusUpdateTimeUtc	string (date-time)	Mendapatkan atau mengatur waktu ketika sumber daya terakhir diperiksa.

CategoryConfiguration

Objek

Tingkat keparahan per konfigurasi kategori untuk Anotasi PR.

Nama	Jenis	Deskripsi
category	RuleCategory	Kategori aturan. Kode - hasil pemindaian kode. Hasil pemindaian artefak. Hasil pemindaian dependensi. Hasil IaC. Hasil pemindaian rahasia. Hasil pemindaian kontainer.
minimumSeverityLevel	string	Mendapatkan atau menetapkan tingkat keparahan minimum untuk kategori tertentu.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DevOpsProvisioningState

Enumerasi

Status provisi sumber daya.

Tertunda - Provisi tertunda. Gagal - Penyediaan gagal. Berhasil - Provisi berhasil. Dibatalkan - Provisi dibatalkan. PendingDeletion - Penghapusan tertunda. DeletionSuccess - Penghapusan berhasil. DeletionFailure - Kegagalan penghapusan.

Nilai	Deskripsi
Succeeded
Failed
Canceled
Pending
PendingDeletion
DeletionSuccess
DeletionFailure

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

InheritFromParentState

Enumerasi

Perbarui Pengaturan.

Diaktifkan - Sumber daya harus mewarisi konfigurasi dari induk. Dinonaktifkan - Sumber daya tidak boleh mewarisi konfigurasi dari induk.

Nilai	Deskripsi
Disabled
Enabled

OnboardingState

Enumerasi

Detail tentang status onboarding sumber daya di semua konektor.

OnboardedByOtherConnector - sumber daya ini telah di-onboard ke konektor lain. Ini hanya berlaku untuk sumber daya tingkat atas. Onboarded - sumber daya ini telah di-onboard oleh konektor yang ditentukan. NotOnboarded - sumber daya ini belum di-onboard ke konektor apa pun. NotApplicable - status onboarding tidak berlaku untuk titik akhir saat ini.

Nilai	Deskripsi
NotApplicable
OnboardedByOtherConnector
Onboarded
NotOnboarded

RuleCategory

Enumerasi

Kategori aturan. Kode - hasil pemindaian kode. Hasil pemindaian artefak. Hasil pemindaian dependensi. Hasil IaC. Hasil pemindaian rahasia. Hasil pemindaian kontainer.

Nilai	Deskripsi
Code
Artifacts
Dependencies
Secrets
IaC
Containers

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

TargetBranchConfiguration

Objek

Konfigurasi cabang repositori untuk Anotasi PR.

Nama	Jenis	Deskripsi
annotateDefaultBranch	AnnotateDefaultBranchState	Konfigurasi Anotasi PR pada cabang default. Diaktifkan - Anotasi PR diaktifkan pada cabang default sumber daya. Dinonaktifkan - Anotasi PR dinonaktifkan pada cabang default sumber daya.
branchNames	string[]	Mendapatkan atau mengatur cabang yang harus memiliki anotasi.

Nama

Jenis

Deskripsi

annotateDefaultBranch

AnnotateDefaultBranchState

Konfigurasi Anotasi PR pada cabang default.

Diaktifkan - Anotasi PR diaktifkan pada cabang default sumber daya. Dinonaktifkan - Anotasi PR dinonaktifkan pada cabang default sumber daya.

branchNames

string[]

Mendapatkan atau mengatur cabang yang harus memiliki anotasi.

Bagikan melalui

Azure DevOps Projects - List

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

List_AzureDevOpsProjects

Permintaan sampel

Respon sampel

Definisi

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsProject

AzureDevOpsProjectListResponse

AzureDevOpsProjectProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration