DevOps Policy Assignments - Create Or Update

Referência

Serviço:: Defender for Cloud

Versão da API:: 2024-05-15-preview

Cria ou atualiza um recurso de atribuição de política de 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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
policyAssignmentId	path	True	string	A ID da atribuição de política.
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
securityConnectorName	path	True	string	O nome do conector de segurança.
subscriptionId	path	True	string	A ID da assinatura de destino.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
properties	DevOpsPolicyAssignmentProperties	Propriedades do recurso de atribuição de política de DevOps.

Respostas

Nome	Tipo	Description
200 OK	DevOpsPolicyAssignment	Cria ou atualiza uma Atribuição de Política de DevOps.
201 Created	DevOpsPolicyAssignment	Criado
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Resposta de exemplo

Código de status:: 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"
}

Código de status:: 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"
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
DescendantBehavior	O comportamento de uma política em recursos descendentes.
DevOpsPolicyAssignment	Recurso de atribuição de Política de DevOps.
DevOpsPolicyAssignmentProperties	Propriedades do recurso de atribuição de política de DevOps.
DevOpsPolicyDescriptor	Informações condensadas para identificar um recurso de Política de DevOps.
DevOpsPolicyType	Tipos de recursos de Política de DevOps.
DevOpsProvisioningState	O estado de provisionamento do recurso. Pendente – Provisionamento pendente. Falha – Falha no provisionamento. Bem-sucedido – Provisionamento bem-sucedido. Cancelado – Provisionamento cancelado. PendingDeletion – Exclusão pendente. DeletionSuccess – Exclusão bem-sucedida. DeletionFailure – Falha de exclusão.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DescendantBehavior

O comportamento de uma política em recursos descendentes.

Nome	Tipo	Description
FallBack	string
Override	string
Unknown	string

DevOpsPolicyAssignment

Recurso de atribuição de Política de DevOps.

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties	DevOpsPolicyAssignmentProperties	Propriedades do recurso de atribuição de política de DevOps.
systemData	systemData	Metadados relativos à criação e última modificação do recurso.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DevOpsPolicyAssignmentProperties

Propriedades do recurso de atribuição de política de DevOps.

Nome	Tipo	Description
assignedAt	string	Obtém ou define a hora em que a atribuição foi criada em UTC.
descendantBehavior	DescendantBehavior	O comportamento de uma política em recursos descendentes.
policy	DevOpsPolicyDescriptor	Informações condensadas para identificar um recurso de Política de DevOps.
provisioningState	DevOpsProvisioningState	O estado de provisionamento do recurso. Pendente – Provisionamento pendente. Falha – Falha no provisionamento. Bem-sucedido – Provisionamento bem-sucedido. Cancelado – Provisionamento cancelado. PendingDeletion – Exclusão pendente. DeletionSuccess – Exclusão bem-sucedida. DeletionFailure – Falha de exclusão.
provisioningStatusMessage	string	Obtém a mensagem de status do recurso.
provisioningStatusUpdateTimeUtc	string	Obtém a hora em que o recurso foi verificado pela última vez.
resourceId	string	Obtém ou define a ID do recurso do Azure.

DevOpsPolicyDescriptor

Informações condensadas para identificar um recurso de Política de DevOps.

Nome	Tipo	Description
policyId	string	Obtém ou define o GUID da política.
policyName	string	Obtém ou define o nome da política.
policyType	DevOpsPolicyType	Tipos de recursos de Política de DevOps.
policyVersion	string	Obtém ou define a versão.

DevOpsPolicyType

Tipos de recursos de Política de DevOps.

Nome	Tipo	Description
Pipeline	string
Unknown	string

DevOpsProvisioningState

O estado de provisionamento do recurso.

Pendente – Provisionamento pendente. Falha – Falha no provisionamento. Bem-sucedido – Provisionamento bem-sucedido. Cancelado – Provisionamento cancelado. PendingDeletion – Exclusão pendente. DeletionSuccess – Exclusão bem-sucedida. DeletionFailure – Falha de exclusão.

Nome	Tipo	Description
Canceled	string
DeletionFailure	string
DeletionSuccess	string
Failed	string
Pending	string
PendingDeletion	string
Succeeded	string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

systemData

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via