Azure DevOps Orgs - List Available

Service:: Defender for Cloud

API-versie:: 2024-04-01

Retourneert een lijst met alle Azure DevOps-organisaties die toegankelijk zijn voor het gebruikerstoken dat door de connector wordt gebruikt.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
securityConnectorName	path	True	string	De naam van de beveiligingsconnector.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	AzureDevOpsOrgListResponse	Bevat een lijst met details van de Azure DevOps-organisatie
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ListAvailable_AzureDevOpsOrgs

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "properties": {
        "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",
      "name": "myAzDevOpsOrg",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
    },
    {
      "properties": {
        "onboardingState": "OnboardedByOtherConnector",
        "actionableRemediation": {
          "state": "Enabled"
        },
        "provisioningState": "Succeeded"
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/anotherOrg",
      "name": "anotherOrg",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
    },
    {
      "properties": {
        "onboardingState": "NotOnboarded",
        "actionableRemediation": {
          "state": "None"
        }
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/notOnboardedOrg",
      "name": "notOnboardedOrg",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
    }
  ]
}

Definities

Name	Description
ActionableRemediation	Nettolading van configuratie voor PR-aantekeningen.
ActionableRemediationState	ActionableRemediation-instelling. Geen- de instelling is nooit ingesteld. Ingeschakeld : ActionableRemediation is ingeschakeld. Uitgeschakeld - ActionableRemediation is uitgeschakeld.
AnnotateDefaultBranchState	Configuratie van PR-aantekeningen in de standaardbranch. Ingeschakeld- PR-aantekeningen zijn ingeschakeld voor de standaardvertakking van de resource. Uitgeschakeld- PR-aantekeningen worden uitgeschakeld in de standaardvertakking van de resource.
AzureDevOpsOrg	Azure DevOps Organization-resource.
AzureDevOpsOrgListResponse	Lijst met RP-resources die paginering ondersteunen.
AzureDevOpsOrgProperties	Eigenschappen van Azure DevOps Organization.
CategoryConfiguration	Ernstniveau per categorieconfiguratie voor PR-aantekeningen.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DevOpsProvisioningState	De inrichtingsstatus van de resource. In behandeling : inrichting in behandeling. Mislukt: inrichten is mislukt. Geslaagd: geslaagde inrichting. Geannuleerd : inrichting geannuleerd. PendingDeletion - Verwijdering in behandeling. DeletionSuccess - Verwijderen is geslaagd. DeletionFailure - Verwijderingsfout.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
InheritFromParentState	Instellingen bijwerken. Ingeschakeld: resource moet configuraties overnemen van bovenliggend item. Uitgeschakeld: resource mag geen configuraties overnemen van bovenliggend item.
OnboardingState	Details over de onboardingstatus van resources voor alle connectors. OnboardedByOtherConnector: deze resource is al geïmplementeerd voor een andere connector. Dit is alleen van toepassing op resources op het hoogste niveau. Onboarded: deze resource is al ge onboarded door de opgegeven connector. NotOnboarded: deze resource is niet ge onboarded naar een connector. NotApplicable: de onboardingstatus is niet van toepassing op het huidige eindpunt.
RuleCategory	Regelcategorieën. Code- scanresultaten van code. Resultaten van het scannen van artefacten. Resultaten van het scannen van afhankelijkheden. IaC-resultaten. Geheimen scannen resultaten. Scanresultaten van containers.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
TargetBranchConfiguration	Configuratie van opslagplaatsbranch voor PR-aantekeningen.

ActionableRemediation

Object

Nettolading van configuratie voor PR-aantekeningen.

Name	Type	Description
branchConfiguration	TargetBranchConfiguration	Configuratie van opslagplaatsbranch voor PR-aantekeningen.
categoryConfigurations	CategoryConfiguration[]	Hiermee haalt u een lijst met categorieën en ernstniveaus op of stelt u deze in.
inheritFromParentState	InheritFromParentState	Instellingen bijwerken. Ingeschakeld: resource moet configuraties overnemen van bovenliggend item. Uitgeschakeld: resource mag geen configuraties overnemen van bovenliggend item.
state	ActionableRemediationState	ActionableRemediation-instelling. Geen- de instelling is nooit ingesteld. Ingeschakeld : ActionableRemediation is ingeschakeld. Uitgeschakeld - ActionableRemediation is uitgeschakeld.

ActionableRemediationState

Opsomming

ActionableRemediation-instelling. Geen- de instelling is nooit ingesteld. Ingeschakeld : ActionableRemediation is ingeschakeld. Uitgeschakeld - ActionableRemediation is uitgeschakeld.

Waarde	Description
None
Disabled
Enabled

AnnotateDefaultBranchState

Opsomming

Configuratie van PR-aantekeningen in de standaardbranch.

Ingeschakeld- PR-aantekeningen zijn ingeschakeld voor de standaardvertakking van de resource. Uitgeschakeld- PR-aantekeningen worden uitgeschakeld in de standaardvertakking van de resource.

Waarde	Description
Disabled
Enabled

AzureDevOpsOrg

Object

Azure DevOps Organization-resource.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	De naam van de resource
properties	AzureDevOpsOrgProperties	Eigenschappen van Azure DevOps Organization.
systemData	systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

AzureDevOpsOrgListResponse

Object

Lijst met RP-resources die paginering ondersteunen.

Name	Type	Description
nextLink	string	Hiermee haalt u de volgende koppeling op of stelt u deze in om over de resultaten te schuiven.
value	AzureDevOpsOrg[]	Hiermee haalt u een lijst met resources op of stelt u deze in.

AzureDevOpsOrgProperties

Object

Eigenschappen van Azure DevOps Organization.

Name	Type	Description
actionableRemediation	ActionableRemediation	Nettolading van configuratie voor PR-aantekeningen.
onboardingState	OnboardingState	Details over de onboardingstatus van resources voor alle connectors. OnboardedByOtherConnector: deze resource is al geïmplementeerd voor een andere connector. Dit is alleen van toepassing op resources op het hoogste niveau. Onboarded: deze resource is al ge onboarded door de opgegeven connector. NotOnboarded: deze resource is niet ge onboarded naar een connector. NotApplicable: de onboardingstatus is niet van toepassing op het huidige eindpunt.
provisioningState	DevOpsProvisioningState	De inrichtingsstatus van de resource. In behandeling : inrichting in behandeling. Mislukt: inrichten is mislukt. Geslaagd: geslaagde inrichting. Geannuleerd : inrichting geannuleerd. PendingDeletion - Verwijdering in behandeling. DeletionSuccess - Verwijderen is geslaagd. DeletionFailure - Verwijderingsfout.
provisioningStatusMessage	string	Hiermee wordt het bericht over de resourcestatus ophaalt of ingesteld.
provisioningStatusUpdateTimeUtc	string (date-time)	Hiermee haalt u de tijd op waarop de resource voor het laatst is gecontroleerd.

CategoryConfiguration

Object

Ernstniveau per categorieconfiguratie voor PR-aantekeningen.

Name	Type	Description
category	RuleCategory	Regelcategorieën. Code- scanresultaten van code. Resultaten van het scannen van artefacten. Resultaten van het scannen van afhankelijkheden. IaC-resultaten. Geheimen scannen resultaten. Scanresultaten van containers.
minimumSeverityLevel	string	Hiermee haalt u het minimale ernstniveau voor een bepaalde categorie op of stelt u dit in.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DevOpsProvisioningState

Opsomming

De inrichtingsstatus van de resource.

In behandeling : inrichting in behandeling. Mislukt: inrichten is mislukt. Geslaagd: geslaagde inrichting. Geannuleerd : inrichting geannuleerd. PendingDeletion - Verwijdering in behandeling. DeletionSuccess - Verwijderen is geslaagd. DeletionFailure - Verwijderingsfout.

Waarde	Description
Succeeded
Failed
Canceled
Pending
PendingDeletion
DeletionSuccess
DeletionFailure

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

InheritFromParentState

Opsomming

Instellingen bijwerken.

Ingeschakeld: resource moet configuraties overnemen van bovenliggend item. Uitgeschakeld: resource mag geen configuraties overnemen van bovenliggend item.

Waarde	Description
Disabled
Enabled

OnboardingState

Opsomming

Details over de onboardingstatus van resources voor alle connectors.

OnboardedByOtherConnector: deze resource is al geïmplementeerd voor een andere connector. Dit is alleen van toepassing op resources op het hoogste niveau. Onboarded: deze resource is al ge onboarded door de opgegeven connector. NotOnboarded: deze resource is niet ge onboarded naar een connector. NotApplicable: de onboardingstatus is niet van toepassing op het huidige eindpunt.

Waarde	Description
NotApplicable
OnboardedByOtherConnector
Onboarded
NotOnboarded

RuleCategory

Opsomming

Regelcategorieën. Code- scanresultaten van code. Resultaten van het scannen van artefacten. Resultaten van het scannen van afhankelijkheden. IaC-resultaten. Geheimen scannen resultaten. Scanresultaten van containers.

Waarde	Description
Code
Artifacts
Dependencies
Secrets
IaC
Containers

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

TargetBranchConfiguration

Object

Configuratie van opslagplaatsbranch voor PR-aantekeningen.

Name	Type	Description
annotateDefaultBranch	AnnotateDefaultBranchState	Configuratie van PR-aantekeningen in de standaardbranch. Ingeschakeld- PR-aantekeningen zijn ingeschakeld voor de standaardvertakking van de resource. Uitgeschakeld- PR-aantekeningen worden uitgeschakeld in de standaardvertakking van de resource.
branchNames	string[]	Hiermee haalt u vertakkingen op die aantekeningen moeten bevatten of stelt u deze in.

Name

Type

Description

annotateDefaultBranch

AnnotateDefaultBranchState

Configuratie van PR-aantekeningen in de standaardbranch.

Ingeschakeld- PR-aantekeningen zijn ingeschakeld voor de standaardvertakking van de resource. Uitgeschakeld- PR-aantekeningen worden uitgeschakeld in de standaardvertakking van de resource.

branchNames

string[]

Hiermee haalt u vertakkingen op die aantekeningen moeten bevatten of stelt u deze in.