Azure DevOps Orgs - List Available

Služba:: Defender for Cloud

Verze rozhraní API:: 2024-04-01

Vrátí seznam všech organizací Azure DevOps, které jsou přístupné pomocí tokenu uživatele spotřebovaného konektorem.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
securityConnectorName	path	True	string	Název konektoru zabezpečení.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	AzureDevOpsOrgListResponse	Poskytuje seznam podrobností o organizaci Azure DevOps.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ListAvailable_AzureDevOpsOrgs

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
    }
  ]
}

Definice

Name	Description
ActionableRemediation	Datová část konfigurace pro poznámky k žádosti o přijetí změn
ActionableRemediationState	Nastavení akceableRemediation. Žádné – nastavení nebylo nikdy nastaveno. Povoleno – AkceableRemediation je povolená. Zakázáno – AkceableRemediation je zakázaná.
AnnotateDefaultBranchState	Konfigurace poznámek k žádosti o přijetí změn ve výchozí větvi Povoleno – Poznámky k žádosti o přijetí změn jsou povolené ve výchozí větvi prostředku. Zakázáno – Poznámky k žádosti o přijetí změn jsou ve výchozí větvi prostředku zakázané.
AzureDevOpsOrg	Prostředek organizace Azure DevOps
AzureDevOpsOrgListResponse	Seznam prostředků rp, které podporují stránkování
AzureDevOpsOrgProperties	Vlastnosti organizace Azure DevOps
CategoryConfiguration	Úroveň závažnosti na konfiguraci kategorií pro poznámky k žádosti o přijetí změn
createdByType	Typ identity, která prostředek vytvořila.
DevOpsProvisioningState	Stav zřizování prostředku. Čeká se na vyřízení – Čeká se na zřízení. Selhalo – Zřizování se nezdařilo. Úspěšné – úspěšné zřizování. Zrušeno – Zřizování bylo zrušeno. PendingDeletion – Čeká na odstranění. OdstraněníSuccess – Odstranění bylo úspěšné. OdstraněníFailure – Chyba odstranění
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
InheritFromParentState	Aktualizovat nastavení Povoleno – Prostředek by měl dědit konfigurace z nadřazeného objektu. Zakázáno – Prostředek by neměl dědit konfigurace z nadřazeného objektu.
OnboardingState	Podrobnosti o stavu onboardingu prostředků napříč všemi konektory OnboardedByOtherConnector – tento prostředek už byl onboardován k jinému konektoru. To platí jenom pro prostředky nejvyšší úrovně. Onboarded – tento prostředek už byl onboardován zadaným konektorem. NotOnboarded – tento prostředek nebyl onboardován k žádnému konektoru. NotApplicable – stav onboardingu se nevztahuje na aktuální koncový bod.
RuleCategory	Kategorie pravidel Kód – výsledky kontroly kódu Výsledky prohledávání artefaktů Výsledky kontroly závislostí Výsledky IaC. Výsledky prohledávání tajných kódů. Výsledky prohledávání kontejnerů
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TargetBranchConfiguration	Konfigurace větve úložiště pro poznámky k žádosti o přijetí změn

ActionableRemediation

Objekt

Datová část konfigurace pro poznámky k žádosti o přijetí změn

Name	Typ	Description
branchConfiguration	TargetBranchConfiguration	Konfigurace větve úložiště pro poznámky k žádosti o přijetí změn
categoryConfigurations	CategoryConfiguration[]	Získá nebo nastaví seznam kategorií a úrovní závažnosti.
inheritFromParentState	InheritFromParentState	Aktualizovat nastavení Povoleno – Prostředek by měl dědit konfigurace z nadřazeného objektu. Zakázáno – Prostředek by neměl dědit konfigurace z nadřazeného objektu.
state	ActionableRemediationState	Nastavení akceableRemediation. Žádné – nastavení nebylo nikdy nastaveno. Povoleno – AkceableRemediation je povolená. Zakázáno – AkceableRemediation je zakázaná.

ActionableRemediationState

Výčet

Nastavení akceableRemediation. Žádné – nastavení nebylo nikdy nastaveno. Povoleno – AkceableRemediation je povolená. Zakázáno – AkceableRemediation je zakázaná.

Hodnota	Description
None
Disabled
Enabled

AnnotateDefaultBranchState

Výčet

Konfigurace poznámek k žádosti o přijetí změn ve výchozí větvi

Povoleno – Poznámky k žádosti o přijetí změn jsou povolené ve výchozí větvi prostředku. Zakázáno – Poznámky k žádosti o přijetí změn jsou ve výchozí větvi prostředku zakázané.

Hodnota	Description
Disabled
Enabled

AzureDevOpsOrg

Objekt

Prostředek organizace Azure DevOps

Name	Typ	Description
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Název prostředku
properties	AzureDevOpsOrgProperties	Vlastnosti organizace Azure DevOps
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

AzureDevOpsOrgListResponse

Objekt

Seznam prostředků rp, které podporují stránkování

Name	Typ	Description
nextLink	string	Získá nebo nastaví další odkaz pro posouvání výsledků.
value	AzureDevOpsOrg[]	Získá nebo nastaví seznam prostředků.

AzureDevOpsOrgProperties

Objekt

Vlastnosti organizace Azure DevOps

Name	Typ	Description
actionableRemediation	ActionableRemediation	Datová část konfigurace pro poznámky k žádosti o přijetí změn
onboardingState	OnboardingState	Podrobnosti o stavu onboardingu prostředků napříč všemi konektory OnboardedByOtherConnector – tento prostředek už byl onboardován k jinému konektoru. To platí jenom pro prostředky nejvyšší úrovně. Onboarded – tento prostředek už byl onboardován zadaným konektorem. NotOnboarded – tento prostředek nebyl onboardován k žádnému konektoru. NotApplicable – stav onboardingu se nevztahuje na aktuální koncový bod.
provisioningState	DevOpsProvisioningState	Stav zřizování prostředku. Čeká se na vyřízení – Čeká se na zřízení. Selhalo – Zřizování se nezdařilo. Úspěšné – úspěšné zřizování. Zrušeno – Zřizování bylo zrušeno. PendingDeletion – Čeká na odstranění. OdstraněníSuccess – Odstranění bylo úspěšné. OdstraněníFailure – Chyba odstranění
provisioningStatusMessage	string	Získá nebo nastaví stavovou zprávu zdroje.
provisioningStatusUpdateTimeUtc	string (date-time)	Získá nebo nastaví čas poslední kontroly prostředku.

CategoryConfiguration

Objekt

Úroveň závažnosti na konfiguraci kategorií pro poznámky k žádosti o přijetí změn

Name	Typ	Description
category	RuleCategory	Kategorie pravidel Kód – výsledky kontroly kódu Výsledky prohledávání artefaktů Výsledky kontroly závislostí Výsledky IaC. Výsledky prohledávání tajných kódů. Výsledky prohledávání kontejnerů
minimumSeverityLevel	string	Získá nebo nastaví minimální úroveň závažnosti pro danou kategorii.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DevOpsProvisioningState

Výčet

Stav zřizování prostředku.

Čeká se na vyřízení – Čeká se na zřízení. Selhalo – Zřizování se nezdařilo. Úspěšné – úspěšné zřizování. Zrušeno – Zřizování bylo zrušeno. PendingDeletion – Čeká na odstranění. OdstraněníSuccess – Odstranění bylo úspěšné. OdstraněníFailure – Chyba odstranění

Hodnota	Description
Succeeded
Failed
Canceled
Pending
PendingDeletion
DeletionSuccess
DeletionFailure

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

InheritFromParentState

Výčet

Aktualizovat nastavení

Povoleno – Prostředek by měl dědit konfigurace z nadřazeného objektu. Zakázáno – Prostředek by neměl dědit konfigurace z nadřazeného objektu.

Hodnota	Description
Disabled
Enabled

OnboardingState

Výčet

Podrobnosti o stavu onboardingu prostředků napříč všemi konektory

OnboardedByOtherConnector – tento prostředek už byl onboardován k jinému konektoru. To platí jenom pro prostředky nejvyšší úrovně. Onboarded – tento prostředek už byl onboardován zadaným konektorem. NotOnboarded – tento prostředek nebyl onboardován k žádnému konektoru. NotApplicable – stav onboardingu se nevztahuje na aktuální koncový bod.

Hodnota	Description
NotApplicable
OnboardedByOtherConnector
Onboarded
NotOnboarded

RuleCategory

Výčet

Kategorie pravidel Kód – výsledky kontroly kódu Výsledky prohledávání artefaktů Výsledky kontroly závislostí Výsledky IaC. Výsledky prohledávání tajných kódů. Výsledky prohledávání kontejnerů

Hodnota	Description
Code
Artifacts
Dependencies
Secrets
IaC
Containers

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TargetBranchConfiguration

Objekt

Konfigurace větve úložiště pro poznámky k žádosti o přijetí změn

Name	Typ	Description
annotateDefaultBranch	AnnotateDefaultBranchState	Konfigurace poznámek k žádosti o přijetí změn ve výchozí větvi Povoleno – Poznámky k žádosti o přijetí změn jsou povolené ve výchozí větvi prostředku. Zakázáno – Poznámky k žádosti o přijetí změn jsou ve výchozí větvi prostředku zakázané.
branchNames	string[]	Získá nebo nastaví větve, které by měly mít poznámky.

Name

Typ

Description

annotateDefaultBranch

AnnotateDefaultBranchState

Konfigurace poznámek k žádosti o přijetí změn ve výchozí větvi

branchNames

string[]

Získá nebo nastaví větve, které by měly mít poznámky.

Sdílet prostřednictvím

Azure DevOps Orgs - List Available

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

ListAvailable_AzureDevOpsOrgs

Ukázkový požadavek

Ukázková odpověď

Definice

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsOrg

AzureDevOpsOrgListResponse

AzureDevOpsOrgProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration