Azure DevOps Repos - List

Ссылка

Служба:: Defender for Cloud

Версия API:: 2024-05-15-preview

Возвращает список репозиториев Azure DevOps, подключенных к соединителю.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
orgName	path	True	string	Имя организации Azure DevOps.
projectName	path	True	string	Имя проекта.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не учитывает регистр.
securityConnectorName	path	True	string	Имя соединителя безопасности.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
api-version	query	True	string minLength: 1	Версия API, используемая для этой операции.

Ответы

Имя	Тип	Описание
200 OK	AzureDevOpsRepositoryListResponse	Содержит список сведений о репозитории Azure DevOps
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

List_AzureDevOpsRepos

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


/**
 * Samples for AzureDevOpsRepos List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/ListAzureDevOpsRepos_example.json
     */
    /**
     * Sample code: List_AzureDevOpsRepos.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listAzureDevOpsRepos(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.azureDevOpsRepos().list("myRg", "mySecurityConnectorName", "myAzDevOpsOrg", "myAzDevOpsProject",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "properties": {
        "parentOrgName": "myAzDevOpsOrg",
        "parentProjectName": "myAzDevOpsProject",
        "repoId": "cb64ab91-c9ba-46df-b44c-c769358bccdf",
        "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/repos/myAzDevOpsRepo",
      "name": "myAzDevOpsRepo",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs/projects/repos"
    }
  ]
}

Определения

Имя	Описание
ActionableRemediation	Полезные данные конфигурации для заметок pr.
ActionableRemediationState	Параметр ActionableRemediation. Нет — параметр никогда не был задан. Включено . ActionableRemediation включен. Отключено — ActionableRemediation отключен.
AnnotateDefaultBranchState	Настройка заметок PR в ветви по умолчанию. Включено. Заметки pr включены в ветви ресурса по умолчанию. Отключены— заметки pr отключены в ветви ресурса по умолчанию.
AzureDevOpsRepository	Ресурс репозитория Azure DevOps.
AzureDevOpsRepositoryListResponse	Список ресурсов RP, поддерживающих разбиение на страницы.
AzureDevOpsRepositoryProperties	Свойства репозитория Azure DevOps.
CategoryConfiguration	Уровень серьезности для конфигурации категории для заметок PR.
createdByType	Тип удостоверения, создавшего ресурс.
DevOpsProvisioningState	Состояние подготовки ресурса. Ожидание — ожидание подготовки. Сбой — сбой подготовки. Успешно выполнено — успешная подготовка. Отменено . Подготовка отменена. PendingDeletion — ожидание удаления. УдалениеSuccess — удаление успешно. УдалениеFailure — сбой удаления.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
InheritFromParentState	Параметры обновления. Включено. Ресурс должен наследовать конфигурации от родительского элемента. Отключен. Ресурс не должен наследовать конфигурации от родительского элемента.
OnboardingState	Сведения о состоянии подключения ресурсов во всех соединителях. ПодключениеByOtherConnector — этот ресурс уже подключен к другому соединителю. Это применимо только к ресурсам верхнего уровня. Подключен — этот ресурс уже подключен указанным соединителем. NotOnboarded — этот ресурс не был подключен к любому соединителю. NotApplicable — состояние подключения неприменимо к текущей конечной точке.
RuleCategory	Категории правил. Код — результаты сканирования кода. Результаты сканирования артефактов. Результаты сканирования зависимостей. Результаты IaC. Результаты сканирования секретов. Результаты сканирования контейнеров.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
TargetBranchConfiguration	Конфигурация ветви репозитория для заметок pr.

ActionableRemediation

Object

Полезные данные конфигурации для заметок pr.

Имя	Тип	Описание
branchConfiguration	TargetBranchConfiguration	Конфигурация ветви репозитория для заметок pr.
categoryConfigurations	CategoryConfiguration[]	Возвращает или задает список категорий и уровней серьезности.
inheritFromParentState	InheritFromParentState	Параметры обновления. Включено. Ресурс должен наследовать конфигурации от родительского элемента. Отключен. Ресурс не должен наследовать конфигурации от родительского элемента.
state	ActionableRemediationState	Параметр ActionableRemediation. Нет — параметр никогда не был задан. Включено . ActionableRemediation включен. Отключено — ActionableRemediation отключен.

ActionableRemediationState

Перечисление

Параметр ActionableRemediation. Нет — параметр никогда не был задан. Включено . ActionableRemediation включен. Отключено — ActionableRemediation отключен.

Значение	Описание
Disabled
Enabled
None

AnnotateDefaultBranchState

Перечисление

Настройка заметок PR в ветви по умолчанию.

Включено. Заметки pr включены в ветви ресурса по умолчанию. Отключены— заметки pr отключены в ветви ресурса по умолчанию.

Значение	Описание
Disabled
Enabled

AzureDevOpsRepository

Object

Ресурс репозитория Azure DevOps.

Имя	Тип	Описание
id	string	Полный идентификатор ресурса для ресурса. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Имя ресурса
properties	AzureDevOpsRepositoryProperties	Свойства репозитория Azure DevOps.
systemData	systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

AzureDevOpsRepositoryListResponse

Object

Список ресурсов RP, поддерживающих разбиение на страницы.

Имя	Тип	Описание
nextLink	string	Возвращает или задает следующую ссылку, чтобы прокрутить результаты.
value	AzureDevOpsRepository[]	Возвращает или задает список ресурсов.

AzureDevOpsRepositoryProperties

Object

Свойства репозитория Azure DevOps.

Имя	Тип	Описание
actionableRemediation	ActionableRemediation	Полезные данные конфигурации для заметок pr.
onboardingState	OnboardingState	Сведения о состоянии подключения ресурсов во всех соединителях. ПодключениеByOtherConnector — этот ресурс уже подключен к другому соединителю. Это применимо только к ресурсам верхнего уровня. Подключен — этот ресурс уже подключен указанным соединителем. NotOnboarded — этот ресурс не был подключен к любому соединителю. NotApplicable — состояние подключения неприменимо к текущей конечной точке.
parentOrgName	string	Возвращает или задает родительское имя организации Azure DevOps.
parentProjectName	string	Возвращает или задает родительское имя проекта Azure DevOps.
provisioningState	DevOpsProvisioningState	Состояние подготовки ресурса. Ожидание — ожидание подготовки. Сбой — сбой подготовки. Успешно выполнено — успешная подготовка. Отменено . Подготовка отменена. PendingDeletion — ожидание удаления. УдалениеSuccess — удаление успешно. УдалениеFailure — сбой удаления.
provisioningStatusMessage	string	Возвращает сообщение о состоянии ресурса.
provisioningStatusUpdateTimeUtc	string (date-time)	Возвращает время последнего проверки ресурса.
repoId	string	Возвращает или задает идентификатор репозитория Azure DevOps.
repoUrl	string	Возвращает или задает URL-адрес репозитория Azure DevOps.
visibility	string	Возвращает или задает видимость репозитория Azure DevOps, будь то общедоступная или частная и т. д.

CategoryConfiguration

Object

Уровень серьезности для конфигурации категории для заметок PR.

Имя	Тип	Описание
category	RuleCategory	Категории правил. Код — результаты сканирования кода. Результаты сканирования артефактов. Результаты сканирования зависимостей. Результаты IaC. Результаты сканирования секретов. Результаты сканирования контейнеров.
minimumSeverityLevel	string	Возвращает или задает минимальный уровень серьезности для данной категории.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
Application
Key
ManagedIdentity
User

DevOpsProvisioningState

Перечисление

Состояние подготовки ресурса.

Ожидание — ожидание подготовки. Сбой — сбой подготовки. Успешно выполнено — успешная подготовка. Отменено . Подготовка отменена. PendingDeletion — ожидание удаления. УдалениеSuccess — удаление успешно. УдалениеFailure — сбой удаления.

Значение	Описание
Canceled
DeletionFailure
DeletionSuccess
Failed
Pending
PendingDeletion
Succeeded

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

InheritFromParentState

Перечисление

Параметры обновления.

Включено. Ресурс должен наследовать конфигурации от родительского элемента. Отключен. Ресурс не должен наследовать конфигурации от родительского элемента.

Значение	Описание
Disabled
Enabled

OnboardingState

Перечисление

Сведения о состоянии подключения ресурсов во всех соединителях.

ПодключениеByOtherConnector — этот ресурс уже подключен к другому соединителю. Это применимо только к ресурсам верхнего уровня. Подключен — этот ресурс уже подключен указанным соединителем. NotOnboarded — этот ресурс не был подключен к любому соединителю. NotApplicable — состояние подключения неприменимо к текущей конечной точке.

Значение	Описание
NotApplicable
NotOnboarded
Onboarded
OnboardedByOtherConnector

RuleCategory

Перечисление

Категории правил. Код — результаты сканирования кода. Результаты сканирования артефактов. Результаты сканирования зависимостей. Результаты IaC. Результаты сканирования секретов. Результаты сканирования контейнеров.

Значение	Описание
Artifacts
Code
Containers
Dependencies
IaC
Secrets

systemData

Object

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

TargetBranchConfiguration

Object

Конфигурация ветви репозитория для заметок pr.

Имя	Тип	Описание
annotateDefaultBranch	AnnotateDefaultBranchState	Настройка заметок PR в ветви по умолчанию. Включено. Заметки pr включены в ветви ресурса по умолчанию. Отключены— заметки pr отключены в ветви ресурса по умолчанию.
branchNames	string[]	Возвращает или задает ветви, которые должны содержать заметки.

Имя

Тип

Описание

annotateDefaultBranch

AnnotateDefaultBranchState

Настройка заметок PR в ветви по умолчанию.

branchNames

string[]

Возвращает или задает ветви, которые должны содержать заметки.

Поделиться через

Azure DevOps Repos - List

Параметры URI

Ответы

Безопасность

azure_auth

Области

Примеры

List_AzureDevOpsRepos

Образец запроса

Пример ответа

Определения

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsRepository

AzureDevOpsRepositoryListResponse

AzureDevOpsRepositoryProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration

Дополнительные ресурсы