DevOps Configurations - Create Or Update

Tjänst:

Defender for Cloud

API-version:

2024-05-15-preview

Skapar eller uppdaterar en DevOps-konfiguration.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
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.

Begärandetext

Name	Typ	Description
properties	DevOpsConfigurationProperties	DevOps-konfigurationsegenskaper.

Svar

Name	Typ	Description
200 OK	DevOpsConfiguration	Skapar eller uppdaterar en DevOps-konfiguration
201 Created	DevOpsConfiguration	Skapad
202 Accepted	DevOpsConfiguration	Accepterad
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

CreateOrUpdate_DevOpsConfigurations_OnboardCurrentAndFuture

CreateOrUpdate_DevOpsConfigurations_OnboardCurrentOnly

CreateOrUpdate_DevOpsConfigurations_OnboardSelected

CreateOrUpdate_DevOpsConfigurations_OnboardCurrentAndFuture

Exempelbegäran

HTTP

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

{
  "properties": {
    "authorization": {
      "code": "00000000000000000000"
    },
    "autoDiscovery": "Enabled"
  }
}

Java

import com.azure.resourcemanager.security.fluent.models.DevOpsConfigurationInner;
import com.azure.resourcemanager.security.models.Authorization;
import com.azure.resourcemanager.security.models.AutoDiscovery;
import com.azure.resourcemanager.security.models.DevOpsConfigurationProperties;

/**
 * Samples for DevOpsConfigurations CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/CreateOrUpdateDevOpsConfigurationsOnboardCurrentAndFuture_example.json
     */
    /**
     * Sample code: CreateOrUpdate_DevOpsConfigurations_OnboardCurrentAndFuture.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void createOrUpdateDevOpsConfigurationsOnboardCurrentAndFuture(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.devOpsConfigurations().createOrUpdate("myRg", "mySecurityConnectorName",
            new DevOpsConfigurationInner().withProperties(new DevOpsConfigurationProperties()
                .withAuthorization(new Authorization().withCode("fakeTokenPlaceholder"))
                .withAutoDiscovery(AutoDiscovery.ENABLED)),
            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

Exempelsvar

Statuskod:

200

{
  "properties": {
    "autoDiscovery": "Enabled",
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

Statuskod:

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": {
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

Statuskod:

202

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": {
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

CreateOrUpdate_DevOpsConfigurations_OnboardCurrentOnly

Exempelbegäran

HTTP

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

{
  "properties": {
    "authorization": {
      "code": "00000000000000000000"
    },
    "autoDiscovery": "Disabled"
  }
}

Java

import com.azure.resourcemanager.security.fluent.models.DevOpsConfigurationInner;
import com.azure.resourcemanager.security.models.Authorization;
import com.azure.resourcemanager.security.models.AutoDiscovery;
import com.azure.resourcemanager.security.models.DevOpsConfigurationProperties;

/**
 * Samples for DevOpsConfigurations CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/CreateOrUpdateDevOpsConfigurationsOnboardCurrentOnly_example.json
     */
    /**
     * Sample code: CreateOrUpdate_DevOpsConfigurations_OnboardCurrentOnly.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void createOrUpdateDevOpsConfigurationsOnboardCurrentOnly(
        com.azure.resourcemanager.security.SecurityManager manager) {
        manager.devOpsConfigurations().createOrUpdate("myRg", "mySecurityConnectorName",
            new DevOpsConfigurationInner().withProperties(new DevOpsConfigurationProperties()
                .withAuthorization(new Authorization().withCode("fakeTokenPlaceholder"))
                .withAutoDiscovery(AutoDiscovery.DISABLED)),
            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

Exempelsvar

Statuskod:

200

{
  "properties": {
    "autoDiscovery": "Disabled",
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

Statuskod:

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": {
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

Statuskod:

202

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": {
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

CreateOrUpdate_DevOpsConfigurations_OnboardSelected

Exempelbegäran

HTTP

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

{
  "properties": {
    "authorization": {
      "code": "00000000000000000000"
    },
    "autoDiscovery": "Disabled",
    "topLevelInventoryList": [
      "org1",
      "org2"
    ]
  }
}

Java

import com.azure.resourcemanager.security.fluent.models.DevOpsConfigurationInner;
import com.azure.resourcemanager.security.models.Authorization;
import com.azure.resourcemanager.security.models.AutoDiscovery;
import com.azure.resourcemanager.security.models.DevOpsConfigurationProperties;
import java.util.Arrays;

/**
 * Samples for DevOpsConfigurations CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/CreateOrUpdateDevOpsConfigurationsOnboardSelected_example.json
     */
    /**
     * Sample code: CreateOrUpdate_DevOpsConfigurations_OnboardSelected.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        createOrUpdateDevOpsConfigurationsOnboardSelected(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.devOpsConfigurations().createOrUpdate("myRg", "mySecurityConnectorName",
            new DevOpsConfigurationInner().withProperties(new DevOpsConfigurationProperties()
                .withAuthorization(new Authorization().withCode("fakeTokenPlaceholder"))
                .withAutoDiscovery(AutoDiscovery.DISABLED).withTopLevelInventoryList(Arrays.asList("org1", "org2"))),
            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

Exempelsvar

Statuskod:

200

{
  "properties": {
    "autoDiscovery": "Disabled",
    "topLevelInventoryList": [
      "org1",
      "org2"
    ],
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

Statuskod:

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": {
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

Statuskod:

202

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": {
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default",
  "name": "default",
  "type": "Microsoft.Security/securityConnectors/devops"
}

Definitioner

Name	Description
Authorization	Nyttolast för auktorisering.
AutoDiscovery	Autodiscovery-tillstånd.
createdByType	Den typ av identitet som skapade resursen.
DevOpsCapability	Information om DevOps-funktioner.
DevOpsConfiguration	DevOps-konfigurationsresurs.
DevOpsConfigurationProperties	DevOps-konfigurationsegenskaper.
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
systemData	Metadata som rör skapande och senaste ändring av resursen.

Authorization

Objekt

Nyttolast för auktorisering.

Name	Typ	Description
code	string	Hämtar eller anger en gång OAuth-kod för utbyte av uppdaterings- och åtkomsttoken. Används endast under PUT/PATCH-åtgärder. Hemligheten rensas under GET.

AutoDiscovery

Uppräkning

Autodiscovery-tillstånd.

Värde	Description
Disabled
Enabled
NotApplicable

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

DevOpsCapability

Objekt

Information om DevOps-funktioner.

Name	Typ	Description
name	string	Hämtar namnet på DevOps-funktionen.
value	string	Hämtar värdet för DevOps-funktionen.

DevOpsConfiguration

Objekt

DevOps-konfigurationsresurs.

Name	Typ	Description
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	DevOpsConfigurationProperties	DevOps-konfigurationsegenskaper.
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

DevOpsConfigurationProperties

Objekt

DevOps-konfigurationsegenskaper.

Name	Typ	Description
authorization	Authorization	Nyttolast för auktorisering.
autoDiscovery	AutoDiscovery	Autodiscovery-tillstånd.
capabilities	DevOpsCapability[]	Lista över funktioner som tilldelats DevOps-konfigurationen under identifieringsprocessen.
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 meddelandet om resursstatus.
provisioningStatusUpdateTimeUtc	string (date-time)	Hämtar den tid då resursen senast kontrollerades.
topLevelInventoryList	string[]	Lista över lager på den översta nivån som ska väljas när Automatisk upptäckt är inaktiverat. Det här fältet ignoreras när Automatisk upptäckt är aktiverat.

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

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

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

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

systemData

Objekt

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

Name	Typ	Description
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.