DevOps Policy Assignments - Update

Referens

Tjänst:: Defender for Cloud

API-version:: 2024-05-15-preview

Uppdaterar en DevOps-principtilldelningsresurs.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
policyAssignmentId	path	True	string	Principtilldelnings-ID:t.
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	DevOpsPolicyAssignmentProperties	Egenskaper för DevOps-principtilldelningsresursen.

Svar

Name	Typ	Description
200 OK	DevOpsPolicyAssignment	Uppdaterar en DevOps-principtilldelning.
202 Accepted	DevOpsPolicyAssignment	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

Update_DevOpsPolicyAssignments

PATCH https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/policyAssignments/5ec87f43-62d8-437b-8f46-4c8d4032cf6d?api-version=2024-05-15-preview

{
  "properties": {
    "resourceId": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourcegroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/Contoso",
    "descendantBehavior": "Override",
    "policy": {
      "policyName": "myDevOpsPolicy",
      "policyId": "00000000-0000-0000-0000-000000000000",
      "policyVersion": "1.0",
      "policyType": "Pipeline"
    }
  }
}


import com.azure.resourcemanager.security.models.DescendantBehavior;
import com.azure.resourcemanager.security.models.DevOpsPolicyAssignment;
import com.azure.resourcemanager.security.models.DevOpsPolicyAssignmentProperties;
import com.azure.resourcemanager.security.models.DevOpsPolicyDescriptor;
import com.azure.resourcemanager.security.models.DevOpsPolicyType;

/**
 * Samples for DevOpsPolicyAssignments Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/UpdateDevOpsPolicyAssignments_example.json
     */
    /**
     * Sample code: Update_DevOpsPolicyAssignments.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void updateDevOpsPolicyAssignments(com.azure.resourcemanager.security.SecurityManager manager) {
        DevOpsPolicyAssignment resource
            = manager.devOpsPolicyAssignments().getWithResponse("myRg", "mySecurityConnectorName",
                "5ec87f43-62d8-437b-8f46-4c8d4032cf6d", com.azure.core.util.Context.NONE).getValue();
        resource.update().withProperties(new DevOpsPolicyAssignmentProperties().withResourceId(
            "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourcegroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/Contoso")
            .withDescendantBehavior(DescendantBehavior.OVERRIDE)
            .withPolicy(new DevOpsPolicyDescriptor().withPolicyName("myDevOpsPolicy")
                .withPolicyId("00000000-0000-0000-0000-000000000000").withPolicyVersion("1.0")
                .withPolicyType(DevOpsPolicyType.PIPELINE)))
            .apply();
    }
}

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": {
    "resourceId": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourcegroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/Contoso",
    "descendantBehavior": "Override",
    "policy": {
      "policyName": "myDevOpsPolicy",
      "policyId": "00000000-0000-0000-0000-000000000000",
      "policyVersion": "1.0",
      "policyType": "Pipeline"
    },
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/policyAssignments/5ec87f43-62d8-437b-8f46-4c8d4032cf6d",
  "name": "5ec87f43-62d8-437b-8f46-4c8d4032cf6d",
  "type": "Microsoft.Security/securityConnectors/devops/policyAssignments"
}

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": {
    "resourceId": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourcegroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/Contoso",
    "descendantBehavior": "Override",
    "policy": {
      "policyName": "myDevOpsPolicy",
      "policyId": "00000000-0000-0000-0000-000000000000",
      "policyVersion": "1.0",
      "policyType": "Pipeline"
    },
    "provisioningState": "Accepted"
  },
  "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/policyAssignments/5ec87f43-62d8-437b-8f46-4c8d4032cf6d",
  "name": "5ec87f43-62d8-437b-8f46-4c8d4032cf6d",
  "type": "Microsoft.Security/securityConnectors/devops/policyAssignments"
}

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
DescendantBehavior	Beteendet för en princip på underordnade resurser.
DevOpsPolicyAssignment	Tilldelningsresurs för DevOps-princip.
DevOpsPolicyAssignmentProperties	Egenskaper för DevOps-principtilldelningsresursen.
DevOpsPolicyDescriptor	Komprimerad information för att identifiera en DevOps Policy-resurs.
DevOpsPolicyType	DevOps Policy-resurstyper.
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.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

DescendantBehavior

Uppräkning

Beteendet för en princip på underordnade resurser.

Värde	Description
FallBack
Override
Unknown

DevOpsPolicyAssignment

Objekt

Tilldelningsresurs för DevOps-princip.

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	DevOpsPolicyAssignmentProperties	Egenskaper för DevOps-principtilldelningsresursen.
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

DevOpsPolicyAssignmentProperties

Objekt

Egenskaper för DevOps-principtilldelningsresursen.

Name	Typ	Description
assignedAt	string (date-time)	Hämtar eller anger tid när tilldelningen skapades i UTC.
descendantBehavior	DescendantBehavior	Beteendet för en princip på underordnade resurser.
policy	DevOpsPolicyDescriptor	Komprimerad information för att identifiera en DevOps Policy-resurs.
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.
resourceId	string (arm-id)	Hämtar eller anger Azure-resurs-ID: t.

DevOpsPolicyDescriptor

Objekt

Komprimerad information för att identifiera en DevOps Policy-resurs.

Name	Typ	Description
policyId	string	Hämtar eller anger principens GUID.
policyName	string	Hämtar eller anger principnamnet.
policyType	DevOpsPolicyType	DevOps Policy-resurstyper.
policyVersion	string	Hämtar eller anger versionen.

DevOpsPolicyType

Uppräkning

DevOps Policy-resurstyper.

Värde	Description
Pipeline
Unknown

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.

Dela via

DevOps Policy Assignments - Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Update_DevOpsPolicyAssignments

Exempelbegäran

Exempelsvar

Definitioner

createdByType

DescendantBehavior

DevOpsPolicyAssignment

DevOpsPolicyAssignmentProperties

DevOpsPolicyDescriptor

DevOpsPolicyType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

systemData

Ytterligare resurser