Azure DevOps Repos - Create Or Update

Referentie

Service:: Defender for Cloud

API-versie:: 2024-05-15-preview

Hiermee maakt u een bewaakte Azure DevOps-opslagplaatsresource of werkt u deze bij.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/azureDevOpsOrgs/{orgName}/projects/{projectName}/repos/{repoName}?api-version=2024-05-15-preview

URI-parameters

Name	In	Vereist	Type	Description
orgName	path	True	string	De naam van de Azure DevOps-organisatie.
projectName	path	True	string	De projectnaam.
repoName	path	True	string	De naam van de opslagplaats.
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
securityConnectorName	path	True	string	De naam van de beveiligingsconnector.
subscriptionId	path	True	string	De id van het doelabonnement.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
properties	AzureDevOpsRepositoryProperties	Eigenschappen van Azure DevOps-opslagplaats.

Antwoorden

Name	Type	Description
200 OK	AzureDevOpsRepository	Een bewaakte Azure DevOps-opslagplaatsresource maken of bijwerken
201 Created	AzureDevOpsRepository	Geschapen
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

CreateOrUpdate_AzureDevOpsRepos

PUT https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg/projects/myAzDevOpsProject/repos/myAzDevOpsRepo?api-version=2024-05-15-preview

{
  "properties": {
    "onboardingState": "NotApplicable",
    "actionableRemediation": {
      "state": "Enabled"
    }
  }
}


import com.azure.resourcemanager.security.models.ActionableRemediation;
import com.azure.resourcemanager.security.models.ActionableRemediationState;
import com.azure.resourcemanager.security.models.AzureDevOpsRepositoryProperties;
import com.azure.resourcemanager.security.models.OnboardingState;

/**
 * Samples for AzureDevOpsRepos CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/CreateOrUpdateAzureDevOpsRepos_example.json
     */
    /**
     * Sample code: CreateOrUpdate_AzureDevOpsRepos.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void createOrUpdateAzureDevOpsRepos(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.azureDevOpsRepos().define("myAzDevOpsRepo")
            .withExistingProject("myRg", "mySecurityConnectorName", "myAzDevOpsOrg", "myAzDevOpsProject")
            .withProperties(new AzureDevOpsRepositoryProperties().withOnboardingState(OnboardingState.NOT_APPLICABLE)
                .withActionableRemediation(new ActionableRemediation().withState(ActionableRemediationState.ENABLED)))
            .create();
    }
}

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

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

Statuscode:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/operationResults/4e826cf1-5c36-4808-a7d2-fb4f5170978b?api-version=2024-05-15-preview

{
  "properties": {
    "parentOrgName": "myAzDevOpsOrg",
    "parentProjectName": "myAzDevOpsProject",
    "repoId": "cb64ab91-c9ba-46df-b44c-c769358bccdf",
    "onboardingState": "NotApplicable",
    "actionableRemediation": {
      "state": "None"
    },
    "provisioningState": "Accepted"
  },
  "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"
}

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.
AzureDevOpsRepository	Azure DevOps Repository-resource.
AzureDevOpsRepositoryProperties	Eigenschappen van Azure DevOps-opslagplaats.
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

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

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

Name	Type	Description
Disabled	string
Enabled	string
None	string

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.

Name	Type	Description
Disabled	string
Enabled	string

AzureDevOpsRepository

Azure DevOps Repository-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	AzureDevOpsRepositoryProperties	Eigenschappen van Azure DevOps-opslagplaats.
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'

AzureDevOpsRepositoryProperties

Eigenschappen van Azure DevOps-opslagplaats.

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.
parentOrgName	string	Hiermee haalt u de naam van de bovenliggende Azure DevOps-organisatie op of stelt u deze in.
parentProjectName	string	Hiermee haalt u de bovenliggende Naam van het Azure DevOps-project op of stelt u deze in.
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.
provisioningStatusUpdateTimeUtc	string	Hiermee wordt de tijd opgehaald waarop de resource voor het laatst is gecontroleerd.
repoId	string	Hiermee haalt u de azure DevOps-opslagplaats-id op of stelt u deze in.
repoUrl	string	Hiermee haalt u de URL van de Azure DevOps-opslagplaats op of stelt u deze in.
visibility	string	Hiermee haalt u de zichtbaarheid van de Azure DevOps-opslagplaats op of stelt u deze in, ongeacht of deze openbaar of privé is, enzovoort.

CategoryConfiguration

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

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

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.

Name	Type	Description
Canceled	string
DeletionFailure	string
DeletionSuccess	string
Failed	string
Pending	string
PendingDeletion	string
Succeeded	string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

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

ErrorDetail

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

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

InheritFromParentState

Instellingen bijwerken.

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

Name	Type	Description
Disabled	string
Enabled	string

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.

Name	Type	Description
NotApplicable	string
NotOnboarded	string
Onboarded	string
OnboardedByOtherConnector	string

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.

Name	Type	Description
Artifacts	string
Code	string
Containers	string
Dependencies	string
IaC	string
Secrets	string

systemData

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

Name	Type	Description
createdAt	string	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	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

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 Repos - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

CreateOrUpdate_AzureDevOpsRepos

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsRepository

AzureDevOpsRepositoryProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration

Aanvullende resources