Azure DevOps Orgs - List Available

서비스:: Defender for Cloud

API 버전:: 2024-04-01

커넥터에서 사용하는 사용자 토큰으로 액세스할 수 있는 모든 Azure DevOps 조직의 목록을 반환합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
securityConnectorName	path	True	string	보안 커넥터 이름입니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	AzureDevOpsOrgListResponse	Azure DevOps 조직 세부 정보 목록을 제공합니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

ListAvailable_AzureDevOpsOrgs

샘플 요청

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

샘플 응답

상태 코드:: 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"
    }
  ]
}

정의

Name	Description
ActionableRemediation	PR 주석에 대한 구성 페이로드입니다.
ActionableRemediationState	ActionableRemediation 설정입니다. 없음 - 설정이 설정되지 않았습니다. 사용 - ActionableRemediation이 사용하도록 설정됩니다. 사용 안 함 - ActionableRemediation을 사용할 수 없습니다.
AnnotateDefaultBranchState	기본 분기에서 PR 주석 구성 사용 - 리소스의 기본 분기에서 PR 주석을 사용할 수 있습니다. 사용 안 함 - 리소스의 기본 분기에서 PR 주석을 사용할 수 없습니다.
AzureDevOpsOrg	Azure DevOps 조직 리소스.
AzureDevOpsOrgListResponse	페이지 매김을 지원하는 RP 리소스 목록입니다.
AzureDevOpsOrgProperties	Azure DevOps 조직 속성입니다.
CategoryConfiguration	PR 주석에 대한 범주 구성당 심각도 수준입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DevOpsProvisioningState	리소스의 프로비전 상태입니다. 보류 중 - 프로비전 보류 중입니다. 실패 - 프로비전에 실패했습니다. 성공 - 프로비전에 성공했습니다. 취소됨 - 프로비전이 취소되었습니다. PendingDeletion - 삭제 보류 중입니다. DeletionSuccess - 삭제에 성공했습니다. DeletionFailure - 삭제 실패입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
InheritFromParentState	설정을 업데이트합니다. 사용 - 리소스는 부모로부터 구성을 상속해야 합니다. 사용 안 함 - 리소스는 부모로부터 구성을 상속해서는 안 됩니다.
OnboardingState	모든 커넥터의 리소스 온보딩 상태에 대한 세부 정보입니다. OnboardedByOtherConnector - 이 리소스는 이미 다른 커넥터에 온보딩되었습니다. 이는 최상위 리소스에만 적용됩니다. 온보딩됨 - 이 리소스는 지정된 커넥터에 의해 이미 온보딩되었습니다. NotOnboarded - 이 리소스가 커넥터에 온보딩되지 않았습니다. NotApplicable - 온보딩 상태는 현재 엔드포인트에 적용되지 않습니다.
RuleCategory	규칙 범주입니다. 코드 - 코드 검사 결과입니다. 아티팩트 검색 결과입니다. 종속성 검사 결과입니다. IaC 결과입니다. 비밀 검사 결과입니다. 컨테이너 검색 결과입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TargetBranchConfiguration	PR 주석에 대한 리포지토리 분기 구성입니다.

ActionableRemediation

Object

PR 주석에 대한 구성 페이로드입니다.

Name	형식	Description
branchConfiguration	TargetBranchConfiguration	PR 주석에 대한 리포지토리 분기 구성입니다.
categoryConfigurations	CategoryConfiguration[]	범주 및 심각도 수준의 목록을 가져오거나 설정합니다.
inheritFromParentState	InheritFromParentState	설정을 업데이트합니다. 사용 - 리소스는 부모로부터 구성을 상속해야 합니다. 사용 안 함 - 리소스는 부모로부터 구성을 상속해서는 안 됩니다.
state	ActionableRemediationState	ActionableRemediation 설정입니다. 없음 - 설정이 설정되지 않았습니다. 사용 - ActionableRemediation이 사용하도록 설정됩니다. 사용 안 함 - ActionableRemediation을 사용할 수 없습니다.

ActionableRemediationState

열거형

ActionableRemediation 설정입니다. 없음 - 설정이 설정되지 않았습니다. 사용 - ActionableRemediation이 사용하도록 설정됩니다. 사용 안 함 - ActionableRemediation을 사용할 수 없습니다.

값	Description
None
Disabled
Enabled

AnnotateDefaultBranchState

열거형

기본 분기에서 PR 주석 구성

사용 - 리소스의 기본 분기에서 PR 주석을 사용할 수 있습니다. 사용 안 함 - 리소스의 기본 분기에서 PR 주석을 사용할 수 없습니다.

값	Description
Disabled
Enabled

AzureDevOpsOrg

Object

Azure DevOps 조직 리소스.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름
properties	AzureDevOpsOrgProperties	Azure DevOps 조직 속성입니다.
systemData	systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

AzureDevOpsOrgListResponse

Object

페이지 매김을 지원하는 RP 리소스 목록입니다.

Name	형식	Description
nextLink	string	결과를 스크롤할 다음 링크를 가져오거나 설정합니다.
value	AzureDevOpsOrg[]	리소스 목록을 가져오거나 설정합니다.

AzureDevOpsOrgProperties

Object

Azure DevOps 조직 속성입니다.

Name	형식	Description
actionableRemediation	ActionableRemediation	PR 주석에 대한 구성 페이로드입니다.
onboardingState	OnboardingState	모든 커넥터의 리소스 온보딩 상태에 대한 세부 정보입니다. OnboardedByOtherConnector - 이 리소스는 이미 다른 커넥터에 온보딩되었습니다. 이는 최상위 리소스에만 적용됩니다. 온보딩됨 - 이 리소스는 지정된 커넥터에 의해 이미 온보딩되었습니다. NotOnboarded - 이 리소스가 커넥터에 온보딩되지 않았습니다. NotApplicable - 온보딩 상태는 현재 엔드포인트에 적용되지 않습니다.
provisioningState	DevOpsProvisioningState	리소스의 프로비전 상태입니다. 보류 중 - 프로비전 보류 중입니다. 실패 - 프로비전에 실패했습니다. 성공 - 프로비전에 성공했습니다. 취소됨 - 프로비전이 취소되었습니다. PendingDeletion - 삭제 보류 중입니다. DeletionSuccess - 삭제에 성공했습니다. DeletionFailure - 삭제 실패입니다.
provisioningStatusMessage	string	리소스 상태 메시지를 가져오거나 설정합니다.
provisioningStatusUpdateTimeUtc	string (date-time)	리소스를 마지막으로 확인한 시간을 가져오거나 설정합니다.

CategoryConfiguration

Object

PR 주석에 대한 범주 구성당 심각도 수준입니다.

Name	형식	Description
category	RuleCategory	규칙 범주입니다. 코드 - 코드 검사 결과입니다. 아티팩트 검색 결과입니다. 종속성 검사 결과입니다. IaC 결과입니다. 비밀 검사 결과입니다. 컨테이너 검색 결과입니다.
minimumSeverityLevel	string	지정된 범주의 최소 심각도 수준을 가져오거나 설정합니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DevOpsProvisioningState

열거형

리소스의 프로비전 상태입니다.

보류 중 - 프로비전 보류 중입니다. 실패 - 프로비전에 실패했습니다. 성공 - 프로비전에 성공했습니다. 취소됨 - 프로비전이 취소되었습니다. PendingDeletion - 삭제 보류 중입니다. DeletionSuccess - 삭제에 성공했습니다. DeletionFailure - 삭제 실패입니다.

값	Description
Succeeded
Failed
Canceled
Pending
PendingDeletion
DeletionSuccess
DeletionFailure

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

InheritFromParentState

열거형

설정을 업데이트합니다.

사용 - 리소스는 부모로부터 구성을 상속해야 합니다. 사용 안 함 - 리소스는 부모로부터 구성을 상속해서는 안 됩니다.

값	Description
Disabled
Enabled

OnboardingState

열거형

모든 커넥터의 리소스 온보딩 상태에 대한 세부 정보입니다.

OnboardedByOtherConnector - 이 리소스는 이미 다른 커넥터에 온보딩되었습니다. 이는 최상위 리소스에만 적용됩니다. 온보딩됨 - 이 리소스는 지정된 커넥터에 의해 이미 온보딩되었습니다. NotOnboarded - 이 리소스가 커넥터에 온보딩되지 않았습니다. NotApplicable - 온보딩 상태는 현재 엔드포인트에 적용되지 않습니다.

값	Description
NotApplicable
OnboardedByOtherConnector
Onboarded
NotOnboarded

RuleCategory

열거형

규칙 범주입니다. 코드 - 코드 검사 결과입니다. 아티팩트 검색 결과입니다. 종속성 검사 결과입니다. IaC 결과입니다. 비밀 검사 결과입니다. 컨테이너 검색 결과입니다.

값	Description
Code
Artifacts
Dependencies
Secrets
IaC
Containers

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

TargetBranchConfiguration

Object

PR 주석에 대한 리포지토리 분기 구성입니다.

Name	형식	Description
annotateDefaultBranch	AnnotateDefaultBranchState	기본 분기에서 PR 주석 구성 사용 - 리소스의 기본 분기에서 PR 주석을 사용할 수 있습니다. 사용 안 함 - 리소스의 기본 분기에서 PR 주석을 사용할 수 없습니다.
branchNames	string[]	주석이 있어야 하는 분기를 가져오거나 설정합니다.

Name

형식

Description

annotateDefaultBranch

AnnotateDefaultBranchState

기본 분기에서 PR 주석 구성

사용 - 리소스의 기본 분기에서 PR 주석을 사용할 수 있습니다. 사용 안 함 - 리소스의 기본 분기에서 PR 주석을 사용할 수 없습니다.

branchNames

string[]

주석이 있어야 하는 분기를 가져오거나 설정합니다.

다음을 통해 공유

Azure DevOps Orgs - List Available

URI 매개 변수

응답

보안

azure_auth

범위

예제

ListAvailable_AzureDevOpsOrgs

샘플 요청

샘플 응답

정의

ActionableRemediation

ActionableRemediationState

AnnotateDefaultBranchState

AzureDevOpsOrg

AzureDevOpsOrgListResponse

AzureDevOpsOrgProperties

CategoryConfiguration

createdByType

DevOpsProvisioningState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InheritFromParentState

OnboardingState

RuleCategory

systemData

TargetBranchConfiguration