Azure DevOps Orgs - List Available

Tjänst:: Defender for Cloud

API-versionen:: 2024-04-01

Returnerar en lista över alla Azure DevOps-organisationer som är tillgängliga via den användartoken som används av anslutningsappen.

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

URI-parametrar

Namn	I	Krävs	Typ	Beskrivning
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
securityConnectorName	path	True	string	Namnet på säkerhetsanslutningsappen.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Svaren

Namn	Typ	Beskrivning
200 OK	AzureDevOpsOrgListResponse	Innehåller en lista över information om Azure DevOps-organisationen
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde

Typ: oauth2
Rinna: implicit
Auktorisations-URL: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

ListAvailable_AzureDevOpsOrgs

Exempelförfrågan

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

Exempelsvar

Statuskod:: 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"
    }
  ]
}

Definitioner

Namn	Beskrivning
ActionableRemediation	Konfigurationsnyttolast för PR-anteckningar.
ActionableRemediationState	ActionableRemediation-inställning. Ingen – inställningen har aldrig angetts. Aktiverad – ActionableRemediation är aktiverat. Inaktiverad – ActionableRemediation är inaktiverad.
AnnotateDefaultBranchState	Konfiguration av PR-anteckningar på standardgrenen. Aktiverad – PR-anteckningar är aktiverade på resursens standardgren. Inaktiverad – PR-anteckningar är inaktiverade på resursens standardgren.
AzureDevOpsOrg	Azure DevOps Organisationsresurs.
AzureDevOpsOrgListResponse	Lista över RP-resurser som stöder sidnumrering.
AzureDevOpsOrgProperties	Egenskaper för Azure DevOps-organisationen.
CategoryConfiguration	Allvarlighetsgrad per kategorikonfiguration för PR-anteckningar.
createdByType	Den typ av identitet som skapade resursen.
DevOpsProvisioningState	Resursens etableringstillstånd. Väntar – etablering väntar. Misslyckades – etableringen misslyckades. Lyckades – etableringen lyckades. Avbröts – Etableringen avbröts. PendingDeletion – Väntar på borttagning. DeletionSuccess – Borttagningen lyckades. DeletionFailure – Borttagningsfel.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
InheritFromParentState	Uppdateringsinställningar. Aktiverad – Resursen ska ärva konfigurationer från överordnad. Inaktiverad – Resursen ska inte ärva konfigurationer från överordnad.
OnboardingState	Information om status för resursregistrering för alla anslutningsappar. OnboardedByOtherConnector – den här resursen har redan registrerats för en annan anslutningsapp. Detta gäller endast för resurser på den översta nivån. Registrerad – den här resursen har redan registrerats av den angivna anslutningsappen. NotOnboarded – den här resursen har inte registrerats för någon anslutningsapp. NotApplicable – registreringstillståndet gäller inte för den aktuella slutpunkten.
RuleCategory	Regelkategorier. Kod – resultat av kodgenomsökning. Resultat av artefaktgenomsökning. Genomsökningsresultat för beroenden. IaC-resultat. Resultat av genomsökning av hemligheter. Resultat av containergenomsökning.
systemData	Metadata som rör skapande och senaste ändring av resursen.
TargetBranchConfiguration	Konfiguration av lagringsplatsgren för PR-anteckningar.

ActionableRemediation

Objekt

Konfigurationsnyttolast för PR-anteckningar.

Namn	Typ	Beskrivning
branchConfiguration	TargetBranchConfiguration	Konfiguration av lagringsplatsgren för PR-anteckningar.
categoryConfigurations	CategoryConfiguration[]	Hämtar eller anger en lista över kategorier och allvarlighetsnivåer.
inheritFromParentState	InheritFromParentState	Uppdateringsinställningar. Aktiverad – Resursen ska ärva konfigurationer från överordnad. Inaktiverad – Resursen ska inte ärva konfigurationer från överordnad.
state	ActionableRemediationState	ActionableRemediation-inställning. Ingen – inställningen har aldrig angetts. Aktiverad – ActionableRemediation är aktiverat. Inaktiverad – ActionableRemediation är inaktiverad.

ActionableRemediationState

Uppräkning

ActionableRemediation-inställning. Ingen – inställningen har aldrig angetts. Aktiverad – ActionableRemediation är aktiverat. Inaktiverad – ActionableRemediation är inaktiverad.

Värde	Beskrivning
None
Disabled
Enabled

AnnotateDefaultBranchState

Uppräkning

Konfiguration av PR-anteckningar på standardgrenen.

Aktiverad – PR-anteckningar är aktiverade på resursens standardgren. Inaktiverad – PR-anteckningar är inaktiverade på resursens standardgren.

Värde	Beskrivning
Disabled
Enabled

AzureDevOpsOrg

Objekt

Azure DevOps Organisationsresurs.

Namn	Typ	Beskrivning
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Namnet på resursen
properties	AzureDevOpsOrgProperties	Egenskaper för Azure DevOps-organisationen.
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

AzureDevOpsOrgListResponse

Objekt

Lista över RP-resurser som stöder sidnumrering.

Namn	Typ	Beskrivning
nextLink	string	Hämtar eller anger nästa länk för att rulla över resultatet.
value	AzureDevOpsOrg[]	Hämtar eller anger en lista över resurser.

AzureDevOpsOrgProperties

Objekt

Egenskaper för Azure DevOps-organisationen.

Namn	Typ	Beskrivning
actionableRemediation	ActionableRemediation	Konfigurationsnyttolast för PR-anteckningar.
onboardingState	OnboardingState	Information om status för resursregistrering för alla anslutningsappar. OnboardedByOtherConnector – den här resursen har redan registrerats för en annan anslutningsapp. Detta gäller endast för resurser på den översta nivån. Registrerad – den här resursen har redan registrerats av den angivna anslutningsappen. NotOnboarded – den här resursen har inte registrerats för någon anslutningsapp. NotApplicable – registreringstillståndet gäller inte för den aktuella slutpunkten.
provisioningState	DevOpsProvisioningState	Resursens etableringstillstånd. Väntar – etablering väntar. Misslyckades – etableringen misslyckades. Lyckades – etableringen lyckades. Avbröts – Etableringen avbröts. PendingDeletion – Väntar på borttagning. DeletionSuccess – Borttagningen lyckades. DeletionFailure – Borttagningsfel.
provisioningStatusMessage	string	Hämtar eller anger meddelande om resursstatus.
provisioningStatusUpdateTimeUtc	string (date-time)	Hämtar eller anger tid när resursen senast kontrollerades.

CategoryConfiguration

Objekt

Allvarlighetsgrad per kategorikonfiguration för PR-anteckningar.

Namn	Typ	Beskrivning
category	RuleCategory	Regelkategorier. Kod – resultat av kodgenomsökning. Resultat av artefaktgenomsökning. Genomsökningsresultat för beroenden. IaC-resultat. Resultat av genomsökning av hemligheter. Resultat av containergenomsökning.
minimumSeverityLevel	string	Hämtar eller anger lägsta allvarlighetsgrad för en viss kategori.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Beskrivning
User
Application
ManagedIdentity
Key

DevOpsProvisioningState

Uppräkning

Resursens etableringstillstånd.

Väntar – etablering väntar. Misslyckades – etableringen misslyckades. Lyckades – etableringen lyckades. Avbröts – Etableringen avbröts. PendingDeletion – Väntar på borttagning. DeletionSuccess – Borttagningen lyckades. DeletionFailure – Borttagningsfel.

Värde	Beskrivning
Succeeded
Failed
Canceled
Pending
PendingDeletion
DeletionSuccess
DeletionFailure

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Namn	Typ	Beskrivning
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Namn	Typ	Beskrivning
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Namn	Typ	Beskrivning
error	ErrorDetail	Felobjektet.

InheritFromParentState

Uppräkning

Uppdateringsinställningar.

Aktiverad – Resursen ska ärva konfigurationer från överordnad. Inaktiverad – Resursen ska inte ärva konfigurationer från överordnad.

Värde	Beskrivning
Disabled
Enabled

OnboardingState

Uppräkning

Information om status för resursregistrering för alla anslutningsappar.

OnboardedByOtherConnector – den här resursen har redan registrerats för en annan anslutningsapp. Detta gäller endast för resurser på den översta nivån. Registrerad – den här resursen har redan registrerats av den angivna anslutningsappen. NotOnboarded – den här resursen har inte registrerats för någon anslutningsapp. NotApplicable – registreringstillståndet gäller inte för den aktuella slutpunkten.

Värde	Beskrivning
NotApplicable
OnboardedByOtherConnector
Onboarded
NotOnboarded

RuleCategory

Uppräkning

Regelkategorier. Kod – resultat av kodgenomsökning. Resultat av artefaktgenomsökning. Genomsökningsresultat för beroenden. IaC-resultat. Resultat av genomsökning av hemligheter. Resultat av containergenomsökning.

Värde	Beskrivning
Code
Artifacts
Dependencies
Secrets
IaC
Containers

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Namn	Typ	Beskrivning
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

TargetBranchConfiguration

Objekt

Konfiguration av lagringsplatsgren för PR-anteckningar.

Namn	Typ	Beskrivning
annotateDefaultBranch	AnnotateDefaultBranchState	Konfiguration av PR-anteckningar på standardgrenen. Aktiverad – PR-anteckningar är aktiverade på resursens standardgren. Inaktiverad – PR-anteckningar är inaktiverade på resursens standardgren.
branchNames	string[]	Hämtar eller anger grenar som ska ha anteckningar.

Namn

Typ

Beskrivning

annotateDefaultBranch

AnnotateDefaultBranchState

Konfiguration av PR-anteckningar på standardgrenen.

Aktiverad – PR-anteckningar är aktiverade på resursens standardgren. Inaktiverad – PR-anteckningar är inaktiverade på resursens standardgren.

branchNames

string[]

Hämtar eller anger grenar som ska ha anteckningar.

Dela via

Azure DevOps Orgs - List Available

URI-parametrar

Svaren

Säkerhet

azure_auth

Scope

Exempel

ListAvailable_AzureDevOpsOrgs

Exempelförfrågan

Exempelsvar

Definitioner

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsOrg

AzureDevOpsOrgListResponse

AzureDevOpsOrgProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration