DevOps Policy Assignments - Update

Odwołanie

Usługa:: Defender for Cloud

Wersja interfejsu API:: 2024-05-15-preview

Aktualizuje zasób przypisania zasad DevOps.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
policyAssignmentId	path	True	string	Identyfikator przypisania zasad.
resourceGroupName	path	True	string	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
securityConnectorName	path	True	string	Nazwa łącznika zabezpieczeń.
subscriptionId	path	True	string	Identyfikator subskrypcji docelowej.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
properties	DevOpsPolicyAssignmentProperties	Właściwości zasobu przypisania zasad DevOps.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DevOpsPolicyAssignment	Aktualizuje przypisanie zasad Metodyki DevOps.
202 Accepted	DevOpsPolicyAssignment	Akceptowane
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
DescendantBehavior	Zachowanie zasad dotyczących zasobów potomnych.
DevOpsPolicyAssignment	Zasób przypisania zasad DevOps.
DevOpsPolicyAssignmentProperties	Właściwości zasobu przypisania zasad DevOps.
DevOpsPolicyDescriptor	Skrócone informacje identyfikujące zasób zasad Metodyki DevOps.
DevOpsPolicyType	Typy zasobów usługi DevOps Policy.
DevOpsProvisioningState	Stan aprowizacji zasobu. Oczekujące — oczekiwanie na aprowizację. Niepowodzenie — inicjowanie obsługi administracyjnej nie powiodło się. Powodzenie — pomyślna aprowizacja. Anulowano — aprowizowanie anulowane. PendingDeletion — oczekiwanie na usunięcie. DeletionSuccess — usuwanie powiodło się. DeletionFailure — niepowodzenie usuwania.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

DescendantBehavior

Zachowanie zasad dotyczących zasobów potomnych.

Nazwa	Typ	Opis
FallBack	string
Override	string
Unknown	string

DevOpsPolicyAssignment

Zasób przypisania zasad DevOps.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties	DevOpsPolicyAssignmentProperties	Właściwości zasobu przypisania zasad DevOps.
systemData	systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

DevOpsPolicyAssignmentProperties

Właściwości zasobu przypisania zasad DevOps.

Nazwa	Typ	Opis
assignedAt	string	Pobiera lub ustawia czas utworzenia przypisania w formacie UTC.
descendantBehavior	DescendantBehavior	Zachowanie zasad dotyczących zasobów potomnych.
policy	DevOpsPolicyDescriptor	Skrócone informacje identyfikujące zasób zasad Metodyki DevOps.
provisioningState	DevOpsProvisioningState	Stan aprowizacji zasobu. Oczekujące — oczekiwanie na aprowizację. Niepowodzenie — inicjowanie obsługi administracyjnej nie powiodło się. Powodzenie — pomyślna aprowizacja. Anulowano — aprowizowanie anulowane. PendingDeletion — oczekiwanie na usunięcie. DeletionSuccess — usuwanie powiodło się. DeletionFailure — niepowodzenie usuwania.
provisioningStatusMessage	string	Pobiera komunikat o stanie zasobu.
provisioningStatusUpdateTimeUtc	string	Pobiera czas ostatniego sprawdzenia zasobu.
resourceId	string	Pobiera lub ustawia identyfikator zasobu platformy Azure.

DevOpsPolicyDescriptor

Skrócone informacje identyfikujące zasób zasad Metodyki DevOps.

Nazwa	Typ	Opis
policyId	string	Pobiera lub ustawia identyfikator GUID zasad.
policyName	string	Pobiera lub ustawia nazwę zasad.
policyType	DevOpsPolicyType	Typy zasobów usługi DevOps Policy.
policyVersion	string	Pobiera lub ustawia wersję.

DevOpsPolicyType

Typy zasobów usługi DevOps Policy.

Nazwa	Typ	Opis
Pipeline	string
Unknown	string

DevOpsProvisioningState

Stan aprowizacji zasobu.

Oczekujące — oczekiwanie na aprowizację. Niepowodzenie — inicjowanie obsługi administracyjnej nie powiodło się. Powodzenie — pomyślna aprowizacja. Anulowano — aprowizowanie anulowane. PendingDeletion — oczekiwanie na usunięcie. DeletionSuccess — usuwanie powiodło się. DeletionFailure — niepowodzenie usuwania.

Nazwa	Typ	Opis
Canceled	string
DeletionFailure	string
DeletionSuccess	string
Failed	string
Pending	string
PendingDeletion	string
Succeeded	string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem