Azure DevOps Orgs - List Available

Referentie

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

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


/**
 * Samples for AzureDevOpsOrgs ListAvailable.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/stable/2024-04-01/examples/SecurityConnectorsDevOps/
     * ListAvailableAzureDevOpsOrgs_example.json
     */
    /**
     * Sample code: ListAvailable_AzureDevOpsOrgs.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void listAvailableAzureDevOpsOrgs(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.azureDevOpsOrgs().listAvailableWithResponse("myRg", "mySecurityConnectorName",
            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

from azure.identity import DefaultAzureCredential

from azure.mgmt.security import SecurityCenter

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-security
# USAGE
    python list_available_azure_dev_ops_orgs_example.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SecurityCenter(
        credential=DefaultAzureCredential(),
        subscription_id="0806e1cd-cfda-4ff8-b99c-2b0af42cffd3",
    )

    response = client.azure_dev_ops_orgs.list_available(
        resource_group_name="myRg",
        security_connector_name="mySecurityConnectorName",
    )
    print(response)


# x-ms-original-file: specification/security/resource-manager/Microsoft.Security/stable/2024-04-01/examples/SecurityConnectorsDevOps/ListAvailableAzureDevOpsOrgs_example.json
if __name__ == "__main__":
    main()

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

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

Inventarisatie

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

Waarde	Description
Disabled
Enabled
None

AnnotateDefaultBranchState

Inventarisatie

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. Ex - /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

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
Application
Key
ManagedIdentity
User

DevOpsProvisioningState

Inventarisatie

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
Canceled
DeletionFailure
DeletionSuccess
Failed
Pending
PendingDeletion
Succeeded

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

Inventarisatie

Instellingen bijwerken.

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

Waarde	Description
Disabled
Enabled

OnboardingState

Inventarisatie

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
NotOnboarded
Onboarded
OnboardedByOtherConnector

RuleCategory

Inventarisatie

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
Artifacts
Code
Containers
Dependencies
IaC
Secrets

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.

Delen via

Azure DevOps Orgs - List Available

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

ListAvailable_AzureDevOpsOrgs

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsOrg

AzureDevOpsOrgListResponse

AzureDevOpsOrgProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration

Aanvullende resources