Azure DevOps Orgs - List Available

Serviço:: Defender for Cloud

Versão API:: 2024-04-01

Retorna uma lista de todas as organizações do Azure DevOps acessíveis pelo token de usuário consumido pelo conector.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/securityConnectors/{securityConnectorName}/devops/default/listAvailableAzureDevOpsOrgs?api-version=2024-04-01

Parâmetros URI

Nome	Em	Necessário	Tipo	Descrição
resourceGroupName	path	True	string minLength: 1 maxLength: 90	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 minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Descrição
200 OK	AzureDevOpsOrgListResponse	Fornece uma lista de detalhes da organização do Azure DevOps
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Alcances

Nome	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

ListAvailable_AzureDevOpsOrgs

Pedido de exemplo

HTTP

POST https://management.azure.com/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/listAvailableAzureDevOpsOrgs?api-version=2024-04-01

Resposta de exemplo

Código de estado:: 200

{
  "value": [
    {
      "properties": {
        "onboardingState": "Onboarded",
        "actionableRemediation": {
          "state": "Enabled"
        },
        "provisioningState": "Succeeded"
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/myAzDevOpsOrg",
      "name": "myAzDevOpsOrg",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
    },
    {
      "properties": {
        "onboardingState": "OnboardedByOtherConnector",
        "actionableRemediation": {
          "state": "Enabled"
        },
        "provisioningState": "Succeeded"
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/anotherOrg",
      "name": "anotherOrg",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
    },
    {
      "properties": {
        "onboardingState": "NotOnboarded",
        "actionableRemediation": {
          "state": "None"
        }
      },
      "id": "/subscriptions/0806e1cd-cfda-4ff8-b99c-2b0af42cffd3/resourceGroups/myRg/providers/Microsoft.Security/securityConnectors/mySecurityConnectorName/devops/default/azureDevOpsOrgs/notOnboardedOrg",
      "name": "notOnboardedOrg",
      "type": "Microsoft.Security/securityConnectors/devops/azureDevOpsOrgs"
    }
  ]
}

Definições

Nome	Descrição
ActionableRemediation	Carga útil de configuração para anotações PR.
ActionableRemediationState	Configuração ActionableRemedia. Nenhum - o cenário nunca foi definido. Ativado - ActionableRemediation está habilitado. Desabilitado - ActionableRemediation está desabilitado.
AnnotateDefaultBranchState	Configuração de anotações PR na ramificação padrão. Habilitado - As anotações PR são habilitadas na ramificação padrão do recurso. Desabilitado - As anotações PR são desabilitadas na ramificação padrão do recurso.
AzureDevOpsOrg	Recurso da Organização de DevOps do Azure.
AzureDevOpsOrgListResponse	Lista de recursos de RP que suporta paginação.
AzureDevOpsOrgProperties	Propriedades da Organização de DevOps do Azure.
CategoryConfiguration	Nível de severidade por configuração de categoria para anotações PR.
createdByType	O tipo de identidade que criou o recurso.
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	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
InheritFromParentState	Atualizar configurações. Habilitado - O recurso deve herdar as configurações do pai. Desabilitado - O recurso não deve herdar configurações do pai.
OnboardingState	Detalhes sobre o status de integração de recursos em todos os conectores. OnboardedByOtherConnector - este recurso já foi integrado a outro conector. Isto só se aplica a recursos de nível superior. Integrado - este recurso já foi integrado pelo conector especificado. NotOnboarded - este recurso não foi integrado a nenhum conector. NotApplicable - o estado de integração não é aplicável ao endpoint atual.
RuleCategory	Categorias de regras. Código - resultados da verificação de código. Resultados da varredura de artefatos. Resultados da verificação de dependências. Resultados do IAC. Resultados da verificação de segredos. Resultados da varredura de contêineres.
systemData	Metadados referentes à criação e última modificação do recurso.
TargetBranchConfiguration	Configuração de ramificação do repositório para anotações PR.

ActionableRemediation

Objetivo

Carga útil de configuração para anotações PR.

Nome	Tipo	Descrição
branchConfiguration	TargetBranchConfiguration	Configuração de ramificação do repositório para anotações PR.
categoryConfigurations	CategoryConfiguration[]	Obtém ou define a lista de categorias e níveis de gravidade.
inheritFromParentState	InheritFromParentState	Atualizar configurações. Habilitado - O recurso deve herdar as configurações do pai. Desabilitado - O recurso não deve herdar configurações do pai.
state	ActionableRemediationState	Configuração ActionableRemedia. Nenhum - o cenário nunca foi definido. Ativado - ActionableRemediation está habilitado. Desabilitado - ActionableRemediation está desabilitado.

ActionableRemediationState

Enumeração

Configuração ActionableRemedia. Nenhum - o cenário nunca foi definido. Ativado - ActionableRemediation está habilitado. Desabilitado - ActionableRemediation está desabilitado.

Valor	Descrição
None
Disabled
Enabled

AnnotateDefaultBranchState

Enumeração

Configuração de anotações PR na ramificação padrão.

Habilitado - As anotações PR são habilitadas na ramificação padrão do recurso. Desabilitado - As anotações PR são desabilitadas na ramificação padrão do recurso.

Valor	Descrição
Disabled
Enabled

AzureDevOpsOrg

Objetivo

Recurso da Organização de DevOps do Azure.

Nome	Tipo	Descrição
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties	AzureDevOpsOrgProperties	Propriedades da Organização de DevOps do Azure.
systemData	systemData	Metadados referentes à criação e última modificação do recurso.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AzureDevOpsOrgListResponse

Objetivo

Lista de recursos de RP que suporta paginação.

Nome	Tipo	Descrição
nextLink	string	Obtém ou define o próximo link para rolar sobre os resultados.
value	AzureDevOpsOrg[]	Obtém ou define a lista de recursos.

AzureDevOpsOrgProperties

Objetivo

Propriedades da Organização de DevOps do Azure.

Nome	Tipo	Descrição
actionableRemediation	ActionableRemediation	Carga útil de configuração para anotações PR.
onboardingState	OnboardingState	Detalhes sobre o status de integração de recursos em todos os conectores. OnboardedByOtherConnector - este recurso já foi integrado a outro conector. Isto só se aplica a recursos de nível superior. Integrado - este recurso já foi integrado pelo conector especificado. NotOnboarded - este recurso não foi integrado a nenhum conector. NotApplicable - o estado de integração não é aplicável ao endpoint atual.
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 ou define a mensagem de status do recurso.
provisioningStatusUpdateTimeUtc	string (date-time)	Obtém ou define a hora em que o recurso foi verificado pela última vez.

CategoryConfiguration

Objetivo

Nível de severidade por configuração de categoria para anotações PR.

Nome	Tipo	Descrição
category	RuleCategory	Categorias de regras. Código - resultados da verificação de código. Resultados da varredura de artefatos. Resultados da verificação de dependências. Resultados do IAC. Resultados da verificação de segredos. Resultados da varredura de contêineres.
minimumSeverityLevel	string	Obtém ou define o nível mínimo de gravidade para uma determinada categoria.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

DevOpsProvisioningState

Enumeração

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.

Valor	Descrição
Succeeded
Failed
Canceled
Pending
PendingDeletion
DeletionSuccess
DeletionFailure

ErrorAdditionalInfo

Objetivo

O erro de gerenciamento de recursos informações adicionais.

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

ErrorDetail

Objetivo

O detalhe do erro.

Nome	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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

Objetivo

Resposta de erro

Nome	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

InheritFromParentState

Enumeração

Atualizar configurações.

Habilitado - O recurso deve herdar as configurações do pai. Desabilitado - O recurso não deve herdar configurações do pai.

Valor	Descrição
Disabled
Enabled

OnboardingState

Enumeração

Detalhes sobre o status de integração de recursos em todos os conectores.

OnboardedByOtherConnector - este recurso já foi integrado a outro conector. Isto só se aplica a recursos de nível superior. Integrado - este recurso já foi integrado pelo conector especificado. NotOnboarded - este recurso não foi integrado a nenhum conector. NotApplicable - o estado de integração não é aplicável ao endpoint atual.

Valor	Descrição
NotApplicable
OnboardedByOtherConnector
Onboarded
NotOnboarded

RuleCategory

Enumeração

Categorias de regras. Código - resultados da verificação de código. Resultados da varredura de artefatos. Resultados da verificação de dependências. Resultados do IAC. Resultados da verificação de segredos. Resultados da varredura de contêineres.

Valor	Descrição
Code
Artifacts
Dependencies
Secrets
IaC
Containers

systemData

Objetivo

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

Nome	Tipo	Descrição
createdAt	string (date-time)	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 (date-time)	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.

TargetBranchConfiguration

Objetivo

Configuração de ramificação do repositório para anotações PR.

Nome	Tipo	Descrição
annotateDefaultBranch	AnnotateDefaultBranchState	Configuração de anotações PR na ramificação padrão. Habilitado - As anotações PR são habilitadas na ramificação padrão do recurso. Desabilitado - As anotações PR são desabilitadas na ramificação padrão do recurso.
branchNames	string[]	Obtém ou define ramificações que devem ter anotações.

Nome

Tipo

Descrição

annotateDefaultBranch

AnnotateDefaultBranchState

Configuração de anotações PR na ramificação padrão.

Habilitado - As anotações PR são habilitadas na ramificação padrão do recurso. Desabilitado - As anotações PR são desabilitadas na ramificação padrão do recurso.

branchNames

string[]

Obtém ou define ramificações que devem ter anotações.

Partilhar via

Azure DevOps Orgs - List Available

Parâmetros URI

Respostas

Segurança

azure_auth

Alcances

Exemplos

ListAvailable_AzureDevOpsOrgs

Pedido de exemplo

Resposta de exemplo

Definições

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsOrg

AzureDevOpsOrgListResponse

AzureDevOpsOrgProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration