Compartir a través de


Azure DevOps Repos - List

Devuelve una lista de repositorios de Azure DevOps incorporados al conector.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
orgName
path True

string

Nombre de la organización de Azure DevOps.

projectName
path True

string

Nombre del proyecto.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.

securityConnectorName
path True

string

Nombre del conector de seguridad.

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Respuestas

Nombre Tipo Description
200 OK

AzureDevOpsRepositoryListResponse

Proporciona una lista de los detalles del repositorio de Azure DevOps.

Other Status Codes

ErrorResponse

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

List_AzureDevOpsRepos

Solicitud de ejemplo

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-04-01

Respuesta de muestra

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

Definiciones

Nombre Description
ActionableRemediation

Carga de configuración para anotaciones de solicitud de incorporación de cambios.

ActionableRemediationState

Valor actionableRemediation. Ninguno: la configuración nunca se estableció. Habilitado: ActionableRemediation está habilitado. Deshabilitado: ActionableRemediation está deshabilitado.

AnnotateDefaultBranchState

Configuración de anotaciones de solicitud de incorporación de cambios en la rama predeterminada.

Habilitado: las anotaciones de pr están habilitadas en la rama predeterminada del recurso. Deshabilitado: las anotaciones pr están deshabilitadas en la rama predeterminada del recurso.

AzureDevOpsRepository

Recurso del repositorio de Azure DevOps.

AzureDevOpsRepositoryListResponse

Lista de recursos de RP que admiten la paginación.

AzureDevOpsRepositoryProperties

Propiedades del repositorio de Azure DevOps.

CategoryConfiguration

Nivel de gravedad por configuración de categoría para anotaciones de solicitud de incorporación de cambios.

createdByType

Tipo de identidad que creó el recurso.

DevOpsProvisioningState

Estado de aprovisionamiento del recurso.

Pendiente: aprovisionamiento pendiente. Error: error de aprovisionamiento. Correcto: aprovisionamiento correcto. Cancelado: aprovisionamiento cancelado. PendienteDeletion: eliminación pendiente. DeletionSuccess: eliminación correcta. DeletionFailure: error de eliminación.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

InheritFromParentState

Actualizar configuración.

Habilitado: el recurso debe heredar las configuraciones de los elementos primarios. Deshabilitado: el recurso no debe heredar configuraciones del elemento primario.

OnboardingState

Detalles sobre el estado de incorporación de recursos en todos los conectores.

OnboardedByOtherConnector: este recurso ya se ha incorporado a otro conector. Esto solo es aplicable a los recursos de nivel superior. Incorporado: el conector especificado ya ha incorporado este recurso. NotOnboarded: este recurso no se ha incorporado a ningún conector. NotApplicable: el estado de incorporación no es aplicable al punto de conexión actual.

RuleCategory

Categorías de reglas. Código: resultados de análisis de código. Resultados del examen de artefactos. Resultados del examen de dependencias. Resultados de IaC. Resultados del examen de secretos. Resultados del examen de contenedores.

systemData

Metadatos relativos a la creación y última modificación del recurso.

TargetBranchConfiguration

Configuración de la rama de repositorio para anotaciones de solicitud de incorporación de cambios.

ActionableRemediation

Carga de configuración para anotaciones de solicitud de incorporación de cambios.

Nombre Tipo Description
branchConfiguration

TargetBranchConfiguration

Configuración de la rama de repositorio para anotaciones de solicitud de incorporación de cambios.

categoryConfigurations

CategoryConfiguration[]

Obtiene o establece la lista de categorías y niveles de gravedad.

inheritFromParentState

InheritFromParentState

Actualizar configuración.

Habilitado: el recurso debe heredar las configuraciones de los elementos primarios. Deshabilitado: el recurso no debe heredar configuraciones del elemento primario.

state

ActionableRemediationState

Valor actionableRemediation. Ninguno: la configuración nunca se estableció. Habilitado: ActionableRemediation está habilitado. Deshabilitado: ActionableRemediation está deshabilitado.

ActionableRemediationState

Valor actionableRemediation. Ninguno: la configuración nunca se estableció. Habilitado: ActionableRemediation está habilitado. Deshabilitado: ActionableRemediation está deshabilitado.

Valor Description
Disabled
Enabled
None

AnnotateDefaultBranchState

Configuración de anotaciones de solicitud de incorporación de cambios en la rama predeterminada.

Habilitado: las anotaciones de pr están habilitadas en la rama predeterminada del recurso. Deshabilitado: las anotaciones pr están deshabilitadas en la rama predeterminada del recurso.

Valor Description
Disabled
Enabled

AzureDevOpsRepository

Recurso del repositorio de Azure DevOps.

Nombre Tipo Description
id

string

Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso

properties

AzureDevOpsRepositoryProperties

Propiedades del repositorio de Azure DevOps.

systemData

systemData

Metadatos relativos a la creación y última modificación del recurso.

type

string

Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AzureDevOpsRepositoryListResponse

Lista de recursos de RP que admiten la paginación.

Nombre Tipo Description
nextLink

string

Obtiene o establece el vínculo siguiente para desplazarse por los resultados.

value

AzureDevOpsRepository[]

Obtiene o establece la lista de recursos.

AzureDevOpsRepositoryProperties

Propiedades del repositorio de Azure DevOps.

Nombre Tipo Description
actionableRemediation

ActionableRemediation

Carga de configuración para anotaciones de solicitud de incorporación de cambios.

onboardingState

OnboardingState

Detalles sobre el estado de incorporación de recursos en todos los conectores.

OnboardedByOtherConnector: este recurso ya se ha incorporado a otro conector. Esto solo es aplicable a los recursos de nivel superior. Incorporado: el conector especificado ya ha incorporado este recurso. NotOnboarded: este recurso no se ha incorporado a ningún conector. NotApplicable: el estado de incorporación no es aplicable al punto de conexión actual.

parentOrgName

string

Obtiene o establece el nombre primario de la organización de Azure DevOps.

parentProjectName

string

Obtiene o establece el nombre primario de Azure DevOps Project.

provisioningState

DevOpsProvisioningState

Estado de aprovisionamiento del recurso.

Pendiente: aprovisionamiento pendiente. Error: error de aprovisionamiento. Correcto: aprovisionamiento correcto. Cancelado: aprovisionamiento cancelado. PendienteDeletion: eliminación pendiente. DeletionSuccess: eliminación correcta. DeletionFailure: error de eliminación.

provisioningStatusMessage

string

Obtiene o establece el mensaje de estado del recurso.

provisioningStatusUpdateTimeUtc

string (date-time)

Obtiene o establece la hora en que se ha comprobado por última vez el recurso.

repoId

string

Obtiene o establece el identificador del repositorio de Azure DevOps.

repoUrl

string

Obtiene o establece la dirección URL del repositorio de Azure DevOps.

visibility

string

Obtiene o establece la visibilidad del repositorio de Azure DevOps, ya sea pública o privada, etc.

CategoryConfiguration

Nivel de gravedad por configuración de categoría para anotaciones de solicitud de incorporación de cambios.

Nombre Tipo Description
category

RuleCategory

Categorías de reglas. Código: resultados de análisis de código. Resultados del examen de artefactos. Resultados del examen de dependencias. Resultados de IaC. Resultados del examen de secretos. Resultados del examen de contenedores.

minimumSeverityLevel

string

Obtiene o establece el nivel de gravedad mínimo de una categoría determinada.

createdByType

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

DevOpsProvisioningState

Estado de aprovisionamiento del recurso.

Pendiente: aprovisionamiento pendiente. Error: error de aprovisionamiento. Correcto: aprovisionamiento correcto. Cancelado: aprovisionamiento cancelado. PendienteDeletion: eliminación pendiente. DeletionSuccess: eliminación correcta. DeletionFailure: error de eliminación.

Valor Description
Canceled
DeletionFailure
DeletionSuccess
Failed
Pending
PendingDeletion
Succeeded

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

Mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

InheritFromParentState

Actualizar configuración.

Habilitado: el recurso debe heredar las configuraciones de los elementos primarios. Deshabilitado: el recurso no debe heredar configuraciones del elemento primario.

Valor Description
Disabled
Enabled

OnboardingState

Detalles sobre el estado de incorporación de recursos en todos los conectores.

OnboardedByOtherConnector: este recurso ya se ha incorporado a otro conector. Esto solo es aplicable a los recursos de nivel superior. Incorporado: el conector especificado ya ha incorporado este recurso. NotOnboarded: este recurso no se ha incorporado a ningún conector. NotApplicable: el estado de incorporación no es aplicable al punto de conexión actual.

Valor Description
NotApplicable
NotOnboarded
Onboarded
OnboardedByOtherConnector

RuleCategory

Categorías de reglas. Código: resultados de análisis de código. Resultados del examen de artefactos. Resultados del examen de dependencias. Resultados de IaC. Resultados del examen de secretos. Resultados del examen de contenedores.

Valor Description
Artifacts
Code
Containers
Dependencies
IaC
Secrets

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

TargetBranchConfiguration

Configuración de la rama de repositorio para anotaciones de solicitud de incorporación de cambios.

Nombre Tipo Description
annotateDefaultBranch

AnnotateDefaultBranchState

Configuración de anotaciones de solicitud de incorporación de cambios en la rama predeterminada.

Habilitado: las anotaciones de pr están habilitadas en la rama predeterminada del recurso. Deshabilitado: las anotaciones pr están deshabilitadas en la rama predeterminada del recurso.

branchNames

string[]

Obtiene o establece ramas que deben tener anotaciones.