DevOps Policy Assignments - Create Or Update

Reference

Služba:: Defender for Cloud

Verze rozhraní API:: 2024-05-15-preview

Vytvoří nebo aktualizuje prostředek přiřazení zásad DevOps.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
policyAssignmentId	path	True	string	ID přiřazení zásady.
resourceGroupName	path	True	string	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	ID cílového předplatného.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
properties	DevOpsPolicyAssignmentProperties	Vlastnosti prostředku přiřazení zásad DevOps

Odpovědi

Name	Typ	Description
200 OK	DevOpsPolicyAssignment	Vytvoří nebo aktualizuje přiřazení zásad DevOps.
201 Created	DevOpsPolicyAssignment	Vytvořil
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

CreateOrUpdate_DevOpsPolicyAssignments

PUT 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.DevOpsPolicyAssignmentProperties;
import com.azure.resourcemanager.security.models.DevOpsPolicyDescriptor;
import com.azure.resourcemanager.security.models.DevOpsPolicyType;

/**
 * Samples for DevOpsPolicyAssignments CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/security/resource-manager/Microsoft.Security/preview/2024-05-15-preview/examples/
     * SecurityConnectorsDevOps/CreateOrUpdateDevOpsPolicyAssignments_example.json
     */
    /**
     * Sample code: CreateOrUpdate_DevOpsPolicyAssignments.
     * 
     * @param manager Entry point to SecurityManager.
     */
    public static void
        createOrUpdateDevOpsPolicyAssignments(com.azure.resourcemanager.security.SecurityManager manager) {
        manager.devOpsPolicyAssignments().define("5ec87f43-62d8-437b-8f46-4c8d4032cf6d")
            .withExistingSecurityConnector("myRg", "mySecurityConnectorName")
            .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)))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Ukázková odpověď

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

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

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
DescendantBehavior	Chování zásady u následnických prostředků.
DevOpsPolicyAssignment	Prostředek přiřazení zásad DevOps
DevOpsPolicyAssignmentProperties	Vlastnosti prostředku přiřazení zásad DevOps
DevOpsPolicyDescriptor	Zhuštěné informace pro identifikaci prostředku devOps Policy
DevOpsPolicyType	Typy prostředků zásad DevOps
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ěď
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

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

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DescendantBehavior

Chování zásady u následnických prostředků.

Name	Typ	Description
FallBack	string
Override	string
Unknown	string

DevOpsPolicyAssignment

Prostředek přiřazení zásad 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	DevOpsPolicyAssignmentProperties	Vlastnosti prostředku přiřazení zásad 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

DevOpsPolicyAssignmentProperties

Vlastnosti prostředku přiřazení zásad DevOps

Name	Typ	Description
assignedAt	string	Získá nebo nastaví čas vytvoření přiřazení v UTC.
descendantBehavior	DescendantBehavior	Chování zásady u následnických prostředků.
policy	DevOpsPolicyDescriptor	Zhuštěné informace pro identifikaci prostředku devOps Policy
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á zprávu o stavu prostředku.
provisioningStatusUpdateTimeUtc	string	Získá čas poslední kontroly prostředku.
resourceId	string	Získá nebo nastaví ID prostředku Azure.

DevOpsPolicyDescriptor

Zhuštěné informace pro identifikaci prostředku devOps Policy

Name	Typ	Description
policyId	string	Získá nebo nastaví identifikátor GUID zásad.
policyName	string	Získá nebo nastaví název zásady.
policyType	DevOpsPolicyType	Typy prostředků zásad DevOps
policyVersion	string	Získá nebo nastaví verzi.

DevOpsPolicyType

Typy prostředků zásad DevOps

Name	Typ	Description
Pipeline	string
Unknown	string

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í

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

ErrorAdditionalInfo

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

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

ErrorDetail

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

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

systemData

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

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

Sdílet prostřednictvím